> ## 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.

# API Keys & Billing

> 在 Krea 工作区创建和管理 API 密钥，为 API 余额充值，了解各模型定价与 API 计费方式，并跟踪用量，以可预测的成本构建集成。

## 创建 API 密钥

API token 分为两种：

* **个人 API token** 以**你本人**的身份运行：请求在你自己的 Krea 账户下执行，沿用你在工作区中的角色以及你对风格的访问权限。任何工作区成员都可以创建个人 token；如果你离开工作区，你的个人 token 将失效。
* **服务 API token** 以工作区中一个**独立的服务用户**身份运行，而不是以创建者的身份运行。只有工作区**所有者**和**管理员**可以创建服务 token。即使创建者离开工作区，服务 token 也会继续有效。工作区**所有者**和**管理员**可以查看工作区中的所有 token，并可查看每个服务 token 近 30 天的消费记录。

创建 API 密钥的步骤：

1. 前往 [krea.ai/app/api/tokens](https://www.krea.ai/app/api/tokens)
2. 点击 **Create Personal Token** 或 **Create Service Token**
3. 为你的密钥起一个具有描述性的名称
4. 妥善保存该 token——它只会显示一次！

> [!NOTE]
>
> 个人 API token 以你自己的 Krea 账户运行，因此你在应用中训练的风格可以直接使用。服务 API token 在你的工作区中拥有独立的用户身份：除非被共享到工作区，否则在应用中训练的风格不能通过服务 token 访问，通过服务 token 训练的风格也不会出现在应用中。详情请参阅 [训练自定义风格](https://www.krea.ai/docs/cn/developers/tutorials/train-image-style.md#use-your-trained-style)。

> [!WARNING]
>
> **安全准则**
>
> * 将 token 存储在环境变量中，切勿写入代码
> * 在开发和生产环境中使用不同的 token
> * 一旦泄露立即吊销 token
> * 切勿将 token 提交到版本控制
> * 切勿公开分享 token

## 使用 API 密钥

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

```javascript Node.js theme={"theme":{"light":"github-light-default","dark":"vesper"}}
// 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}`);
```

```bash cURL theme={"theme":{"light":"github-light-default","dark":"vesper"}}
curl -X POST https://api.krea.ai/generate/image/bfl/flux-1-dev \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a serene mountain landscape at sunset",
    "width": 1024,
    "height": 576
  }'
```

```python Python theme={"theme":{"light":"github-light-default","dark":"vesper"}}
import requests

API_BASE = "https://api.krea.ai"
API_TOKEN = "your-api-token"

response = requests.post(
    f"{API_BASE}/generate/image/bfl/flux-1-dev",
    headers={
        "Authorization": f"Bearer {API_TOKEN}",
        "Content-Type": "application/json"
    },
    json={
        "prompt": "a serene mountain landscape at sunset",
        "width": 1024,
        "height": 576
    }
)

job = response.json()
print(f"Job ID: {job['job_id']}")
```

```go Go theme={"theme":{"light":"github-light-default","dark":"vesper"}}
package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    apiBase := "https://api.krea.ai"
    apiToken := "your-api-token"

    payload := map[string]interface{}{
        "prompt": "a serene mountain landscape at sunset",
        "width":  1024,
        "height": 576,
    }

    jsonData, _ := json.Marshal(payload)
    req, _ := http.NewRequest("POST", apiBase+"/generate/image/bfl/flux-1-dev", bytes.NewBuffer(jsonData))
    req.Header.Set("Authorization", "Bearer "+apiToken)
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    var job map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&job)
    fmt.Printf("Job ID: %s\n", job["job_id"])
}
```

## 定价

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

## API 计费方式

直接 API 调用以及使用 API token 的 MCP 连接，会从工作区上一个**独立的 USD 余额**中扣费——与 Krea 网页应用使用的计算单元相互独立。使用 OAuth 的 MCP 连接则按计算单元计费，扣除自已登录的 Krea 账户。在使用 API 密钥之前，必须先为工作区启用 API 访问；如未启用，请联系 [support@krea.ai ↗](mailto:support@krea.ai)。

> [!NOTE]
>
> [Agent API](https://www.krea.ai/docs/cn/developers/agent.md) 和 Agent 工具是例外：Agent 的每一轮都使用工作区的计算单元余额，即使使用 API 密钥认证也是如此，不会使用 API 余额。

> [!TIP]
>
> 失败和被取消的任务不会计费。你只需为已完成的任务付费。

### 余额耗尽时

进行中的任务会正常完成。新的 API 请求将以 **HTTP 402 Payment Required** 被拒绝：

```json theme={"theme":{"light":"github-light-default","dark":"vesper"}}
{
  "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/](https://krea.ai/app/api/) 充值以恢复使用。目前没有用于以编程方式查询余额的公开端点——请在应用内监控余额。

上述响应体是 API 余额不足时返回的 `402`。Zero Data Retention 及其他 `402` 响应请参阅 [错误与调试](https://www.krea.ai/docs/cn/developers/errors-and-debugging.md)。

## 添加 API 余额

在 [krea.ai/app/api/](https://krea.ai/app/api/) 添加资金。只有工作区**所有者**可以添加 API 余额。

* **预设金额：** \$10、\$25、\$50、\$100
* **自定义金额：** 最低 \$5，最高 \$10,000
* 通过 Stripe Checkout 支付；支付成功后余额立即生效

## 跟踪用量

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

## 企业版

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

## 后续步骤

> [card] [交互式 Playground](https://www.krea.ai/docs/developers/interactiveexample.md)
>
> 发起你的第一个 API 请求

> [card] [模型 API](https://www.krea.ai/docs/api-reference/introduction.md)
>
> 浏览所有可用端点

> [card] [任务生命周期](https://www.krea.ai/docs/developers/job-lifecycle.md)
>
> 了解任务状态与轮询

> [card] [速率限制](https://www.krea.ai/docs/developers/rate-limits.md)
>
> 了解各计划层级的 API 限制


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