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 '
{
  "model": "<string>",
  "prompt": "<string>",
  "images": [
    "<string>"
  ],
  "aspect_ratio": "<string>",
  "size": "<string>",
  "duration": 123
}
'
{
  "id": "grok:48a67431-0708-46d1-9ab9-83cb84700153",
  "status": "processing",
  "status_update_time": 1762780400,
  "task_id": "48038932-0ff5-4251-8b4b-7a76c09fd114",
  "created_at": "2025-11-08T23:07:57.510141923+08:00"
}

​
创建视频

Grok 统一视频入口使用 POST /v1/video/create，请求体为 JSON。与 OpenAI 格式的 Grok 视频生成 不同，本接口使用 images、aspect_ratio、size 等字段，并支持在 prompt 中通过 @img1、@img2 引用多图。
  • 路由入口是 POST /v1/video/create。
  • 参考图通过 images 数组传入 URL 或 base64；文生视频可传 []。
  • 常见模型为 grok-video-3，以当前渠道实际可用模型为准。
  • 提交成功后返回 id 或 task_id 与 status，后续用 查询任务 轮询结果。

​
方法与路径

POST /v1/video/create

​
请求示例

# 文生视频 / 首尾帧（images 为空或按场景传图）
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 '{
    "model": "grok-video-3",
    "prompt": "cat fish --mode=custom",
    "images": [],
    "aspect_ratio": "3:2",
    "size": "1080P",
    "duration": 10
  }'

​
响应示例

{
  "id": "grok:48a67431-0708-46d1-9ab9-83cb84700153",
  "status": "processing",
  "status_update_time": 1762780400,
  "task_id": "48038932-0ff5-4251-8b4b-7a76c09fd114",
  "created_at": "2025-11-08T23:07:57.510141923+08:00"
}
实际响应字段可能因渠道略有差异，请以返回中的 id 或 task_id 作为后续查询凭据。

​
认证

Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
必填
模型名称，例如 grok-video-3。
​
prompt
string
必填
提示词。多图参考时可在文案中使用 @img1、@img2 等占位符，对应 images 数组下标顺序。
​
images
array<string>
必填
参考图列表，元素为 URL 或 base64 data URI。文生视频可传 []；首尾帧一般按顺序传 2 张；多图参考最多支持 6 张。
​
aspect_ratio
string
必填
视频比例。可选 16:9、9:16、2:3、3:2、1:1。
​
size
string
必填
分辨率规格，传 720P 或 1080P。
​
duration
integer
视频时长（秒）。默认 10，支持 6、10、15。

​
Response

​
id
string
任务 ID，查询时作为 id 参数；部分响应可能仅返回 task_id。
​
task_id
string
上游任务 ID，与 id 可能并存，以实际响应为准。
​
status
string
任务状态，常见值包括 processing、completed、failed。
​
status_update_time
integer
状态最近更新时间（Unix 时间戳）。
​
created_at
string
创建时间，部分响应为 RFC3339 字符串。

​
相关接口