画像生成

ファイルを入力する場合はファイル API でアップロードし、返された file_id を参照します。ゲートウェイは変換を担当し、入力への対応可否は上流が判断します。

input_references: [{"type":"image","role":"reference","source":{"type":"file","file_id":"..."}}] で素材を参照します。type は実ファイルの image/audio/video に一致させます。ゲートウェイがファイルを読み取り、上流の API が期待する形で引き渡し、role はそのまま保たれます。既存の必須項目は引き続き必要です。Images・Video・Speech の input_references は InOneAPI 拡張です。

公開仕様は OpenAI Images に準拠：POST /v1/images/generations。サービスプロバイダーごとのパラメーターやレスポンスの差異はプラットフォーム側で吸収するため、公開仕様に従ってリクエストするだけでできます。InOneAPI は明示的な公開 model ID を必須とし、OpenAI の既定モデルに依存しません。

最小リクエスト

YOUR_MODEL_ID をモデル詳細の正確な ID に置き換え、接頭辞は追加しないでください。任意パラメーターはモデルの対応範囲に従い、アプリヘッダーはコメントのままで利用できます。

# -H "X-APP-NAME: Your App Name"
# -H "X-APP-URL: https://your-app.example.com"
curl "https://api.inoneapi.com/v1/images/generations" \
  -H "Authorization: Bearer $INONEAPI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_MODEL_ID",
  "prompt": "A blue bird on a white background"
}'

生成パラメーター一覧

Parameter	Type	生成パラメーター一覧
`model`	string	必須の公開モデル ID。転送時にプラットフォームが実際のサービスプロバイダーのモデル ID に置き換えます。
`prompt`	string	必須の生成指示。被写体、構図、スタイル、文字、制約を記述。長さ制限はモデル依存。
`n`	integer	任意の画像数。Qwen-Image シリーズ（2.1/3.0）は 1–6 枚、既定値 1。Seedream 系・GLM-Image・混元画像など非対応モデルは 1 枚のみ生成し、エラーにはなりません。モデル詳細ページの「画像数」能力が対応目印。省略時は上流の既定値。
`size`	string	任意の WIDTHxHEIGHT または auto。例：1024x1024、1536x1024、1024x1536。ゲートウェイで拡縮しません。
`quality`	string	任意。GPT Image 系は auto/low/medium/high、旧モデルは standard/hd など。全モデル共通ではありません。
`style`	string	任意の vivid/natural。対応する旧形式モデルのみ。
`response_format`	string	対応サービスのみ url/b64_json。GPT Image は常に Base64 で、このフィールドを受け付けないため省略。
`background`	string	任意の auto/opaque/transparent。透過には対応モデルと png/webp が必要、jpeg は不可。
`output_format`	string	任意の png/jpeg/webp。対応時のみ使用。省略時は上流既定値。
`output_compression`	integer	任意の整数 0–100。jpeg/webp 圧縮のみ、png では使用不可。
`moderation`	string	対応時のみ auto/low。安全対策を回避する機能ではありません。
`user`	string	任意の利用者識別子。メール・電話番号などの機密情報を避けてください。
`stream`	boolean	任意の真偽値、既定は非ストリーム。ストリーム対応はモデル次第で、非対応の場合 400 `PROTOCOL_STREAM_UNSUPPORTED` を返します。
`partial_images`	integer	ストリーム用の整数 0–3。途中画像の最大数であり、出力枚数ではありません。最終画像が先に届く場合があります。

n 対応モデル

n はすべての画像モデルで使えるわけではありません。上流が複数画像出力に対応し、プラットフォームがパラメーターを映射しているモデルでのみ有効です。現在の対応モデルは Qwen-Image シリーズ（qwen-image-2.1-pro、qwen-image-3.0、qwen-image-3.0-pro）で、1–6 枚、既定値は 1 枚です。モデル詳細ページの能力区に「画像数」と表示されていれば対応しています。

