メインコンテンツへスキップ
Tokios API キーは、api.tokios.com へのすべてのリクエストを Bearer トークンとして認証するために使用します。キーはコンソールの Keys タブで作成します。キーは sk-tok- で始まり、特定のモデルにスコープを制限できます。キーは無料で、クレジットカードは不要です。

キーを作成する

  1. コンソールの Keys タブを開きます。
  2. アプリのdisplay name を入力します(例: production-app や local-dev)。
  3. 必要に応じて model patterns を設定します。カンマ区切りのグロブで、キーがアクセスできるモデルを制限します(例: gemma*、gpt-4*)。すべてのモデルを許可するには * のままにします。
  4. まずCreate key をクリックし、copy the key immediately — キーは作成時にのみ表示されます。
キーは作成時にのみ表示されます。すぐにパスワードマネージャーやシークレット保管庫に保存してください。紛失した場合は、キーを失効して新しいキーを作成します。
最大 50 個のアクティブなキーを保持できます。各キーの行には、edit、rotate、disable、delete のアクションがあります。

キーをメールで共有する

秘密情報を自分で扱うことなくチームメイトや友人にアクセス権を付与するには、Share Key を使用します(Keys タブの Create key の隣にあります)。これにより、その人専用の 新しいキー が発行され、キーを確認するための ワンタイムリンク がメールで送信されます。キー自体はメールに含まれず、あなたが確認したりコピーしたりすることもありません。 次の Share a key by email ダイアログで:
1

Enter the recipient email

キーを受け取る人物です。キー本体ではなくワンタイムの表示リンクが送信されます。
2

Set the model scope

この共有キーで呼び出せるモデルを選択します。通常のキーと同じモデルパターンスコープで、共有キーを特定のデプロイメントのみに制限することもできます。
3

Optionally add a passphrase and expiry

追加のpassphrase(受信者に別途共有します)を表示リンクの第二因子として追加します。Expiry でキーが機能しなくなるタイミングを設定します。または No expiry のままにします。
4

Choose usage visibility, then send

ここではLet them check this key’s usage を有効にしておくと、受信者が共有キーの使用状況を確認できます(後からキーごとに無効にすることもできます)。ワークスペースでリクエストログ記録が有効で、受信者にこのキーで送信されたプロンプトの閲覧も許可したい場合は、Let them read their stored prompts there too もチェックします。これはデフォルトでオフです。キーを持つ誰でもそのプロンプトを閲覧できるためです。最後に Send invite をクリックします。
共有キーは独立した専用キーであるため、revoke it any time でき、他のユーザーに影響を与えずにその人のアクセスを停止できます。これがローカルモデル用の API キーで説明されているユーザーごとのキー管理の最も簡単な方法です。
ワークスペースでリクエストログ記録が有効な場合、共有キーで送信されたプロンプトも保存され、受信者は使用状況ページにその旨の通知を受け取ります。上記のプロンプトオプションをチェックするか、後からキー設定で許可した場合にのみ、受信者はそれらのプロンプトを閲覧できます。キーを共有する前に必ず伝えておいてください。

キーを使用する

キーを Bearer トークンとして送信し、クライアントに合わせてベース URL を設定します。
  • OpenAI スタイル(Codex、OpenAI SDK): https://api.tokios.com/v1
  • Anthropic スタイル(Claude Code): https://api.tokios.com
OpenAI SDK(Python):
Anthropic SDK(Python) — Anthropic の API サーフェスにはベース URL に /v1 が含まれません。

キーのセキュリティ

  • キーをソースコントロールにコミットしない。 チェックインされる .env ファイルやハードコードされた文字列からキーを排除してください。
  • 環境変数を使用 し、実行時に読み取ります。
  • 定期的にローテーション します。置き換え用のキーを作成し、サービスを更新してから、古いキーを削除します。
  • 環境ごとに別のキーを使用 すれば、他の環境に影響を与えずにキーを失効できます。
  • モデルパターンでスコープを設定 し、キーが必要なモデルにのみアクセスできるようにします。
  • 何が保存されるかを把握する。 デフォルトでは、Tokios はリクエストやレスポンスのボディを保持しません。リクエストログ記録を有効にすると、ワークスペース管理者は 7 日間、ワークスペース内の任意のキーで送信されたプロンプトを閲覧できます。
  • キーを管理するスクリプトには自動化トークンを使用する。 キーはモデルを呼び出すためのものです。他のキーを作成、ローテーション、失効することはできません。それを行うプログラムは、代わりにスコープ付きで期限付きの自動化トークンを使用します。

キーを失効する

次の Keys タブで、キーを見つけて disable または delete します。失効したキーは即座に認証が停止され、そのキーを使用したリクエストは拒否されます。