跳转到主要内容

创建 API 密钥

API token 分为两种:
  • 个人 API token 以你本人的身份运行:请求在你自己的 Krea 账户下执行,沿用你在工作区中的角色以及你对风格的访问权限。任何工作区成员都可以创建个人 token;如果你离开工作区,你的个人 token 将失效。
  • 服务 API token 以工作区中一个独立的服务用户身份运行,而不是以创建者的身份运行。只有工作区所有者和管理员可以创建服务 token。即使创建者离开工作区,服务 token 也会继续有效。工作区所有者和管理员可以查看工作区中的所有 token,并可查看每个服务 token 近 30 天的消费记录。
创建 API 密钥的步骤:
  1. 前往 krea.ai/app/api/tokens
  2. 点击 Create Personal Token 或 Create Service Token
  3. 为你的密钥起一个具有描述性的名称
  4. 妥善保存该 token——它只会显示一次!
个人 API token 以你自己的 Krea 账户运行,因此你在应用中训练的风格可以直接使用。服务 API token 在你的工作区中拥有独立的用户身份:除非被共享到工作区,否则在应用中训练的风格不能通过服务 token 访问,通过服务 token 训练的风格也不会出现在应用中。详情请参阅 训练自定义风格。
安全准则
  • 将 token 存储在环境变量中,切勿写入代码
  • 在开发和生产环境中使用不同的 token
  • 一旦泄露立即吊销 token
  • 切勿将 token 提交到版本控制
  • 切勿公开分享 token

使用 API 密钥

在所有请求的 Authorization 请求头中携带你的 token:

定价

各模型的具体价格请参阅 krea.ai/features/api ↗。每个模型都有由请求参数(分辨率、质量、音频、时长、风格参考等)决定的固定单次生成价格。

API 计费方式

直接 API 调用以及使用 API token 的 MCP 连接,会从工作区上一个独立的 USD 余额中扣费——与 Krea 网页应用使用的计算单元相互独立。使用 OAuth 的 MCP 连接则按计算单元计费,扣除自已登录的 Krea 账户。在使用 API 密钥之前,必须先为工作区启用 API 访问;如未启用,请联系 support@krea.ai ↗。
Agent API 和 Agent 工具是例外:Agent 的每一轮都使用工作区的计算单元余额,即使使用 API 密钥认证也是如此,不会使用 API 余额。
失败和被取消的任务不会计费。你只需为已完成的任务付费。

余额耗尽时

进行中的任务会正常完成。新的 API 请求将以 HTTP 402 Payment Required 被拒绝:
前往 krea.ai/app/api/ 充值以恢复使用。目前没有用于以编程方式查询余额的公开端点——请在应用内监控余额。 上述响应体是 API 余额不足时返回的 402。Zero Data Retention 及其他 402 响应请参阅 错误与调试。

添加 API 余额

在 krea.ai/app/api/ 添加资金。只有工作区所有者可以添加 API 余额。
  • 预设金额: $10、$25、$50、$100
  • 自定义金额: 最低 $5,最高 $10,000
  • 通过 Stripe Checkout 支付;支付成功后余额立即生效

跟踪用量

前往 krea.ai/app/api/usage 的 API 用量页面,查看所选日期范围内已完成的 API 任务及预估费用。工作区管理者可以查看整个工作区的用量;其他成员只能查看自己 token 产生的用量。krea.ai/app/api/ 的 API 余额卡片也会显示近 7 天的预估 API 费用。

企业版

高用量客户可以采用 Net 30 条款按月开票,无需预付。如需洽谈企业计费,请联系 sales@krea.ai ↗。

后续步骤

交互式 Playground

发起你的第一个 API 请求

模型 API

浏览所有可用端点

任务生命周期

了解任务状态与轮询

速率限制

了解各计划层级的 API 限制