Read one partner model's catalog entry by canonical model ID.

Per-model detail for a single Comfy Router model, so a caller can check one model without walking the whole paginated catalog. The SDKs use it to look a model up immediately before invoking it.

GET /v2/models/{provider}/{model}

Read one partner model's catalog entry by canonical model ID.

cURL

curl --request GET \
  --url https://api.comfy.org/v2/models/{provider}/{model} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "bfl/flux-2-pro",
  "provider": "bfl",
  "model": "flux-2-pro",
  "billing": {
    "charges_on_policy_rejection": "unknown"
  },
  "input_schema_url": "<string>"
}

承認

BearerAuthApiKeyAuth

Authorization · string · header · 必須

Bearer token authentication. Normally a Firebase or Cloud JWT. A 'comfyui-' prefixed API key is also accepted in this header: the prefix classifies the value as an API key and it is validated exactly as if it had been sent in X-API-Key.

パスパラメータ

provider · string · 必須

Lowercase provider segment of the canonical {provider}/{model} model ID - the partner whose model is being run. Lowercase provider segment of the canonical {provider}/{model} model ID - the partner whose model is being addressed. The invocation route's provider path parameter and a catalog entry's provider field both reference this one schema, which is what keeps the listed IDs and the accepted IDs from drifting apart.

Maximum string length: 64

Pattern: ^[a-z0-9]+([._-][a-z0-9]+)*$

例:

"bfl"

model · string · 必須

Lowercase model segment of the canonical {provider}/{model} model ID - the model to run within that provider. Lowercase model segment of the canonical {provider}/{model} model ID - the model to run within that provider. Shared by the invocation route's model path parameter and a catalog entry's model field, for the same no-drift reason as RouterProviderSegment.

Maximum string length: 128

Pattern: ^[a-z0-9]+([._-][a-z0-9]+)*$

例:

"flux-2-pro"

レスポンス

200

application/json

OK - the model's catalog entry.

Per-model detail for one Comfy Router model: everything the catalog listing reports for it, plus the per-model fields that only the single-model route carries.

id · string · 必須

A canonical Comfy Router model ID, {provider}/{model} - exactly the value that addresses the model on POST /v2/models/{provider}/{model}, so a caller can interpolate it into that path without re-deriving it from anything. Its pattern is RouterProviderSegment and RouterModelSegment joined by a single /, and maxLength is their sum plus that separator.

Maximum string length: 193

Pattern: ^[a-z0-9]+([._-][a-z0-9]+)*/[a-z0-9]+([._-][a-z0-9]+)*$

例:

"bfl/flux-2-pro"

provider · string · 必須

Lowercase provider segment of the canonical {provider}/{model} model ID - the partner whose model is being addressed. The invocation route's provider path parameter and a catalog entry's provider field both reference this one schema, which is what keeps the listed IDs and the accepted IDs from drifting apart.

Maximum string length: 64

Pattern: ^[a-z0-9]+([._-][a-z0-9]+)*$

例:

"bfl"

model · string · 必須

Lowercase model segment of the canonical {provider}/{model} model ID - the model to run within that provider. Shared by the invocation route's model path parameter and a catalog entry's model field, for the same no-drift reason as RouterProviderSegment.

Maximum string length: 128

Pattern: ^[a-z0-9]+([._-][a-z0-9]+)*$

例:

"flux-2-pro"

billing · object · 必須

Per-model billing facts a caller needs before invoking - not prices. Usage and cost figures never appear here.

Show child attributes

input_schema_url · string<uri>

Pointer to this model's input schema document - the description of the body POST /v2/models/{provider}/{model} accepts for this model. Only the pointer is part of this contract: the document it addresses is authored separately. Absent when no schema has been authored for the model.

Maximum string length: 2048

Pattern: ^https://