メインコンテンツへスキップ
POST
https://api.apimart.ai
/
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.1-flash-image-preview",
    "prompt": "サイバーパンクスタイルの夜の都市景観、ネオンライトが輝く",
    "size": "16:9",
    "resolution": "2K",
    "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-3.1-flash-image-preview",
    "prompt": "サイバーパンクスタイルの夜の都市景観、ネオンライトが輝く",
    "size": "16:9",
    "resolution": "2K",
    "n": 1
  }'

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

​
認証

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

​
Body

​
model
string
デフォルト:"gemini-3.1-flash-image-preview"
必須
画像生成モデル名Example: "gemini-3.1-flash-image-preview"
​
prompt
string
必須
画像生成のテキスト説明
​
size
string
画像のアスペクト比サポートされる比率：
  • 1:1 - 正方形、アバター、SNS
  • 3:2 / 2:3 - 標準写真
  • 4:3 / 3:4 - 従来のディスプレイ比率
  • 16:9 / 9:16 - ワイドスクリーン/縦型動画カバー
  • 5:4 / 4:5 - Instagram画像
  • 21:9 - ウルトラワイドバナー
  • 1:4 / 4:1 - 長尺ポスター/バナー
  • 1:8 / 8:1 - 極端な長尺画像/バナー広告
​
resolution
string
デフォルト:"1K"
出力画像解像度サポートされる値：
  • 0.5K - 約512px、低解像度プレビュー
  • 1K - 約1024px、標準解像度（デフォルト）
  • 2K - 約2048px、高解像度
  • 4K - 約4096px、超高解像度
注意： 解像度によって料金が異なります。4Kは1Kより高額です。
​
n
integer
生成する画像の数デフォルト：1⚠️ 注意： 数値のみ入力してください（例：1）。引用符を使用するとエラーが発生します
​
image_urls
array
画像から画像生成用の参照画像URLリスト制限：
  • 最大 14枚 の参照画像（推奨：最大10枚のオブジェクト参照 + 4枚のキャラクター参照）
  • 1枚あたり10MB以下
  • 対応形式：jpeg、png、webp
​
google_search
boolean
デフォルト:"false"
Googleテキスト検索強化を有効にする
  • true：モデルがウェブテキスト情報を検索して画像生成を支援します
  • false：無効（デフォルト）
​
google_image_search
boolean
デフォルト:"false"
Google画像検索強化を有効にする
  • true：テキスト検索に加えて、参照画像も検索して生成を支援します
  • false：無効（デフォルト）
注意： google_search: true と一緒に使用する必要があります

​
レスポンス

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