跳转到主要内容
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-imagine-1.0-video-apimart",
    "prompt": "一只狗在海滩上奔跑，阳光明媚，慢镜头",
    "size": "16:9",
    "duration": 6,
    "quality": "720p"
  }'

{
  "code": 200,
  "data": {
    "id": "task_01JNXXXXXXXXXXXXXXXXXX",
    "status": "submitted",
    "progress": 0,
    "created": 1710000000,
    "type": "video"
  }
}

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-imagine-1.0-video-apimart",
    "prompt": "一只狗在海滩上奔跑，阳光明媚，慢镜头",
    "size": "16:9",
    "duration": 6,
    "quality": "720p"
  }'

{
  "code": 200,
  "data": {
    "id": "task_01JNXXXXXXXXXXXXXXXXXX",
    "status": "submitted",
    "progress": 0,
    "created": 1710000000,
    "type": "video"
  }
}

​
认证

​
Authorization
string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key：访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加：
Authorization: Bearer YOUR_API_KEY

​
请求参数

​
model
string
默认值:"grok-imagine-1.0-video-apimart"
必填
视频生成模型名称支持的模型：
  • grok-imagine-1.0-video-apimart - Grok 视频生成
示例："grok-imagine-1.0-video-apimart"
​
prompt
string
必填
视频内容描述，支持中英文
​
size
string
默认值:"16:9"
视频尺寸可选值：
  • 16:9 - 横屏（默认）
  • 9:16 - 竖屏
  • 1:1 - 正方形
  • 3:2 - 横屏
  • 2:3 - 竖版
​
duration
integer
默认值:6
视频时长（秒）取值范围：6-30（最短 6 秒，最长 30 秒）⚠️ 注意： 必须输入纯数字（如 6），不要加引号，否则会报错
​
quality
string
默认值:"480p"
视频质量可选值：
  • 480p - 标清（默认）
  • 720p - 高清
​
image_urls
string[]
图生视频参考图 URL 数组。传入即为图生视频模式，系统将使用数组中的第一张图片作为参考。
上传参考图之后，宽高比会自动匹配参考图的宽高比

​
响应

​
code
integer
响应状态码
​
data
object
返回数据对象
查询任务结果视频生成为异步任务，提交后会返回 id (即 task_id)。使用 获取任务状态 接口查询生成进度和结果。

​
使用场景

​
场景 1：文生视频

{
  "model": "grok-imagine-1.0-video-apimart",
  "prompt": "一只狗在海滩上奔跑，阳光明媚，慢镜头",
  "size": "16:9",
  "duration": 6
}

​
场景 2：图生视频

{
  "model": "grok-imagine-1.0-video-apimart",
  "prompt": "让画面动起来，添加自然的动态效果",
  "image_urls": ["https://example.com/start.png"],
  "size": "16:9",
  "duration": 10,
  "quality": "720p"
}