智信Token平台
  1. 视频(Videos)
  • 欢迎使用
  • Codex 配置
  • Claude Code 配置
  • 本地错误码说明
  • 模型(Models)
    • 列出模型
      • 原生OpenAI格式
      • 原生Gemini格式
  • 聊天(Chat)
    • 原生OpenAI格式
      • OpenAI聊天格式
      • Responses格式
      • Responses压缩格式
    • 原生Gemini格式
      • Gemini媒体识别
      • Gemini媒体识别
    • 原生Claude格式
      POST
  • 图像(Images)
    • 原生OpenAI格式
      • 生成图像
      • 编辑图像
    • Nano Banana
      • Gemini原生格式
      • Gemini原生格式
    • 通义千问OpenAI格式
      • 生成图像
      • 编辑图像
  • 视频(Videos)
    • 可灵模型参数说明
    • Seedance模型参数说明
    • HappyHorse参数说明
    • Seedance素材库
      • Seedance人像素材用户使用说明
      • 新建素材目录
      • 查询素材目录列表
      • 获取素材目录详情
      • 删除素材目录
      • 上传素材
      • 查询素材列表
      • 获取素材详情
      • 刷新素材状态
      • 删除素材
    • 创建视频生成任务
      POST
    • 获取视频生成任务状态
      GET
    • 视频生成任务回调通知
      POST
  • deepseek常见问题
    • 思考模式开关与思考强度控制
  • qwen系列模型常见问题
    • 上下文缓存
  • kimi系列模型常见问题
    • 模型参数参考
  • 用户
    • 获取个人资料
      GET
  • 日志
    • 获取使用日志
  • 数据模型
    • Schemas
    • Model
    • Usage
    • ModelsResponse
    • ErrorResponse
    • Message
    • MessageContent
    • Tool
    • ToolCall
    • GeminiModelsResponse
    • ChatCompletionResponse
    • ChatCompletionRequest
    • CompletionRequest
    • CompletionResponse
    • ResponseFormat
    • ResponsesRequest
    • ResponsesResponse
    • ClaudeRequest
    • ClaudeMessage
    • ClaudeResponse
    • EmbeddingRequest
    • EmbeddingResponse
    • ImageResponse
    • AudioTranscriptionResponse
    • SpeechRequest
    • RerankRequest
    • RerankResponse
    • VideoRequest
    • ModerationRequest
    • VideoResponse
    • ModerationResponse
    • VideoTaskResponse
    • GeminiRequest
    • VideoTaskMetadata
    • GeminiResponse
    • VideoTaskError
    • OpenAIVideoError
    • UserProfile
    • LogItem
    • Permissions
    • LogListResponse
    • VideoTaskQueryResponse
  1. 视频(Videos)

视频生成任务回调通知

POST
https://client.example.com/hooks/video
这是平台向调用方 callback_url 发起的出站 Webhook,不是调用方请求平台的接口。请将路径替换为创建视频生成任务时传入的 callback_url,并在该地址实现接收逻辑。
当任务进入 SUCCESS 或 FAILURE 终态后,平台会以 POST 和 Content-Type: application/json 推送任务数据。请求 body 严格等同于 GET /v1/video/generations/{task_id} 成功响应的 data 字段;仅去掉查询响应最外层的 code、message、data,不会增加、删除或改写其中任何字段。当前接口请求体 Schema 与查询接口 data 使用同一份 VideoTaskResponse 定义。
接收方应在成功处理后返回任意 HTTP 2xx。非 2xx 或网络错误会被视为投递失败;平台请求超时为 10 秒且不会自动跟随重定向。首次失败后分别在 30 秒、60 秒、300 秒后重试,总投递次数默认最多 3 次(包含首次)。
示例接收地址:https://client.example.com/hooks/video。

请求参数

Header 参数

Body 参数application/json必填

示例

返回响应

🟢200接收成功
application/json
接收方返回任意 2xx 状态码即视为回调投递成功。
Bodyapplication/json

请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://client.example.com/hooks/video' \
--header 'Content-Type: application/json' \
--data '{
    "task_id": "task_cmKs5YPqLFIpEAXFFhn0emR45VFJMqSK",
    "action": "generate",
    "status": "NOT_START",
    "quota": 5935731,
    "result_url": "https://example.com/video.mp4",
    "submit_time": 1782094592,
    "start_time": 1782094593,
    "finish_time": 1782097341,
    "progress": "100%",
    "resolution": "1080P",
    "seconds": 5,
    "completion_tokens": 245025,
    "fail_reason": ""
}'
响应示例响应示例
null
修改于 2026-07-27 00:40:26
上一页
获取视频生成任务状态
下一页
思考模式开关与思考强度控制
Built with