页面加载中
通过个人 API Key 创建文生视频或图生视频任务。每个模型的可用值、参考素材上限和特殊约束都列在下方。
创建视频任务
POST /openapi/v1/videos/generations请求立即返回 taskId；视频完成后通过详情接口读取 videos[].url。
curl -X POST 'https://prompthub.xin/api/openapi/v1/videos/generations' \
-H 'Authorization: Bearer phk_你的API密钥' \
-H 'Content-Type: application/json' \
-d '{
"prompt": "雨夜霓虹街道，镜头缓慢推进",
"model": "platform-video-model-id",
"clientRequestId": "video_demo_001",
"mode": "text_to_video",
"parameters": {
"aspectRatio": "16:9",
"duration": 10,
"resolution": "720p",
"generateAudio": true
}
}'素材
生成接口只接收 JSON 中的 URL，不接收文件本体、Base64 或 multipart。
PromptHub OSS URL 或供应商可访问的公网 URL 可直接放入素材数组。
references[].url = https://...先获取上传签名并直传 PromptHub OSS，再把响应中的 publicUrl 或 standardUrl 放入素材数组。
POST /openapi/v1/videos/uploads/signature签名接口只接收 contentType；响应中的 host、policy、signature、accessKeyId、key 用于 OSS 表单直传。图片上限 20 MB；视频/音频还受模型和接口的时长限制。
curl -X POST 'https://prompthub.xin/api/openapi/v1/videos/uploads/signature' \
-H 'Authorization: Bearer phk_你的API密钥' \
-H 'Content-Type: application/json' \
-d '{"contentType":"video/mp4"}'
# 使用响应 data.host、data.policy、data.signature、data.accessKeyId、data.key 直传 OSS
curl -X POST '<data.host>' \
-F "key=<data.key>" \
-F "policy=<data.policy>" \
-F "OSSAccessKeyId=<data.accessKeyId>" \
-F "Signature=<data.signature>" \
-F "Content-Type=video/mp4" \
-F "file=@./reference.mp4"01
公共协议只接受平台模型 ID 和统一参数，内部路由细节不会对外暴露。
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
| prompt | 是 | string | 视频描述、动作和镜头指令。 |
| model | 是 | string | 平台模型 ID，必须来自视频模型列表。 |
| clientRequestId | 是 | string | 用户侧幂等 ID；重复提交不会重复扣点。 |
| mode | 否 | enum | text_to_video / image_to_video |
| references | 否 | array | type=image/video/audio 的混合参考素材数组。 |
| parameters | 否 | object | aspectRatio、duration、resolution、generateAudio、referenceType 等。 |
02
数据实时来自平台模型目录，只展示可调用的平台模型 ID 和公开能力，不包含内部路由与绑定信息。
| 平台模型 | 平台模型 ID | 状态 | mode | aspectRatio | duration | resolution | 参考素材限制 |
|---|---|---|---|---|---|---|---|
| 正在读取平台模型目录... | |||||||
不在模型能力矩阵中的值不会被静默忽略，服务端会返回参数错误。
只有声明 referenceAudios=true 的模型支持音频参考；generateAudio 是否可用以模型能力为准。
使用上方平台模型表中的可用值
图生视频必须提供图片参考；参考视频/音频需要同时满足数量、大小及时长限制。
@图片1 → references[type=image][0]
@图片2 → references[type=image][1]
@视频N → references[type=video][N-1]
@音频N → references[type=audio][N-1]
@图片N、@视频N、@音频N 分别按各自类型的素材顺序从 1 开始编号；type 与 role 用于表达素材类型和用途。
{
"prompt": "脸型参考@图片1，服装参考@图片2；动作参考@视频1，音乐使用@音频1",
"references": [
{ "type": "image", "url": "https://example.com/face.jpg", "role": "character" },
{ "type": "video", "url": "https://example.com/motion.mp4", "role": "motion_reference" },
{ "type": "image", "url": "https://example.com/outfit.jpg", "role": "wardrobe" },
{ "type": "audio", "url": "https://example.com/music.mp3", "role": "background_music" }
]
}03
将创建响应中的 taskId 替换到路径中，直到 status 为 completed 或 failed。
curl 'https://prompthub.xin/api/openapi/v1/videos/generations/{taskId}' \
-H 'Authorization: Bearer phk_你的API密钥'