DeepSeek V4.1 Flash API 怎么接?型号名怎么填、报 400 怎么排查(Python / curl)
DeepSeek V4.1 Flash API 怎么接、model 填什么、报 400 怎么办?cocodot 上 model 填 deepseek-v4.1-flash(也认 deepseek、deepseek-chat),其它 DeepSeek 版本返回 400、不扣费、不换型号。附接入代码和程序外核对步骤。
1. 三项配置,改一行就能调
接入只涉及三项。base_url:https://cocodot.co/api/ai/v1,末尾的 /v1 不能漏。api_key:在 cocodot 控制台建的 key,放进环境变量,不要写进代码或提交到仓库。model:deepseek-v4.1-flash。接口按 OpenAI 的 chat.completions 格式,所以已经在用 OpenAI SDK 的项目,只改这三项就能跑;同一个 key 和余额还能调 Claude、GPT、Gemini、Qwen、GLM 等在售型号,换型号只改 model。第一次接入时,先发一条只有一句话的最小请求,确认能返回内容,再接入真实业务。
import os
from openai import OpenAI
client = OpenAI(
base_url="https://cocodot.co/api/ai/v1",
api_key=os.environ["COCODOT_KEY"],
)
resp = client.chat.completions.create(
model="deepseek-v4.1-flash", # 也认 "deepseek"、"deepseek-chat"
messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(resp.model, resp.usage)
print(resp.choices[0].message.content)2. 型号名只认三个,其它一律 400
DeepSeek 系列在 cocodot 目前只开放 V4.1 Flash,型号名只认 deepseek-v4.1-flash、deepseek、deepseek-chat 三种;大小写、空格、点和下划线的差别会被统一处理,前面带厂商前缀(比如 deepseek/deepseek-v4.1-flash)也能认。除此之外的 DeepSeek 名字,包括 deepseek-reasoner、deepseek-coder、deepseek-v3、deepseek-r1、deepseek-flash、deepseek-v4-pro,以及在 V4.1 Flash 后面加日期、preview、thinking 的写法,都会返回 400,不扣费,也不会被换成别的型号。这样设计的好处是:你写错了会立刻看到报错,而不是悄悄换了个型号继续跑、账单和效果都对不上。生产配置里只写 deepseek-v4.1-flash,别依赖别名。
3. 报 400 时按这个顺序核对
第一步,读错误原文:400 是「请求本身有问题」的统称,可能是型号名,也可能是参数格式,原文里通常会指出是哪一项;在 cocodot 点名不提供的型号时,错误信息会提示暂不支持该型号。第二步,打印程序实际发出的 model:很多框架和客户端会给型号名自动加前缀,或者在你没填时用它自己的默认值,你以为发的是 deepseek-v4.1-flash,实际发出去的可能是别的。第三步,在程序外发一条最小请求:用下面的 curl,同一个 key、同一个 base_url、同一个 model;curl 能通而程序报错,先拿程序的配置和参数和 curl 那条请求逐项对比;curl 也报同样的错,把错误原文和请求时间一起发给客服。第四步,拉一次模型列表,确认你要的型号在不在里面。更多型号类报错见 /hub/api-model-not-found-fix,key 类报错见 /hub/api-401-invalid-api-key-fix。
# 最小请求(把 key 换成你自己的)
curl -s https://cocodot.co/api/ai/v1/chat/completions \
-H "Authorization: Bearer $COCODOT_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-v4.1-flash","messages":[{"role":"user","content":"hi"}]}'
# 当前在售型号(公开接口)
curl -s https://cocodot.co/api/ai/v1/models | grep -o '"id":"deepseek[^"]*"'4. 从 DeepSeek 官方平台迁过来,要改哪几处
如果你的代码原来直连 DeepSeek 官方平台,迁移时要改三处:base_url 换成 https://cocodot.co/api/ai/v1;key 换成 cocodot 的 key(两家的 key 不通用);model 换成 deepseek-v4.1-flash。最容易出错的是第三处:官方平台当前用什么型号名、旧名字现在对应哪个版本,以 DeepSeek 官方文档当前说明为准,而这些名字不一定是 cocodot 认的那三个。所以别把官方文档或别的网关里的型号名直接复制过来,先对照第 2 节。迁移时还要把代码里依赖的官方专有参数列出来,逐个用最小请求测一遍;测不通的参数,先从请求里去掉,确认基础调用正常后再一个个加回来,这样能分清是哪一个参数引起的 400。
5. 在各种工具里配置时的注意点
在聊天客户端、工作流平台或编辑器插件里接入时,一般找「自定义 OpenAI 兼容服务」或「自定义 base URL」这类设置项,把第 1 节的三项填进去;具体菜单名称以各工具自己的文档为准。三个常见的坑:一是路径重复或缺失,有的工具会自己在地址后面拼 /v1 或 /chat/completions,你再填一遍就会变成重复路径,反过来有的工具要求你填到 /v1 为止,按工具说明二选一;二是型号下拉框里没有,有的工具只列它预置的型号,要找「手动输入型号」的入口填 deepseek-v4.1-flash;三是工具里还存着旧配置,改完要确认保存的是新值,必要时删掉旧的服务商配置重新加。工具报错时,同样先用第 3 节的 curl 在工具外核对。
6. 上线前逐项测你要用的功能
接口格式兼容,只说明请求和返回的结构对得上,不说明你要的每个功能在这个型号上都表现一致。上线前按实际用到的功能逐项测,一次只测一项:流式输出能不能正常拼接成完整回答;要求返回 JSON 时能不能稳定解析;用到工具调用的,检查工具名和参数是否符合你定义的格式;多轮对话里历史消息能否原样带上;你业务里最长的那类输入能不能处理,超出上限时怎么报错,处理方法见 /hub/context-length-exceeded-fix。每一项都用你自己的真实样本,不要只用一句「你好」判断能不能上线。批量跑测试时并发别开太高,触发限流的处理见 /hub/api-429-rate-limit-concurrency-china。
7. 计费、对账与充值
按实际 token 用量计费,单价逐型号以价格页实时标价为准。返回 400 的请求不扣费,所以型号名写错不会产生费用,但会让你的任务失败,上线前务必跑一遍第 3 节的核对。每次调用的返回里都有 usage 字段,记录输入和输出 token 数;把它和你自己的任务编号一起写进日志,月底按任务汇总,就能算出每类任务实际花了多少,也方便和控制台对账。充值方式是支付宝 / 微信支付(人民币)、USDT / USDC;建议先小额充值,把第 6 节的功能测完再加大用量。验证邮箱送的体验额度只能调部分低价型号,哪些型号能用以控制台显示为准。
8. 和其它型号搭配,以及版本变化时
同一个 key 下,DeepSeek V4.1 Flash 可以和 Claude、GPT、GLM、Qwen 等在售型号搭配使用:例如批量的抽取、分类先用 deepseek-v4.1-flash,没通过你的验收标准的再交给另一个经过测试的型号。怎么分档、什么时候升级、怎么按合格产出算账,见 /hub/deepseek-claude-mixed-api;想在 DeepSeek 和 GLM 之间比较,方法见 /hub/deepseek-v4-pro-vs-glm-52。版本变化时记住两点:cocodot 开放新的 DeepSeek 版本后,以模型列表接口和价格页为准,你需要自己改配置里的 model 才会用上新版本;在此之前,点名还没开放的版本会返回 400,不会被自动升级或降级。把型号名放进配置文件、而不是写死在代码里,版本变化时只改一处。
在 cocodot 上,model 字段的几种填法会怎样处理
| 你填的 model | 处理方式 | 说明 |
|---|---|---|
| deepseek-v4.1-flash | 调用 DeepSeek V4.1 Flash | 推荐写法,写进配置文件 |
| deepseek、deepseek-chat | 同样按 V4.1 Flash 处理 | 方便旧代码少改一处 |
| 大小写、空格或分隔符不同(如 DeepSeek V4.1 Flash) | 同样按 V4.1 Flash 处理 | 仍建议统一成推荐写法 |
| deepseek-reasoner、deepseek-coder、deepseek-v3、deepseek-r1 | 返回 400,不扣费 | 这些在 cocodot 不提供 |
| deepseek-flash、deepseek-v4-pro、deepseek-v4.1 | 返回 400,不扣费 | 不会被换成 V4.1 Flash 或别家型号 |
| 带日期、preview、thinking 后缀或更高版本号 | 返回 400,不扣费 | 开放新版本后以模型列表为准 |