Tham chiếu
POST /v1/chat/completions
Chat completions kiểu OpenAI, tại https://nokeep.ai/v1/chat/completions. Gửi một khóa bearer và một body JSON; nhận lại một chat completion, hoặc một luồng các chunk.
Đã kiểm tra 27 tháng 10, 2026
Các trường yêu cầu
| Trường | Bắt buộc | Tác dụng |
|---|---|---|
model | Có | Một model id lấy từ GET /v1/models, ví dụ deepseek-v4.1-flash-uncensored. |
messages | Có | Từ 1 đến 2.000 tin nhắn. Vai trò: system, developer, user, assistant, tool. Nội dung là một chuỗi, hoặc danh sách các phần văn bản và image_url. |
stream | Không | true để nhận server-sent events. Xem Truyền từng phần. |
stream_options | Không | {"include_usage": true} thêm một chunk cuối có số liệu sử dụng. |
max_tokens, max_completion_tokens | Không | Độ dài phản hồi tối đa, kể cả phần suy nghĩ, tới mức tối đa của chính mô hình. Không đặt: phần còn lại mà giới hạn và số dư của bạn chi trả, tối đa 8.192. |
reasoning_effort | Không | Mô hình suy nghĩ kỹ đến mức nào. Xem Suy nghĩ. |
tools, tool_choice, parallel_tool_calls | Không | Xem Gọi công cụ. |
response_format | Không | Xem Đầu ra JSON. |
temperature, top_p, top_k, min_p | Không | Lấy mẫu. Xem Bộ lấy mẫu. |
frequency_penalty, presence_penalty, repetition_penalty | Không | Kiểm soát sự lặp lại. |
stop, seed | Không | Chuỗi dừng, và một seed để phản hồi lặp lại được ổn định hơn. |
prompt_cache_key | Không | Một chuỗi bất kỳ, giữ nguyên cho một cuộc hội thoại, để các lần gọi của nó đến được máy chủ đã cache phần đầu. Xem Input đã cache. |
n | Không | Phải bằng 1. |
Mô hình nào nhận trường nào
| Trường | DeepSeek | GLM |
|---|---|---|
temperature | Có | Bị bỏ qua |
top_p | Có | Bị bỏ qua |
stop | Có | Bị bỏ qua |
seed | Có | Bị bỏ qua |
frequency_penalty | Có | Bị bỏ qua |
presence_penalty | Có | Bị bỏ qua |
repetition_penalty | Có | Bị bỏ qua |
min_p | Có | Bị bỏ qua |
top_k | Có | Bị bỏ qua |
tools | Có | Có |
tool_choice | Có | Có |
parallel_tool_calls | Có | Bị bỏ qua |
response_format | Có | Bị bỏ qua |
reasoning_effort | Có | Có |
prompt_cache_key | Có | Bị bỏ qua |
Trường mà mô hình không nhận sẽ bị bỏ và được nêu tên trong header x-nokeep-ignored. Trường mà cả hai mô hình đều không biết cũng bị bỏ theo cách tương tự.
Phản hồi
{
"id": "chatcmpl-…",
"object": "chat.completion",
"created": 1792972800,
"model": "deepseek-v4.1-flash-uncensored",
"choices": [{
"index": 0,
"message": { "role": "assistant", "content": "…" },
"finish_reason": "stop"
}],
"usage": {
"prompt_tokens": 412,
"completion_tokens": 286,
"total_tokens": 698,
"nokeep_credits": 1
}
}idvàmodeldo chúng tôi cấp. Không có gì từ máy chủ của mô hình được chuyển tiếp.message.reasoning_contentchứa phần suy nghĩ, khi có.message.tool_callschứa các lời gọi công cụ, vớifinish_reasonlàtool_calls.usage.nokeep_creditslà chi phí của lần gọi, tính bằng tín dụng (1.000 tín dụng là $1).usage.prompt_tokens_details.cached_tokens, khi có, là số prompt token mô hình đọc từ cache. Chúng được tính theo giá đã cache; xem Input đã cache.
Giới hạn của một yêu cầu
Tối đa 12 MB, 2.000 tin nhắn và 10 hình ảnh (chỉ DeepSeek). Yêu cầu vượt quá sẽ bị từ chối kèm mã; xem Lỗi.