Models

GET /v1/models

Lists models with pricing and metadata.

Authentication is optional. With an API key, the list holds only the models your organization has access to, priced in its billing currency. Without one, it lists every model ai& serves, priced in USD. Requests without a key are rate-limited to 600 per minute per IP, one budget shared by every catalog endpoint callable without a key, including GET /v1/videos/models.

Example

curl https://api.aiand.com/v1/models

With an API key:

curl https://api.aiand.com/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

Response

{
  "object": "list",
  "data": [
    {
      "id": "google/gemma-4-31b-it",
      "name": "google/gemma-4-31b-it",
      "object": "model",
      "created": 1775474514,
      "owned_by": "ai&",
      "provider": "google",
      "context_window": 262144,
      "max_output_tokens": 32768,
      "capabilities": [
        "reasoning",
        "tool_calling",
        "vision",
        "video",
        "document"
      ],
      "reasoning_efforts": [
        "none",
        "high"
      ],
      "reasoning_effort_default": "none",
      "description": "Largest Gemma 4 instruction model for open, self-hosted chat and reasoning",
      "currency": "usd",
      "input_per_1m": "0.200000",
      "output_per_1m": "0.500000",
      "cached_input_per_1m": "0.050000",
      "deprecation_date": null
    }
  ]
}

Model object

Field	Type	Description
id	string	Model identifier — use this as the model parameter in requests
object	string	Always "model"
created	integer	Unix timestamp
owned_by	string	Always "ai&"
provider	string	Upstream provider name
context_window	integer	Maximum context length in tokens
max_output_tokens	integer | null	Recorded maximum generation length. null when no limit is recorded for the model
description	string	Short model description
currency	string	Your organization’s billing currency (usd or jpy)
input_per_1m	string	Cost per 1M input tokens, in your billing currency. Numeric value returned as a string for precision (e.g. "0.150000")
output_per_1m	string	Cost per 1M output tokens, in your billing currency
deprecation_date	string | null	When the model stops serving requests, as an ISO 8601 timestamp. null when no retirement is scheduled

Example

curl https://api.aiand.com/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

Model name resolution

The model parameter you send on an inference request (/v1/chat/completions, /v1/responses, /v1/messages) must be an exact model id from GET /v1/models. Matching is case-insensitive, but partial names are not accepted: a model family without its version returns a 404 with error code model_not_found rather than guessing a version. Use GET /v1/models as the source of valid names.

A model that exists but your organization does not have access to returns a 404 with error code model_access_denied. It is also left out of your organization’s GET /v1/models list.

Usage is always recorded and billed against the model’s canonical id, regardless of the casing you sent.

Cost calculation

cost = (input_tokens / 1_000_000 * input_per_1m) + (output_tokens / 1_000_000 * output_per_1m)

Credits are deducted after each successful request. Failed requests (4xx/5xx) are not billed.