错误码与常见问题

通用错误响应

接口失败时通常返回 JSON：

{
  "error": {
    "message": "请求参数不合法",
    "type": "invalid_request_error",
    "code": "invalid_request"
  }
}

实际错误字段可能随接口和上游渠道不同而变化，请同时记录 HTTP 状态码、错误消息和请求 ID。

创建 Interaction 时，model 与 agent 必须且只能填写一个。

input 是必填字段，既可以是字符串，也可以是输入内容数组，不能传 null 或空值。

使用 agent 创建任务时不要传 generation_config。模型请求才可以使用 generation_config。

使用 model 创建任务时不要传 agent_config。只有 Agent 请求可以使用它。

后台 Interaction 在用量尚未完成结算时不能直接删除。请先取消任务，再查询一次最终状态，确认结算完成后再删除。

确认请求地址使用了正确的 API 服务域名。

确认请求头包含 Authorization: Bearer ...。

调用 /v1/models 确认 Token 可以访问目标模型。

检查请求体中的模型名、必填字段和 JSON 类型。

保存 HTTP 状态码、错误响应和请求 ID，再进行重试或联系管理员。