Skip to Content
接入规范

接入规范

接入 API 时,请按照以下约束选择模型、处理响应并记录请求信息。

模型选择

实际可调用模型以 GET /v1/models 返回结果为准。切换模型时,只需替换请求中的 model 字段。

curl "https://api.example.com/v1/models" \ -H "Authorization: Bearer <YOUR_API_KEY>"

请求追踪

客户端应在每次请求后记录响应头中的 X-Oneapi-Request-Id。处理接口异常或提交问题反馈时,请提供对应的请求 ID。

错误处理

同时检查 HTTP 状态码和响应中的错误信息。参数或鉴权错误应修正请求后再重试;遇到 HTTP 429 或 5xx 时,使用有重试次数上限的指数退避。

超时与异步任务

根据任务耗时设置连接和读取超时。异步任务按对应模型页面建议的间隔轮询,避免高频查询或重复创建任务。

日志中不要记录完整 API Key 或其他敏感请求数据。

Last updated on