Codeium接口调用示例提示词总是字段漏掉怎么改

Codeium接口调用失败，十有八九是请求体字段缺失或者格式不对。这个问题看起来简单，但坑不少，尤其是当你用不同SDK或者抄了不同版本的示例代码时，更容易踩进去。

调用失败时，要么请求直接被拒，要么返回一个空结果，问题的源头往往就卡在请求体的结构上——没有严格按照最新文档要求的必填字段来组织，尤其是容易漏掉messages数组的嵌套层级、把model值拼错，或者忽略了像temperature这种看似可选、实则在某些端点里强制校验的字段。

别急，下面这几个排查方向，基本能帮你定位到问题所在。

检查请求体最外层必填字段

先翻翻Codeium最新的API文档，确认一下你调用的端点究竟要什么。v1/chat/completions这个端点，必须用messages数组，而v1/completions才接受prompt字符串。混用？400错误直接甩你脸上，而且还不告诉你具体缺了哪一项。

最省事的办法：用curl测试时，直接复制文档里最简的成功示例JSON结构，然后逐字段比对。确保model的值写对了，是"codium/llm"——注意那个斜杠和大小写。再确认messages是数组形式，并且里面至少有一个{"role":"user","content":"..."}这样的对象。

顺便提一句，如果漏掉model字段，API会直接返回{"error":"model is required"}，这个倒好排查。反倒是部分SDK会悄悄给你补一个默认值，反而把问题藏起来了。

验证messages数组内部结构

第一个容易踩的坑：角色字段必须小写，而且只能是"user"、"assistant"、"system"这三个。你写成"User"或者"USER"？API会直接忽略掉这条消息，看起来就好像“字段漏了”。

第二个坑：每条message对象里，role和content缺一不可。只要少任何一个，整条对象都会被丢弃。比如你写了{"role":"user"}但没有content，那这条消息在请求里就等于不存在。

特别强调一下：content不能是空字符串，连空格都不行。如果真的没内容，要么删掉这条message，要么填点有效文本进去。

排查SDK自动注入干扰

很多问题其实出在SDK这层。怎么排查？

第一步，把封装库都关掉，直接用Postman或者curl直连API，发一个最小可行的JSON：
{"model":"codium/llm","messages":[{"role":"user","content":"Hello"}]}

如果这个请求成功了，那问题基本就锁定在SDK层了。这时候要检查SDK初始化时是不是设了全局默认参数，比如自动给你加了个temperature: 0.5，但这个参数和你手动构造的body没同步，导致字段冲突。

如果还不行，不妨翻翻SDK的源码，搜索required这个关键词，看看它的校验逻辑。有些SDK会强制补全字段，但补出来的值偏偏不符合Codeium服务端的校验规则，这时候你就得手动调整了。