Video Generations

面向上游视频生成任务的异步透传 API。

本页目录

端点
创建任务
轮询结果
取消或删除
透传与计费

端点

http

1POST /v1/contents/generations/tasks2GET /v1/contents/generations/tasks/{task_id}3DELETE /v1/contents/generations/tasks/{task_id}4Content-Type: application/json

创建任务

直接用 JSON 发送上游视频请求体。 model 需要在当前工作区启用，并路由到支持视频任务生成的渠道。

bash

1curl -X POST "$UNI_API_BASE_URL/contents/generations/tasks" \2  -H "Authorization: Bearer $UNI_API_KEY" \3  -H "Content-Type: application/json" \4  -d '{5    "model": "seedance-2-0",6    "content": [7      {8        "type": "text",9        "text": "一只橘猫在窗边晒太阳，镜头缓慢推进，温暖自然光，电影感，细节清晰"10      }11    ],12    "ratio": "16:9",13    "duration": 5,14    "resolution": "720p",15    "generate_audio": false,16    "watermark": false,17    "seed": -118  }'

轮询结果

创建接口会返回任务 id。用这个 id 轮询，直到上游返回终态。成功响应通常会包含视频 URL 和 usage 对象。

bash

1curl "$UNI_API_BASE_URL/contents/generations/tasks/cgt-your-task-id" \2  -H "Authorization: Bearer $UNI_API_KEY"

json

1{2  "id": "cgt-your-task-id",3  "status": "succeeded",4  "content": {5    "video_url": "https://example.com/generated-video.mp4"6  },7  "usage": {8    "completion_tokens": 108900,9    "total_tokens": 10890010  }11}

取消或删除

当上游提供方支持取消或删除任务时，使用 delete 路由转发请求。

bash

1curl -X DELETE "$UNI_API_BASE_URL/contents/generations/tasks/cgt-your-task-id" \2  -H "Authorization: Bearer $UNI_API_KEY"

透传与计费

Uni API 会将请求 body、兼容 headers 与 query string 转发到上游。
响应状态码、body 与响应类型来自上游提供方。
当轮询响应返回 status: succeeded 且包含 usage tokens 时，Uni API 会为计费与日志记录一次 token 用量。
如果查询的任务不是通过当前 Uni API 部署创建的，请附加 ?model=... ，让网关能把轮询请求路由到正确的上游渠道。

Image Edits

密钥（控制台）