> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vibetoken.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# Wan 2.7 — 图生视频

> 使用文本提示词，将一张静态图像动画化，由 Wan 2.7 驱动。

|           |                       |
| --------- | --------------------- |
| **模型 ID** | `alibaba/wan-2-7-i2v` |
| **系列**    | `wan-2-7-novita`      |
| **任务**    | `image-to-video`      |
| **模态**    | 视频                    |
| **上游**    | Alibaba Wan 2.7       |

## 接口

```http theme={null}
POST https://vibetoken.cn/v1/videos/generations
```

异步 — 返回 `{id, status: "pending"}`；轮询
`GET /v1/videos/generations/{id}`，直到状态为 `success` 或 `failed`。

## 参数

<ParamField body="prompt" type="string" required>
  描述运动效果以及相对源图像变化的文本提示词。
  最多 5000 个字符。
</ParamField>

<ParamField body="image_urls" type="string[]" required>
  恰好一个源图像 URL（PNG / JPEG，需可通过 HTTPS
  公开访问）。
</ParamField>

<ParamField body="resolution" type="&#x22;720P&#x22; | &#x22;1080P&#x22;" default="&#x22;1080P&#x22;">
  输出分辨率。决定每秒费率（$0.10/s 对比 $0.15/s）。
</ParamField>

<ParamField body="duration" type="integer" default="5">
  生成片段的时长（秒）。范围 `[2, 15]`。
</ParamField>

<ParamField body="last_frame_url" type="string">
  可选的公开 HTTPS URL，用于固定输出的最后一帧。
</ParamField>

<ParamField body="driving_audio_url" type="string">
  可选 URL，指向用于驱动运动 / 口型同步的参考音轨。
</ParamField>

<ParamField body="negative_prompt" type="string">
  引导模型避开的内容。最多 500 个字符。
</ParamField>

<ParamField body="prompt_extend" type="boolean" default="true">
  模型是否应在生成前扩展提示词。
</ParamField>

<ParamField body="watermark" type="boolean" default="false">
  是否在输出上叠加上游水印。
</ParamField>

<ParamField body="seed" type="integer">
  随机数生成器初始化种子。范围 `[0, 2147483647]`。
</ParamField>

## 示例

```bash theme={null}
curl https://vibetoken.cn/v1/videos/generations \
  -H "Authorization: Bearer $VIBETOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-2-7-i2v",
    "prompt": "the cat slowly turns its head and blinks",
    "image_urls": ["https://example.com/cat.jpg"],
    "resolution": "1080P",
    "duration": 5
  }'
```

```json theme={null}
{ "id": "wan_def456…", "status": "pending", "model": "alibaba/wan-2-7-i2v" }
```

轮询直到终态：

```bash theme={null}
curl https://vibetoken.cn/v1/videos/generations/wan_def456… \
  -H "Authorization: Bearer $VIBETOKEN_API_KEY"
```

```json theme={null}
{
  "id": "wan_def456…",
  "status": "success",
  "data": [{ "url": "https://…mp4" }]
}
```

## 参考