> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryorbit.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Native Orbit API

> Call a model by slug without an OpenAI or Anthropic client.

The native chat route is useful for simple HTTP clients. For most apps, prefer the [OpenAI](/api/openai) or [Anthropic](/api/anthropic) SDKs.

## Chat

```http theme={"theme":"github-dark"}
POST https://api.tryorbit.cloud/api/v1/models/{slug}/chat
Authorization: Bearer $ORBIT_API_KEY
```

`{slug}` can be a catalogue slug (`claude-sonnet-5`) or the catalogue UUID.

```bash theme={"theme":"github-dark"}
curl https://api.tryorbit.cloud/api/v1/models/claude-sonnet-5/chat \
  -H "Authorization: Bearer $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{ "role": "user", "content": "Hello!" }],
    "stream": false
  }'
```

### Body

| Field         | Type    | Notes                                                                           |
| ------------- | ------- | ------------------------------------------------------------------------------- |
| `messages`    | array   | Required. Each item has `role` (`user` or `assistant`) and non-empty `content`. |
| `max_tokens`  | number  | Optional                                                                        |
| `temperature` | number  | Optional                                                                        |
| `stream`      | boolean | Default `false`. `true` returns server-sent events.                             |

## Errors

| Status | Meaning                          |
| ------ | -------------------------------- |
| `400`  | Invalid body or missing messages |
| `401`  | Missing or invalid API key       |
| `402`  | Organization is low on credits   |
| `404`  | Model not found                  |
| `502`  | Provider call failed             |

## Other API-key routes

These share the same `sk-orbit-` auth and timeout as chat:

* `POST /api/v1/chat/completions` — OpenAI compatible
* `GET /api/v1/models` — OpenAI model list
* `POST /api/v1/messages` — Anthropic compatible