メインコンテンツへスキップ
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-image-1-official",
    "prompt": "星空の下の古い城",
    "size": "1:1",
    "quality": "auto",
    "n": 1
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-1-official",
    "prompt": "星空の下の古い城",
    "size": "1:1",
    "quality": "auto",
    "n": 1
  }'

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

​
サポートモデル

モデル名説明モード画像から画像最大枚数課金方式
gpt-image-1-official安定性重視、汎用画像生成に最適テキストから画像 / 画像から画像対応4枚サイズ×品質
gpt-image-1.5-official新バージョン、高品質・複雑な編集に最適テキストから画像 / 画像から画像対応4枚サイズ×品質

​
Authorizations

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

​
Body

​
model
string
必須
モデル名
  • gpt-image-1-official - 安定性重視、汎用画像生成に最適
  • gpt-image-1.5-official - 新バージョン、高品質・複雑な編集に最適
​
prompt
string
必須
画像生成のテキスト説明、中国語と英語に対応
​
size
string
デフォルト:"1:1"
アスペクト比対応する比率：
  • 1:1 - 正方形（デフォルト）
  • 3:2 - 横長
  • 2:3 - 縦長
​
n
integer
デフォルト:"1"
生成枚数範囲：1-4
  • 0以下の値は 1 として処理されます
  • 4を超える値は 4 として処理されます
⚠️ 注意： 純粋な数値（例：1）を入力してください。引用符を付けるとエラーになります
​
quality
string
デフォルト:"auto"
画像品質
  • auto - 自動品質選択（デフォルト）
  • low - より高速、より経済的
  • medium - 品質とコストのバランス
  • high - より高品質、コスト増
​
background
string
デフォルト:"auto"
背景モード
  • auto - 自動背景（デフォルト）
  • opaque - 不透明背景
  • transparent - 透明背景、png 出力形式との併用推奨
background: transparent と output_format: jpeg は同時に使用できません
​
moderation
string
デフォルト:"auto"
モデレーションレベル
  • auto - デフォルトのモデレーションレベル
  • low - より緩やかなモデレーション
​
output_format
string
デフォルト:"png"
出力形式
  • png - デフォルト形式、透明背景に最適
  • jpeg - ファイルサイズが小さい、一般的な画像出力に最適
background: transparent と output_format: jpeg は同時に使用できません
​
output_compression
integer
出力圧縮レベル、範囲 0-100
  • jpeg でのみ使用推奨
  • png では設定不要
​
image_urls
array
参照画像のURL配列、指定すると画像から画像モードが有効になります制限： 最大15枚の参照画像
​
mask_url
string
マスク画像URL、インペインティング用
  • image_urls と併用する必要があります
  • 公式編集APIで一緒に送信されます
1、マスク画像をアップロードする前に、画像のAlphaチャンネルが「はい」であることを確認してください。2、マスク画像のサイズは最初の参考画像と一致する必要があります。

​
サイズ対照表

アスペクト比を外部で使用し、システム内部で公式の実際のサイズに自動マッピングします。
比率実際のサイズ説明
1:11024×1024正方形
2:31024×1536縦長
3:21536×1024横長

​
使用例

テキストから画像（最小リクエスト） 
{
  "model": "gpt-image-1-official",
  "prompt": "星空の下の古い城"
}
テキストから画像（全パラメータ） 
{
  "model": "gpt-image-1-official",
  "prompt": "A flat icon of a glass bottle with no background",
  "size": "2:3",
  "quality": "high",
  "background": "transparent",
  "moderation": "low",
  "output_format": "png",
  "n": 1
}
画像から画像（単一参照画像） 
{
  "model": "gpt-image-1.5-official",
  "prompt": "参照画像をイラスト風に変換し、メインの輪郭を保持する",
  "size": "1:1",
  "quality": "auto",
  "image_urls": [
    "https://your-cdn.com/input.png"
  ],
  "n": 1
}
画像から画像（複数参照画像の融合） 
{
  "model": "gpt-image-1.5-official",
  "prompt": "2枚の参照画像をイラストポスターに融合し、メインの輪郭を保持する",
  "size": "1:1",
  "quality": "auto",
  "background": "transparent",
  "image_urls": [
    "https://your-cdn.com/input-a.png",
    "https://your-cdn.com/input-b.png"
  ],
  "moderation": "low",
  "output_format": "png",
  "n": 1
}
複数枚生成（n > 1） 
{
  "model": "gpt-image-1-official",
  "prompt": "Four minimalist poster variations of a red fox",
  "size": "1:1",
  "quality": "low",
  "output_format": "png",
  "n": 4
}

​
Response

​
code
integer
レスポンスステータスコード
​
data
array
レスポンスデータ配列

​
注意事項

  1. 非同期処理：送信後に task_id が返されます。/v1/tasks/{task_id} をポーリングして結果を取得してください
  2. モデル選択：汎用画像生成には gpt-image-1-official を優先使用。高品質編集や複雑な画像から画像には gpt-image-1.5-official を推奨
  3. 画像URL要件：画像から画像には、公開アクセス可能な安定した画像URLを使用してください
  4. 課金ルール：正常に生成された画像枚数で課金、失敗時は課金なし