メインコンテンツへスキップ

API キーの作成

API トークンには 2 種類あります:
  • 個人用 API トークンはあなた自身として動作します。リクエストはあなた自身の Krea アカウントで実行され、あなたのワークスペースでの役割とスタイルへのアクセス権が適用されます。ワークスペースのメンバーであれば誰でも作成でき、ワークスペースを離れると個人用トークンは機能しなくなります。
  • サービス API トークンは、作成者本人ではなく、ワークスペース内の独立したサービスユーザーとして動作します。作成できるのはワークスペースのオーナーと管理者のみです。サービストークンは、作成者がワークスペースを離れた後も引き続き機能します。ワークスペースのオーナーと管理者はワークスペース内のすべてのトークンを確認でき、サービストークンごとに過去 30 日間の支出が記録されます。
API キーを作成するには:
  1. krea.ai/app/api/tokens に移動します
  2. Create Personal Token または Create Service Token をクリックします
  3. キーに分かりやすい名前を付けます
  4. トークンを安全に保管します — 表示されるのは一度きりです!
個人用 API トークンはあなた自身の Krea アカウントとして動作するため、アプリで学習したスタイルをそのまま利用できます。サービス API トークンはワークスペース内で独自のユーザーアイデンティティとして動作します。アプリで学習したスタイルはサービストークンからはアクセスできず、サービストークンで学習したスタイルもワークスペースに共有されていない限りアプリには表示されません。詳細は カスタムスタイルを学習する を参照してください。
セキュリティガイドライン
  • トークンは環境変数に保存し、コード内に書かないでください
  • 開発用と本番用で異なるトークンを使用してください
  • 漏洩した場合はただちにトークンを失効させてください
  • トークンをバージョン管理にコミットしないでください
  • トークンを公開・共有しないでください

API キーの使用

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

料金

モデルごとの料金については、krea.ai/app/api/pricing ↗ を参照してください。各モデルにはリクエストパラメータ (解像度、品質、音声、長さ、スタイル参照など) によって決まる、生成 1 回あたりの固定料金が設定されています。

API 請求の仕組み

直接の API 呼び出しおよび API トークンを使用する MCP 接続は、ワークスペースの個別の USD 残高から差し引かれます。これは Krea ウェブアプリで使用される compute units とは独立しています。OAuth を使用する MCP 接続は、サインイン中の Krea アカウントの compute units から請求されます。API キーを使用するには、事前にワークスペースで API アクセスが有効化されている必要があります。有効化されていない場合は support@krea.ai ↗ までお問い合わせください。
Agent API と Agent ツールは例外です。Agent のターンは、API キーで認証した場合も含め、ワークスペースの compute units 残高を使用します。API 残高は使用しません。
失敗またはキャンセルされたジョブには課金されません。完了したジョブに対してのみお支払いいただきます。

残高がなくなった場合

実行中のジョブは通常どおり完了します。新しい API リクエストは HTTP 402 Payment Required で拒否されます。
利用を再開するには krea.ai/app/api/ でチャージしてください。残高をプログラムから確認するための公開エンドポイントはありません — アプリ内で確認してください。 このボディは API 残高不足による 402 です。Zero Data Retention やその他の 402 レスポンスについては、エラーとデバッグ に一覧があります。

API 残高の追加

krea.ai/app/api/ で残高を追加できます。API 残高を追加できるのはワークスペースのオーナーのみです。
  • プリセット金額: $10、$25、$50、$100
  • カスタム金額: 最低 $5、最大 $10,000
  • 支払いは Stripe Checkout 経由で、成功すると残高は即座に反映されます

使用状況の確認

krea.ai/app/api/usage の API 使用状況ページで、選択した期間における完了済みの API ジョブと推定コストを確認できます。ワークスペースの管理者はワークスペース全体の使用状況を、その他のメンバーは自分のトークンによる使用状況を確認できます。krea.ai/app/api/ の API 残高カードにも、過去 7 日間の推定 API コストが表示されます。

エンタープライズ

大規模利用のお客様は、前払いではなく Net 30 条件で毎月請求書払いに対応できます。エンタープライズ向け請求についてご相談されたい場合は sales@krea.ai ↗ までご連絡ください。

次のステップ

インタラクティブプレイグラウンド

初めての API リクエストを実行しましょう

モデル API

利用可能なすべてのエンドポイントを参照します

ジョブのライフサイクル

ジョブの状態とポーリングについて理解します

レート制限

プラン階層ごとの API 制限を理解します