Chat Completions - Kyma API

curl https://kymaapi.com/v1/chat/completions \
  -H "Authorization: Bearer ky-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "llama-3.3-70b",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }'

from openai import OpenAI
client = OpenAI(base_url="https://kymaapi.com/v1", api_key="ky-your-api-key")
response = client.chat.completions.create(
    model="llama-3.3-70b",
    messages=[{"role": "user", "content": "Hello!"}]
)

POST

chat

completions

curl https://kymaapi.com/v1/chat/completions \
  -H "Authorization: Bearer ky-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "llama-3.3-70b",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }'

from openai import OpenAI
client = OpenAI(base_url="https://kymaapi.com/v1", api_key="ky-your-api-key")
response = client.chat.completions.create(
    model="llama-3.3-70b",
    messages=[{"role": "user", "content": "Hello!"}]
)

Request body

string

required

Model ID to use. See available models.

array

required

Array of message objects with role and content.

role: "system", "user", or "assistant"
content: The message text

number

default:"1"

Sampling temperature (0-2). Lower = more focused, higher = more creative.

number

Maximum tokens to generate in the response.

boolean

default:"false"

Stream response tokens as server-sent events.

number

default:"1"

Nucleus sampling parameter (0-1).

Response

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1700000000,
  "model": "qwen-3.6-plus",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! How can I help you today?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 20,
    "completion_tokens": 10,
    "total_tokens": 30
  }
}

Status codes

Code	Means	What to do
`400`	Your request is malformed	Fix it — retrying will not help
`401`	Your API key is missing or invalid	Check the `Authorization` header
`402`	Your Kyma balance is exhausted	Top up
`429`	You hit your tier’s rate limit	Back off; `Retry-After` tells you how long
`503`	Every route for that model is temporarily unavailable	Retry — `Retry-After: 5`

402 means one thing only: your account is out of credit. It is never used to report a problem on our side. When all routes for a model are exhausted, you get 503 with Retry-After and:

{
  "error": {
    "message": "All providers for this model are temporarily unavailable. Please retry shortly.",
    "type": "upstream_error",
    "code": "provider_unavailable"
  }
}

Retry the same request, or send it to another model — the catalog is at GET /v1/models.

curl https://kymaapi.com/v1/chat/completions \
  -H "Authorization: Bearer ky-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "llama-3.3-70b",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }'

from openai import OpenAI
client = OpenAI(base_url="https://kymaapi.com/v1", api_key="ky-your-api-key")
response = client.chat.completions.create(
    model="llama-3.3-70b",
    messages=[{"role": "user", "content": "Hello!"}]
)

​Request body

​Response

​Status codes

Request body

Response

Status codes