메인 콘텐츠로 건너뛰기

​
API 키 만들기

워크스페이스 소유자와 관리자만 API 토큰을 만들 수 있습니다. 토큰을 만들 옵션이 보이지 않는다면, 워크스페이스 소유자에게 접근 권한 또는 상위 역할을 요청하세요. API 키를 만들려면:
  1. krea.ai/settings/api-tokens으로 이동합니다
  2. 올바른 워크스페이스에 있는지 확인합니다 (좌측 상단의 워크스페이스 토글 사용)
  3. “New Token”을 클릭합니다
  4. 토큰에 설명이 담긴 이름을 지정합니다
  5. 토큰을 안전하게 저장합니다—한 번만 표시됩니다!
API는 워크스페이스 내에서 별도의 사용자 정체성으로 동작합니다. 앱에서 학습한 스타일은 API로 접근할 수 없으며, API로 학습한 스타일은 워크스페이스에 공유되지 않는 한 앱에 표시되지 않습니다. 자세한 내용은 커스텀 스타일 학습을 참조하세요.
보안 가이드라인
  • 토큰을 코드가 아닌 환경 변수에 저장하세요
  • 개발용과 프로덕션용으로 서로 다른 토큰을 사용하세요
  • 토큰이 노출되면 즉시 폐기하세요
  • 절대로 토큰을 버전 관리 시스템에 커밋하지 마세요
  • 절대로 토큰을 공개적으로 공유하지 마세요

​
API 키 사용하기

모든 요청의 Authorization 헤더에 토큰을 포함하세요: 
// 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 호출과 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 ↗으로 문의하세요.

​
다음 단계

인터랙티브 플레이그라운드

첫 API 요청을 만들어 보세요

모델 API

사용 가능한 모든 엔드포인트를 살펴보세요

작업 수명 주기

작업 상태와 폴링을 이해하세요

속도 제한

플랜 등급별 API 제한을 이해하세요