Skip to main content

List models

List model identifiers available to the current account. GET /api/v1/cloud/models Lists the enabled models available to the current account. Use this endpoint to choose the model value when creating or updating an Agent.

Headers

HeaderRequiredDescription
AuthorizationYesBearer $QODER_PAT

Query parameters

This endpoint does not currently accept query parameters.

Example request

curl -X GET "https://api.qoder.com.cn/api/v1/cloud/models" \
  -H "Authorization: Bearer $QODER_PAT"

Example response

HTTP 200 OK 
{
  "data": [
    {
      "id": "ultimate",
      "type": "model",
      "display_name": "Ultimate",
      "source": "system",
      "is_enabled": true,
      "is_new": false,
      "price_factor": 1.6,
      "efforts": ["low", "medium", "high", "xhigh", "max"],
      "default_effort": "high",
      "max_input_tokens": 1000000,
      "default_context_window": 200000,
      "available_context_windows": [200000, 400000, 1000000]
    }
  ],
  "has_more": false
}

Response fields

FieldTypeDescription
dataarrayAvailable Model objects
has_morebooleanAlways false; model listing is not paginated
Each model object contains:
FieldTypeDescription
idstringModel identifier to pass as the Agent model
typestringAlways "model"
display_namestringHuman-readable model name
sourcestringModel source, usually system; user for account-specific models
is_enabledbooleanWhether the model is enabled and usable
is_newbooleanWhether the model is marked as new
price_factornumberOptional relative price multiplier
effortsarrayOptional supported reasoning effort levels, such as none, low, medium, high, xhigh, or max
default_effortstringOptional default effort level when the upstream catalog designates one
max_input_tokensintegerMaximum input context supported by the model, in tokens
default_context_windowintegerOptional default context window (in tokens) to use when the Agent does not set one
available_context_windowsarray of integerOptional user-selectable context window tiers (in tokens) accepted as model.context_window when creating or updating an Agent

Notes

  • Only enabled models are returned.
  • The response does not include internal routing, provider, secret, or description fields.
  • The model catalog is resolved for the authenticated user and the service's configured scene. The default scene is assistant.

Errors

HTTPTypeTrigger
401authentication_errorPAT invalid or expired
503api_errorModel catalog is temporarily unavailable
See Errors for the full error envelope.
Overview
Getting Started