Documentation
Guides / クイックスタート
Guides · クイックスタート

クイックスタート

AllToken を使い始めましょう。

はじめに

AllToken は統一された API を提供し、単一のインターフェースから数百の AI モデルにアクセスできます。自動フェイルオーバーと最もコスト効率の高いオプションの選択を自動で処理します。

数行のコードで、お好みの SDK やフレームワークを使って呼び出しを開始できます。

Base URL: https://api.alltoken.ai/v1

認証方式： Bearer API Key

互換性： OpenAI 互換 API

API Key の取得

始める前に、API Key を作成してください：

  1. 設定 → API Keys に移動します
  2. 新しい Key を作成 をクリックします
  3. Key をコピーして安全に保管してください — 一度しか表示されません

API Key は厳重に管理し、クライアントコードや公開リポジトリには絶対に公開しないでください。

エージェントスキルとしてインストール

既存のスタックがすでに AllToken を扱えるなら、統合コードを書く必要はありません。AllToken は SKILL.md を読み込む agent runtime 向けに 2 つの公式 skill を提供しており、1 コマンドでインストールすると agent が AllToken API 全体を扱えるようになります。

Skill機能
alltokenTypeScript または Python の AllToken プロジェクトを構築します。chat、非同期画像、非同期動画、streaming、tool-calling agent core、任意の Ink TUI に対応します。
alltoken-callagent がチャット内で認識する 6 つの slash-style コマンド：/alltoken-chat、/alltoken-image、/alltoken-video、/alltoken-search、/alltoken-models、/alltoken-cost。stdlib Python recipes なので pip install は不要です。

どちらも MIT で公開されています。ソース： github.com/alltoken-ai/alltoken-skills.

runtime にインストール

OpenClaw（ClawHub CLI 経由）：

OpenClaw
$clawhub skill install alltoken
clawhub skill install alltoken-call

Hermes Agent（直接 URL インストール）：

Hermes Agent
$hermes skills install https://alltoken.ai/skills/alltoken/SKILL.md
hermes skills install https://alltoken.ai/skills/alltoken-call/SKILL.md

Claude Code / Codex CLI / OpenCode - SKILL.md ファイルをプロジェクトの skills/ ディレクトリに配置します：

Claude Code / Codex CLI / OpenCode
$mkdir -p ./skills/alltoken-call
curl -fsSL https://alltoken.ai/skills/alltoken-call/SKILL.md -o ./skills/alltoken-call/SKILL.md

次の session で agent が skill を読み込みます。

試す

agent が実行される環境で ALLTOKEN_API_KEY が設定されていることを確認します。その後、自然言語で依頼します：

  • "alltoken-call skill を使って、1024x1024 のティーポット画像を生成する。"
  • "alltoken を使って ./my-agent に AllToken chat プロジェクトを作成する。"
  • "/alltoken-models --type=video を実行して、利用可能な動画モデルを表示する。"

SillyTavern で roleplay を使っていますか？専用ガイドはこちら： Use AllToken with SillyTavern.

自分で統合を書きたい場合は、下の SDK のインストール に進み、TypeScript / Python の手順を確認してください。

SDK のインストール

AllToken は OpenAI SDK と完全に互換性があります。お好みのパッケージマネージャーでインストールしてください：

npm
$npm install openai

次に環境変数を設定します：

Shell
$export ALLTOKEN_API_KEY="your_alltoken_api_key"

最初のリクエストを送信する

クライアントを作成し、モデルを選択して、チャットリクエストを送信します：

TypeScript
1import OpenAI from 'openai';
2
3const client = new OpenAI({
4 apiKey: process.env.ALLTOKEN_API_KEY,
5 baseURL: 'https://api.alltoken.ai/v1',
6});
7
8const completion = await client.chat.completions.create({
9 model: 'minimax-m2.7',
10 messages: [
11 {
12 role: 'user',
13 content: '人生の意味とは何ですか？',
14 },
15 ],
16});
17
18console.log(completion.choices[0]?.message?.content);

Python の例

Python
1from openai import OpenAI
2import os
3
4client = OpenAI(
5 api_key=os.environ.get("ALLTOKEN_API_KEY"),
6 base_url="https://api.alltoken.ai/v1",
7)
8
9completion = client.chat.completions.create(
10 model="minimax-m2.7",
11 messages=[
12 {"role": "user", "content": "人生の意味とは何ですか？"}
13 ],
14)
15
16print(completion.choices[0].message.content)

API を直接呼び出す

cURL や任意の HTTP クライアントを使って API を直接呼び出すこともできます：

cURL
1curl https://api.alltoken.ai/v1/chat/completions \
2 -H "Authorization: Bearer $ALLTOKEN_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "model": "minimax-m2.7",
6 "messages": [
7 {"role": "user", "content": "こんにちは！"}
8 ]
9 }'

ストリーミングレスポンス

stream: true を追加すると、Server-Sent Events 経由で Token を逐次受け取ることができます：

TypeScript
1const stream = await client.chat.completions.create({
2 model: 'minimax-m2.7',
3 messages: [{ role: 'user', content: '物語を聞かせてください' }],
4 stream: true,
5});
6
7for await (const chunk of stream) {
8 const content = chunk.choices[0]?.delta?.content;
9 if (content) process.stdout.write(content);
10}

詳細なストリーミングドキュメントは ストリーミングレスポンス を参照してください。

次のステップ