Skip to main content
Chat Completions 是文本模型最常用的调用方式,适合聊天、问答、摘要、改写、分类、结构化输出和自动化任务。
示例模型使用 gpt-5.4。实际接入时,请以控制台可用模型和模型详情为准。
不要把 sk- 开头的 Key 写进前端代码、公开仓库、浏览器插件配置或第三方共享模板里。生产环境建议由服务端代理调用 Tapapi。

基本请求

请求字段

参数是否生效取决于具体模型和上游渠道。上线前不要只验证 200 状态码,还要验证返回质量、错误结构、用量字段和账单扣费是否符合预期。

messages 怎么写

最小可用请求只需要一条 user 消息。生产环境建议把稳定规则放到 system,把本次输入放到 user 文本消息最常见写法是:
部分多模态模型也接受数组形式的 content,例如 {"type": "text", "text": "Hello"}。文本 API 入门先使用字符串形式即可。

返回结构

非流式请求通常读取:
常见字段: 生产环境建议同时保存响应头里的 X-Oneapi-Request-Id。排查超时、扣费、上游失败和重试问题时,这个 ID 比单纯保存错误文案更有用。

解析建议

常见错误

错误响应通常包含 error.messageerror.typeerror.code。建议日志至少记录:HTTP 状态码、error.messageerror.typeerror.code、模型名、业务用户 ID、请求耗时和 X-Oneapi-Request-Id 更多处理方式见 错误码与重试