api.tokios.com へのすべてのリクエストを Bearer トークンとして認証するために使用します。キーはコンソールの Keys タブで作成します。キーは sk-tok- で始まり、特定のモデルにスコープを制限できます。キーは無料で、クレジットカードは不要です。
キーを作成する
- コンソールの Keys タブを開きます。
- アプリのdisplay name を入力します(例:
production-appやlocal-dev)。 - 必要に応じて model patterns を設定します。カンマ区切りのグロブで、キーがアクセスできるモデルを制限します(例:
gemma*、gpt-4*)。すべてのモデルを許可するには*のままにします。 - まずCreate key をクリックし、copy the key immediately — キーは作成時にのみ表示されます。
キーをメールで共有する
秘密情報を自分で扱うことなくチームメイトや友人にアクセス権を付与するには、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 をクリックします。
ワークスペースでリクエストログ記録が有効な場合、共有キーで送信されたプロンプトも保存され、受信者は使用状況ページにその旨の通知を受け取ります。上記のプロンプトオプションをチェックするか、後からキー設定で許可した場合にのみ、受信者はそれらのプロンプトを閲覧できます。キーを共有する前に必ず伝えておいてください。
キーを使用する
キーを Bearer トークンとして送信し、クライアントに合わせてベース URL を設定します。- OpenAI スタイル(Codex、OpenAI SDK):
https://api.tokios.com/v1 - Anthropic スタイル(Claude Code):
https://api.tokios.com
/v1 が含まれません。
キーのセキュリティ
- キーをソースコントロールにコミットしない。 チェックインされる
.envファイルやハードコードされた文字列からキーを排除してください。 - 環境変数を使用 し、実行時に読み取ります。
- 定期的にローテーション します。置き換え用のキーを作成し、サービスを更新してから、古いキーを削除します。
- 環境ごとに別のキーを使用 すれば、他の環境に影響を与えずにキーを失効できます。
- モデルパターンでスコープを設定 し、キーが必要なモデルにのみアクセスできるようにします。
- 何が保存されるかを把握する。 デフォルトでは、Tokios はリクエストやレスポンスのボディを保持しません。リクエストログ記録を有効にすると、ワークスペース管理者は 7 日間、ワークスペース内の任意のキーで送信されたプロンプトを閲覧できます。
- キーを管理するスクリプトには自動化トークンを使用する。 キーはモデルを呼び出すためのものです。他のキーを作成、ローテーション、失効することはできません。それを行うプログラムは、代わりにスコープ付きで期限付きの自動化トークンを使用します。