新着違うモデルを出品する販売者をどう見抜き、どう返金するか。

認証


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" } }

完全なリストについては、エラーと制限 を参照してください。