AI 视频生成器 API：访问、定价、集成与生产指南

AI 视频生成器 API：访问、定价、集成与生产指南

AI 视频生成器 API是一种在产品或工作流中根据文本、图像、音频或参考视频创建短视频的方式。API 调用只是开始。生产环境实现还需要做出模型访问决策、制定反映已接受输出而非仅反映尝试渲染的预算、建立异步作业工作流，以及规划如何存储和监控已完成的资产。

本指南为产品团队提供了一种持久有效的方法来做出这些决策。它以当前公开的 API 文档为示例，但将模型名称、参数、可用性和价格视为应在上线前立即验证的输入项。

简要回答：选择能够提供你实际所需控制能力的访问路径，根据提供商的实际计费单位统一成本口径，将视频生成建模为异步作业，并在做出生产承诺前测试一批具有代表性的样本。对大多数团队而言，有用的运营指标是每个被接受片段的成本，而不是每秒的标价。

AI 视频生成器 API 实际做什么

大多数视频 API 会创建长时间运行的生成任务，而不是在同一个 HTTP 响应中返回 MP4。基本生命周期如下：

1. 你的应用发送提示词和可选的参考媒体。
2. 提供商或网关创建任务或操作。
3. 你的工作进程轮询任务、接收 webhook，或同时采用两种方式。
4. 当作业进入终态时，你的应用检索输出、持久化资产元数据，并使该片段可供用户使用。

Google 的 Veo 文档明确将视频工作描述为一项长时间运行的操作，必须持续检查直至报告完成。Flatkey 当前的 Seedance 2.5 模型页面遵循相同的运营模式：提交到 /v1/videos，保留任务 ID，轮询状态，并获取已完成的内容。这意味着，AI 视频生成器 API应位于你自己系统中的作业记录之后，而不是置于等待最终资产的请求处理程序中。

API 可能支持多种创意输入：

模型能力并非某个类别范围内的承诺。例如，当前 Flatkey Seedance 2.5 页面记录了其路由上的文本转视频、图像转视频和参考内容转视频，同时将视频编辑和视频延长标记为不可用。请将你要发布的确切模型 ID 的实时模型页面或提供商 API 参考文档视为合同。

如何选择访问方式：直接提供商还是多模型网关

访问视频模型有两种合理的方式。没有哪一种在所有情况下都更好。

Flatkey 是第二种模式的一个示例。其文档描述了一个用于共享模型目录、兼容 OpenAI 的基础 URL，而其视频模型页面记录了适用于所选路由的视频特定合同。这一区别很重要：账户和路由层的兼容性并不意味着每个媒体模型都使用 chat-completions 载荷。

作为一个具体的当前路由，Flatkey 在 POST /v1/videos 上记录了 Seedance 2.5，并使用 content[] 请求体。该页面列出了文本、图像、视频和音频参考内容；还列出了路由特定的输出设置和基于任务的检索流程。请先阅读实时 Seedance 2.5 模型合同，然后有意发起一个小型调用，使用与你计划中的产品工作流相同的时长、分辨率、宽高比和参考媒体模式。

一个简单的访问决策

如果你的发布依赖某项特定提供商独有的能力，并且你具备负责该集成的运营能力，请选择直接 API。如果你的首要问题是模型评估、路由可移植性，或是在更大型产品中整合凭据和计费，请选择一个公开多个模型的访问层。

在这两种情况下，都应将提供商/模型名称、请求结构和返回的任务 ID 保存在自己的数据库中。这样才能在日后切换模型、复盘事件或对账成本时有所依据。

AI 视频生成器 API 定价：先比较计费单位，再比较费率

定价很容易被误读，因为各视频提供商的计费方式并不相同。一种路径可能按生成秒数定价，另一种可能根据消耗的令牌计算成本，而网关可能显示按路径区分的实时费率。这些并不是电子表格中可以互换的列。

Google Gemini API 定价页面按生成秒数、模型变体和分辨率列出了当前 Veo 付费层级费率。BytePlus ModelArk 定价文档指出，实际视频消耗量由调用后返回的 completion_tokens 决定。Flatkey 的 Seedance 2.5 页面按路径和输出设置展示当前目录定价。应将这些页面用作上线当天的核查，而不要把它们当作永久价格表复制到代码中。

使用每条通过审核片段的成本

对于 AI 视频生成器 API，决策指标通常不是每次请求的成本，而是符合预期用途的质量和政策规则的视频片段成本。

每条通过审核片段的成本 = 可计费生成总支出 / 通过审核的片段数

对于上线预测：

预估支出 = 计划尝试次数 × 每次尝试的预估成本
预期通过审核的片段数 = 计划尝试次数 × 观察到的通过率
预估每条通过审核片段的成本 = 预估支出 / 预期通过审核的片段数

