画像生成

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

input_references: [{"type":"image","role":"reference","source":{"type":"file","file_id":"..."}}] で素材を参照します。type は実ファイルの image/audio/video に一致させます。source を COS 署名 URL に変換し、role を保持して DSL に渡します。既存の必須項目は引き続き必要です。Images と Speech の input_references は InOneAPI 拡張です。

公開仕様は OpenAI Images に準拠：POST /v1/images/generations。互換サービスは透過転送し、非互換 JSON は管理者が DSL で変換します。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	任意の画像数。通常 1–10、一部モデルは 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	任意の真偽値、既定は非ストリーム。ネイティブ互換のみ透過転送。request DSL では変換不可。
`partial_images`	integer	ストリーム用の整数 0–3。途中画像の最大数であり、出力枚数ではありません。最終画像が先に届く場合があります。

モデル別の完全例

全パラメーターを同時に指定できる共通モデルはありません。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 秒の整数。動画仕様の ISO 日時とは異なります。
`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 は入力や DSL の不整合、401/403 は認証・権限、429 は Retry-After に従って待機。502 は正規化失敗や応答バッファ超過の可能性。X-Gateway-Trace-ID を記録し、キーや機密画像は記録しません。タイムアウト後も生成済みの可能性があるため無条件に再送しないでください。同期結果またはネイティブ SSE であり、動画式タスク API ではありません。汎用タスク取得、非同期ポーリング変換、variations は未実装。DSL は SSE を変換しません。Base64 は GATEWAY_RESPONSE_BUFFER_BYTES（既定 32 MiB）制限を受けるため、並列数とメモリーを考慮してください。

管理者・AI 向け設定

image_path を設定。ネイティブは {"version":1}。生成は request/response。ネイティブプロトコルは既定で有効です。無効にすると DSL の編集とテストができます。厳密な上流スキーマには mode=replace。リポジトリの docs/image-protocol-dsl.md と docs/protocol-mapping-dsl.schema.json にフィールド対応、fixture、列挙値、機能不足の確認方法を記載。価格は別 DSL で、計量は上流の元レスポンスを使用。

オンライン体験

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