# Seedance 1.5 Pro API

Seedance 1.5 Pro 视频生成模型的完整 API 参考文档。

## 模型变体

此 API 支持两种模型变体：

| 模型 | ID | 描述 |
|-------|-----|-------------|
| **Seedance 1.5 Pro Text to Video** | `seedance-v1.5-pro-text-to-video` | 高质量文本转视频生成 |
| **Seedance 1.5 Pro Image to Video** | `seedance-v1.5-pro-image-to-video` | 带运动控制的图像动画 |

## 快速对比

| 功能 | Text to Video | Image to Video |
|---------|---------------|----------------|
| 输入 | 文本提示词 | 图像 + 文本提示词 |
| 时长范围 | 4-12 seconds | 4-12 seconds |
| 分辨率选项 | 480p, 720p, 1080p | 480p, 720p, 1080p |
| 起始帧 | 不支持 | 必填 |
| 结束帧 | 不支持 | 不支持 |
| 音频支持 | 可选 | 可选 |
| 音频 URL | 不支持 | 不支持 |

### 支持的宽高比

`21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`

### 分辨率选项

| 分辨率 | 描述 |
|------------|-------------|
| `480p` | 标准清晰度，处理速度更快 |
| `720p` | 高清，质量与速度均衡 |
| `1080p` | 全高清，最高质量输出 |

## Seedance 1.5 Pro Text to Video

### 接口地址

```
POST /api/v1/video/task
```

### 请求参数

#### 必填

| 参数 | 类型 | 描述 |
|-----------|------|-------------|
| `model_name` | string | 必须为 `"seedance-v1.5-pro-text-to-video"` |
| `prompt` | string | 视频生成提示词 |
| `duration` | number | 视频时长，单位秒（4-12） |
| `resolution` | string | 输出分辨率：`"480p"`、`"720p"` 或 `"1080p"` |
| `aspect_ratio` | string | 视频宽高比：`"21:9"`、`"16:9"`、`"9:16"`、`"1:1"`、`"4:3"` 或 `"3:4"` |

#### 可选

| 参数 | 类型 | 描述 |
|-----------|------|-------------|
| `sound` | boolean | 为视频生成环境音效 |
| `camera_fixed` | boolean | 锁定摄像机位置，禁用摄像机移动 |
| `seed` | number | 用于可复现生成的随机种子 |

### 请求示例

```javascript
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedance-v1.5-pro-text-to-video',
    prompt: 'A golden retriever running through a sunlit meadow',
    duration: 6,
    resolution: '1080p',
    aspect_ratio: '16:9'
  })
});

const { data } = await response.json();
const taskId = data.task_id;
```

**仅含请求体的可选参数示例：**

```javascript
{
  model_name: 'seedance-v1.5-pro-text-to-video',
  prompt: 'A golden retriever running through a sunlit meadow',
  duration: 6,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true,
  camera_fixed: false,
  seed: 42
}
```

## Seedance 1.5 Pro Image to Video

### 请求参数

#### 必填

| 参数 | 类型 | 描述 |
|-----------|------|-------------|
| `model_name` | string | 必须为 `"seedance-v1.5-pro-image-to-video"` |
| `prompt` | string | 视频生成提示词 |
| `duration` | number | 视频时长，单位秒（4-12） |
| `resolution` | string | 输出分辨率：`"480p"`、`"720p"` 或 `"1080p"` |
| `aspect_ratio` | string | 视频宽高比：`"21:9"`、`"16:9"`、`"9:16"`、`"1:1"`、`"4:3"` 或 `"3:4"` |
| `image_url` | string | 视频的第一帧图像 |

#### 可选

| 参数 | 类型 | 描述 |
|-----------|------|-------------|
| `sound` | boolean | 为视频生成环境音效 |
| `camera_fixed` | boolean | 锁定摄像机位置，禁用摄像机移动 |
| `seed` | number | 用于可复现生成的随机种子 |

### 请求示例

```javascript
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedance-v1.5-pro-image-to-video',
    image_url: 'https://example.com/image.jpg',
    prompt: 'Camera slowly pulls back to reveal the full landscape',
    duration: 6,
    resolution: '1080p',
    aspect_ratio: '16:9'
  })
});

const { data } = await response.json();
const taskId = data.task_id;
```

**仅含请求体的示例：**

```javascript
{
  model_name: 'seedance-v1.5-pro-image-to-video',
  image_url: 'https://example.com/image.jpg',
  prompt: 'Camera slowly pulls back to reveal the full landscape',
  duration: 6,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true
}
```

## 响应格式

### 初始响应

两种模型均返回用于轮询的 `task_id`：

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}
```

### 轮询响应

轮询 `GET /api/v1/video/{taskId}` 以检查状态：

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "credit": 0.2,
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}
```

### 状态值

- `submitted`：任务已接受，等待处理
- `processing`：视频生成中
- `succeed`：视频生成完成
- `failed`：视频生成失败

## 处理时间

典型处理时间：根据时长和分辨率，约需 2-5 分钟。

1080p 的较长视频最多可能需要 8 分钟。建议每 5-10 秒轮询一次以检查状态。

## 最佳实践

1. **清晰描述运动**：在提示词中加入具体的动作描述，以获得更可预期的结果
2. **分辨率选择**：快速迭代时使用 `480p` 或 `720p`，最终输出使用 `1080p`
3. **摄像机控制**：当希望主体成为焦点且不需要摄像机漂移时，设置 `camera_fixed: true`
4. **宽高比**：根据目标平台匹配宽高比（例如移动端使用 `9:16`，桌面端使用 `16:9`）
5. **可复现性**：使用 `seed` 参数复现或迭代特定的生成结果
6. **图像质量**：图像转视频时，使用高分辨率、光线充足的输入图像以获得最佳效果