创建 Muse Video

统一视频创建入口。当前可用 model：omni-10s、veo3.1-fast、veo3.1-lite、veo3.1-lite-hd、grok-imagine-video-1.5（及 fast/lite）、minimax-h3、minimax-h3-max、kling-4.0（720p/1080p）、sd2.5-480p / sd2.5-720p / sd2.5-1080p（按秒）、seedance2.0-md、sd2-480p-ac、sd2-720p-ac、sd2-720p-dl、sd2-720p-db、sd2.0-mini-720p、seedance2.5-30s、sd2.5-720p-ac、sd2.5-720p-933-ac、wan3-720p / wan3-1080p（按秒）、wan3.0-prime-720p / wan3.0-prime-1080p（按秒）、wan3-480p-20s-ac、muse-video / muse-video-20s / muse-video-30s / muse-video-40s / muse-video-50s / muse-video-60s（1–60 秒，按时长分档，原生 720p，按次）。Veo 也可用专用入口 POST /v1/veo/frames。

POST

videos

curl --request POST \
  --url https://sigrunai.com/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "omni-10s",
  "prompt": "A golden retriever running across a sunny meadow, cinematic tracking shot",
  "aspect_ratio": "16:9"
}
'

{
  "code": 20000,
  "msg": "<string>",
  "data": {
    "task_id": "<string>",
    "status": "<string>",
    "progress": 123,
    "model": "<string>",
    "created_at": 123,
    "completed_at": 123,
    "cost": 123,
    "error_message": "<string>",
    "result": {
      "image_url": "<string>",
      "video_url": "<string>"
    }
  }
}

异步生成 Muse Video。使用统一入口 POST /v1/videos。成功返回 task_id，用查询视频任务轮询，完成后从 result.video_url 取片。成片为原生 720p。计费方式为 per_task（按次）。时长不乘价，但决定落到哪一档计费模型。实际单价以模型目录与创建响应中的 cost 为准。

按时长选择模型

传入 duration 或 seconds（1～60）。系统按秒数选择计费模型，并在创建响应的 model 中返回该档。请求里写了别的档，仍以秒数为准。

时长	计费 `model`	不传时长时
1～10 秒	`muse-video`	请求模型为 `muse-video` 时默认 5 秒
11～20 秒	`muse-video-20s`	默认 20 秒
21～30 秒	`muse-video-30s`	默认 30 秒
31～40 秒	`muse-video-40s`	默认 40 秒
41～50 秒	`muse-video-50s`	默认 50 秒
51～60 秒	`muse-video-60s`	默认 60 秒

超过 60 秒会被拒绝。例如请求 muse-video 且 duration 为 25，计费模型是 muse-video-30s；请求 muse-video-60s 且 duration 为 8，计费模型是 muse-video。

模式

模式	传参
文生视频	不传图片
首帧 / 首尾帧	传 `first_image`（及可选 `last_image`）。也可设 `first_last_frame: true`，并在 `images` 里按顺序放首帧、尾帧
参考图	传 `images` / `reference_images` / `image_urls` / `reference_image_urls`

首尾帧可以和参考图一起用。尾帧必须同时有首帧。首尾帧与参考图合计张数：落到 muse-video 时最多 10 张，落到 20～60 秒档时最多 9 张。不支持参考视频和参考音频。

请求参数

