Skip to main content
POST
/
videos
/
generations
Create video generation
curl --request POST \
  --url https://dimilinks.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "grok-imagine-video",
  "prompt": "<string>",
  "input_reference": [
    "<string>"
  ],
  "group": "<string>"
}
'
{
  "data": {
    "id": "video_xxx",
    "task_id": "video_xxx"
  }
}
/v1/videos/generations 提交后立即返回 task_id。生成耗时取决于时长与清晰度（一般 1 到 5 分钟），用 /v1/tasks/{task_id} 轮询任务状态。
视频接口当前只支持 grok-imagine-video 模型；推理与计费会带上 Grok 渠道的特别价格。

​
请求地址

POST https://dimilinks.com/v1/videos/generations
Content-Type: application/json
Authorization: Bearer <DIMILINKS_API_KEY>

​
文生视频示例

curl "https://dimilinks.com/v1/videos/generations" \
  -H "Authorization: Bearer $DIMILINKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "一群霓虹色水母在深海中缓慢漂浮，光线像电影质感",
    "seconds": "6",
    "size": "1280x720",
    "resolution_name": "720p",
    "preset": "normal"
  }'
成功响应： 
{
  "data": {
    "id": "video_xxx",
    "task_id": "video_xxx",
    "status": "queued"
  }
}
拿到 task_id 后调用 Retrieve video task 查询。

​
参考图生视频示例

参考图必须先转成 data:image/...;base64,... Data URL；浏览器侧的 blob: URL 不能直接传，需要先在服务端读到二进制再编码。 
curl "https://dimilinks.com/v1/videos/generations" \
  -H "Authorization: Bearer $DIMILINKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "保持人物主体一致，让镜头围绕主体环绕一周",
    "seconds": "10",
    "size": "1280x720",
    "resolution_name": "720p",
    "preset": "normal",
    "input_reference": [
      "data:image/png;base64,iVBORw0KGgo..."
    ]
  }'

​
参数

参数类型必填说明
modelstring是当前固定为 grok-imagine-video。
promptstring是视频内容描述，最长 2500 字符。
secondsstring是时长，可选 "6" / "10" / "12" / "16" / "20"，单位秒。
sizestring是画面尺寸：1280x720（16:9）、720x1280（9:16）、1024x1024（1:1）。
resolution_namestring是清晰度档位：720p（高清）或 480p（标清）。
presetstring是风格预设：normal（标准）、fun（趣味高）、spicy（高强度）、custom（自定义提示）。
input_referencestring[]否参考图 Data URL 数组，最多 7 张；提供时进入参考图生视频模式。
groupstring否渠道分组，控制台调用会带 default，第三方一般留空。

​
时长与清晰度组合

  • 720p 适合最终成片；480p 出图更快，适合预览。
  • 时长越长，生成耗时和单价越高，建议先用 seconds: "6" 走通链路。
  • 同一段提示语切到 9:16 或 1:1 时，建议在描述里说明主体在画面内的位置，避免被裁掉。

​
错误处理

视频接口同样使用 OpenAI 风格的 error 包装，常见错误见 Errors。如果 400 提示参考图问题，请检查：
  • 参考图是否是 PNG / JPEG / WebP；
  • 是否使用了 Data URL（不是 blob: 也不是普通 HTTP URL）；
  • 单张参考图小于 10 MB；
  • 参考图数量不超过 7 张。

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
model
string
default:grok-imagine-video
required
​
prompt
string
required
Maximum string length: 2500
​
seconds
enum<string>
required
Available options:
6,
10,
12,
16,
20
​
size
enum<string>
required
Available options:
1280x720,
720x1280,
1024x1024
​
resolution_name
enum<string>
required
Available options:
480p,
720p
​
preset
enum<string>
required
Available options:
normal,
fun,
spicy,
custom
​
input_reference
string[]
Maximum array length: 7

data:image/...;base64,... Data URL

​
group
string

Response

Video task submission

​
data
object