跳到正文
全部文档

参考

POST /v1/chat/completions

与 OpenAI 的 chat completions 兼容,地址为 https://nokeep.ai/v1/chat/completions。发送 bearer 密钥和 JSON 请求体,即可获得一条完整的聊天补全结果,或一串分块的流。

核对于 2026年10月27日

请求字段

字段必填作用
model是来自 GET /v1/models 的模型 id,例如 deepseek-v4.1-flash-uncensored。
messages是1 到 2,000 条消息。角色:system、developer、user、assistant、tool。内容可以是字符串,也可以是文本和 image_url 部分组成的列表。
stream否设为 true 则返回服务器发送事件(SSE)。见流式输出。
stream_options否{"include_usage": true} 会在最后一个分块中加入用量信息。
max_tokens、max_completion_tokens否最长回复长度(含思考内容),上限为模型自身的最长输出。不设置时,可用空间由你的上限和余额决定,最多 8,192。
reasoning_effort否模型思考的力度。见思考。
tools、tool_choice、parallel_tool_calls否见工具调用。
response_format否见JSON 输出。
temperature、top_p、top_k、min_p否采样参数。见采样。
frequency_penalty、presence_penalty、repetition_penalty否重复控制。
stop、seed否停止字符串,以及使回复更可复现的种子。
prompt_cache_key否任意字符串,同一段对话保持一致,这样它的调用会命中已缓存开头的服务器。见缓存输入。
n否必须为 1。

各模型支持哪些字段

字段DeepSeekGLM
temperature支持忽略
top_p支持忽略
stop支持忽略
seed支持忽略
frequency_penalty支持忽略
presence_penalty支持忽略
repetition_penalty支持忽略
min_p支持忽略
top_k支持忽略
tools支持支持
tool_choice支持支持
parallel_tool_calls支持忽略
response_format支持忽略
reasoning_effort支持支持
prompt_cache_key支持忽略

模型不支持的字段会被丢弃,并在 x-nokeep-ignored 响应头中列出。两个模型都不认识的字段同样会被丢弃。

回复

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 和 model 由我们生成,模型托管方的任何信息都不会透传。
  • 有思考内容时,message.reasoning_content 会保存其中的思考。
  • 有工具调用时,message.tool_calls 会保存工具调用,并且 finish_reason 为 tool_calls。
  • usage.nokeep_credits 是本次调用的费用,单位为积分(1,000 积分 = $1)。
  • usage.prompt_tokens_details.cached_tokens(如有)是模型从缓存中读取的提示词 token 数。这部分按缓存价格计费;见缓存输入。

请求上限

最多 12 MB、2,000 条消息,以及 10 张图片(仅限 DeepSeek)。超出上限的请求会被拒绝并返回错误代码;见错误。