メインコンテンツへスキップ
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-3-pro-image-preview",
    "prompt": "月明かりの下の竹林の小道",
    "size": "1:1",
    "n": 1,
    "resolution": "1K"
  }'
{
  "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-3-pro-image-preview",
    "prompt": "月明かりの下の竹林の小道",
    "size": "1:1",
    "n": 1,
    "resolution": "1K"
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

Authorizations

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

Body

model
string
デフォルト:"gemini-3-pro-image-preview"
必須
画像生成モデル名サポートされているモデル:
  • gemini-3-pro-image-preview - 標準版
  • gemini-3-pro-image-preview-official - 公式版
例:"gemini-3-pro-image-preview" または "gemini-3-pro-image-preview-official"
prompt
string
必須
画像生成のテキスト説明
size
string
画像生成のサイズサポートされている形式:
  • 比率:1:12:33:23:44:34:55:49:1616:921:9
n
integer
生成する画像の数範囲:1〜4(最小1枚、最大4枚)デフォルト:1⚠️ 注意: 純粋な数字(例:1)を入力してください。引用符を付けないでください。エラーになります
resolution
string
出力画像の解像度サポートされる値:
  • 1K - 1K解像度(デフォルト)
  • 2K - 2K解像度
  • 4K - 4K解像度
⚠️ 注意: base64形式で4K画像を生成する場合、処理時間が長くなります
official_fallback
boolean
デフォルト:"false"
公式チャネルのフォールバックを使用するかどうか
  • false:使用しない(デフォルト)
  • true:公式チャネルを使用
公式チャネル(gemini-3-pro-image-preview-official)を使用する場合、このパラメータは使用できません。
image_urls
array
画像から画像への変換や画像編集用の参照画像URLリスト💡 クイック入力(Try itエリア):
  1. 「+ Add an item」をクリックして画像URLを追加
  2. 完全な画像URLアドレスまたはbase64データを入力
制限: 最大14枚の画像

Response

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