Hoàn thành Trò chuyện
Yêu cầu và phản hồi của POST /v1/chat/completions.
Hoàn thành Trò chuyện
Yêu cầu
POST https://apimaster.ai/v1/chat/completions
Headers
| Header | Bắt buộc | Ghi chú |
|---|---|---|
Authorization |
Có | Bearer YOUR_API_KEY |
Content-Type |
Có | application/json |
Body (các trường phổ biến)
| Trường | Kiểu | Ghi chú |
|---|---|---|
model |
chuỗi | ví dụ claude-sonnet-4-6 |
messages |
mảng | {role, content} |
max_tokens |
số | Số token hoàn thành tối đa |
temperature |
số | Tuỳ chọn |
stream |
boolean | Luồng SSE |
Ví dụ
curl -s "https://apimaster.ai/v1/chat/completions" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"messages": [
{"role": "system", "content": "Bạn là người hữu ích."},
{"role": "user", "content": "Nói xin chào bằng một từ."}
],
"max_tokens": 64
}'
Phản hồi không luồng
{
"id": "chatcmpl-...",
"object": "chat.completion",
"choices": [
{
"index": 0,
"message": { "role": "assistant", "content": "..." },
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 10,
"completion_tokens": 5,
"total_tokens": 15
}
}
Luồng
Với "stream": true, phần thân là text/event-stream; các dòng có dạng data: {json} cho đến khi gặp data: [DONE].
Mã trạng thái
| Mã | Ý nghĩa |
|---|---|
| 400 | Tham số không hợp lệ |
| 401 | Xác thực thất bại |
| 402 / 403 | Hạn mức hoặc quyền hạn |
| 429 | Bị giới hạn tần suất |
| 502 / 503 | Lỗi từ thượng nguồn — hãy thử lại |