API Chat Completions
POST /v1/chat/completions — endpoint theo định dạng OpenAI, dành cho Cursor, LangChain, LiteLLM và các SDK OpenAI.
Giao diện tương thích OpenAI. Cùng mô hình, cùng mức giá, khác cấu trúc bao bọc dữ liệu.
Endpoint
POST https://aiprimetech.io/v1/chat/completionsURL cơ sở cho SDK
https://aiprimetech.io/v1 — lưu ý phần /v1Xác thực
Authorization: Bearer sk-...Nội dung yêu cầu
| Trường | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
model | chuỗi | có | Bất kỳ ID nào từ /v1/models, bao gồm các ID Claude |
messages | mảng | có | Hỗ trợ các vai trò system, user và assistant |
max_tokens | số nguyên | không | Không bắt buộc ở đây, khác với Messages API |
temperature | số | không | 0–2 theo quy ước của OpenAI |
stream | giá trị boolean | không | true để nhận các phần dữ liệu SSE |
tools | mảng | không | Cấu trúc gọi hàm của OpenAI |
Khác với Messages,
system là một vai trò ở đây — hãy đặt nó làm phần tử đầu tiên của messages. Không gửi trường cấp cao nhất system đến endpoint này.Ví dụ
curl https://aiprimetech.io/v1/chat/completions \
-H "Authorization: Bearer $CLAUDEAPIKEY" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"messages": [{"role": "user", "content": "Hello"}]
}'
Phản hồi
{
"id": "chatcmpl-...",
"object": "chat.completion",
"model": "claude-sonnet-4-6",
"choices": [{
"index": 0,
"message": {"role": "assistant", "content": "..."},
"finish_reason": "stop"
}],
"usage": {"prompt_tokens": 9, "completion_tokens": 12, "total_tokens": 21}
}
Sử dụng SDK OpenAI
from openai import OpenAI
client = OpenAI(
api_key=class="s">"sk-your-key",
base_url=class="s">"https://aiprimetech.io/v1", class=class="s">"c"># the /v1 matters
)
resp = client.chat.completions.create(
model=class="s">"claude-sonnet-4-6",
messages=[{class="s">"role": class="s">"user", class="s">"content": class="s">"Hello"}],
)
print(resp.choices[0].message.content)
Ánh xạ trường giữa hai định dạng
| Khái niệm | Messages | Chat Completions |
|---|---|---|
| Lời nhắc hệ thống | cấp cao nhất system | messages[0] với vai trò system |
| Văn bản trả lời | content[0].text | choices[0].message.content |
| Lý do dừng | stop_reason | finish_reason |
| Token đầu vào | usage.input_tokens | usage.prompt_tokens |
| Token đầu ra | usage.output_tokens | usage.completion_tokens |
| Phần thay đổi trong luồng | content_block_delta | choices[0].delta.content |