视频

视频接口覆盖 Sora、Kling、即梦、火山、万相、MiniMax，以及素材库与真人认证相关能力。视频生成通常为异步任务：先创建任务，再使用返回的任务 ID 查询状态或获取结果。

所有请求均使用 Authorization: Bearer <API Key> 鉴权。

Sora 兼容格式

方法	请求地址	说明
POST	/v1/videos	创建视频任务。
GET	/v1/videos/{task_id}	查询视频任务状态。
GET	/v1/videos/{task_id}/content	获取生成的视频内容。

curl 'https://xueyangai.com/v1/videos' \
  --header 'Authorization: Bearer sk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{"model":"sora","prompt":"清晨云海中的未来城市"}'

Kling 格式

方法	请求地址	说明
POST	/kling/v1/videos/text2video	创建 Kling 文生视频任务。
GET	/kling/v1/videos/text2video/{task_id}	查询文生视频任务。
POST	/kling/v1/videos/image2video	创建 Kling 图生视频任务。
GET	/kling/v1/videos/image2video/{task_id}	查询图生视频任务。

文生视频请求包含 model_name、prompt 等字段；图生视频还需要提供首帧图片或图片 URL。

即梦格式

POST /jimeng/

创建即梦视频生成任务。请求中提供模型、提示词、画面比例和时长等参数。

火山视频

方法	请求地址	说明
POST	/v1/video/generations	创建视频生成任务。
GET	/v1/video/generations/{task_id}	查询任务状态。

该组接口使用统一视频生成格式，适合通过标准任务创建和查询流程接入。

火山原生 v3

方法	请求地址	说明
POST	/api/v3/contents/generations/tasks	创建火山原生 v3 视频任务。
GET	/api/v3/contents/generations/tasks	查询视频任务列表。
GET	/api/v3/contents/generations/tasks/{task_id}	查询单个视频任务。

万相原生 v1

方法	请求地址	说明
POST	/api/v1/services/aigc/video-generation/video-synthesis	创建万相 3.0 视频任务。
GET	/api/v1/tasks/{task_id}	查询万相 3.0 视频任务。

MiniMax 原生 v2

方法	请求地址	说明
POST	/v2/video_generation	创建 MiniMax-H3 视频任务。
GET	/v2/query/video_generation/{task_id}	查询 MiniMax-H3 视频任务。

火山虚拟人像库

方法	请求地址	说明
POST	/api/v3/ark/assets/groups	创建素材组。
POST	/api/v3/ark/assets	上传素材。
GET	/api/v3/ark/assets	查询素材列表。
GET	/api/v3/ark/assets/{asset_id}	查询素材详情。

真人认证

方法	请求地址	说明
POST	/api/v3/ark/real-person/validate/sessions	创建真人认证 H5 会话。
GET	/api/v3/ark/real-person/validate/sessions/{session_id}	查询真人认证会话。
POST	/api/v3/ark/real-person/assets	上传真人素材。
GET	/api/v3/ark/real-person/assets/{asset_id}	查询真人素材。

移动视频素材库

方法	请求地址	说明
POST	/api/openapi-maas/exp/aicc/v2/asset-group/query	查询素材组列表。
POST	/api/openapi-maas/exp/aicc/v2/asset-group/	创建素材组。
POST	/api/openapi-maas/exp/aicc/v2/asset/	上传素材。
POST	/api/openapi-maas/exp/aicc/v2/asset/query	查询素材列表。
GET	/api/openapi-maas/exp/aicc/v2/asset/{asset_id}	查询素材详情。

移动视频真人认证

方法	请求地址	说明
POST	/api/openapi-maas/exp/aicc/v2/real-person-auth/sessions	创建真人认证会话。
POST	/api/openapi-maas/exp/aicc/v2/real-person-auth/asset-group/by-byted-token	查询真人素材组。

通用任务流程

1. 调用对应的创建接口并保存返回的 task_id。
2. 使用同一格式下的查询接口轮询任务状态。
3. 状态成功后读取结果 URL，或调用内容获取接口下载视频。
4. 对失败任务记录请求 ID、错误码与模型名称，避免记录完整 API Key。