功能介绍
callback_url是可选的上游通知地址，供业务服务接收任务状态更新。轮询始终是本指南的主要获取方式，回调可以用于辅助提醒。
字段放在哪里
统一视频/Responses用 metadata.callback_url、metadata.external_task_id；可灵原生请求用顶层 callback_url、external_task_id。两者都是字符串，回调地址应为可公网访问的HTTPS地址；external_task_id使用业务侧唯一关联号。
这些字段用于接收模型服务发出的通知，并非本站另行签名的回调。回调 ID 可能与本站任务 ID 不同，重试行为以对应的回调规范为准。不要把 API Key 放进 callback_url。
三种 ID 分别是什么
| 标识 | 来源 | 本站用途 |
|---|---|---|
| 任务 ID | 统一返回id，或原生data.task_id | 查询本站任务、下载产物 |
| response ID | Responses创建返回id | GET /v1/responses/{response_id} |
| external_task_id | 业务方自行设置 | 关联请求记录，不替代本站查询ID |
原生创建和查询响应中的 data.task_id 是本站公共任务 ID。直接来自厂商的回调可能仍使用上游ID，不能把它当成本站ID。保存业务关联号与本站返回ID的映射；通过external_task_id等信息匹配业务记录，随后用已保存本站ID查询确认最终状态。
接收回调时
依据所接上游的官方回调规范验证来源、及时确认接收并幂等处理，同一通知可能重复或乱序。不要仅凭一个未经校验的回调推进订单。官方当前新旧API并存，回调字段也可能不同；请识别本页使用的旧版 task_id/task_status 结构。
可灵官方回调说明。该链接说明官方行为，不表示本站额外提供同名回调管理接口。