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

> 创建和管理 API 密钥、为 API 余额充值，并了解各模型的定价，让你以可预测的成本交付 Krea 集成。

## 创建 API 密钥

只有工作区**所有者**和**管理员**可以创建 API token。如果你看不到创建 token 的选项，请联系你的工作区所有者申请访问权限或更高级别的角色。

创建 API 密钥的步骤：

1. 前往 [krea.ai/settings/api-tokens](https://www.krea.ai/settings/api-tokens)
2. 确保你处于正确的工作区（使用左上角的工作区切换器）
3. 点击 "New Token"
4. 为你的 token 起一个具有描述性的名称
5. 妥善保存该 token——它只会显示一次！

<Info>
  API 在你的工作区中拥有独立的用户身份。除非被共享到工作区，否则在应用中训练的风格不能通过 API 访问，通过 API 训练的风格也不会出现在应用中。详情请参阅 [训练自定义风格](/developers/tutorials/train-image-style#use-your-trained-style)。
</Info>

<Warning>
  **安全准则**

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

## 使用 API 密钥

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

<CodeGroup>
  ```javascript Node.js theme={null}
  // 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={null}
  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={null}
  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={null}
  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"])
  }
  ```
</CodeGroup>

## 定价

各模型的具体价格请参阅 [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)。

<Check>
  失败和被取消的任务不会计费。你只需为已完成的任务付费。
</Check>

### 余额耗尽时

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

```json theme={null}
{
  "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 余额

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

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

## 跟踪用量

近期消费会显示在 [krea.ai/app/api/](https://krea.ai/app/api/) 的 API 余额卡片上，位于 "API cost in the last 7 days" 一栏。

## 企业版

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

## 后续步骤

<CardGroup cols={2}>
  <Card title="交互式 Playground" icon="rocket" href="/developers/interactiveexample">
    发起你的第一个 API 请求
  </Card>

  <Card title="模型 API" icon="book-open" href="/api-reference/image/flux">
    浏览所有可用端点
  </Card>

  <Card title="任务生命周期" icon="cube" href="/developers/job-lifecycle">
    了解任务状态与轮询
  </Card>

  <Card title="速率限制" icon="gauge" href="/developers/rate-limits">
    了解各计划层级的 API 限制
  </Card>
</CardGroup>