メインコンテンツへスキップ
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,
    "image_urls": [
      "https://openai-documentation.vercel.app/images/cat_and_otter.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": "gemini-2.5-flash-image-preview",
    "prompt": "月明かりの下の竹林の小道",
    "size": "1:1",
    "n": 1,
    "image_urls": [
      "https://openai-documentation.vercel.app/images/cat_and_otter.png"
    ]
  }'

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

​
認証

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

​
リクエストボディ

​
model
string
デフォルト:"gemini-2.5-flash-image-preview"
必須
画像生成モデル名サポートされているモデル：
  • gemini-2.5-flash-image-preview - 標準版
  • gemini-2.5-flash-image-preview-official - 公式版
例："gemini-2.5-flash-image-preview" または "gemini-2.5-flash-image-preview-official"
​
prompt
string
必須
画像生成のためのテキスト説明最大1000文字
​
size
string
画像生成サイズサポートされている形式：
  • 比率：auto、1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9
テキストから画像生成では、size が auto の場合、デフォルトは 1:1 または 16:9 です。画像から画像生成では、上流の返却比率に従います。（比率の指定を推奨します）
​
resolution
string
デフォルト:"1K"
出力画像の解像度サポートされている値：
  • 1K - 1K 解像度（デフォルト）
​
n
integer
生成する画像の数範囲：1〜4（最小1枚、最大4枚）デフォルト：1⚠️ 注意： 純粋な数字を入力してください（例：1）。引用符を使用するとエラーになります
​
official_fallback
boolean
デフォルト:"false"
公式チャネルのフォールバックを使用するかどうか
  • false：使用しない（デフォルト）
  • true：公式チャネルを使用
公式チャネル（gemini-2.5-flash-image-preview-official）を使用する場合、このパラメータは使用できません。
​
image_urls
array
画像から画像への変換や画像編集用の参照画像URLリスト💡 クイック入力（Try itエリア）：
  1. 「+ Add an item」をクリックして画像URLを追加
  2. 完全な画像URLアドレスまたはbase64データを入力
制限： 最大14枚の画像
​
mask_url
string
マスク画像の URL。部分再描画（inpainting）に使用します
  • image_urls と併用する必要があります
  • 1 枚のみアップロード可能
マスク画像をアップロードする前に、画像の Alpha チャンネルが「あり」であることを確認してください。

​
レスポンス

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