API Guide
Complete API reference for TeleAI Gateway. Based on Pilot API Guide (V36).
Overview
| Base Path | Auth | Purpose |
|---|---|---|
/v1/chat/completions | API Key | Chat completion |
/v1/embeddings | API Key | Text embeddings |
/v1/images/generations | API Key | Image generation |
/v1/governance/* | JWT | Usage, costs, keys |
Chat Completions
OpenAI-compatible endpoint. Supports streaming via stream: true.
bash
POST /v1/chat/completions
Authorization: Bearer teleai_...
{
"model": "gpt-4o",
"messages": [{"role": "user", "content": "Hello"}],
"max_tokens": 256,
"temperature": 0.7
}Embeddings
bash
POST /v1/embeddings
Authorization: Bearer teleai_...
{
"model": "text-embedding-3-small",
"input": "The quick brown fox"
}Error Codes
| Status | Meaning |
|---|---|
| 401 | Invalid or missing API key / JWT |
| 403 | Insufficient permissions |
| 429 | Rate limit or quota exceeded |
| 502 | Upstream provider error |