先区分两条生产链路
如果应用已经使用 OpenAI SDK，文本与多模态任务通常可以保留客户端调用方式，只替换 Base URL、API Key 和模型 ID。完整的基础配置可先阅读OpenAI 兼容 API 接入指南。
视频生成是另一条异步链路：提交任务、保存任务 ID、轮询或接收 Webhook，再把结果写回订单或内容管理系统。开始接入前应同时查看ApiHub 接入文档、实时模型目录和AI 视频 API 页面。
第一步：用最小请求验证鉴权和协议
先不要接入复杂 Agent 或批处理。用模型列表接口验证域名可达、Bearer Key 生效、返回格式符合客户端预期，再分别测试 Chat Completions 或 Responses 请求。
Base URL: https://video.gqaiapp.com/v1
API Key 只应保存在服务端环境变量或密钥管理器中。返回 401 时，优先检查 Key 是否缺失、过期或发送到了错误环境；需要流式输出时，还要确认当前模型和通道的能力，不能把一个供应商的协议规则直接套用到所有模型。
第二步：从实时目录选择模型
模型目录会随通道状态变化，业务记录中应保存实际模型 ID，而不只是展示名称。当前目录中的 GPT-5.6 系列包括 gpt-5.6、gpt-5.6-sol、gpt-5.6-terra 和 gpt-5.6-luna，其他模型应以实时 availability 与能力说明为准。
选型时可结合AI API 中转检查清单，不要写死“永远可用”、固定延迟、固定成本或未经验证的兼容性。
第三步：为 Seedance 视频任务设计状态机
视频任务应按“提交任务、保存 task_id、等待回调或轮询、校验状态、保存公网结果、通知客户”的顺序处理。超时或失败需要记录原因，再按明确规则重试或退款。
Webhook 处理器至少应做到：
参数准备和异步流程可继续阅读Seedance API 接入指南。需要批量制作电商内容时，还应先核对电商视频生产流程与风险。
上线前检查清单
视频素材准备可参考AI 视频提示词指南与文生视频入门教程。模型比较应读取当前能力说明，历史对比可参考Seedance 与 Veo 场景对比。
Sora 2 状态说明
本站已停止提供 Sora 2 服务。需要迁移的项目可阅读Sora 2 停止服务后的迁移指南，再根据实时目录选择 Seedance、Veo、Kling、海螺或 Wan。新项目不应把 Sora 2 写成当前可用型号。
常见问题
#
ApiHub 是否必须改写 OpenAI SDK？
通常不需要。可以保留 SDK 的请求结构，替换 Base URL、服务端 API Key 和模型 ID，但仍需按当前文档验证 Responses、流式输出和工具调用能力。
#
可以把 API Key 放在浏览器前端吗？
不建议。浏览器代码会暴露长期密钥，应由自己的服务端代理请求，并在服务端执行限流、日志和预算控制。
#
视频生成任务为什么适合使用 Webhook？
视频生成耗时不可预测。Webhook 可以在任务完成或失败时触发后续处理，减少长连接和高频轮询，但生产系统仍应保留补偿轮询。
#
如何确认模型当前仍然可用？
发布前读取实时模型目录，用真实模型 ID 发起最小请求，并保存当时的模型、通道和时间记录，不要只依据旧文章或缓存名称。