Đi tới nội dung
Tất cả tài liệu

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ườngBắt buộcTác dụng
modelCóMột model id lấy từ GET /v1/models, ví dụ deepseek-v4.1-flash-uncensored.
messagesCó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.
streamKhôngtrue để nhận server-sent events. Xem Truyền từng phần.
stream_optionsKhông{"include_usage": true} thêm một chunk cuối có số liệu sử dụng.
max_tokens, max_completion_tokensKhô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_effortKhôngMô hình suy nghĩ kỹ đến mức nào. Xem Suy nghĩ.
tools, tool_choice, parallel_tool_callsKhôngXem Gọi công cụ.
response_formatKhôngXem Đầu ra JSON.
temperature, top_p, top_k, min_pKhôngLấy mẫu. Xem Bộ lấy mẫu.
frequency_penalty, presence_penalty, repetition_penaltyKhôngKiểm soát sự lặp lại.
stop, seedKhôngChuỗi dừng, và một seed để phản hồi lặp lại được ổn định hơn.
prompt_cache_keyKhôngMộ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.
nKhôngPhải bằng 1.

Mô hình nào nhận trường nào

TrườngDeepSeekGLM
temperatureCóBị bỏ qua
top_pCóBị bỏ qua
stopCóBị bỏ qua
seedCóBị bỏ qua
frequency_penaltyCóBị bỏ qua
presence_penaltyCóBị bỏ qua
repetition_penaltyCóBị bỏ qua
min_pCóBị bỏ qua
top_kCóBị bỏ qua
toolsCóCó
tool_choiceCóCó
parallel_tool_callsCóBị bỏ qua
response_formatCóBị bỏ qua
reasoning_effortCóCó
prompt_cache_keyCó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

Response
{
  "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
  }
}
  • id và model do 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_content chứa phần suy nghĩ, khi có.
  • message.tool_calls chứa các lời gọi công cụ, với finish_reason là tool_calls.
  • usage.nokeep_credits là 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.