参考
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。 |
各模型支持哪些字段
| 字段 | DeepSeek | GLM |
|---|---|---|
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 响应头中列出。两个模型都不认识的字段同样会被丢弃。
回复
{
"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)。超出上限的请求会被拒绝并返回错误代码;见错误。