> ## 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 トークンを作成できるのは、ワークスペースの**オーナー**と**管理者**のみです。トークン作成のオプションが表示されない場合は、ワークスペースのオーナーにアクセス権限の付与や権限の引き上げをリクエストしてください。

API キーを作成するには:

1. [krea.ai/settings/api-tokens](https://www.krea.ai/settings/api-tokens) に移動します
2. 正しいワークスペースにいることを確認します (左上のワークスペース切り替えを使用)
3. "New Token" をクリックします
4. トークンに分かりやすい名前を付けます
5. トークンを安全に保管します — 表示されるのは一度きりです!

<Info>
  API はワークスペース内で独自のユーザーアイデンティティとして動作します。アプリで学習したスタイルは API からはアクセスできず、API で学習したスタイルもワークスペースに共有されていない限りアプリには表示されません。詳細は [カスタムスタイルを学習する](/developers/tutorials/train-image-style#use-your-trained-style) を参照してください。
</Info>

<Warning>
  **セキュリティガイドライン**

  * トークンは環境変数に保存し、コード内に書かないでください
  * 開発用と本番用で異なるトークンを使用してください
  * 漏洩した場合はただちにトークンを失効させてください
  * トークンをバージョン管理にコミットしないでください
  * トークンを公開・共有しないでください
</Warning>

## API キーの使用

すべてのリクエストの `Authorization` ヘッダーにトークンを含めてください。

<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) を参照してください。各モデルにはリクエストパラメータ (解像度、品質、音声、長さ、スタイル参照など) によって決まる、生成 1 回あたりの固定料金が設定されています。

## API 請求の仕組み

直接の API 呼び出しおよび API トークンを使用する MCP 接続は、ワークスペースの**個別の USD 残高**から差し引かれます。これは Krea ウェブアプリで使用される compute units とは独立しています。OAuth を使用する MCP 接続は、サインイン中の Krea アカウントの compute units から請求されます。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="インタラクティブプレイグラウンド" 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>