示例模型使用
gpt-5.4。实际接入时,请以控制台可用模型和模型详情为准。基本请求
请求字段
参数是否生效取决于具体模型和上游渠道。上线前不要只验证 200 状态码,还要验证返回质量、错误结构、用量字段和账单扣费是否符合预期。
messages 怎么写
最小可用请求只需要一条
user 消息。生产环境建议把稳定规则放到 system,把本次输入放到 user。
文本消息最常见写法是:
{"type": "text", "text": "Hello"}。文本 API 入门先使用字符串形式即可。
返回结构
非流式请求通常读取:
生产环境建议同时保存响应头里的
X-Oneapi-Request-Id。排查超时、扣费、上游失败和重试问题时,这个 ID 比单纯保存错误文案更有用。
解析建议
常见错误
错误响应通常包含
error.message、error.type 或 error.code。建议日志至少记录:HTTP 状态码、error.message、error.type、error.code、模型名、业务用户 ID、请求耗时和 X-Oneapi-Request-Id。
更多处理方式见 错误码与重试。