v3

latestOpenAPI 3.0.0Proprietary2026-08-041323140.2 KB
API Endpoints

List agent models

List the currently available agent models and the aliases that resolve to them.

The model parameter on POST /jobs/agent accepts any value listed under availableModels[].id or aliases[].id. Aliases let you target the latest recommended model for a given tier without chasing version bumps — for example, passing claude-opus always routes to whichever Claude Opus version Descript currently recommends.

The catalog changes as models launch and retire, so this endpoint's live response is the source of truth — the example below is an abridged illustration, not the full list.

Cost tiers are coarse buckets — low, medium, high — useful for showing users a relative price/performance signal. Exact pricing is reported per job via the ai_credits_used field on GET /jobs/{job_id}.

When model is omitted on POST /jobs/agent, the request defaults to auto, which selects a recommended model for your account. auto is a medium-cost option. For an auto request, result.resolved_model on GET /jobs/{job_id} reports auto; for an explicit model or alias it reports the canonical id that ran.

get/agent/models

Response

Available agent models and aliases

Example response

{
  "availableModels": [
    {
      "id": "claude-opus-4.8",
      "cost": "high"
    }
  ],
  "aliases": [
    {
      "id": "claude-opus",
      "resolvesTo": "claude-opus-4.8",
      "description": "Tracks stable Anthropic Claude Opus",
      "cost": "high"
    }
  ]
}