認証
APIキー
推論リクエストはMartLLM APIキーで認証されます。キーはull_で始まり、その後にランダムなサフィックスが続きます。ベアラートークンとして渡してください:
Authorization: Bearer ull_your_key_here
Anthropicのインターフェースもx-api-keyヘッダーでキーを受け付けます。
初めてダッシュボードにアクセスした際に、最初のキーが作成され、貼り付け可能な最初の呼び出し例とともに表示されます。キーの作成、編集、一覧表示、削除は、ダッシュボード → APIキーで行えます。完全なシークレットは作成時に一度だけ表示されます — すぐに保存してください。MartLLMはハッシュのみを保持し、二度と表示することはできません。キーを削除する(ダッシュボード → APIキー → 削除)と、すぐに効果が適用されます:そのキーを使用しているアプリは動作を停止し、過去の使用状況は合計に残り続けます。
APIキーごとの設定
各キーは独自のガードレールを持つことができ、作成時、または後でダッシュボード → APIキーの編集で設定できます。変更は、そのキーの次回のリクエストから適用されます。
- 利用額制限 —
daily、monthly、またはlifetimeの期間におけるUSDでの上限。これを超過するリクエストは、402 key_spend_cap_exceededというエラーで拒否されます。空欄の場合、制限はありません。 - 日次制限 —
daily_limit_usd。利用額制限に加えて適用されます。リクエストは両方の制限内に収まる必要があり、日次制限はUTCの深夜0時にリセットされます。いずれかの制限を超過するリクエストは、402 key_spend_cap_exceededというエラーで拒否され、料金は発生しません。キーページ、またはPATCH /api/v1/keys/{id}で設定します。 - レート制限 — 1分あたりのリクエスト上限 (1から10,000)。空欄の場合、標準のキーごとの制限 (1分あたり300) が適用されます。
- リクエストと回答を保存しない — デフォルトではオフです。MartLLMは、失敗したリクエストの修正やサポートの質問への回答のため、各リクエストとその回答を90日間保持します。これをオンにすると、このキーで行われた呼び出しは保存されません。当社は、各呼び出しの記録(時間、モデル、token数、コスト、送信元アドレス、試行したプロバイダー、およびそれらが返したエラー)のみを保持し、お客様が送信した内容や返された内容は保持しません。そのため、誤った回答について調査することはできません。ビデオおよび音楽のジョブは引き続きリクエストを保持するため、プロバイダーが中断したジョブは再開できます。リクエストを処理するプロバイダーは、いずれにしてもそれを受け取ります。キーページ、または
POST /api/v1/keysとPATCH /api/v1/keys/{id}でno_store(true/false) を使用して設定します。GET /api/v1/keysで取得できます。 - BYOKプロバイダー — キーを独自のプロバイダー認証情報経由でルーティングするように固定します(下記参照)。
残高不足メール
ダッシュボード → クレジットで、残高がご自身で設定した金額を下回った際にメール通知を受け取ることができます。これはデフォルトではオフになっており、残高がその金額を下回るたびに1通のメールが送信され、アカウントの所有者に届きます。画像、動画、音楽、または音声のリクエストのために確保された資金が、ジョブ終了後 15 分経過してもまだ保留されている場合、アカウント所有者にはそれらのジョブをリストしたメールが届き、当社のチームにも通知されます。その資金は引き続きお客様のものであり、解放されます。
BYOK — 自分のキーを持ち込む
Dashboard → BYOK にて、プロバイダーの認証情報を追加します。BYOK プロバイダーを経由するリクエストは、お客様の認証情報を直接使用します。クレジットは予約されず、MartLLM の残高における per-token コストはゼロになります。保存された認証情報は暗号化されており、マスクされた最後の-4としてのみ表示されます。
ダッシュボードセッション
ウェブダッシュボードにはGoogle (ワンクリックで、martllm.comの「Continue as」プロンプト、またはGoogleボタンから) またはメールアドレスでサインインします。15分で有効期限が切れる6桁のコード (およびサインインリンク) をお送りします。パスワードはありません。サインインすると、httpOnly cookieに保存される短期間有効なセッションが生成されます。このセッションは、お客様のull_ inference keysとは別物です。ダッシュボードのendpoint (/api/v1/*配下) はcookieを使用し、gateway (/v1/*) はAPI keyを使用します。
エラー
認証の失敗は、OpenAIスタイルのエラーエンベロープを返します。
{ "error": { "code": "invalid_api_key", "message": "…", "type": "authentication_error" } }
完全なリストについては、エラーと制限 を参照してください。