字段	类型	必填	说明
`model`	string	是	上表任一档。下划线写法如 `muse_video_20s` 也可
`prompt`	string	是	整段视频的主体、动作和氛围，1～4000 字
`duration` / `seconds`	int \| string	否	1～60。不传时按上表默认。字符串亦可（如 `"25"`）
`aspect_ratio` / `ratio`	string	否	`16:9`、`9:16`、`1:1`、`4:3`、`3:4`；默认 `16:9`
`orientation`	string	否	`portrait` / `vertical` 为 `9:16`，`landscape` / `horizontal` 为 `16:9`
`size`	string	否	比例，或 `1280x720` / `1920x1080` / `720x1280` / `1080x1920`
`resolution`	string	否	仅 `720p`；省略即可
`first_image` / `first_image_url`	string	否	首帧 URL
`last_image` / `last_image_url`	string	否	尾帧 URL；必须同时有首帧
`images` / `reference_images` / `image_urls` / `reference_image_urls`	string[]	否	参考图 URL。多个字段同时出现时，按 `reference_images`、`image_urls`、`images`、`reference_image_urls` 取第一组非空列表
`camera_movement`	string	否	运镜，自由文本，最长 1000 字。例如 `zoom_in`、`pan_left`、`static`
`style`	string	否	风格，自由文本，最长 1000 字。例如 `cinematic`、`anime`
`negative_prompt`	string	否	不要出现的内容，与 `prompt` 分开，最长 1000 字
`first_last_frame`	boolean	否	`true` 时把 `images` 的前两张当作首帧、尾帧
`smart_queue`	bool	否	默认 `false`。为 `true` 时，近期成功率过低会先保持 `queued`，恢复后再提交（最长约 2 小时）。详见智能排队

参考素材须为公网 https:// 直链，或 data URL。

示例

文生视频（8 秒，计费 `muse-video`）

curl -X POST 'https://sigrunai.com/v1/videos' \
  -H 'Authorization: Bearer sk_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "muse-video",
    "prompt": "热气球从山谷的晨雾中缓缓升起",
    "duration": 8,
    "aspect_ratio": "16:9",
    "camera_movement": "zoom_in"
  }'

25 秒（计费 `muse-video-30s`）

curl -X POST 'https://sigrunai.com/v1/videos' \
  -H 'Authorization: Bearer sk_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "muse-video",
    "prompt": "一个人沿海岸走完整个黄昏，海风吹动衣角",
    "duration": 25,
    "aspect_ratio": "9:16",
    "style": "cinematic"
  }'

首尾帧与参考图

curl -X POST 'https://sigrunai.com/v1/videos' \
  -H 'Authorization: Bearer sk_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "muse-video-20s",
    "prompt": "让画面中的人物转身微笑",
    "first_image": "https://example.com/first.png",
    "last_image": "https://example.com/last.png",
    "images": ["https://example.com/ref.png"],
    "negative_prompt": "blurry, watermark, text"
  }'

未传 duration 时，muse-video-20s 按 20 秒计费。成功响应示例：

{
  "code": 20000,
  "msg": "提交成功",
  "data": {
    "task_id": "vid_xxxxxxxx",
    "status": "queued",
    "progress": 0,
    "model": "muse-video",
    "cost": 0,
    "result": {}
  }
}

data.model 是按时长落到的计费档。

轮询

curl -X GET 'https://sigrunai.com/v1/videos/vid_xxxxxxxx' \
  -H 'Authorization: Bearer sk_xxx'

状态说明见查询视频任务。完成后读取 data.result.video_url（请及时转存）。

授权

Authorization

string

header

必填

控制台创建的 API Key，格式：Bearer sk_xxx

请求体

application/json

model

string

必填

omni-10s, veo3.1-fast, veo3.1-lite, veo3.1-lite-hd, grok-imagine-video-1.5 (and fast/lite), minimax-h3, minimax-h3-max, kling-4.0 / kling-4.0-720p / kling-4.0-1080p, sd2.5-480p / sd2.5-720p / sd2.5-1080p, seedance2.0-md, sd2-480p-ac, sd2-720p-ac, sd2-720p-dl, sd2-720p-db, sd2.0-mini-720p, seedance2.5-30s, sd2.5-720p-ac, sd2.5-720p-933-ac, wan3-720p / wan3-1080p, wan3.0-prime-720p / wan3.0-prime-1080p, wan3-480p-20s-ac, or muse-video / muse-video-20s / muse-video-30s / muse-video-40s / muse-video-50s / muse-video-60s

