API Reference
Synthorai exposes a multi-protocol REST API over HTTPS. The same base URL, key, and billing serve three request shapes - OpenAI Chat Completions, OpenAI Responses, and Anthropic Messages - plus auxiliary endpoints for embeddings, images, audio, and reranking.
Base URL: https://synthorai.io/v1
All endpoints require:
Content-Type: application/json
Authorization: Bearer <your-api-key>
(or x-api-key: <your-api-key> for /v1/messages) Endpoints
| Endpoint | Type | Description |
|---|---|---|
POST /v1/chat/completions | chat | OpenAI Chat Completions - universal entry point, routes to any provider. |
POST /v1/responses | chat | OpenAI Responses - tool use, reasoning, structured output. |
POST /v1/messages | chat | Anthropic Messages - Claude / Bedrock-Anthropic native. |
POST /v1/embeddings | embedding | Generate vector embeddings. |
POST /v1/images/generations | image | Generate images from text prompts. |
POST /v1/videos | video | Create and poll asynchronous video generation jobs. |
POST /v1/audio/transcriptions | audio | Transcribe audio to text. |
POST /v1/audio/speech | audio | Convert text to speech. |
GET /v1/models | read | List all models available to the authenticated key. |
/api/v1/keys | keys | Create, list, change, rotate and delete inference keys from your own code (requires an admin key with keys.read or keys.write). |
GET /api/v1/requests | logs | List and read the workspace’s requests: model, key, tokens, cost, timing and labels, never the prompt or the answer (requires an admin key with logs.read). |
/api/v1/prompts | prompts | Read and change the prompt library from your own code: prompts, versions, labels and rollouts, plus test sets and eval runs (requires an admin key with prompts.read or prompts.write; evals.read or evals.write for the tests). |
GET /api/v1/audit-logs | workspace | Read how the workspace is set up and what was changed in it: the audit log, members and invitations, BYOK settings and export destinations, each with its own read scope. Credentials are never returned. |
GET /api/v1/billing/* | billing | Read-only usage, cost, and freshness data for your own workspace (requires a billing key, not a regular API key). |
POST /v1/mcp | mcp | MCP server: every model, API key management and billing data as tools for AI agents (Claude Code, Cursor, Codex …), with your API key. |
Every endpoint bills against the same per-token catalog - see the model price comparison for what each routable model costs.