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

# 在 Krea 上使用 ByteDance Seedance API

> 通过 Krea API 使用 ByteDance Seedance 2.5 和 2.0。借助 REST 与 JavaScript 示例、API 密钥和定价链接，从文本或图像生成视频。

Krea 提供 ByteDance Seedance 视频生成模型的 API 访问。在 Krea 上使用 Seedance API，你可以从文本生成视频、让图像动起来，或借助图像、视频和音频参考来引导生成。请求使用 Krea API token 和 `https://api.krea.ai` 基础 URL。

## 可用的 Seedance API 模型

| 模型 | POST 端点 | 视频时长 | 输出分辨率 |
| - | - | - | - |
| Seedance 2.5 | `/generate/video/bytedance/seedance-2-5` | 4–30 秒 | 480p、720p、1080p |
| Seedance 2.0 | `/generate/video/bytedance/seedance-2` | 4–15 秒 | 480p、720p、1080p、4K |
| Seedance 2.0 Fast | `/generate/video/bytedance/seedance-2-fast` | 4–15 秒 | 480p、720p |
| Seedance 2.0 Mini | `/generate/video/bytedance/seedance-2-mini` | 4–15 秒 | 480p、720p |

这些模型支持文本生成视频、首帧与尾帧、参考媒体以及原生音频。各模型当前的请求结构请参阅 [API 参考](https://www.krea.ai/docs/api-reference/introduction.md)。提交任务前请查看 [API 定价 ↗](https://www.krea.ai/app/api/pricing)；价格取决于模型和生成设置。

> [!NOTE]
>
> Krea 的 Seedance 2.0 和 2.0 Fast 端点在基础模型之外还提供可选的 Krea 提示词增强和超分放大。Seedance 2.5 提供可选的 Krea 提示词增强。对于带有 `reference_videos` 的 Seedance 2.5 视频编辑请求，输出时长和宽高比取决于源视频；这类请求会忽略 `duration` 和 `aspect_ratio`。

## 获取 Seedance API 密钥

按照 [API 密钥与计费](https://www.krea.ai/docs/cn/developers/api-keys-and-billing.md) 创建 Krea API token 并为 API 余额充值。将 token 存储在服务器的 `KREA_API_KEY` 环境变量中，并以 `Authorization: Bearer $KREA_API_KEY` 的形式发送；切勿在浏览器代码中暴露它。

Krea 应用算力与 API 余额相互独立。通过 Krea API 发起的 Seedance 请求使用你所在工作区的 API 余额。

## 生成视频

向 Seedance 2.5 端点提交提示词即可进行文本生成视频。以下示例请求一段 5 秒、720p 的横向视频。

```bash cURL theme={"theme":{"light":"github-light-default","dark":"vesper"}}
curl --fail-with-body https://api.krea.ai/generate/video/bytedance/seedance-2-5 \
  -H "Authorization: Bearer $KREA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A slow camera orbit around a ceramic vase in warm studio light",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'
```

```javascript JavaScript theme={"theme":{"light":"github-light-default","dark":"vesper"}}
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

const job = await krea.video("bytedance/seedance-2-5", {
  prompt: "A slow camera orbit around a ceramic vase in warm studio light",
  duration: 5,
  aspect_ratio: "16:9",
  resolution: "720p"
});

const completed = await krea.jobs.wait(job.job_id);
console.log(completed.result.urls[0]);
```

使用 `npm install @krea-ai/sdk` 安装 JavaScript SDK。REST 请求返回的是 `job_id`，而不是生成好的视频。每隔 2–5 秒轮询一次 `GET /jobs/{job_id}`，直到 `status` 变为 `completed`，然后从 `result.urls[0]` 读取视频 URL。当状态为 `failed` 或 `cancelled` 时停止轮询。SDK 的 `jobs.wait` 方法会替你处理轮询。

```bash cURL theme={"theme":{"light":"github-light-default","dark":"vesper"}}
curl --fail-with-body "https://api.krea.ai/jobs/YOUR_JOB_ID" \
  -H "Authorization: Bearer $KREA_API_KEY"
```

在生产环境集成中，请使用 [webhooks](https://www.krea.ai/docs/cn/developers/webhooks.md) 接收完成事件。有关任务状态和失败处理，请参阅 [任务生命周期](https://www.krea.ai/docs/cn/developers/job-lifecycle.md) 和 [错误与调试](https://www.krea.ai/docs/cn/developers/errors-and-debugging.md)。

## 让图像动起来

进行 Seedance 图生视频时，使用同一个端点，并在请求中添加 `start_image`。可传入公开可访问的图像 URL、已上传资源的 URL 或 base64 data URI。

```json theme={"theme":{"light":"github-light-default","dark":"vesper"}}
{
  "prompt": "The camera slowly moves closer as soft light shifts across the scene",
  "start_image": "https://your-domain.example/product.png",
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "720p"
}
```

将 `start_image` 替换为你自己的图像 URL。如需控制最后一帧，请添加 `end_image`。如需参考引导生成，请根据所选模型的 [API 结构](https://www.krea.ai/docs/api-reference/introduction.md) 使用 `reference_images`、`reference_videos` 和 `reference_audios`。

## 常见问题

### Krea 是否提供 ByteDance Seedance API？

是的。Krea 通过位于 `https://api.krea.ai` 的 REST API 提供 ByteDance Seedance 2.5、Seedance 2.0、Seedance 2.0 Fast 和 Seedance 2.0 Mini。使用 Krea API token 进行身份验证，并向上文列出的 Seedance 端点提交请求即可。

### Seedance 能同时用于文本生成视频和图生视频吗？

可以。发送 `prompt` 即可进行文本生成视频，添加 `start_image` 即可让图像动起来。两种工作流使用同一个 Seedance 模型端点，并返回一个异步任务。

### 我需要单独的 ByteDance API 密钥吗？

不需要。通过 Krea 调用 Seedance 使用的是你的 Krea API token 和工作区 API 余额。这些请求无需另外发送 ByteDance 凭证。

### Krea 上的 Seedance API 费用是多少？

当前 Seedance 价格和可用设置请参阅 [Krea API 定价 ↗](https://www.krea.ai/app/api/pricing)。API 用量与 Krea 应用算力分开计费。失败和取消的任务不会计费。

### 我可以从 AI agent 调用 Seedance 吗？

可以。将 agent 连接到 [Krea MCP 服务器](https://www.krea.ai/docs/cn/developers/mcp.md)，即可发现可用的视频模型及其结构。你也可以直接在应用中调用 REST API 或 JavaScript SDK。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.