API キー

API キーは、Grafilab Inference API へのすべての呼び出しと Playground でのすべての 実行を認証するものです。キーはアカウント単位で、保有数に上限はありません。それぞれが 独自の使用履歴を持つため、プロジェクトごと・環境ごとにキーを分けても費用はかからず、 支出が読みやすくなります。

コンソールで API を開きます。ページのタイトルは API Management で、キーは API Secret Keys の下に、Name、Key、 Created Date、Actions の列を持つテーブルとして並びます。

テーブルの上にある API Endpoint の行には、コピーボタン付きでベース URL が 表示されます。https://llm.grafilab.ai/v1 です。

Key 列では、値が末尾 4 文字までマスクされています。Show Key で全体が表示され、 隣にコピーボタンがあるので、以前に作ったキーもこのテーブルから読み出せます。

キーを一度も作ったことがない場合、このページを開くと Default という名前のキーが 自動的に作られます。これは想定どおりの動作です。そのまま使っても、自分でキーを作って これを削除しても構いません。

同じページの下のほうにある Sample API Implementation には、Python、 CURL、TypeScript それぞれの、Text Generation、Image Generation、 Image Edit、Video Generation、Image to Video 向けの既成スニペットが あり、エンドポイントと選択中のモデルがあらかじめ埋め込まれています。

1. API で Generate New Key をクリックします。テーブルの先頭に名前入力欄の ある行が現れ、Key 列には will be generated と表示されます。

2. 名前を入力します。100 文字までで、有効なキーの中で一意である必要があります。 Enter で送信、Esc でキャンセルします。

3. API Key Created ダイアログに Key Name とキーの全文（Key）が 表示されます。ここでコピーしてから I’ve saved my key をクリックします。

新しいキーは sk-grafilab- に続けて 48 文字の 16 進数という形式です。それ以前の 形式で発行されたキーも有効で、いまも認証に使えます。現在の形式に移すには、 そのキーをローテーションします。

キーはヘッダーとして送ります。どのヘッダーかは、クライアントが話す方言によります。

• OpenAI サーフェス — Authorization: Bearer <api-key>。
• Anthropic サーフェス — x-api-key: <api-key>、あるいはそのほうが簡単なら Authorization: Bearer。存在するヘッダーのほうが検証に使われます。形式の おかしい x-api-key はその値で失敗し、Authorization にフォールバックしません。

curl https://llm.grafilab.ai/v1/models \
  -H "Authorization: Bearer $GRAFILAB_API_KEY"

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["GRAFILAB_API_KEY"],
    base_url="https://llm.grafilab.ai/v1",
)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.GRAFILAB_API_KEY,
  baseURL: "https://llm.grafilab.ai/v1",
});

拒否されたキーは 401 とコード invalid_api_key で返ります。最も多い原因は、 貼り付けのときに混じったスペースや改行です。

どちらの操作も行の Actions 列にあり、どちらも即座に反映されます。

Rotate Key で Rotate API Key が開きます。Are you sure you want to rotate this key? The existing key value will immediately stop working. All in-flight requests using the old value will fail. 確認すると API Key Created ダイアログに 新しい値が一度だけ表示されます。

ローテーションはキーのレコードそのものを維持します。id、名前、使用履歴のすべてが 引き継がれるので、使用状況のグラフが途切れることはありません。変わるのは秘密の値 だけです。

Delete Key で Delete API Key が開きます。Are you sure you want to delete this key? This action will invalidate the key, but historical usage data will be preserved.

削除は取り消しのできない論理削除です。キーはただちに認証しなくなり、過去の使用状況は レポートに残り、値を復元することはできません。漏洩した秘密を無効にしたいだけなら、 ローテーションを選んでください。同じ名前のまま履歴を保てます。

すべてのリクエストは認証に使われたキーに紐づけられるため、キーごとの集計は推定では なく正確な値です。

キーはアカウントに属し、作成した個人には属しません。あなたのアカウントで作業する チームメンバーが作ったキーはあなたのアカウントのものになり、そのメンバーが抜けても 残ります。メンバーを削除するときに Also revoke the API keys this member created にチェックを入れた場合を除きます。

キーの行で View Usage をクリックすると、そのキーで絞り込んだ Inference API Usageが開きます。読み方は 推論の使用状況を参照してください。