常见错误

常见错误 ### ​ invalid_request_error Schema 格式本身不合法（例如 json_schema.schema 不是 object）时，API 会返回 400，错误类型为 invalid_request_error： { "error": { "message": "Invalid request: the `response_format.json_schema.schema` field in the request (expected type dict[string,interface]) is illegal...", "type": "invalid_request_error" } } 请检查 schema 是否为合法的 JSON Schema 对象。 ### ​ 输出被截断（finish_reason="length"） 模型在输出完整 JSON 之前达到了 max_tokens 限制。建议： 增大 max_tokens（例如 4096 或更高） 简化 schema 的嵌套层级 缩短输入文本长度 ### ​ 字段类型不匹配 / 输出 Markdown 代码块 在 kimi-k2.6 等旧模型上，可能出现以下情况： 返回的 content 包含 Markdown 代码块（如 json ... ），导致 json.loads 失败。 oneOf / $ref 等复杂 schema 未被严格遵守。 建议： 使用 kimi-k2.7-code 进行 Structured Output 调用。 如果必须使用 kimi-k2.6，在业务层先 stripping Markdown 标记，再对解析结果做 schema 字段校验。 是否 工具调用最佳实践 自动断线重连 website