TokiosのAPIキーを作成・管理する

Every request to api.tokios.com authenticates with a Tokios API key sent as a Bearer token. You create keys on the Keys tab of the console; they start with sk-tok- and can be scoped to specific models. Keys are free and need no credit card.

キーを作成する

コンソール内で Keys タブを開いてください。
Enter a display name (for example production-app or local-dev).
任意で model patterns を設定してもよい — これはコンマで区切られたグロブ形式の文字列で、そのAPIキーが利用可能なモデルを制限するためのものだ（例えば gemma* や gpt-4* など）。すべてのモデルを利用可能にしたい場合は * のままにしておく。
Click Create key, then copy the key immediately — it is shown only once.

キーは作成時のみ表示される。作成後は直ちにパスワードマネージャーやシークレット管理ツールに保存しておくこと。紛失した場合は該当キーを無効化し、新規に作成する必要がある。

最大で50個の有効なキーを保持可能だ。各キーの行には編集、ローテーション、disable、deleteといった操作メニューが用意されている。自分で秘密情報を扱うことなくチームメイトや友人にアクセス権を付与したい場合は、Share Keyを利用してください（キータブ内のCreate keyの隣にあります）。これによりその人物専用の新規キーが生成され、そのキーを確認するためのワンタイムリンクがメールで送信されます。キー自体はメール内に記載されず、あなたもその内容を確認したりコピーしたりすることはできません。 In the Share a key by email dialog:

受信者のメールアドレスを入力します。

キーの受取人となる人物です。この人にはキー本体ではなくワンタイムの確認リンクのみが送られます。

利用可能なモデルの範囲を設定します。

この共有キーで呼び出せるモデルを選択します。通常のキーと同様にモデルパターンによる制限が可能で、特定のデプロイのみに利用を限定することも可能です。

必要に応じてパスフレーズや有効期限を設定します。

A passphrase (share it with the recipient separately) adds a second factor to the reveal link. Expiry sets when the key stops working — or leave it as No expiry.

利用状況の可視性を選択した上で送信します。

受信者に共有キーの利用状況を閲覧させたい場合はLet them check this key’s usageを有効にしてください（後から個別のキーごとに無効化も可能です）。また、ワークスペースでリクエストログ記録が有効化されており、受信者にこのキーで送信されたプロンプト内容も見せたい場合は彼らが保存済みプロンプトも閲覧できるようにするにチェックを入れてください。デフォルトでは無効になっており、キーを所有する者なら誰でもその内容を閲覧可能になるためです。最後にSend inviteをクリックします。

共有キーは専用の個別キーであるため、いつでも無効化でき、他のユーザーのアクセス権に影響を与えずに特定の人物の利用を停止できます。これがローカルモデル用APIキーで説明されている個別ユーザー向けキー管理の最も簡単な方法です。

ワークスペースでリクエストログ記録が有効化されている場合、共有キーで送信されたプロンプトも保存され、受信者は利用状況ページでその旨の通知を受け取ります。上記のプロンプト設定を有効化したり、後からキー設定で許可したりしない限り、受信者はそれらの内容を閲覧できません。キーを共有する前に必ずその点を伝えておきましょう。

APIキーを利用する

APIキーをBearerトークンとして送信し、クライアントに合わせてベースURLも設定してください：

OpenAI形式（Codex、OpenAI SDK）：https://api.tokios.com/v1
Anthropic形式（Claude Code）：https://api.tokios.com

curl https://api.tokios.com/v1/chat/completions \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gemma-tunnel", "messages": [{"role": "user", "content": "Hello"}]}'

OpenAI SDK（Python）：

from openai import OpenAI

client = OpenAI(
    api_key="sk-tok-YOUR_KEY",
    base_url="https://api.tokios.com/v1",
)
response = client.chat.completions.create(
    model="gemma-tunnel",
    messages=[{"role": "user", "content": "Hello"}],
)

Anthropic SDK（Python） — Anthropic側の仕様上、ベースURLに /v1 は含まれません：

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-tok-YOUR_KEY",
    base_url="https://api.tokios.com",
)
message = client.messages.create(
    model="gemma-tunnel",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello"}],
)

APIキーの安全な管理

絶対にソースコントロールにキーをコミットしてはいけません。チェックインされる .env ファイルやハードコーディングされた文字列からキーを排除してください。
環境変数を利用し、実行時にはそれらを読み込むようにしてください。
定期的にキーを更新しましょう。新しいキーを作成してサービスに適用した後、古いキーを無効化してください。
環境ごとに別々のキーを使用すれば、ある環境のキーを無効化しても他の環境に影響が出ません。
モデルパターンごとにキーのスコープを設定すれば、各キーが必要なモデルにのみアクセスできるようになります。
何が保存されるかを把握する。 デフォルトではTokiosはリクエストやレスポンスの内容を一切保存しません。ただしリクエストログ記録を有効にすると、ワークスペース管理者は 7 日間分のワークスペース内すべてのキーで送信されたプロンプト内容を確認できるようになります。

APIキーの無効化

On the Keys tab, find the key and disable or delete it. A revoked key stops authenticating immediately — any request using it is rejected.

はじめに

モデル

概念

リファレンス

TokiosのAPIキーを作成・管理する

キーを作成する

APIキーを利用する

APIキーの安全な管理

APIキーの無効化

​キーを作成する

​キーをメールで共有する

​APIキーを利用する

​APIキーの安全な管理

​APIキーの無効化

キーを作成する

キーをメールで共有する

APIキーを利用する

APIキーの安全な管理

APIキーの無効化