画像モデル

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"

生成の手順と結果の受け取り方は画像生成を参照してください。

入力パラメータ

フィールド型指定意味値と制約
modelstring必須このページのモデルを選ぶ ID。他のモデル名や別名に置き換えず指定します。固定値 "ideogram-v3"
promptstring必須生成する内容、または編集で変更したい内容を記述する文章。minLength: 1
character_element_idstring任意Soul 2 で使用する、このワークスペースの学習済みキャラクター要素の ID。pattern: "^elem_[a-f0-9-]{36}$"
image_urls(string)[]任意編集や参照に使う画像の HTTPS URL。入力は認証なしで取得できる必要があります。minItems: 1; maxItems: 16
mask_urlstring任意編集する領域を指定するマスク画像の HTTPS URL。対応モデルで使用します。format: "uri"
aspect_ratiostring任意出力の幅と高さの比。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_sizestring / object / string任意プリセット、WIDTHxHEIGHT、または width と height のオブジェクト。aspect_ratio より優先されます。モデルの capabilities と constraints で確認
image_size.widthinteger必須画像またはフレームの幅。単位はピクセル。minimum: 1
image_size.heightinteger必須画像またはフレームの高さ。単位はピクセル。minimum: 1
qualitystring任意モデルが受け付ける生成品質。対応する値はカタログで確認します。モデルの capabilities と constraints で確認
resolutionstring任意出力の解像度。モデルが対応する値をカタログで確認します。"0.5K", "1K", "2K", "4K", "720p", "1080p"
num_imagesinteger任意一つのジョブで生成する画像数。共通スキーマの範囲内でもモデル固有の上限が適用されます。minimum: 1; maximum: 10
output_formatstring任意成果物のファイル形式。対応する値はモデルによって異なります。"png", "jpeg", "jpg", "webp", "gif", "svg"
metadataobject任意利用者の追跡用データ。ジョブと関連付けて保存し、モデルには送りません。モデルの capabilities と constraints で確認
modestring任意async は即時応答、webhook は終端通知、sync と subscribe は時間を区切って完了を待ちます。"async", "sync", "subscribe", "webhook"; default: "async"
webhook_urlstring任意終端イベントを受け取る公開 HTTPS URL(2048 文字以内、既定のポート)。async または webhook モードで指定し、sync とは併用できません。localhost、プライベート、ループバック、リンクローカルのアドレス宛ては指定できません。ジョブが完了、失敗、取消のいずれかになると、ワークスペースの署名シークレットで署名した通知を 1 件送ります。maxLength: 2048; format: "uri"
wait_timeout_secondsinteger任意HTTP 応答を待つ秒数。0〜30。時間を過ぎてもジョブは継続します。minimum: 0; maximum: 30
project_idstring任意ジョブまたは配置先を関連付けるプロジェクトの ID。maxLength: 200
model_paramsobject任意モデル固有設定。通常は省略または空オブジェクト。higgsfield-ai-influencer は tier(normal、freak、total)と selection(グループ ID から最大 4 個の選択 ID への対応)を指定できます。モデルの capabilities と constraints で確認
backgroundstring任意GPT Image 2.5 系の背景指定。auto、transparent、opaque。対応モデルだけに指定します。"auto", "transparent", "opaque"
rendering_speedstring任意生成速度と品質の配分。TURBO、BALANCED、QUALITY から対応モデルの値を選びます。"TURBO", "BALANCED", "QUALITY"
complexitystring任意描画前の計画量。low、medium、high。GPT Image 2.6 系で使用し、既定は high です。quality とは別の設定です。"low", "medium", "high"
frame_countinteger任意GIF のフレーム数。GPT Image 2.6 の GIF 出力で 2〜16、既定は 9。image_size は各フレームのサイズです。minimum: 2; maximum: 16
frame_duration_msinteger任意GIF の 1 フレームの表示時間。20〜2,000 ミリ秒を 10 ミリ秒単位に丸めます。既定は 200。minimum: 20; maximum: 2000

カタログの対応範囲

フィールド型指定意味値と制約
namestring必須選択画面などに表示する名称。モデルの capabilities と constraints で確認
modalitystring必須モデルが生成するメディアの種類。"image"
routingstring必須モデルへの入力の渡し方と呼び出し経路の情報。"pass_through"
capabilitiesobject必須テキスト生成・編集・参照入力など、このモデルが対応する機能。必須の子項目: text_to_image, image_edit, aspect_ratios, resolutions, qualities, max_images, output_formats
capabilities.text_to_imageboolean必須文章から画像を生成できるかどうか。モデルの capabilities と constraints で確認
capabilities.image_editboolean必須入力画像を編集できるかどうか。モデルの capabilities と constraints で確認
capabilities.aspect_ratios(string)[]必須このモデルで指定できる縦横比の一覧。モデルの capabilities と constraints で確認
capabilities.resolutions(string)[]必須このモデルで指定できる出力解像度の一覧。モデルの capabilities と constraints で確認
capabilities.qualities(string)[]必須このモデルで指定できる品質の一覧。モデルの capabilities と constraints で確認
capabilities.max_reference_imagesinteger任意このモデルが受け付ける参照画像の最大数。minimum: 1
capabilities.max_imagesinteger必須一つの要求に含められる画像数の上限。モデルの capabilities と constraints で確認
capabilities.output_formats(string)[]必須このモデルで生成できるファイル形式の一覧。モデルの capabilities と constraints で確認
constraints(string)[]必須モデルごとに受け付ける解像度、入力数、長さなどの制約。モデルの capabilities と constraints で確認

料金の形状

金額はカタログ取得時の値を使用します。単価と課金単位を組み合わせて見積もり、実際の消費量はジョブの usage で確認してください。

フィールド型指定意味値と制約
basisstring必須画像数、秒数、解像度など、単価を適用する基準。"per_image"
credits_per_imagenumber必須画像 1 枚あたりの消費クレジット。minimum: 0
image_edit_options(object)[]任意画像編集の設定ごとの消費クレジット。モデルの capabilities と constraints で確認
image_edit_options[].resolutionstring任意この料金を適用する画像編集の解像度。モデルの capabilities と constraints で確認
image_edit_options[].qualitystring任意この料金を適用する画像編集の品質。モデルの capabilities と constraints で確認
image_edit_options[].creditsnumber必須指定した解像度と品質で画像を 1 枚編集するときの消費クレジット。minimum: 0
credits_by_image_countobject任意出力枚数ごとの合計消費クレジット。料金は要求全体で丸められます。モデルの capabilities と constraints で確認
usd_per_imagestring任意画像 1 枚あたりの USD 単価。pattern: "^\\d+\\.\\d{4,}$"
usd_options(object)[]任意生成オプションによる USD 単価の差。モデルの capabilities と constraints で確認
usd_options[].labelstring必須画面に表示する項目の名前。モデルの capabilities と constraints で確認
usd_options[].resolutionstring任意出力の解像度。モデルが対応する値をカタログで確認します。モデルの capabilities と constraints で確認
usd_options[].audioboolean任意音声の生成または入力への対応条件。モデルの capabilities と constraints で確認
usd_options[].qualitystring任意モデルが受け付ける生成品質。対応する値はカタログで確認します。モデルの capabilities と constraints で確認
usd_options[].usdstring必須指定した処理の料金。単位は USD。pattern: "^\\d+\\.\\d{4,}$"