Introduction

CanalAPI is a unified gateway over 600+ LLM, image, and audio models. Use any OpenAI-compatible client — point base_url at https://api.canalapi.com/v1, pass your key, and ship.

Quickstart

You need two things: an API key (from the console) and a model slug. Here's the simplest possible request:

# Any OpenAI-compatible client works — just swap the base URL
curl https://api.canalapi.com/v1/chat/completions \
  -H "Authorization: Bearer $CANAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-4-sonnet",
    "messages": [{"role":"user","content":"Hello"}]
  }'

Response

{
  "id": "chatcmpl_8K2m3",
  "object": "chat.completion",
  "created": 1745078400,
  "model": "claude-4-sonnet",
  "choices": [{
    "index": 0,
    "message": { "role": "assistant", "content": "Hi there!" },
    "finish_reason": "stop"
  }],
  "usage": { "prompt_tokens": 8, "completion_tokens": 3, "total_tokens": 11 }
}

Authentication

Pass your key via the Authorization: Bearer ... header. Keys are scoped — create separate keys per environment (dev / staging / prod) from the console.

Chat completionsPOST/v1/chat/completions

Create a chat completion. Compatible with OpenAI's chat/completions — same parameters, same response shape.

Request body

Streaming example

stream = client.chat.completions.create(
  model="claude-4-sonnet",
  messages=[{"role": "user", "content": "Write a haiku."}],
  stream=True,
)
for chunk in stream:
  print(chunk.choices[0].delta.content or "", end="")

Errors & retries

CanalAPI uses conventional HTTP status codes. On 5xx upstream failures we auto-retry across healthy channels — you only see an error after the routing pool is exhausted.

SDKs

Official SDKs wrap retries, streaming, and error normalization. Under the hood they're thin wrappers over the HTTP API.