メインコンテンツへスキップ
POST
/
v1
/
images
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-2.5-flash-image-preview",
    "prompt": "月明かりの下の竹林の小道",
    "size": "1:1",
    "n": 1
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-2.5-flash-image-preview",
    "prompt": "月明かりの下の竹林の小道",
    "size": "1:1",
    "n": 1
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

​
認証

​
Authorization
string
required
すべてのAPIエンドポイントはBearer Token認証が必要ですAPIキーの取得方法：APIキー管理ページにアクセスしてAPIキーを取得してくださいリクエストヘッダーに追加：
Authorization: Bearer YOUR_API_KEY

​
リクエストボディ

​
model
string
default:"gemini-2.5-flash-image-preview"
required
画像生成モデル名Example: "gemini-2.5-flash-image-preview"
​
prompt
string
required
画像生成のためのテキスト説明最大1000文字
​
size
string
画像生成サイズサポートされている形式：
  • 比率：1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9
​
n
integer
default:"1"
生成する画像の数1に固定
​
image_urls
array
画像から画像または画像編集のための参照画像URLリスト
  • 最大5枚の画像
  • 各画像は10MBを超えないこと
  • サポート形式：.jpeg, .jpg, .png, .webp
​
mask_url
string
マスク画像URL
  • PNG形式である必要があります
  • サイズは参照画像と一致する必要があります
  • 最大4MB

​
レスポンス

​
created
integer
タスク作成タイムスタンプ
​
id
string
一意のタスク識別子
​
model
string
実際に使用されたモデル名
​
object
string
オブジェクトタイプ、image.generation.taskに固定
​
progress
integer
タスク完了進捗率 (0-100)
​
status
string
タスクステータス可能な値:
  • pending - 処理待ち
  • processing - 処理中
  • completed - 完了
  • failed - 失敗
​
task_info
object
タスク詳細
​
type
string
出力タイプ、imageに固定
​
usage
object
課金情報