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 かエラーメッセージを送っていただければ、こちらで調査します。