# 视频生成

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

## 创建视频任务

### Seedance 2.5

- model: seedance-2.5
- resolution: 480p / 720p / 1080p
- duration: 4–30
- aspect_ratio: 示例提供横屏、竖屏与正方形。
- Idempotency-Key: 重试同一次生成时保持不变。

POST /v1/videos

```json
{
  "model": "seedance-2.5",
  "prompt": "A slow camera move through a peaceful garden",
  "duration": 5,
  "resolution": "480p",
  "aspect_ratio": "16:9"
}
```

### Seedance 2.0

- model: seedance-2.0
- resolution: 480p / 720p / 1080p
- duration: 4–15
- aspect_ratio: 示例提供横屏、竖屏与正方形。
- Idempotency-Key: 重试同一次生成时保持不变。

POST /v1/videos

```json
{
  "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

- model: seedance-2.0-fast
- resolution: 480p / 720p
- duration: 4–15
- aspect_ratio: 示例提供横屏、竖屏与正方形。
- Idempotency-Key: 重试同一次生成时保持不变。

POST /v1/videos

```json
{
  "model": "seedance-2.0-fast",
  "prompt": "A slow camera move through a peaceful garden",
  "duration": 5,
  "resolution": "480p",
  "aspect_ratio": "16:9"
}
```

### MiniMax H3

- model: minimax-h3
- resolution: 480p / 720p
- duration: 4–15
- aspect_ratio: 示例提供横屏、竖屏与正方形。
- Idempotency-Key: 重试同一次生成时保持不变。

POST /v1/videos

```json
{
  "model": "minimax-h3",
  "prompt": "A slow camera move through a peaceful garden",
  "duration": 5,
  "resolution": "480p",
  "aspect_ratio": "16:9"
}
```

### MiniMax H3 SFW

- model: minimax-h3-sfw
- resolution: 768p / 1080p
- duration: 4–30
- aspect_ratio: 示例提供横屏、竖屏与正方形。
- Idempotency-Key: 重试同一次生成时保持不变。

POST /v1/videos

```json
{
  "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

- model: wan-2.2-anime
- resolution: 480p / 720p
- duration: 5
- aspect_ratio: 示例提供横屏、竖屏与正方形。
- Idempotency-Key: 重试同一次生成时保持不变。

POST /v1/videos

```json
{
  "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

- model: wan-2.2-real
- resolution: 480p / 720p
- duration: 5
- aspect_ratio: 示例提供横屏、竖屏与正方形。
- Idempotency-Key: 重试同一次生成时保持不变。

POST /v1/videos

```json
{
  "model": "wan-2.2-real",
  "prompt": "A slow camera move through a peaceful garden",
  "duration": 5,
  "resolution": "480p",
  "aspect_ratio": "16:9"
}
```

## 查询与下载

```bash
curl --fail-with-body 'https://noveadream.com/v1/videos/video_12345' \
  -H "Authorization: Bearer $NOVEA_API_KEY"
```

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

```bash
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
}
```