Skip to main content
すべての API エンドポイントは、API キー を Bearer トークン形式で渡して認証する必要があります。

API キーの発行

  1. BIZ MORI ダッシュボード にログインします
  2. API キー に移動します
  3. 新規発行 をクリックします
  4. キーをコピーして安全に保管します。本番用 API キーは一度しか表示されません。
ダッシュボードでは、アカウントおよび組織ごとにテスト API キーを 1 つずつ自動的に発行します。発行されたキーは API キーページで再度確認できます。詳しい検証手順については テスト API キー を参照してください。
API キーはアカウントの API に対する全アクセス権限を付与します。クライアント側のコード、公開リポジトリ、バージョン管理システムには絶対に公開しないでください。環境変数として保存してください。

テスト API キー

処理サービスを実際に実行せずに連携を検証したい場合は、自動発行された sk_test_ プレフィックスのテスト API キーを使用してください。 テスト API キーは次のように動作します。
  • 本番用キーと同様に Authorization: Bearer 認証を使用します。
  • 注文作成および注文履歴 API でテスト注文のライフサイクルを検証できます。
  • Anti-AI、watermark、AI Detection の処理は実行されません。
  • 外部処理サービスを呼び出さず、クレジットも消費しません。
  • アップロードされたファイルの内容は破棄され、結果ファイルは作成されません。
テスト注文は本番注文と分離されます。テストキーで Webhook の管理リクエストを送信すると拒否されます。アップロード URL、状態遷移、ファイル名による決定的な結果については テスト API キー を参照してください。

API キーの使用方法

すべてのリクエストで Authorization: Bearer ヘッダーを使って API キーを渡します。

冪等性(Idempotency)

すべての注文作成エンドポイントは idempotencyKey パラメータをサポートしています。同じキーで重複したリクエストを送信すると、新しい注文を作成する代わりに 既存の注文を返します。ネットワーク再試行時の二重処理を防ぐことができます。
UUID v7 の使用を推奨します。ビジネスロジックから導出された決定論的なキー(例: user-{id}-batch-{timestamp})も使用できます。