---
title: 如何生成视频
sidebarTitle: 如何生成视频
description: 使用 Apifox 和可灵模型，完成第一次视频生成。
---

这篇教程只做一件事：**用一句话生成一段视频**。

不需要写代码。你只需要安装 Apifox，然后按页面填写内容并点击发送。

整个过程分为三步：

1. 提交视频生成任务。
2. 等待视频生成完成。
3. 打开或下载视频。

<Warning>
提交视频生成任务会消耗账户余额。开始前可以先到[模型广场](https://infistar.cc/pricing)查看当前模型和价格。发送成功后不要重复提交同一个任务。
</Warning>

## 第一步：准备 API Key

API Key 可以理解为账户的“调用密码”。

1. 登录[无限星河AI 控制台](https://infistar.cc/console)。
2. 打开 **令牌管理**，点击 **添加令牌**。
3. 不知道如何选择分组时，点击 **新手入口**。
4. 创建后，复制以 `sk-` 开头的 API Key。

不要把 API Key 发给别人，也不要让它出现在截图或公开网页中。

## 第二步：在 Apifox 新建请求

Apifox 是一个可以帮你发送 API 请求的客户端，不需要输入终端命令。

第一次使用 Apifox 时，可以先看 [Apifox 使用教程](/client-integrations/apifox)，认识请求方式、地址、Headers 和 Body 的位置。

1. 前往 [Apifox 官网](https://apifox.com/)下载并安装客户端。
2. 打开 Apifox，新建或进入一个项目。
3. 点击左侧的 **+**，选择 **快捷请求**。

![在 Apifox 中新建快捷请求](/images/tutorials/api/apifox-quick-request.png)

## 第三步：提交视频任务

在新打开的请求页面中填写以下内容。

### 1. 填写请求地址

- 请求方式选择 `POST`。
- 地址填写：

```text
https://infistar.cc/v1/videos
```

### 2. 填写 Headers

打开 **Headers**，添加下面两行：

| 参数名 | 参数值 |
| --- | --- |
| `Authorization` | `Bearer 你的API Key` |
| `Content-Type` | `application/json` |

例如你的 API Key 是 `sk-abc`，第一行的参数值就填写 `Bearer sk-abc`。`Bearer` 后面要保留一个空格。

### 3. 填写 Body

打开 **Body**，选择 **json**，粘贴下面的内容：

```json
{
  "model": "kling-v2-6",
  "prompt": "清晨的湖面上有一艘木船缓慢前行，薄雾轻轻散开，电影感镜头",
  "seconds": "5",
  "size": "1280x720"
}
```

这几个参数分别表示：

| 参数 | 作用 |
| --- | --- |
| `model` | 使用哪个视频模型 |
| `prompt` | 你想生成什么画面 |
| `seconds` | 视频时长 |
| `size` | 视频尺寸 |

想更换画面时，只修改 `prompt` 后面的中文描述即可。模型、时长和尺寸是否支持，请以[模型广场](https://infistar.cc/pricing)当前信息为准。

### 4. 发送请求

点击 **发送**。发送成功后，在下方返回结果中找到 `id`，例如：

```json
{
  "id": "task_xxxxxxxxxxxx",
  "status": "queued"
}
```

复制并保存 `id` 后面的完整内容。它是这次视频的**任务 ID**，相当于取件号。

## 第四步：查看生成进度

视频需要等待一段时间才能生成完成。

1. 在 Apifox 中再新建一个 **快捷请求**。
2. 请求方式选择 `GET`。
3. 地址填写 `https://infistar.cc/v1/videos/你的任务ID`。
4. 在 **Headers** 中添加 `Authorization`，参数值仍为 `Bearer 你的API Key`。
5. 点击 **发送**，查看返回结果中的 `status`。

例如任务 ID 是 `task_123`，查询地址就是：

```text
https://infistar.cc/v1/videos/task_123
```

| 看到的状态 | 表示什么 | 接下来怎么做 |
| --- | --- | --- |
| `queued` | 正在排队 | 等待约 10 秒，再发送一次查询请求 |
| `in_progress` | 正在生成 | 等待约 10 秒，再发送一次查询请求 |
| `completed` | 已经完成 | 查看或下载视频 |
| `failed` | 生成失败 | 查看返回结果中的 `error` |

等待时只需要重新发送**查询请求**，不要重新发送第三步的视频生成请求，否则可能创建多个任务并重复扣费。

## 第五步：查看视频

当 `status` 变成 `completed` 后：

- 如果返回结果中有 `metadata.url`，复制这个网址，在浏览器中打开即可查看视频。
- 如果没有视频网址，再新建一个 `GET` 请求，地址填写 `https://infistar.cc/v1/videos/你的任务ID/content`，添加相同的 `Authorization` 后发送，然后使用 Apifox 响应区域的下载功能保存视频。

## 常见问题

- **提示 401**：API Key 填写错误，或 `Bearer` 后面没有空格。
- **提示 402**：账户余额不足，需要先充值或兑换额度。
- **提示 404**：检查请求地址和任务 ID 是否填写完整。
- **提示模型不可用**：前往[模型广场](https://infistar.cc/pricing)确认当前可用的模型 ID。
- **一直显示排队**：视频生成通常比文字对话慢，请保留任务 ID，稍后继续查询。
