统一处理 JSON、UTF-8、SSE 流、客户端超时、连接中断和幂等边界。
接口请求与响应使用 UTF-8。文本类接口以 JSON 表达；流式输出通常使用 Server-Sent Events。客户端必须区分连接建立、首字节、完整响应和业务写入四个阶段的超时与失败。
本文面向通过天工智算云 OpenAI 兼容接口接入模型能力的后端开发者、架构师和运维人员。完成本文后，你应当能够独立完成配置、验证结果，并知道出现异常时应该保留哪些信息。
云资源和模型能力会随区域、库存、模型版本及账号权限变化。页面显示的可用规格、价格、配额和状态是本次操作的直接依据；文档用于解释操作逻辑和风险边界。
先完成以下准备，再进入控制台操作。对生产环境而言，准备阶段还应明确资源负责人、费用归属、数据级别和回滚方式。
按照下面的顺序执行。每完成一步都应检查页面反馈，不要在状态仍为“处理中”时连续提交相同操作。涉及删除、重装、退款、密钥禁用等不可逆动作时，应再次核对资源名称和影响范围。
字段名、类型和嵌套结构应符合对应端点。不要发送未使用的大字段，也不要依赖服务端忽略未知参数。
在发送前估算上下文和媒体大小，限制单用户输入。超长内容先切分、检索或摘要。
等待完整 JSON 后再解析，校验状态、内容类型和必需字段。对空结果和非预期结束原因单独处理。
设置 stream: true 后按 SSE 事件逐块解析，处理 [DONE]、心跳、半个 UTF-8 字符、网络断开和用户取消。
分别设置连接、读取和总请求时限。视频等异步任务不应依赖一个无限长 HTTP 连接。
模型生成请求通常会产生费用且结果不确定。重试前判断是否已经收到或写入结果；对异步任务保存任务 ID，避免重复创建。
功能能够使用并不等于已经具备生产条件。正式承载业务前，请把可观测性、权限、费用和数据恢复纳入同一套运行基线。
建议为关键资源建立变更记录，至少包含操作者、时间、原因、预期结果、实际结果和回退步骤。团队协作时，不要通过聊天工具传递密码或完整 API Key。
排查时先确认影响对象、开始时间和最近一次变更，再区分是浏览器、账号权限、平台资源、网络还是应用自身问题。提交工单时，请附上资源 ID、请求 ID、发生时间、错误信息和已经执行过的排查步骤；不要提交密码、完整密钥或身份证件原图。
检查 Bearer 认证格式、密钥状态、所属环境与模型权限。不要在排障信息中提供完整密钥。
使用最小请求逐项检查模型名称、字段类型、消息结构、文件格式和上下文长度，不要盲目重试相同请求。
限制并发并受控退避。记录 Request ID；若流式响应已经产生部分内容，先判断业务写入是否可安全重放。
离开页面前，逐项确认：
如结果与本文不一致，应停止继续扩大变更范围，通过页面右上角“工单支持”提交问题。