> ## 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)에서 확인하세요. 모든 모델은 요청 파라미터(해상도, 품질, 오디오, 길이, 스타일 레퍼런스 등)에 따라 결정되는 생성당 고정 가격을 가집니다.

## API 청구 방식

API 토큰을 사용하는 직접 API 호출과 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="인터랙티브 플레이그라운드" 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>