Models

List models

Lists the models naturali offers, sorted by name. Filter by vendor, input/output modality or lifecycle status. Every model listed here is available to any project with a provider: "naturali" AI provider — there is no second class to filter for. Models naturali cannot serve (unpriced, or producing something other than text) are not in this catalog; to generate on one of those, register your own credentials as an AI provider and ask that provider what it serves with GET /v1/projects/{project_id}/ai-providers/{ai_provider_id}/models.

get/v1/models

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/models
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)

Query parameters

limitinteger

Results per page, 1 to 100 (default 50). Above 100 it is clamped; below 1 or not an integer it is 400.

cursorstring

Opaque pagination cursor from a previous response's next_cursor.

vendorstring
Example:amazon

Filter by model maker (e.g. anthropic, amazon, meta).

modalitystring
Example:text

Filter to models whose input or output modalities include this value (e.g. text, image, embedding, speech).

status'available' | 'deprecated'
Example:available

Filter by lifecycle status.

Response

A page of models.

next_cursorstring nullable required

Cursor for the next page, or null at the end.

Example response

{
  "data": [
    {
      "model": "nova-lite-v1",
      "vendor": "amazon",
      "input_modalities": [
        "text",
        "image",
        "video"
      ],
      "output_modalities": [
        "text"
      ],
      "streaming": true,
      "status": "available",
      "pricing": {
        "input_usd_per_token": 7.5e-8,
        "output_usd_per_token": 3e-7,
        "cached_input_usd_per_token": 1.875e-8
      },
      "synced_at": "2026-08-18T06:00:00.000Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.