在完成一个小型代表性批次后进行此计算。如果模型需要多次重试或人工返工，较低的每秒费率反而可能导致每条通过审核片段的成本更高。反之，对于通过率高且编辑轮次较少的工作流，较高的单次尝试费率可能更具经济性。

在扩大支出之前，请为每个测试任务记录以下所有字段：

• 模型 ID 以及提供商或网关路径；
• 请求和实际交付的时长、分辨率及宽高比；
• 输入类型和参考资产数量；
• 提供商任务 ID 以及您自己的任务 ID；
• 报告的用量和计费金额；
• 终态状态和重试原因；
• 审核通过决定及原因；以及
• 拥有该任务的营销活动、客户或产品功能。

如需了解适用于文本、图像和视频工作负载的完整预算工作表，请参阅如何预测多模型 AI API 支出。

将 AI 视频生成器 API 集成为异步任务

不要让浏览器等待视频提供商。持久化保存任务，将工作加入队列，并让工作进程负责提交和轮询。客户端会立即收到您的任务 ID，并可以检查您应用程序的状态端点。

当前 Flatkey Seedance 请求示例

以下是基于当前已记录的 Seedance 2.5 请求结构而编写的小型、特定路径的冒烟测试。请将密钥保存在服务器上。在生产环境中使用前，请再次核实实时路径、账户可用性和确切的模型页面。

curl https://router.flatkey.ai/v1/videos \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -d '{
    "model": "seedance-2.5",
    "content": [
      {
        "type": "text",
        "text": "A clean product video, natural light, slow camera move."
      }
    ],
    "ratio": "adaptive",
    "resolution": "720p",
    "duration": 5,
    "generate_audio": true
  }'

响应会提供一个任务标识符。请将完整响应与您的应用任务一同存储，然后轮询文档中说明的任务端点，而不要猜测结束时间：

curl "https://router.flatkey.ai/v1/videos/TASK_ID" \
  -H "Authorization: Bearer $FLATKEY_API_KEY"

在任务成功完成后，从文档中说明的内容路由获取已完成的内容。不要假设每个提供商都采用完全相同的端点或响应结构。例如，Google 会返回一个长时间运行的操作，必须持续检查，直到 done 为 true，然后才能下载结果。应用侧适配器可将这些差异隔离在产品代码之外。

type VideoJob = {
  id: string;
  provider: string;
  model: string;
  providerTaskId?: string;
  status: "queued" | "submitted" | "running" | "succeeded" | "failed";
};

async function submitFlatkeySeedance(job: VideoJob, prompt: string) {
  const response = await fetch("https://router.flatkey.ai/v1/videos", {
    method: "POST",
    headers: {
      "content-type": "application/json",
      authorization: `Bearer ${process.env.FLATKEY_API_KEY}`,
    },
    body: JSON.stringify({
      model: "seedance-2.5",
      content: [{ type: "text", text: prompt }],
      ratio: "adaptive",
      resolution: "720p",
      duration: 5,
      generate_audio: true,
    }),
  });

  if (!response.ok) throw new Error(`Video submission failed: ${response.status}`);
  return response.json(); // Persist the returned task identifier with job.id.
}

上述适配器刻意不硬编码响应字段或终态字符串。请存储提供商响应，将其映射到您自己的标准化状态机，并将该映射保留在靠近提供商集成的位置。

防止高昂意外成本的生产控制措施

AI 视频生成器 API需要与其他任何按量计费的异步依赖项相同的工程纪律，另外还需要资产管理和人工质量审核。

1. 让重复提交无从发生

根据您的任务 ID 和提交的修订版本创建应用级幂等键。如果工作进程在提供商接受任务后、数据库更新前崩溃，安全重试必须先确定是否已存在提供商任务 ID。不要盲目地将同一个创意任务提交两次。

2. 使用有界重试

仅重试被您的集成分类为暂时性的错误。设置最大尝试次数，记录之前的提供商任务 ID，并在预算或重试限制用尽时停止。验证错误、策略拦截或无效输入资产应得到面向用户的说明，而不是自动重新提交。

3. 保持资产持久且访问受控

参考资产在请求期间需要稳定且已获授权的 URL。生成后，应根据您的存储和保留策略复制或持久化输出，而不是永久依赖临时的提供商 URL。将输入资产哈希和输出位置与任务元数据一同记录。

4. 将创意验收与 API 成功分开

succeeded 表示 API 创建了输出；并不表示该输出适合客户、营销活动或产品界面。添加一个轻量级验收结果——自动、人工或两者兼有——并记录片段被拒绝的原因。这些数据将用于计算您的每个获接受片段成本。

5. 关注模型生命周期

