List chat and embedding models

curl --request GET \
  --url https://api.aurous-labs.com/v1/models \
  --header 'X-Api-Key: <api-key>'

{
  "object": "list",
  "data": [
    {
      "object": "model",
      "id": "aurous-grow-2.0-pro",
      "created": 1716076800,
      "owned_by": "aurous",
      "kind": "chat",
      "display_name": "Aurous Chat Pro",
      "description": "Flagship multimodal chat model with 256K context.",
      "chat_pricing": {
        "input": {
          "credits_per_M": 75
        },
        "output": {
          "credits_per_M": 75
        }
      },
      "embedding_pricing": {
        "text": {
          "credits_per_M": 75
        },
        "visual": {
          "credits_per_M": 75
        },
        "video": {
          "credits_per_M": 75
        }
      },
      "aurous_metadata": {
        "context_window": 256000,
        "default_max_output_tokens": 4096,
        "max_output_tokens_hard_cap": 128000,
        "capabilities": [
          "streaming",
          "tools",
          "structured_output"
        ],
        "deprecated_at": null,
        "replaced_by_slug": null,
        "dimensions": [
          256,
          512,
          1024
        ],
        "max_input_items": 96
      }
    }
  ]
}

Chat completions

List chat and embedding models

Returns the catalog of chat and embedding models available to your team. Shape mirrors OpenAI’s GET /v1/models envelope ({ object: "list", data: [...] }) so SDK clients that already speak OpenAI drop in unchanged. Platform-specific fields (capability tags, lifecycle pointers) live under aurous_metadata on each entry. Per-model pricing lives on top-level chat_pricing (chat models) or embedding_pricing (embedding models) — the unused sibling is null. Customers can compute credits-per-1K by dividing the published credits_per_M value by 1000. When the catalog is empty the response is 200 with data: [] — never 404. No query, path, or body parameters are accepted.

Image and video rates are frozen per Aurous-Version: customers pinned to an older version see the rate card that was current when their version shipped, so price changes are never silently retroactive. Chat and embedding rates are NOT frozen per Aurous-Version — they track the most recently published rate version for each model, because LLM provider economics shift on weekly cadence. The receipt echoed on every chat / embedding response carries the exact rate that applied at dispatch time, so audit trails remain stable.

GET

models

curl --request GET \
  --url https://api.aurous-labs.com/v1/models \
  --header 'X-Api-Key: <api-key>'

{
  "object": "list",
  "data": [
    {
      "object": "model",
      "id": "aurous-grow-2.0-pro",
      "created": 1716076800,
      "owned_by": "aurous",
      "kind": "chat",
      "display_name": "Aurous Chat Pro",
      "description": "Flagship multimodal chat model with 256K context.",
      "chat_pricing": {
        "input": {
          "credits_per_M": 75
        },
        "output": {
          "credits_per_M": 75
        }
      },
      "embedding_pricing": {
        "text": {
          "credits_per_M": 75
        },
        "visual": {
          "credits_per_M": 75
        },
        "video": {
          "credits_per_M": 75
        }
      },
      "aurous_metadata": {
        "context_window": 256000,
        "default_max_output_tokens": 4096,
        "max_output_tokens_hard_cap": 128000,
        "capabilities": [
          "streaming",
          "tools",
          "structured_output"
        ],
        "deprecated_at": null,
        "replaced_by_slug": null,
        "dimensions": [
          256,
          512,
          1024
        ],
        "max_input_items": 96
      }
    }
  ]
}

Authorizations

X-Api-Key

string

header

required

Your team API key (starts with al_live_).

Headers

Aurous-Version

string

Optional API version pin (YYYY-MM-DD). Defaults to your team's pinned version, or the system default 2026-05-15 for unauthenticated requests.

Pattern: ^\d{4}-\d{2}-\d{2}$

Example:

"2026-05-15"

Response

List of available chat and embedding models.

object

enum<string>

required

Discriminator — always list.

Available options:

list

Example:

"list"

data

object[]

required

All active + public models in the catalog. Order matches the admin-configured sort_order. Empty catalog returns data: [] (NEVER 404).

Show child attributes

Cancel an in-flight chat completion Embeddings