Sora 933:文生视频与多素材参考
本页目录
接入预告 · 待上线。以下为计划兼容的请求格式。请在 UiUiAPI 为你的令牌开放对应模型、并标明支持本页接口后再调用;实际上线的模型名、限制和价格以平台为准。
按 Pro 或 Fast 型号提交,并按参考素材的类型区分单个 URL 和 URL 数组。
型号与画幅
型号为 sora-v3-933-pro 和 sora-v3-933-fast。预期时长 10 或 15 秒,推荐 720p,可按场景指定 16:9、9:16、4:3、3:4、1:1 或 21:9。
提交任务
先在终端设置环境变量 UIUI_API_KEY。以下示例使用主站的 JSON 接口。含 example.com 的素材地址需要换成服务器能读取的 HTTPS 文件地址。
curl -sS --fail-with-body 'https://api.uiuihao.com/v1/videos' \
-H "Authorization: Bearer $UIUI_API_KEY" \
-H 'Content-Type: application/json' \
--data-binary '{
"model": "sora-v3-933-pro",
"prompt": "镜头沿着展台移动,跟随音乐节奏切换远近景。",
"seconds": 10,
"aspect_ratio": "16:9",
"resolution": "720p",
"image_url": "https://example.com/ref.jpg",
"audio_url": "https://example.com/beat.mp3"
}'
切换参考模式
纯文本请求省略素材。多图使用 image_urls(最多 9 张),视频使用 video_url 或 video_urls(最多 3 段),音频使用 audio_url 或 audio_urls(最多 3 段)。文件上传模式用相应的 multipart 字段传文件,不要把本地磁盘路径写入 JSON。
查询进度与保存视频
从提交响应读取 id 或 task_id。在终端设置 TASK_ID 为返回的原值,再查询状态。
curl -sS --fail-with-body "https://api.uiuihao.com/v1/videos/$TASK_ID" \
-H "Authorization: Bearer $UIUI_API_KEY"
排队或生成中时隔几秒再查询;收到 429 时按 Retry-After 延长间隔。遇到 failed / FAILURE 时停止轮询并查看错误。成功状态如 completed / SUCCESS 出现后,可用同一任务 ID 保存成片。
curl -fSL "https://api.uiuihao.com/v1/videos/$TASK_ID/content" \
-H "Authorization: Bearer $UIUI_API_KEY" -o output.mp4
若返回临时成片链接,及时保存。向外部存储下载时无需附带 UiUiAPI 密钥。超时先查任务记录,避免重复生成。