メインコンテンツへスキップ
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": "gpt-4o-image",
    "prompt": "海の上の鮮やかな色彩の美しい夕焼け",
    "size": "1:1",
    "n": 1,
    "image_urls": [
      "https://cdn.apimart.ai/doc/9998238784524590-549804af-14bc-4fbc-bae5-9d8469d35de3-image_task_01K889V97T2YF8RHQW21XMVMS1_0.png"
    ]
  }'

{
  "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": "gpt-4o-image",
    "prompt": "海の上の鮮やかな色彩の美しい夕焼け",
    "size": "1:1",
    "n": 1,
    "image_urls": [
      "https://cdn.apimart.ai/doc/9998238784524590-549804af-14bc-4fbc-bae5-9d8469d35de3-image_task_01K889V97T2YF8RHQW21XMVMS1_0.png"
    ]
  }'

{
  "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:"gpt-4o-image"
required
画像生成モデル名Example: "gpt-4o-image"
​
prompt
string
required
画像生成のためのテキスト説明最大1000文字
​
size
string
画像生成サイズサポートされている形式：
  • 比率：1:1, 2:3, 3:2
​
n
integer
生成する画像の数1、2、4をサポート。数量に基づいて料金が事前に差し引かれます
​
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
課金情報