视频模型参数和可用性变化很快。Google 当前的 Veo 文档区分了模型生命周期状态，并引导开发者查看特定模型的限制；Flatkey 的模型页面列出了当前路由字段和可用性。每当更改模型、分辨率、音频、参考媒体行为或提供商路由时，都应重新运行冒烟测试。

6. 将真实可信的媒体政策纳入工作流

获取参考资产的权利，在发布渠道要求披露时向用户提供清晰说明，并在上线前确定对合成人物、品牌和敏感内容的处理方式。提供商的接受并不能替代您产品的政策或法律审查。

如需了解涵盖队列、Webhook、重试、存储和监控的详细运营清单，请阅读面向文生视频团队的 Seedance API 生产清单。

7 步上线计划

1. 编写一个可测试的用例。定义受众、宽高比、时长、可接受的瑕疵，以及由谁批准输出。
2. 选择两到三个路由进行测试。比较确切的模型 ID 和请求结构，而不是基于品牌层面的假设。
3. 创建一小批具有代表性的样本。包含用户实际会提交的提示词和参考媒体条件。
4. 记录每次尝试的成本和结果。捕获用量、任务状态、时长、重试和验收决策。
5. 选择预算护栏。设置每个任务的最大尝试次数，以及每个获接受片段的成本阈值。
6. 在异步队列后上线。持久化您自己的任务状态、提供商任务 ID 和输出元数据。
7. 安排重新验证。在提高量级或推出新的创意工作流之前，重新检查当前模型页面、价格、限制和生命周期。

如果您的产品将在文本、图像、音频和视频模型之间进行路由，也请参考这份多模态代理路由指南，规划回退和可观测性方案。

AI 视频生成器 API 生产清单

• [ ] 已记录确切的模型 ID、提供商/网关路由和生命周期状态。
• [ ] 请求契约取自当前有效的模型/API 文档。
• [ ] 您的应用将该任务作为异步任务处理，并保留持久化的提供商任务 ID。
• [ ] 您的重试系统可防止重复付费提交。
• [ ] 已根据具有代表性的批次验证计费单位。
• [ ] 团队跟踪每个已接受片段的成本，而不仅是标称费率。
• [ ] 参考资产和输出资产具有已记录的存储和保留路径。
• [ ] 已针对该用例定义输出审核、安全处理和用户披露。
• [ ] 在扩大流量之前，已安排模型/页面重新验证。

如果 Veo 在您的候选清单中，请阅读 Veo 3 定价（2026 年 10 月），了解 Vertex AI 费率以及取代 Gemini API 预览模型的方案。

常见问题

什么是 AI 视频生成器 API？

AI 视频生成器 API允许软件根据文本、图像、音频或其他参考媒体请求生成视频。在生产环境中，它通常以异步任务方式运行：提交请求、保留任务或操作 ID、检查状态并获取完成的结果。

AI 视频生成器 API 的费用是多少？

这取决于具体路由和计费单位。目前公开的示例包括 Google Veo 按生成秒数计费、直接使用 BytePlus ModelArk Seedance 的 Token 消耗计费，以及 Flatkey Seedance 路由的实时按秒目录价格。在预测支出之前，请匹配模型、分辨率、时长、输入媒体、重试次数和接受率。

我可以用一个 API 同时实现文生视频和图生视频吗？

某些模型路由支持两者，但具体细节因模型而异。Flatkey 当前的 Seedance 2.5 页面记录了 /v1/videos 上的文生视频和图生视频；在实施前，请验证实时路由支持的内容角色、限制和输出设置。

我应该使用轮询还是 Webhook？

请使用所选提供商文档中规定的机制。当存在任务状态端点时，轮询是一个安全的起点。Webhook 可以减少轮询并加快应用更新，但仍应进行验证、去重，并与您存储的任务状态进行核对。

如何安全地切换视频模型？

应将模型切换视为受控评估。保持应用任务架构稳定，为新路由添加提供商适配器，测试同一具有代表性的批次，比较每个已接受片段的成本，并为两个版本保留模型 ID 和任务元数据。在更换提供商之前，模型价格比较工作流是很有用的配套参考。

从可衡量的试点开始

最佳的AI 视频生成器 API并非演示效果最令人印象深刻的那个；而是能够满足您的创意需求、契合您的运营设计，并在您可持续承担的预算内产出已接受片段的路由。先从一个路由、一个真实批次和一份完整的任务记录开始。然后利用结果数据决定是调整提示词系统、更换模型，还是增加另一条路由。

浏览当前的Flatkey 模型目录，验证实时的Seedance 2.5 API 和定价页面，并在提高生产限额之前运行一个小型异步试点。

来源

• Flatkey 文档
• Flatkey Seedance 2.5 模型页面
• Google：在 Gemini API 中使用 Veo 3.1 生成视频
• Google Gemini API 定价
• BytePlus ModelArk：创建视频生成任务
• BytePlus ModelArk 定价