Trang chủ / Tài liệu / API Chat Completions

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.

EndpointPOST https://aiprimetech.io/v1/chat/completions
URL cơ sở cho SDKhttps://aiprimetech.io/v1 — lưu ý phần /v1
Xác thựcAuthorization: Bearer sk-...

Nội dung yêu cầu

TrườngLoạiBắt buộcMô tả
modelchuỗicóBất kỳ ID nào từ /v1/models, bao gồm các ID Claude
messagesmảngcóHỗ trợ các vai trò system, user và assistant
max_tokenssố nguyênkhôngKhông bắt buộc ở đây, khác với Messages API
temperaturesốkhông0–2 theo quy ước của OpenAI
streamgiá trị booleankhôngtrue để nhận các phần dữ liệu SSE
toolsmảngkhôngCấ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ệmMessagesChat Completions
Lời nhắc hệ thốngcấp cao nhất systemmessages[0] với vai trò system
Văn bản trả lờicontent[0].textchoices[0].message.content
Lý do dừngstop_reasonfinish_reason
Token đầu vàousage.input_tokensusage.prompt_tokens
Token đầu rausage.output_tokensusage.completion_tokens
Phần thay đổi trong luồngcontent_block_deltachoices[0].delta.content