API リファレンス

画像:即時応答

対応モデルはまだありません

現在、モデル一覧にこのルートに対応するモデルはありません。このページは参考として残しています。
POST/v1/images/generations

このルートに対応するモデル向けの、OpenAI 形式のボディ 1 つで行う同期型の画像生成。レスポンスには最終的な画像 URL が含まれます。

#リクエストパラメーター

  • modelstring必須

    この同期ルートに対応する画像モデル。タスク専用モデルは拒否します — /v1/images/tasks を使ってください。

  • promptstring必須

    描きたい内容。

  • ninteger任意

    画像の枚数(枚数分の料金がかかります)。

  • sizestring任意

    アスペクト比のプリセット(例:"16:9")。ほとんどの画像モデルはこの形式で、指定できる値はモデルカードに記載されています。一部の古いモデルは WIDTHxHEIGHT も受け付けます。

  • resolutionstring任意

    出力解像度のティア(例:"1K"、"2K"、"4K")。モデルカードに記載がある場合に指定できます — これも料金ティアの軸の 1 つです。

  • qualitystring任意

    ベンダーの品質レベル(例:standard / hd) — これも料金ティアの軸の 1 つです。

  • response_formatstring任意

    "url"(デフォルト)、またはバイト列をインラインで返す "b64_json"。

ティア別料金

size、quality、duration によって課金ティアが決まります — ティアごとの正確な料金はモデルカードに記載されており、失敗した呼び出しは自動で返金されます。

#関連するエラー

  • 422 unprocessable_entityゲートウェイが転送したパラメーター値をベンダーが拒否しました(対応していないサイズや長さなど)。
  • 401Bearer トークンが無効か、ありません。このパスでは error.code が付きません — ステータスで判定してください。
  • 402 insufficient_user_quotaウォレット残高が事前確保の見積額に足りません。
  • 429キー単位のレート制限です。ボディは空なので、Retry-After の時間だけ待ってください。insufficient_user_quota が付いた 429 は、レート制限ではなく 1 日の利用上限額によるものです。
  • 503 model_not_found不明なモデルか、現在そのモデルを提供できる正常なチャネルがありません。

エラーコード一覧 →

#リクエスト例

curl https://www.aisplice.store/v1/images/generations \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_SYNC_IMAGE_MODEL",
    "prompt": "A cyberpunk skyline at dusk, neon rain",
    "size": "1:1"
  }'

#レスポンス

response.json
{
  "created": 1720000000,
  "data": [{"url": "https://…"}]
}

まだ解決しませんか?

リクエスト ID かエラーメッセージを送っていただければ、こちらで調査します。