Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Open Dashboard — Create API keys, manage your account, and monitor usage.
Reference for the LLM.kiwi REST API: authentication, chat completion endpoints, request and response fields, headers, and HTTP status codes.
https://api.llm.kiwi/v1
/v1.
Authorization: Bearer sk_kiwi_...
GET /v1/models
curl "https://api.llm.kiwi/v1/models" \
-H "Authorization: Bearer $LLM_KIWI_API_KEY"
{
"object": "list",
"data": [
{ "id": "auto", "object": "model", "owned_by": "llm-kiwi" },
{ "id": "hrllm", "object": "model", "owned_by": "llm-kiwi" }
]
}
POST /v1/chat/completions
| Header | Required | Value |
|---|---|---|
Authorization | Yes | Bearer YOUR_API_KEY |
Content-Type | Yes | application/json |
| Field | Type | Required | Description |
|---|---|---|---|
model | string | Yes | Model ID such as auto or hrllm |
messages | array | Yes | Ordered conversation messages |
temperature | number | No | Sampling variability; support and defaults can depend on the routed model |
max_tokens | integer | No | Maximum number of output tokens |
stream | boolean | No | When true, returns incremental events instead of one complete response |
| Field | Type | Required | Description |
|---|---|---|---|
role | string | Yes | system, user, or assistant |
content | string | Yes | Text content of the message |
curl "https://api.llm.kiwi/v1/chat/completions" \
-H "Authorization: Bearer $LLM_KIWI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "auto",
"messages": [
{"role": "user", "content": "Hello!"}
]
}'
{
"id": "chatcmpl-abc123",
"object": "chat.completion",
"created": 1700000000,
"model": "auto",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Hello! How can I help?"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 10,
"completion_tokens": 8,
"total_tokens": 18
}
}
| Field | Description |
|---|---|
id | Identifier for the completion |
model | Model value reported for the request |
choices | Generated completion choices |
choices[0].message.content | Assistant response text |
choices[0].finish_reason | Why generation stopped; commonly stop or length |
usage | Token counts when provided |
stream to true to receive incremental server-sent events:
{
"model": "auto",
"messages": [{"role": "user", "content": "Write a short story."}],
"stream": true
}
| Status | Meaning | Application behavior |
|---|---|---|
200 | Success | Read the response |
400 | Invalid request | Fix request fields; do not retry unchanged |
401 | Missing or invalid authentication | Check or replace the API key |
403 | Request is not allowed | Check account or key access |
404 | Endpoint or model not found | Check the URL and model ID |
429 | Rate limit reached | Wait and retry with backoff |
500 | Server error | Retry a limited number of times |
503 | Service temporarily unavailable | Retry a limited number of times |
{
"error": {
"message": "Invalid API key",
"type": "invalid_request_error",
"code": "invalid_api_key"
}
}