POST
https://zx1.deepwl.net
/
v1
/
video
/
create
创建视频
curl --request POST \
  --url https://zx1.deepwl.net/v1/video/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "images": [
    "<string>"
  ],
  "model": "<string>",
  "orientation": "<string>",
  "prompt": "<string>",
  "size": "<string>",
  "duration": 123,
  "watermark": true,
  "private": true,
  "style": "<string>",
  "storyboard": true
}
'
{
  "id": "sora-2:task_01k9008rhbefnt3rb1g9szxdwr",
  "status": "pending",
  "status_update_time": 1762010621323
}

创建视频

Sora 统一视频入口使用 POST /v1/video/create,请求体为 JSON。与 OpenAI 格式的 Sora 视频生成 不同,本接口使用 imagesorientationsizeduration 等字段,并支持 watermarkprivatestylestoryboard 等 Sora 专有选项。
  • 路由入口是 POST /v1/video/create
  • 参考图通过 images 数组传入 URL 列表,文生视频可传空数组。
  • 常见模型示例为 sora-2,以当前渠道实际可用模型为准。
  • 提交成功后返回任务 idstatus,后续用 查询任务 轮询结果。

方法与路径

POST /v1/video/create

请求示例

curl -X POST https://zx1.deepwl.net/v1/video/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "images": [],
    "model": "sora-2",
    "orientation": "portrait",
    "prompt": "make animate",
    "size": "large",
    "duration": 15,
    "watermark": false,
    "private": true,
    "storyboard": false
  }'

响应示例

{
  "id": "sora-2:task_01k9008rhbefnt3rb1g9szxdwr",
  "status": "pending",
  "status_update_time": 1762010621323
}
完整响应还可能包含 objectmodelprogresscreated_atsizedetail 等字段,结构与 OpenAI VIDEO 返回格式一致。

认证

Authorization: Bearer YOUR_API_KEY

Body

images
array<string>
必填
参考图链接列表。文生视频可传 []
model
string
必填
模型名称,例如 sora-2
orientation
string
必填
画面方向。portrait 表示竖屏,landscape 表示横屏。
prompt
string
必填
提示词。
size
string
必填
输出规格。small 一般对应 720p。
duration
integer
必填
视频时长(秒)。默认常为 10,可选 101525sora-2-pro 可用更长时长)。
watermark
boolean
是否保留水印。默认为 true:会优先尝试无水印,失败时可能兜底为有水印。传 false 会强制无水印,遇到去水印错误时可能自动重试。
private
boolean
是否隐藏视频。true 时视频不会发布,且无法进行 remix;默认为 false
style
string
视频风格,仅 sora_video2 等支持的模型可用。可选值包括 thanksgiving(感恩节)、comic(漫画)、news(新闻)、selfie(自拍)、nostalgic(复古)、anime(动漫)。
storyboard
boolean
是否使用故事板,以实现更精细的视频生成细节控制。

Response

id
string
任务 ID,后续查询时作为 id 参数传入。
status
string
任务状态,常见值包括 pendingqueuedprocessingcompletedfailedcancelled
status_update_time
integer
状态最近更新时间(Unix 时间戳)。
object
string
对象类型,部分响应为 video
model
string
实际使用的模型名。
progress
string | integer
任务进度。
detail
object
提交详情,通常包含回显的 input 字段。

相关接口