非対応モデル（Seedream 系、GLM-Image、混元画像）は 1 回のリクエストで 1 枚だけ返します。n を送ってもエラーにならず、枚数も増えません。Seedream 系の上流複数画像機能は別の組図パラメーター（sequential_image_generation）で、枚数指定とは意味が異なり、現在は公開していません。モデル詳細ページの API ガイドポップアップでも同样の案内を表示します。

モデル別の完全例

全パラメーターを同時に指定できる共通モデルはありません。GPT Image 系と旧式 style/URL を分けて示します。model ID を有効なものへ置換。partial_images はストリーム例を参照。

curl https://api.inoneapi.com/v1/images/generations \
  -H "Authorization: Bearer $INONEAPI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "YOUR_MODEL_ID",
  "prompt": "A blue bird on a white background",
  "n": 1,
  "size": "1024x1024",
  "quality": "high",
  "background": "opaque",
  "output_format": "jpeg",
  "output_compression": 90,
  "moderation": "auto",
  "user": "user_123",
  "stream": false
}'

{"model":"YOUR_MODEL_ID","prompt":"A blue bird","n":1,"size":"1024x1024","quality":"hd","style":"vivid","response_format":"url","user":"user_123"}

curl -N https://api.inoneapi.com/v1/images/generations \
  -H "Authorization: Bearer $INONEAPI_API_KEY" -H 'Content-Type: application/json' \
  -d '{"model":"YOUR_MODEL_ID","prompt":"A blue bird","stream":true,"partial_images":2}'

レスポンスと保存

{
  "created":1788580800,
  "data":[{"b64_json":"REPLACE_WITH_IMAGE_BYTES"}],
  "background":"opaque",
  "output_format":"jpeg",
  "size":"1024x1024",
  "quality":"high",
  "usage":{"input_tokens":100,"output_tokens":1000,"total_tokens":1100,"input_tokens_details":{"text_tokens":60,"image_tokens":40}}
}

Field	レスポンスと保存
`created`	Unix 秒の整数。動画の時刻形式はプロバイダー次第なので、混同しないでください。
`data[]`	順序付き結果配列。通常 n に対応しますが失敗時の完全性は保証されません。
`data[].b64_json`	data URL 接頭辞を含まない Base64。出力形式に従って復号。
`data[].url`	対応サービスのみの一時 URL。早めに保存し、永続ホスティングを期待しないでください。
`data[].revised_prompt`	任意の修正済みプロンプト。元の指示とは異なる場合があります。
`background / output_format / size / quality`	任意の実際の背景・形式・寸法・品質。
`usage`	任意のトークン使用量。欠落は無料を意味しません。
`usage.input_tokens / output_tokens / total_tokens`	任意の入力・出力・合計トークン。input_tokens_details.text_tokens/image_tokens は入力内訳。実際の課金はモデルの課金方式に従い、トークン以外の単位の場合もあります。

エラー・ストリーム・制限

400 はモデルが受け付けないパラメーターやメディア形式、401/403 は認証・権限、429 は Retry-After に従って待機。502 はプロバイダーが解析不能なレスポンスを返した場合の可能性。X-Gateway-Trace-ID を記録し、キーや機密画像は記録しません。タイムアウト後も生成済みの可能性があるため無条件に再送しないでください。同期結果またはプロバイダーの SSE イベントであり、動画式タスク API ではありません。汎用タスク取得、非同期ポーリング変換、variations は未実装。SSE はサービスプロバイダーの元のイベント形式で返り、構造は変更されません。Base64 は本文を大幅に膨らませ、単一レスポンスには上限があり超過時は失敗します。URL 出力を選んで早めに保存してください。

オンライン体験

コンソールの Playground とモデル詳細の「今すぐ試す」は、モデルの出力モダリティに応じてこの API を呼び出します。data[].url と data[].b64_json の画像を表示・保存できます。テキストと画像の両方に対応するモデルでは、入力欄で出力形式を選択します。モデル一覧のタブは出力能力のみで絞り込みます。