画像モデル
ideogram-v3
画像カタログのモデル ID は ideogram-v3 です。モデル一覧から同じ種類のモデルを比較できます。
使用前に確認すること
下の入力表は router が扱う共通パラメータです。すべての設定をこのモデルへ同時に渡せるという意味ではありません。利用するワークスペースのカタログ行で対応入力・値・組み合わせを確認し、対応する設定だけを送信してください。
GET /v1/creative/image-router/models/{model_id} で一行を取得します。data.model.capabilities と data.model.constraints を確認してから、生成要求を組み立てます。
curl 'https://api.orchestor.io/v1/creative/image-router/models/ideogram-v3' \
-H "Authorization: Bearer $ORCHESTOR_API_KEY"生成の手順と結果の受け取り方は画像生成を参照してください。
入力パラメータ
| フィールド | 型 | 指定 | 意味 | 値と制約 |
|---|---|---|---|---|
model | string | 必須 | このページのモデルを選ぶ ID。他のモデル名や別名に置き換えず指定します。 | 固定値 "ideogram-v3" |
prompt | string | 必須 | 生成する内容、または編集で変更したい内容を記述する文章。 | minLength: 1 |
character_element_id | string | 任意 | Soul 2 で使用する、このワークスペースの学習済みキャラクター要素の ID。 | pattern: "^elem_[a-f0-9-]{36}$" |
image_urls | (string)[] | 任意 | 編集や参照に使う画像の HTTPS URL。入力は認証なしで取得できる必要があります。 | minItems: 1; maxItems: 16 |
mask_url | string | 任意 | 編集する領域を指定するマスク画像の HTTPS URL。対応モデルで使用します。 | format: "uri" |
aspect_ratio | string | 任意 | 出力の幅と高さの比。auto は入力画像に合わせます。モデルの対応値を確認してください。 | "auto", "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "9:8", "1:2", "2:1", "1:3", "3:1", "1:4", "4:1", "1:8", "8:1", "9:21", "21:9", "10:16", "16:10", "20:9", "19.5:9", "9:19.5", "9:20", "6:10", "14:10", "10:14" |
image_size | string / object / string | 任意 | プリセット、WIDTHxHEIGHT、または width と height のオブジェクト。aspect_ratio より優先されます。 | モデルの capabilities と constraints で確認 |
image_size.width | integer | 必須 | 画像またはフレームの幅。単位はピクセル。 | minimum: 1 |
image_size.height | integer | 必須 | 画像またはフレームの高さ。単位はピクセル。 | minimum: 1 |
quality | string | 任意 | モデルが受け付ける生成品質。対応する値はカタログで確認します。 | モデルの capabilities と constraints で確認 |
resolution | string | 任意 | 出力の解像度。モデルが対応する値をカタログで確認します。 | "0.5K", "1K", "2K", "4K", "720p", "1080p" |
num_images | integer | 任意 | 一つのジョブで生成する画像数。共通スキーマの範囲内でもモデル固有の上限が適用されます。 | minimum: 1; maximum: 10 |
output_format | string | 任意 | 成果物のファイル形式。対応する値はモデルによって異なります。 | "png", "jpeg", "jpg", "webp", "gif", "svg" |
metadata | object | 任意 | 利用者の追跡用データ。ジョブと関連付けて保存し、モデルには送りません。 | モデルの capabilities と constraints で確認 |
mode | string | 任意 | async は即時応答、webhook は終端通知、sync と subscribe は時間を区切って完了を待ちます。 | "async", "sync", "subscribe", "webhook"; default: "async" |
webhook_url | string | 任意 | 終端イベントを受け取る公開 HTTPS URL(2048 文字以内、既定のポート)。async または webhook モードで指定し、sync とは併用できません。localhost、プライベート、ループバック、リンクローカルのアドレス宛ては指定できません。ジョブが完了、失敗、取消のいずれかになると、ワークスペースの署名シークレットで署名した通知を 1 件送ります。 | maxLength: 2048; format: "uri" |
wait_timeout_seconds | integer | 任意 | HTTP 応答を待つ秒数。0〜30。時間を過ぎてもジョブは継続します。 | minimum: 0; maximum: 30 |
project_id | string | 任意 | ジョブまたは配置先を関連付けるプロジェクトの ID。 | maxLength: 200 |
model_params | object | 任意 | モデル固有設定。通常は省略または空オブジェクト。higgsfield-ai-influencer は tier(normal、freak、total)と selection(グループ ID から最大 4 個の選択 ID への対応)を指定できます。 | モデルの capabilities と constraints で確認 |
background | string | 任意 | GPT Image 2.5 系の背景指定。auto、transparent、opaque。対応モデルだけに指定します。 | "auto", "transparent", "opaque" |
rendering_speed | string | 任意 | 生成速度と品質の配分。TURBO、BALANCED、QUALITY から対応モデルの値を選びます。 | "TURBO", "BALANCED", "QUALITY" |
complexity | string | 任意 | 描画前の計画量。low、medium、high。GPT Image 2.6 系で使用し、既定は high です。quality とは別の設定です。 | "low", "medium", "high" |
frame_count | integer | 任意 | GIF のフレーム数。GPT Image 2.6 の GIF 出力で 2〜16、既定は 9。image_size は各フレームのサイズです。 | minimum: 2; maximum: 16 |
frame_duration_ms | integer | 任意 | GIF の 1 フレームの表示時間。20〜2,000 ミリ秒を 10 ミリ秒単位に丸めます。既定は 200。 | minimum: 20; maximum: 2000 |
カタログの対応範囲
| フィールド | 型 | 指定 | 意味 | 値と制約 |
|---|---|---|---|---|
name | string | 必須 | 選択画面などに表示する名称。 | モデルの capabilities と constraints で確認 |
modality | string | 必須 | モデルが生成するメディアの種類。 | "image" |
routing | string | 必須 | モデルへの入力の渡し方と呼び出し経路の情報。 | "pass_through" |
capabilities | object | 必須 | テキスト生成・編集・参照入力など、このモデルが対応する機能。 | 必須の子項目: text_to_image, image_edit, aspect_ratios, resolutions, qualities, max_images, output_formats |
capabilities.text_to_image | boolean | 必須 | 文章から画像を生成できるかどうか。 | モデルの capabilities と constraints で確認 |
capabilities.image_edit | boolean | 必須 | 入力画像を編集できるかどうか。 | モデルの capabilities と constraints で確認 |
capabilities.aspect_ratios | (string)[] | 必須 | このモデルで指定できる縦横比の一覧。 | モデルの capabilities と constraints で確認 |
capabilities.resolutions | (string)[] | 必須 | このモデルで指定できる出力解像度の一覧。 | モデルの capabilities と constraints で確認 |
capabilities.qualities | (string)[] | 必須 | このモデルで指定できる品質の一覧。 | モデルの capabilities と constraints で確認 |
capabilities.max_reference_images | integer | 任意 | このモデルが受け付ける参照画像の最大数。 | minimum: 1 |
capabilities.max_images | integer | 必須 | 一つの要求に含められる画像数の上限。 | モデルの capabilities と constraints で確認 |
capabilities.output_formats | (string)[] | 必須 | このモデルで生成できるファイル形式の一覧。 | モデルの capabilities と constraints で確認 |
constraints | (string)[] | 必須 | モデルごとに受け付ける解像度、入力数、長さなどの制約。 | モデルの capabilities と constraints で確認 |
料金の形状
金額はカタログ取得時の値を使用します。単価と課金単位を組み合わせて見積もり、実際の消費量はジョブの usage で確認してください。
| フィールド | 型 | 指定 | 意味 | 値と制約 |
|---|---|---|---|---|
basis | string | 必須 | 画像数、秒数、解像度など、単価を適用する基準。 | "per_image" |
credits_per_image | number | 必須 | 画像 1 枚あたりの消費クレジット。 | minimum: 0 |
image_edit_options | (object)[] | 任意 | 画像編集の設定ごとの消費クレジット。 | モデルの capabilities と constraints で確認 |
image_edit_options[].resolution | string | 任意 | この料金を適用する画像編集の解像度。 | モデルの capabilities と constraints で確認 |
image_edit_options[].quality | string | 任意 | この料金を適用する画像編集の品質。 | モデルの capabilities と constraints で確認 |
image_edit_options[].credits | number | 必須 | 指定した解像度と品質で画像を 1 枚編集するときの消費クレジット。 | minimum: 0 |
credits_by_image_count | object | 任意 | 出力枚数ごとの合計消費クレジット。料金は要求全体で丸められます。 | モデルの capabilities と constraints で確認 |
usd_per_image | string | 任意 | 画像 1 枚あたりの USD 単価。 | pattern: "^\\d+\\.\\d{4,}$" |
usd_options | (object)[] | 任意 | 生成オプションによる USD 単価の差。 | モデルの capabilities と constraints で確認 |
usd_options[].label | string | 必須 | 画面に表示する項目の名前。 | モデルの capabilities と constraints で確認 |
usd_options[].resolution | string | 任意 | 出力の解像度。モデルが対応する値をカタログで確認します。 | モデルの capabilities と constraints で確認 |
usd_options[].audio | boolean | 任意 | 音声の生成または入力への対応条件。 | モデルの capabilities と constraints で確認 |
usd_options[].quality | string | 任意 | モデルが受け付ける生成品質。対応する値はカタログで確認します。 | モデルの capabilities と constraints で確認 |
usd_options[].usd | string | 必須 | 指定した処理の料金。単位は USD。 | pattern: "^\\d+\\.\\d{4,}$" |