面向文本转视频产品团队的 Seedance API

如果你的产品团队希望以最快且安全的方式评估 Seedance API 访问权限，那么第一步不是在第一天就搭建完整的视频工作流，而是用尽可能小的集成范围验证三个基础项：

1. 你的 Flatkey 密钥可以正确完成身份验证
2. 你的应用可以调用 https://router.flatkey.ai/v1
3. 在你接入异步视频任务之前，你的团队能够在 Usage Logs 中看到请求

这就是本页涵盖的低门槛快速开始。

截至 Friday, July 17, 2026，Flatkey 的公开快速开始仍然告诉开发者使用 Bearer auth、OpenAI 兼容的基础 URL https://router.flatkey.ai/v1，以及 POST /v1/chat/completions 来进行第一次冒烟测试。Flatkey 的实时模型目录也公开列出了用于文本转视频和图像转视频的 seedance-2.5，以及用于图像转视频的 seedance-2.0-i2v。Seedance 自己的公开 API 页面仍将视频工作流描述为 异步任务创建、状态轮询、webhook 和按使用量计费的 credits。

这种组合对入门很重要：路由器访问模式很简单，但实际的视频生成工作流并不是一次同步的聊天调用。产品团队应先用最小请求验证路由器，然后再切换为他们需要的模型和任务流程，以便评估 Seedance。

快速答案

当你希望用最少的移动部件获得一条可审查的 Seedance 入门路径时，请按这个顺序进行。

步骤	使用什么	证明什么
1. 创建密钥	以 sk-fk- 开头的 Flatkey API key	你的团队拥有有效凭证
2. 只设置一个基础 URL	https://router.flatkey.ai/v1	你的应用指向共享路由器，而不是某个特定提供方的端点
3. 运行最小冒烟测试	使用简单文本模型的 POST /v1/chat/completions	身份验证、请求头、路由和 Usage Logs 都能正常工作
4. 切换到 Seedance 路由	将占位模型替换为已批准的 Seedance 模型 ID	同一访问层现在可以支持你的视频评估工作流
5. 添加异步处理	视频任务的轮询或 webhook 逻辑	你的产品已经准备好进行真正的文本转视频执行

如果你只记住一件事，那就记住这个：第一次 cURL 请求是路由器连通性检查，而不是最终的文本转视频负载。

开始之前

你需要四样东西：

• 一个 Flatkey 账户
• 一个 Flatkey API key
• 用于该请求的一些预付 credits
• 就你实际想评估哪条 Seedance 路由做出产品决策

对于大多数文本转视频团队来说，公开模型目录已经足够清晰地展示了当前可选项，便于开启讨论：

Flatkey 上当前公开的模型信号	最佳用途
seedance-2.5	文本转视频评估，如有需要也可用于图像转视频
seedance-2.0-i2v	仅图像转视频

不要从旧截图或内部备注中硬编码模型名称。请在发布当天检查当前的模型目录或实时目录，因为视频路由的可用性可能比静态设置指南变化更快。

步骤 1：创建并保存 Flatkey API 密钥

在 Flatkey 控制台中创建一个 API 密钥，并将其保存为环境变量。

export FLATKEY_API_KEY="sk-fk-..."

这是团队最容易引入可避免阻力的第一步。请将密钥保存在服务端，而不是浏览器代码里，也不要放在共享的本地备注中。如果评估对象是产品团队而不是单个工程师，请从一开始就使用团队拥有的密钥。

步骤 2：运行尽可能小的路由器冒烟测试

Flatkey 目前的快速开始在第一次请求中使用 POST /v1/chat/completions。即使你的最终目标是 Seedance 视频生成，这样做也是正确的，因为它能在你加入异步工作流复杂性之前先验证共享访问层。

curl https://router.flatkey.ai/v1/chat/completions   -H "Authorization: Bearer $FLATKEY_API_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "Reply with the word connected."}
    ]
  }'

成功响应会立即告诉你五件有用的事：

• API 密钥有效
• Authorization: Bearer ... 头正确
• 基础 URL 正确
• 你的客户端可以成功 POST JSON
• 该请求应会出现在 Flatkey 使用日志中，并带有 token 计数和成本

这就是访问层正常工作的最小可审查证据。

步骤 3：了解冒烟测试请求实际上在检查什么

chat-completions 冒烟测试是故意设计得很简单。所需结构如下：

请求字段	为什么重要
Authorization 头	确认 Bearer token 格式
Content-Type: application/json	确认请求体能被正确解析
model	确认路由可以解析模型 ID
messages	确认请求体符合 OpenAI 兼容 schema

Flatkey 当前的 chat-completions 文档也指出了产品团队通常首先会检查的三个响应字段：

• choices[0].message.content
• model
• usage

最后一个字段对于入职尤其实用，因为它为产品和运维团队提供了一个共同的检查点，用来验证请求确实经过了路由器。

步骤 4：将占位模型替换为 Seedance 评估

一旦冒烟测试通过，请保持相同的凭证和相同的路由器基础 URL，然后只更改与你的视频工作流相关的部分。

保持以下内容不变：

• Authorization: Bearer $FLATKEY_API_KEY
• https://router.flatkey.ai/v1
• 你的服务端密钥处理
• 你的日志和计费审查路径

接下来更改这些：

