Creative Models

画像モデルを取得

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

GET
/v1/creative/image-router/models/{model_id}
curl --request GET 'https://api.orchestor.io/v1/creative/image-router/models/gpt-image-2' \  --header "Authorization: Bearer $ORCHESTOR_API_KEY"
{  "data": {    "model": {      "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": []    }  }}

Authorizations

Satisfy one of these options:

  • bearerAuth
  • x-api-key

Authentication details

bearer
Authorization

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

Path Parameters

model_idstringpathrequired

モデルカタログの ID。モデルが受け付ける入力と制約は対応するカタログ行で確認します。

Example"gpt-image-2"

Response

application/json

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

Headers

x-orchestor-request-idstringheader

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

ratelimit-limitintegerheader

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

ratelimit-remainingintegerheader

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

ratelimit-resetintegerheader

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

retry-afterintegerheader

再試行までの待機秒数。

{  "data": {    "model": {      "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": []    }  }}
dataobjectrequired

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

Additional properties
Not allowed
data.modelImageRouterCatalogItemrequired

モデルカタログの ID。モデルが受け付ける入力と制約は対応するカタログ行で確認します。

Additional properties
Not allowed
data.model.idstringenum<string>required

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

Allowed
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.model.namestringrequired

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

data.model.modalitystringenum<string>required

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

Allowed
image
data.model.routingstringenum<string>required

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

Allowed
pass_through
data.model.capabilitiesobjectrequired

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

Additional properties
Not allowed
data.model.capabilities.text_to_imagebooleanrequired

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

data.model.capabilities.image_editbooleanrequired

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

data.model.capabilities.aspect_ratiosstring[]required

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

data.model.capabilities.aspect_ratios[]string
data.model.capabilities.resolutionsstring[]required

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

data.model.capabilities.resolutions[]string
data.model.capabilities.qualitiesstring[]required

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

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

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

Value range
≥ 1
data.model.capabilities.max_imagesintegerrequired

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

data.model.capabilities.output_formatsstring[]required

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

data.model.capabilities.output_formats[]string
data.model.pricingobjectrequired

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

Additional properties
Not allowed
data.model.pricing.basisstringenum<string>required

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

Allowed
per_image
data.model.pricing.credits_per_imagenumberrequired

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

Value range
≥ 0
data.model.pricing.image_edit_optionsobject[]

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

data.model.pricing.image_edit_options[]object
Additional properties
Not allowed
data.model.pricing.image_edit_options[].resolutionstring
data.model.pricing.image_edit_options[].qualitystring
data.model.pricing.image_edit_options[].creditsnumberrequired
Value range
≥ 0
data.model.pricing.credits_by_image_countobject

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

data.model.pricing.credits_by_image_count.*number
Value range
≥ 0
data.model.pricing.usd_per_imagestring

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

Pattern
^\d+\.\d{4,}$
data.model.pricing.usd_optionsobject[]

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

data.model.pricing.usd_options[]object
Additional properties
Not allowed
data.model.pricing.usd_options[].labelstringrequired

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

data.model.pricing.usd_options[].resolutionstring

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

data.model.pricing.usd_options[].audioboolean

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

data.model.pricing.usd_options[].qualitystring

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

data.model.pricing.usd_options[].usdstringrequired

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

Pattern
^\d+\.\d{4,}$
data.model.constraintsstring[]required

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

data.model.constraints[]string