モデル

画像モデルを一覧表示

画像モデルを一覧表示。 レスポンス例の料金と利用量は形式を示すための値です。実際の値は取得したカタログを使用してください。

GET
/v1/creative/image-router/models
curl --request GET 'https://api.orchestor.io/v1/creative/image-router/models' \  --header "Authorization: Bearer $ORCHESTOR_API_KEY"
{  "data": {    "models": [      {        "id": "gpt-image-2",        "name": "GPT Image 2",        "modality": "image",        "routing": "pass_through",        "capabilities": {          "text_to_image": true,          "image_edit": true,          "aspect_ratios": [            "1:1",            "16:9",            "9:16"          ],          "resolutions": [            "1K"          ],          "qualities": [            "low",            "medium",            "high"          ],          "max_images": 1,          "output_formats": [            "png",            "jpeg",            "webp"          ]        },        "pricing": {          "basis": "per_image",          "credits_per_image": 5        },        "constraints": []      }    ]  }}

認証

次のいずれかの条件を満たしてください。

  • bearerAuth
  • x-api-key

認証の詳細

bearer
Authorization

外部 API キー。session は受け付けません。apiKey と同時に送ると 401 です。

レスポンス

application/json

モデルの対応入力・制約・料金を返します。生成前に、このモデルが受け付けるオプションを確認してください。

ヘッダー

x-orchestor-request-idstringheader

HTTP リクエストの相関 ID。ジョブの request_id とは別の値。

ratelimit-limitintegerheader

現在の期間で許可されるリクエスト数。

ratelimit-remainingintegerheader

現在の期間で残っているリクエスト数。

ratelimit-resetintegerheader

制限がリセットされるまでの秒数。

retry-afterintegerheader

再試行までの待機秒数。

{  "data": {    "models": [      {        "id": "gpt-image-2",        "name": "GPT Image 2",        "modality": "image",        "routing": "pass_through",        "capabilities": {          "text_to_image": true,          "image_edit": true,          "aspect_ratios": [            "1:1",            "16:9",            "9:16"          ],          "resolutions": [            "1K"          ],          "qualities": [            "low",            "medium",            "high"          ],          "max_images": 1,          "output_formats": [            "png",            "jpeg",            "webp"          ]        },        "pricing": {          "basis": "per_image",          "credits_per_image": 5        },        "constraints": []      }    ]  }}
dataobject必須

この操作が返す結果。形状は以下の子フィールドを参照してください。

追加プロパティ
許可しない
data.modelsImageRouterCatalogItem[]必須

利用できるモデルと各モデルの対応入力・料金。

data.models[]ImageRouterCatalogItem
追加プロパティ
許可しない
data.models[].idstringenum<string>必須

取得・更新時に指定する、このリソースの一意な識別子。

許可される値
higgsfield-soulsoul-2.0gpt-image-2.5gpt-image-2.5-sunburstgpt-image-2.6gpt-image-2.6-sunburstgpt-image-2nano-banana-2.1nano-banana-2-litenano-banana-2ideogram-vectorideogram-4-5-precise-editseedream-5.5minimax-h3-imageflux-3-imagegpt-image-1.5nano-banana-proseedream-5-liteseedream-4-5-editgrok-imageseedream-v4flux-2-proflux-2-flexideogram-v3recraft-v4qwen-image-layeredqwen-image-anglesideogram-v4.5nano-bananaflux-kontext-maxwan-2.2recraft-v4.1seedream-5-flashz-imageflux-2-maxkling-image-o1kling-image-3-omniseedream-5-prohiggsfield-soul-standardhiggsfield-soul-cinemagrok-imagine-2recraft-v4.1-utilitykling-image-3higgsfield-ai-influencerhiggsfield-ads-studio
data.models[].namestring必須

選択画面などに表示する名称。

data.models[].modalitystringenum<string>必須

モデルが生成するメディアの種類。

許可される値
image
data.models[].routingstringenum<string>必須

モデルへの入力の渡し方と呼び出し経路の情報。

許可される値
pass_through
data.models[].capabilitiesobject必須

テキスト生成・編集・参照入力など、このモデルが対応する機能。

追加プロパティ
許可しない
data.models[].capabilities.text_to_imageboolean必須

文章から画像を生成できるかどうか。

data.models[].capabilities.image_editboolean必須

入力画像を編集できるかどうか。

data.models[].capabilities.aspect_ratiosstring[]必須

このモデルで指定できる縦横比の一覧。

data.models[].capabilities.aspect_ratios[]string
data.models[].capabilities.resolutionsstring[]必須

このモデルで指定できる出力解像度の一覧。

data.models[].capabilities.resolutions[]string
data.models[].capabilities.qualitiesstring[]必須

このモデルで指定できる品質の一覧。

data.models[].capabilities.qualities[]string
data.models[].capabilities.max_reference_imagesinteger

このモデルが受け付ける参照画像の最大数。

値の範囲
≥ 1
data.models[].capabilities.max_imagesinteger必須

一つの要求に含められる画像数の上限。

data.models[].capabilities.output_formatsstring[]必須

このモデルで生成できるファイル形式の一覧。

data.models[].capabilities.output_formats[]string
data.models[].pricingobject必須

課金単位とモデルの単価。生成前の見積もりに使用します。

追加プロパティ
許可しない
data.models[].pricing.basisstringenum<string>必須

画像数、秒数、解像度など、単価を適用する基準。

許可される値
per_image
data.models[].pricing.credits_per_imagenumber必須

画像 1 枚あたりの消費クレジット。

値の範囲
≥ 0
data.models[].pricing.image_edit_optionsobject[]

画像編集の設定ごとの消費クレジット。

data.models[].pricing.image_edit_options[]object
追加プロパティ
許可しない
data.models[].pricing.image_edit_options[].resolutionstring
data.models[].pricing.image_edit_options[].qualitystring
data.models[].pricing.image_edit_options[].creditsnumber必須
値の範囲
≥ 0
data.models[].pricing.credits_by_image_countobject

出力枚数ごとの合計消費クレジット。料金は要求全体で丸められます。

data.models[].pricing.credits_by_image_count.*number
値の範囲
≥ 0
data.models[].pricing.usd_per_imagestring

画像 1 枚あたりの USD 単価。

パターン
^\d+\.\d{4,}$
data.models[].pricing.usd_optionsobject[]

生成オプションによる USD 単価の差。

data.models[].pricing.usd_options[]object
追加プロパティ
許可しない
data.models[].pricing.usd_options[].labelstring必須

画面に表示する項目の名前。

data.models[].pricing.usd_options[].resolutionstring

出力の解像度。モデルが対応する値をカタログで確認します。

data.models[].pricing.usd_options[].audioboolean

音声の生成または入力への対応条件。

data.models[].pricing.usd_options[].qualitystring

モデルが受け付ける生成品質。対応する値はカタログで確認します。

data.models[].pricing.usd_options[].usdstring必須

指定した処理の料金。単位は USD。

パターン
^\d+\.\d{4,}$
data.models[].constraintsstring[]必須

モデルごとに受け付ける解像度、入力数、長さなどの制約。

data.models[].constraints[]string