示例:

"omni-10s"

prompt

string

必填

duration

omni-10s: fixed 10; seedance2.0-md: 5/10/15; sd2-*-ac: 4–15; sd2-720p-dl: fixed 15; sd2-720p-db: 5/10/15; sd2.0-mini-720p: 4–15; sd2.5-480p / sd2.5-720p / sd2.5-1080p: 5–30; seedance2.5-30s: fixed 30; sd2.5-720p-ac and sd2.5-720p-933-ac: 4–30; wan3-720p / wan3-1080p: 10–30; wan3.0-prime-720p: 10–30; wan3.0-prime-1080p: 8–30; wan3-480p-20s-ac: 5–20; Muse Video: 1–60, billed as muse-video (1–10, default 5s when omitted) or muse-video-20s through muse-video-60s

seconds

Alias of duration

aspect_ratio

string

ratio

string

Alias of aspect_ratio

orientation

string

portrait/landscape may imply aspect ratio

size

string

resolution

string

omni-10s is fixed at 720p. Muse Video supports 720p only

first_image

string<uri>

First-frame URL. Used by omni-10s and Muse Video

last_image

string<uri>

Last-frame URL; use with first_image. Muse Video also requires a first frame

images

string<uri>[]

reference_images

string<uri>[]

videos

string<uri>[]

reference_videos

string<uri>[]

reference_video_durations

integer[]

Required with reference videos for kling-4.0; same length as videos; seconds 1–30. Billable seconds = output duration + sum of these values.

必填范围: 1 <= x <= 30

reference_audio_durations

integer[]

Required with reference audios for kling-4.0; same length as audios; seconds 5–30 (validation only, not billed).

必填范围: 5 <= x <= 30

audios

string<uri>[]

reference_audios

string<uri>[]

first_image_url

string<uri>

Alias of first_image. Accepted by Muse Video

last_image_url

string<uri>

Alias of last_image. Muse Video requires a first frame as well

image_urls

string<uri>[]

Reference image URLs. Muse Video: frames plus references, up to 10 on the 10s tier and 9 on the 20–60s tiers

reference_image_urls

string<uri>[]

Alias of images

camera_movement

string

Muse Video camera move, free text, up to 1000 characters

style

string

Muse Video style, free text, up to 1000 characters

negative_prompt

string

Muse Video negative prompt, separate from prompt, up to 1000 characters

smart_queue

boolean

默认值:false

When true, a very low recent success rate keeps the task queued until recovery (up to about 2 hours)

响应

200 - application/json

Submitted

code

integer

示例:

20000

msg

string

data

object

Show child attributes

最后修改于 2026年11月13日

curl --request POST \
  --url https://sigrunai.com/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "omni-10s",
  "prompt": "A golden retriever running across a sunny meadow, cinematic tracking shot",
  "aspect_ratio": "16:9"
}
'

{
  "code": 20000,
  "msg": "<string>",
  "data": {
    "task_id": "<string>",
    "status": "<string>",
    "progress": 123,
    "model": "<string>",
    "created_at": 123,
    "completed_at": 123,
    "cost": 123,
    "error_message": "<string>",
    "result": {
      "image_url": "<string>",
      "video_url": "<string>"
    }
  }
}

Gemini Omni

Veo 3.1

Grok Imagine Video

Muse Video

MiniMax H3

Kling 4.0

Wan 3

Seedance 2.0

Seedance 2.5

创建 Muse Video

按时长选择模型

模式

请求参数

示例

文生视频（8 秒，计费 `muse-video`）

25 秒（计费 `muse-video-30s`）

首尾帧与参考图

轮询

授权

请求体

响应

按时长选择模型

模式

请求参数

示例

文生视频（8 秒，计费 muse-video）

25 秒（计费 muse-video-30s）

首尾帧与参考图

轮询

授权

请求体

响应

文生视频（8 秒，计费 `muse-video`）

25 秒（计费 `muse-video-30s`）