烟雾测试之后会发生什么变化	为什么会变化
model	你会把占位的文本模型替换为已批准的 Seedance 模型 ID
请求体形状	视频生成需要自己的负载字段，而不仅仅是一个聊天 messages 数组
响应处理	视频工作流返回的是作业状态、资源或异步状态，而不是仅有的即时文本
产品逻辑	你需要轮询或 webhook，而不是把这次调用当作同步聊天来处理

对于文本转视频产品评估，发布日可安全使用的占位符是：

seedance-2.5

对于图像转视频评估，当前公开路径是：

seedance-2.0-i2v

把这些名称当作探索的起点，而不是承诺所有下游工作流都共享完全相同的负载形状。

第 5 步：围绕 Seedance 的异步视频工作流进行设计

这是大多数快速入门会跳过的一步。

Seedance 的公开 API 页面仍将该工作流描述为：

• 异步任务创建
• 状态轮询
• webhooks
• 按使用量计费的 credits

这意味着，生产团队应当假设真实的视频路径在自己的应用中至少需要四种状态：

作业状态	你的应用应做什么
queued	记录作业并显示请求已被接受
running	轮询状态或等待 webhook
succeeded	获取输出资源并附加元数据
failed	保存错误并决定是否重试

如果你的团队试图把 Seedance 当作同步聊天响应来处理，即使 API 表现正常，集成体验也会显得不稳定。

面向产品团队的实用上手顺序

如果你想要最小可行的评估流程，可以按这个顺序：

1. 创建 Flatkey 密钥。
2. 运行 chat/completions 烟雾测试。
3. 确认请求出现在 Usage Logs 中。
4. 选择你实际想测试的当前 Seedance 模型 ID。
5. 实现 Seedance 专用的异步请求流程。
6. 在扩大推广范围之前，先添加一个轮询路径或一个 webhook 路径。

这样可以降低上手风险，因为你将路由器验证与视频工作流实现分开了。

故障排查

第一次 cURL 请求返回 401 或 403

通常意味着密钥无效、已过期，或者没有作为 Bearer 令牌传递。

检查：

• 密钥以 sk-fk- 开头
• shell 变量确实已设置
• 请求头是 Authorization: Bearer ...

404 或路由不匹配

通常意味着你的应用指向了错误的 URL。

请使用：

https://router.flatkey.ai/v1

不要把请求指向营销网站，也不要去掉 /v1 后缀。

请求成功了，但 Usage Logs 仍然为空

Flatkey 的快速入门明确说明，要等待几秒后再搜索一次。如果日志仍然没有出现，请重新检查你实际发送的模型名称、API 密钥和基础 URL。

烟雾测试通过了，但 Seedance 工作流没有通过

这通常意味着访问层没问题，问题现在出在以下某个地方：

• Seedance 模型 ID 错误
• 视频负载结构错误
• 缺少异步轮询逻辑
• 尚未实现 webhook 处理
• 产品代码假设会得到同步文本响应

这是进展，不是失败。你已经把问题从身份验证和路由中隔离出来了。

什么时候这个快速入门已经足够

当你的团队需要回答以下问题时，这个快速入门就已经足够：

• 我们能通过 Flatkey 进行身份验证吗？
• 我们能复用现有的 OpenAI 兼容客户端路径吗？
• 产品和运维能在日志中看到这次请求吗？
• 我们能否先不添加另一个提供商密钥，就从文本烟雾测试切换到 Seedance 路由？

如果这四个问题的答案都是“是”，那么下一步的审批通常就与异步视频工作流和成本模型有关，而不是基础连通性。

如果在上线前你需要先看定价部分，请先查看 Flatkey 的实时定价页面，这样团队就可以用与生产环境相同的计费界面来批准评估。

常见问题

通过 Flatkey 测试 Seedance API 访问的最快方法是什么？

先使用 Flatkey 当前的 POST /v1/chat/completions 烟雾测试来验证身份验证、基础 URL 和使用日志。成功后，把占位模型替换为当前已批准的 Seedance 模型 ID，并构建异步视频工作流。

第一次 cURL 请求会生成视频吗？

不会。第一次 cURL 请求是对共享路由器的连通性检查。它会在你添加视频相关请求处理之前，证明你的密钥、请求头、基础 URL 和日志都能正常工作。

文本转视频团队应该从哪个 Seedance 模型开始？

截至 2026 年 7 月 17 日星期五，Flatkey 的公开模型目录将 seedance-2.5 列为文本转视频和图像转视频可用模型。在将其硬编码到产品代码之前，请再次检查当前的模型目录。

图像转视频团队应该从哪个 Seedance 模型开始？

截至 2026 年 7 月 17 日星期五，Flatkey 的公开目录将 seedance-2.0-i2v 列为图像转视频模型。

为什么入门流程从 chat completions 开始，而不是从视频任务开始？

因为 chat-completions 请求是证明你的 OpenAI 兼容路由路径可工作的最小可能证据。它把身份验证和日志记录问题与视频流水线问题区分开来。

我应该在第一次成功响应中检查什么？

检查 model、choices[0].message.content 和 usage，然后确认同一请求出现在 Usage Logs 中。

从烟雾测试切换到真正的 Seedance 评估时会发生什么变化？

密钥和基础 URL 保持不变。变化的是模型 ID、请求正文和异步任务处理。