Kawe Chat API

เริ่มต้นใช้งานQuick Start

Authentication

ใช้ API Key ใน header ทุก request:Include API Key in every request header:

Authorization: Bearer kw-YOUR_API_KEY

cURL

curl https://api.kaweai.com/v1/chat/completions \
  -H "Authorization: Bearer kw-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto-model",
    "messages": [{"role": "user", "content": "สวัสดี"}]
  }'

Chat Completions

POST /v1/chat/completions

Request Body

Message Format

{
  "messages": [
    {"role": "system", "content": "You are a helpful assistant."},
    {"role": "user", "content": "สวัสดี"},
    {"role": "assistant", "content": "สวัสดีครับ!"},
    {"role": "user", "content": "ช่วยอธิบาย REST API ให้หน่อย"}
  ]
}

Roles: system, user, assistant, tool

Response

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "auto-model",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "REST API คือ..."},
    "finish_reason": "stop"
  }],
  "usage": {"prompt_tokens": 25, "completion_tokens": 150, "total_tokens": 175}
}

Response Headers

Streaming

ส่ง "stream": true เพื่อรับ response ทีละส่วน (Server-Sent Events):Send "stream": true to receive response chunks (SSE):

curl https://api.kaweai.com/v1/chat/completions \
  -H "Authorization: Bearer kw-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "auto-model", "messages": [{"role": "user", "content": "สวัสดี"}], "stream": true}'

Response Stream

data: {"id":"chatcmpl-abc","choices":[{"delta":{"role":"assistant"},"index":0}]}

data: {"id":"chatcmpl-abc","choices":[{"delta":{"content":"สวัสดี"},"index":0}]}

data: {"id":"chatcmpl-abc","choices":[{"delta":{"content":"ครับ"},"index":0}]}

data: [DONE]

Function Calling

ส่ง tools definitionSend tools definition

{
  "model": "auto-model",
  "messages": [{"role": "user", "content": "อากาศวันนี้ที่กรุงเทพ"}],
  "tools": [{
    "type": "function",
    "function": {
      "name": "get_weather",
      "description": "Get current weather for a location",
      "parameters": {
        "type": "object",
        "properties": {
          "location": {"type": "string", "description": "City name"}
        },
        "required": ["location"]
      }
    }
  }]
}

Model ตอบกลับ tool_callsModel responds with tool_calls

{
  "choices": [{
    "message": {
      "role": "assistant",
      "tool_calls": [{
        "id": "call_abc",
        "type": "function",
        "function": {"name": "get_weather", "arguments": "{\"location\": \"Bangkok\"}"}
      }]
    },
    "finish_reason": "tool_calls"
  }]
}

ส่งผลลัพธ์กลับSend result back

{
  "model": "auto-model",
  "messages": [
    {"role": "user", "content": "อากาศวันนี้ที่กรุงเทพ"},
    {"role": "assistant", "tool_calls": [{"id": "call_abc", ...}]},
    {"role": "tool", "tool_call_id": "call_abc", "content": "{\"temp\": 32, \"condition\": \"sunny\"}"}
  ]
}

Models

GET /v1/models — ดูรายชื่อ model ทั้งหมดที่แผนคุณใช้ได้List all models available to your plan

Model แนะนำRecommended Models

OpenAI SDK Compatibility

API เป็น OpenAI-compatible — ใช้ SDK ได้เลยโดยเปลี่ยน base_url:API is OpenAI-compatible — use any SDK by changing base_url:

Python

from openai import OpenAI

client = OpenAI(
    api_key="kw-YOUR_API_KEY",
    base_url="https://api.kaweai.com/v1"
)

response = client.chat.completions.create(
    model="auto-model",
    messages=[{"role": "user", "content": "สวัสดี"}]
)
print(response.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "kw-YOUR_API_KEY",
  baseURL: "https://api.kaweai.com/v1"
});

const response = await client.chat.completions.create({
  model: "auto-model",
  messages: [{ role: "user", content: "สวัสดี" }]
});
console.log(response.choices[0].message.content);

Error Handling

{
  "error": {
    "type": "error_type",
    "message": "คำอธิบาย"
  }
}

Retry Strategy

• 423 — บัญชีถูกล็อค รอ 30 นาที (header Retry-After ระบุวินาทีที่ต้องรอ)Account locked, wait 30 min (Retry-After header indicates seconds)
• 428 — เพิ่ม tools parameter แล้วลองใหม่Add tools parameter and retry
• 429 — รอสักครู่แล้วลองใหม่ (exponential backoff แนะนำ)Wait and retry (exponential backoff recommended)
• 502 — ลองใหม่ได้ทันที (ระบบจะ failover อัตโนมัติ)Retry immediately (auto-failover)
• 402 — เติม creditsTop up credits

Rate Limits

Credits

• Credits ถูกหักตาม token usage จริง (input + output)Credits deducted based on actual token usage
• ดูยอดคงเหลือ:Check balance: GET /v1/me/credits
• ดู usage วันนี้/เดือนนี้:Today/month usage: GET /v1/me/usage/current