跳转到主要内容

​
创建 API 密钥

只有工作区所有者和管理员可以创建 API token。如果你看不到创建 token 的选项，请联系你的工作区所有者申请访问权限或更高级别的角色。 创建 API 密钥的步骤：
  1. 前往 krea.ai/settings/api-tokens
  2. 确保你处于正确的工作区（使用左上角的工作区切换器）
  3. 点击 “New Token”
  4. 为你的 token 起一个具有描述性的名称
  5. 妥善保存该 token——它只会显示一次！
API 在你的工作区中拥有独立的用户身份。除非被共享到工作区，否则在应用中训练的风格不能通过 API 访问，通过 API 训练的风格也不会出现在应用中。详情请参阅 训练自定义风格。
安全准则
  • 将 token 存储在环境变量中，切勿写入代码
  • 在开发和生产环境中使用不同的 token
  • 一旦泄露立即吊销 token
  • 切勿将 token 提交到版本控制
  • 切勿公开分享 token

​
使用 API 密钥

在所有请求的 Authorization 请求头中携带你的 token： 
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";

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

const job = await krea.image("bfl/flux-1-dev", {
  prompt: "a serene mountain landscape at sunset",
  width: 1024,
  height: 576
});

console.log(`Job ID: ${job.job_id}`);

​
定价

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

​
API 计费方式

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

​
余额耗尽时

进行中的任务会正常完成。新的 API 请求将以 HTTP 402 Payment Required 被拒绝： 
{
  "message": "Your API balance is separate from your workspace compute balance. Please top up your API balance to continue using the API."
}
前往 krea.ai/app/api/ 充值以恢复使用。目前没有用于以编程方式查询余额的公开端点——请在应用内监控余额。

​
添加 API 余额

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

​
跟踪用量

近期消费会显示在 krea.ai/app/api/ 的 API 余额卡片上，位于 “API cost in the last 7 days” 一栏。

​
企业版

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

​
后续步骤

交互式 Playground

发起你的第一个 API 请求

模型 API

浏览所有可用端点

任务生命周期

了解任务状态与轮询

速率限制

了解各计划层级的 API 限制