Chat and embeddings

​

POST /v1/chat/completions

​

Request body

{
  "model": "basics-chat-smart",
  "messages": [
    { "role": "system", "content": "You are a helpful assistant." },
    { "role": "user", "content": "Hello!" }
  ],
  "stream": true
}

​

Request fields

​

Response behavior

• Streaming: returns OpenAI-compatible SSE chunks
• Non-streaming: returns the provider JSON from /v1/chat/completions

​

Typical errors

• 404 with code: "model_not_found" when the alias is unknown or inactive
• 422 with code: "invalid_payload" for malformed JSON or invalid request structure

​

POST /v1/messages

​

Request body

{
  "model": "basics-chat-smart",
  "messages": [
    { "role": "user", "content": "Hello!" }
  ],
  "max_tokens": 512,
  "stream": true
}

​

Request fields

​

Notes

• Allowed roles are user, assistant, and system
• content can be a string or richer JSON content
• Internally, system messages are mapped to role: "user" to fit provider shape

​

POST /v1/embeddings

​

Request body

{
  "model": "basics-embed-small",
  "input": [
    "First text",
    "Second text"
  ]
}

​

Request fields

​

Response

{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [0.01, -0.02]
    }
  ],
  "model": "text-embedding-3-small",
  "usage": {
    "prompt_tokens": 12,
    "total_tokens": 12
  }
}

​

BYOK support

• Chat and messages support BYOK with openai, anthropic, or gemini
• Embeddings support BYOK with openai or gemini