Docs
我的 API Key ↗EN
开发文档/模型与接口

视频生成

创建任务、保存 ID、查询结果。视频生成采用异步流程。

更新于 2026 年 10 月 7 日查看 Markdown ↗

创建视频任务

选择模型后，参数与请求示例会同步更新。

Seedance 2.5

seedance-2.5
参数范围与说明
modelseedance-2.5
resolution480p / 720p / 1080p
duration4–30
aspect_ratio示例提供横屏、竖屏与正方形。
Idempotency-Key重试同一次生成时保持不变。
调整参数只生成代码，不会提交请求或扣费。
POST /v1/videos
curl --fail-with-body 'https://noveadream.com/v1/videos' \
  -H "Authorization: Bearer $NOVEA_API_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $REQUEST_ID" \
  -d '{
  "model": "seedance-2.5",
  "prompt": "A slow camera move through a peaceful garden",
  "duration": 5,
  "resolution": "480p",
  "aspect_ratio": "16:9"
}'

Seedance 2.0

seedance-2.0
参数范围与说明
modelseedance-2.0
resolution480p / 720p / 1080p
duration4–15
aspect_ratio示例提供横屏、竖屏与正方形。
Idempotency-Key重试同一次生成时保持不变。
调整参数只生成代码，不会提交请求或扣费。
POST /v1/videos
curl --fail-with-body 'https://noveadream.com/v1/videos' \
  -H "Authorization: Bearer $NOVEA_API_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $REQUEST_ID" \
  -d '{
  "model": "seedance-2.0",
  "prompt": "A slow camera move through a peaceful garden",
  "duration": 5,
  "resolution": "480p",
  "aspect_ratio": "16:9"
}'

Seedance 2.0 Fast

seedance-2.0-fast
参数范围与说明
modelseedance-2.0-fast
resolution480p / 720p
duration4–15
aspect_ratio示例提供横屏、竖屏与正方形。
Idempotency-Key重试同一次生成时保持不变。
调整参数只生成代码，不会提交请求或扣费。
POST /v1/videos
curl --fail-with-body 'https://noveadream.com/v1/videos' \
  -H "Authorization: Bearer $NOVEA_API_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $REQUEST_ID" \
  -d '{
  "model": "seedance-2.0-fast",
  "prompt": "A slow camera move through a peaceful garden",
  "duration": 5,
  "resolution": "480p",
  "aspect_ratio": "16:9"
}'

MiniMax H3

minimax-h3
参数范围与说明
modelminimax-h3
resolution480p / 720p
duration4–15
aspect_ratio示例提供横屏、竖屏与正方形。
Idempotency-Key重试同一次生成时保持不变。
调整参数只生成代码，不会提交请求或扣费。
POST /v1/videos
curl --fail-with-body 'https://noveadream.com/v1/videos' \
  -H "Authorization: Bearer $NOVEA_API_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $REQUEST_ID" \
  -d '{
  "model": "minimax-h3",
  "prompt": "A slow camera move through a peaceful garden",
  "duration": 5,
  "resolution": "480p",
  "aspect_ratio": "16:9"
}'

MiniMax H3 SFW

minimax-h3-sfw
参数范围与说明
modelminimax-h3-sfw
resolution768p / 1080p
duration4–30
aspect_ratio示例提供横屏、竖屏与正方形。
Idempotency-Key重试同一次生成时保持不变。
调整参数只生成代码，不会提交请求或扣费。
POST /v1/videos
curl --fail-with-body 'https://noveadream.com/v1/videos' \
  -H "Authorization: Bearer $NOVEA_API_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $REQUEST_ID" \
  -d '{
  "model": "minimax-h3-sfw",
  "prompt": "A slow camera move through a peaceful garden",
  "duration": 5,
  "resolution": "768p",
  "aspect_ratio": "16:9"
}'

Wan 2.2 Anime

wan-2.2-anime
参数范围与说明
modelwan-2.2-anime
resolution480p / 720p
duration5
aspect_ratio示例提供横屏、竖屏与正方形。
Idempotency-Key重试同一次生成时保持不变。
调整参数只生成代码，不会提交请求或扣费。
POST /v1/videos
curl --fail-with-body 'https://noveadream.com/v1/videos' \
  -H "Authorization: Bearer $NOVEA_API_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $REQUEST_ID" \
  -d '{
  "model": "wan-2.2-anime",
  "prompt": "A slow camera move through a peaceful garden",
  "duration": 5,
  "resolution": "480p",
  "aspect_ratio": "16:9"
}'

Wan 2.2 Real

wan-2.2-real
参数范围与说明
modelwan-2.2-real
resolution480p / 720p
duration5
aspect_ratio示例提供横屏、竖屏与正方形。
Idempotency-Key重试同一次生成时保持不变。
调整参数只生成代码，不会提交请求或扣费。
POST /v1/videos
curl --fail-with-body 'https://noveadream.com/v1/videos' \
  -H "Authorization: Bearer $NOVEA_API_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $REQUEST_ID" \
  -d '{
  "model": "wan-2.2-real",
  "prompt": "A slow camera move through a peaceful garden",
  "duration": 5,
  "resolution": "480p",
  "aspect_ratio": "16:9"
}'

查询与下载

GET /v1/videos/{id}
curl --fail-with-body 'https://noveadream.com/v1/videos/video_12345' \
  -H "Authorization: Bearer $NOVEA_API_KEY"

video_12345 为占位 ID，应替换为创建请求实际返回的 id。completed 后下载，failed 后停止轮询。建议查询间隔从 5 秒开始，并对限流退避。

Download
curl --fail-with-body https://noveadream.com/v1/videos/video_12345/content \
  -H "Authorization: Bearer $NOVEA_API_KEY" \
  -o result.mp4

MiniMax H3 参考素材

全能参考模式支持图片、视频和音频；首尾帧模式只接收图片。参考音频和视频分别填写累计时长，不能把首尾帧字段与全能参考混用。

JSON
{
  "model": "minimax-h3-sfw",
  "mode": "all-reference",
  "prompt": "Follow the motion of the reference video",
  "duration": 8,
  "resolution": "768p",
  "aspect_ratio": "9:16",
  "reference_video_urls": [
    "https://example.com/motion.mp4"
  ],
  "input_video_seconds": 6
}