接入规范
接入 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