TokenTaro API ドキュメント

5 分で最初のレスポンス

クレジットカードなしで登録し、キーを発行し、ブラウザで 1 リクエスト送り、コードをコピーする。この 4 ステップで、既存の OpenAI SDK がそのまま動きます。

1. STEP 01

   メールで登録

   メールアドレスの確認だけで ¥3,000 分（30 日有効）を付与します。購入条件も自動課金もありません。

   balance: ¥3,000.0 · expires 2026-10-22 · plan: Free
2. STEP 02

   API キーを発行

   ダッシュボード → API キー → 「発行」。用途名を付けると明細がその名前で分かれます。キーは発行時に一度だけ表示されます。

   name: 問い合わせ返信Bot · tt_live_7f3a…c91e · limit ¥10,000 / 月
3. STEP 03

   ブラウザで動作確認

   ダッシュボード → 動作確認 でモデルを選び、1 リクエスト送信。レスポンス、トークン数、消費額（円）が返ります。

   200 OK · 1.9 s · 412 tok · ¥1.3 · balance ¥2,998.7
4. STEP 04

   コードをコピー

   下の クイックスタート から、curl / Python / Node / Dify / n8n のいずれかを貼り付けます。変えるのは base_url とキーの 2 行だけです。

   base_url: https://api.tokentaro.jp/v1 · model: claude-sonnet-5

トークンとは — 日本語 1 文字 ≒ 1〜3 トークン

請求は「100 万トークンあたりの円単価」で決まります。トークンはモデルが文章を区切る単位で、日本語では漢字ほど多め、ひらがな・英数字ほど少なめに数えられます。目安は次の通りです。

認証とエンドポイント

Base URL は https://api.tokentaro.jp/v1。認証は Authorization: Bearer ヘッダーに API キーを入れるだけです。OpenAI 互換のため、既存 SDK の base_url を差し替えれば動きます。

API キー

• tt_live_… — 本番キー。残高を消費します。キーごとに月額上限を設定できます。
• tt_test_… — 検証キー。固定のダミー応答を返し、残高を消費しません（CI やスキーマ確認用）。
• キーはダッシュボードで即時に無効化・再発行できます。ソースコードに直接書かず、環境変数 TOKENTARO_API_KEY に入れてください。

Authorization: Bearer tt_live_7f3a…c91e
Content-Type: application/json
# 任意：明細をプロジェクト名で分けたいとき（キーの用途名より優先）
X-TokenTaro-Project: 問い合わせ返信Bot

エンドポイント

レスポンスの拡張フィールド

OpenAI 互換のレスポンスに、消費額と残高を追加して返します。既存のクライアントは無視して動きます。

{
  "usage": {
    "prompt_tokens": 118, "completion_tokens": 294, "total_tokens": 412,
    "cost_jpy": 1.3,                 // この 1 回の消費額（税込・円）
    "balance_jpy": 2987.0,           // 残高
    "route": "byok"                  // byok | domestic | partner
  }
}

クイックスタート

環境変数 TOKENTARO_API_KEY にキーを入れ、ご利用の環境のタブからそのまま貼り付けてください。モデル名を変えるだけで提供元を切り替えられます。

OpenAI 互換エンドポイント

モデル名を claude-sonnet-5 や gpt-5.6、byok/gpt-5.6 に変えるだけで、同じコードのまま提供元を切り替えられます。

• Base URLapi.tokentaro.jp/v1
• 認証Bearer tt_live_…
• 対応プロトコルChat / Messages / Responses
• ストリーミングSSE 対応

curl Python Node Dify n8n

curl https://api.tokentaro.jp/v1/chat/completions \
  -H "Authorization: Bearer $TOKENTARO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5",
       "messages":[{"role":"user","content":"納品書の文面を丁寧語で作って"}]}'

環境変数 TOKENTARO_API_KEY にキーを入れて実行コピー

# pip install openai
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.tokentaro.jp/v1",
    api_key=os.environ["TOKENTARO_API_KEY"],
)

res = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "納品書の文面を丁寧語で作って"}],
)
print(res.choices[0].message.content)
print(res.usage.total_tokens)   # 412

既存の OpenAI SDK のまま。base_url と api_key の 2 行だけ変更コピー

// npm i openai
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.tokentaro.jp/v1",
  apiKey: process.env.TOKENTARO_API_KEY,
});

const res = await client.chat.completions.create({
  model: "claude-sonnet-5",
  messages: [{ role: "user", content: "納品書の文面を丁寧語で作って" }],
});
console.log(res.choices[0].message.content, res.usage.total_tokens);

Node 18 以降。ストリーミングは stream: trueコピー

• 設定 → モデルプロバイダーOpenAI-API-compatible
• モデル名claude-sonnet-5
• API Keytt_live_••••••••
• API endpoint URLhttps://api.tokentaro.jp/v1
• Completion modeChat
• コンテキスト長200000

Dify 0.15 以降で確認。手順の詳細は Dify 連携URL をコピー

• ノードOpenAI Chat Model（LangChain）
• Credential → Base URLhttps://api.tokentaro.jp/v1
• Credential → API Keytt_live_••••••••
• Modelclaude-sonnet-5（一覧から選択 or 直接入力）
• 用途名でキーを分けるワークフローごとに 1 キー → 明細が分かれます

n8n 1.60 以降で確認。手順の詳細は n8n 連携URL をコピー

BYOK — 自分のキーを登録する

OpenAI / Anthropic / Google とのご契約をそのまま使い、TokenTaro の用量管理・円換算・上限・請求書だけを利用する方法です。当社へのお支払いはプラットフォーム料のみ（料金）。

1. STEP 01

   ダッシュボードで登録

   ダッシュボード → 自分のキー（BYOK） → プロバイダーを選び、各社の API キーを貼り付けます。登録時に 1 回だけ疎通確認のリクエストを送ります（¥0）。

   provider: anthropic · label: 本社契約 · status: verified · 2026-09-22 10:14
2. STEP 02

   暗号化して保管

   キーは AES-256-GCM で暗号化し、鍵は国内リージョンの KMS に置きます。復号はリクエスト処理の瞬間だけで、平文はログ・明細・サポート画面のどこにも残りません。ダッシュボードには末尾 4 桁のみ表示します。

   stored: sk-ant-••••••••••••3f9a · kms: ap-northeast-1 · last used: 2 分前
3. STEP 03

   モデル名の前に byok/ を付ける

   コードは変えず、モデル名だけ変えます。byok/ 付きのモデルはお客様のキーで各社に送信され、モデル利用料は各社からお客様へ直接請求されます。TokenTaro の残高からはプラットフォーム料だけが引かれます。

   model: byok/claude-sonnet-5 · cost_jpy: 0.07（platform fee 5%） · route: byok

res = client.chat.completions.create(
    model="byok/claude-sonnet-5",   # ← "byok/" を付けるだけ
    messages=[{"role": "user", "content": "議事録を 300 字で要約して"}],
)
print(res.usage.cost_jpy)   # 0.07 — プラットフォーム料のみ

コーディングエージェントで使う

Claude Code・Codex CLI などのエージェントは、環境変数か設定ファイルで接続先を TokenTaro に向けるだけで使えます。API キーは通常のキーと同じで、用途名を「Claude Code（山田）」のように付けると人別に明細が分かれます。

Claude Code

Claude Code の LLM ゲートウェイ設定に準拠します。ANTHROPIC_BASE_URL を TokenTaro に、ANTHROPIC_AUTH_TOKEN を TokenTaro のキーに設定してください。TokenTaro 側は /v1/messages（Anthropic Messages 互換）で受けます。

# 環境変数（シェル）
export ANTHROPIC_BASE_URL="https://api.tokentaro.jp"
export ANTHROPIC_AUTH_TOKEN="tt_live_7f3a…c91e"   # TokenTaro のキー
export ANTHROPIC_MODEL="claude-sonnet-5"            # 任意。byok/claude-sonnet-5 も可

# または ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.tokentaro.jp",
    "ANTHROPIC_AUTH_TOKEN": "tt_live_7f3a…c91e"
  }
}

Codex CLI

~/.codex/config.toml にモデルプロバイダー tokentaro を追加し、既定プロバイダーに指定します。TokenTaro 側は /v1/responses（OpenAI Responses 互換）で受けます。

model = "gpt-5.6"                 # byok/gpt-5.6 も可
model_provider = "tokentaro"

[model_providers.tokentaro]
name = "TokenTaro"
base_url = "https://api.tokentaro.jp/v1"
env_key = "TOKENTARO_API_KEY"       # 環境変数名。値は tt_live_…
wire_api = "responses"

TokenTaro Connect

TokenTaro Connect は、TokenTaro の API とリモート対話をひとつの画面で管理する専用デスクトップアプリです。Claude Code・Codex CLI・Gemini CLI などの接続状態を確認し、主流モデルを選んで切り替え、残高と利用状況まで同じ場所で確認できます。

1. TokenTaro の API キーを登録し、接続するツールを選びます。
2. リモート対話で使うモデルを Claude / GPT / Gemini などから選択します。
3. 接続先を適用して CLI を起動。送信した内容と応答は TokenTaro の管理画面で確認できます。
4. 残高・利用量・レート制限はアプリと Web 管理画面の両方で確認できます。

Claude Code   接続中   claude-sonnet-5
Codex CLI     接続中   gpt-5.6
Gemini CLI    接続中   gemini-3.8-flash
Balance       Web 管理画面と同期

Dify 連携

Dify のモデルプロバイダーに OpenAI-API-compatible を追加し、base_url と TokenTaro のキーを入力するだけです。Dify Cloud・セルフホストの両方で同じ手順です。

1. Dify 右上のアカウント → 設定 → モデルプロバイダー を開く。
2. 一覧から OpenAI-API-compatible を探し、「モデルを追加」を押す。
3. 次の項目を入力して保存。モデルごとに 1 件ずつ追加します（Sonnet と Haiku を両方使うなら 2 件）。

• Model TypeLLM
• Model Nameclaude-sonnet-5 · 表示名は自由。API に送る名前を正確に
• API Keytt_live_•••••••• · 用途名「Dify 本番」で発行したキー
• API endpoint URLhttps://api.tokentaro.jp/v1
• Completion modeChat
• Model context size200000
• Upper bound for max tokens8192
• Function callingTool Call · gpt-5.6 / claude-* で対応
• Stream function callingSupported
• Vision supportSupported · 画像入力対応モデルのみ

4. アプリの「モデル設定」で追加したモデルを選ぶ。RAG を使う場合は同じ手順で Model Type: Text Embedding、Model Name embed-jp を追加。
5. 動作確認後、ダッシュボードでキー別上限（例：¥20,000 / 月）を設定しておくと、Dify のワークフロー暴走で残高を使い切る事故を防げます。

n8n 連携

n8n の OpenAI Chat Model ノード（AI Agent / LangChain 系）で Credential の Base URL を TokenTaro に変えるだけです。n8n Cloud・セルフホストのどちらでも同じです。

1. ワークフローに AI Agent（または Basic LLM Chain）ノードを置き、Model に OpenAI Chat Model を選ぶ。
2. Credential → Create New で以下を入力。

• Credential 名TokenTaro（問い合わせ返信）
• API Keytt_live_••••••••
• Organization ID空欄
• Base URLhttps://api.tokentaro.jp/v1

3. ノードの Model 欄で claude-sonnet-5 を一覧から選ぶ（/v1/models を自動取得）か、Expression で直接入力。
4. ワークフローごとに TokenTaro のキーを 1 本ずつ発行すると、明細がワークフロー名で分かれます。

HTTP Request ノードで呼ぶ場合

URL:     https://api.tokentaro.jp/v1/chat/completions
Auth:    Header Auth → Name: Authorization, Value: Bearer {{ $env.TOKENTARO_API_KEY }}
Body:    JSON
{
  "model": "gemini-3.8-flash",
  "messages": [{ "role": "user", "content": "{{ $json.body.text }}" }]
}

Cursor などのツール設定

OpenAI 互換の接続先を設定できるツールなら、基本は「Base URL を https://api.tokentaro.jp/v1 に、キーを TokenTaro のキーに」だけです。Claude Code / Codex CLI は前のセクションを参照してください。

models:
  - name: TokenTaro · Claude Sonnet 5
    provider: openai
    model: claude-sonnet-5
    apiBase: https://api.tokentaro.jp/v1
    apiKey: ${env.TOKENTARO_API_KEY}
    roles: [chat, edit]
  - name: TokenTaro · Qwen（国内）
    provider: openai
    model: qwen-3-large
    apiBase: https://api.tokentaro.jp/v1
    apiKey: ${env.TOKENTARO_API_KEY}
    roles: [autocomplete]

既存 OpenAI 直契約からの移行

変えるのは base_url と api_key の 2 行だけです。モデル名は OpenAI・Anthropic の公式名をそのまま受け付けます。段階移行なら、まず BYOK で今のキーを登録し、コードを一切変えずに明細・上限だけ TokenTaro に移す方法もあります。

  from openai import OpenAI
  client = OpenAI(
-     api_key=os.environ["OPENAI_API_KEY"],
+     base_url="https://api.tokentaro.jp/v1",
+     api_key=os.environ["TOKENTARO_API_KEY"],
  )
  res = client.chat.completions.create(model="gpt-5.6", messages=[...])   # モデル名はそのまま

モデル名対応表

移行チェックリスト

• 環境変数を TOKENTARO_API_KEY に切り替え、OPENAI_API_KEY は残していても無害（SDK は base_url 側の設定を使う）。
• ストリーミング（SSE）・ツール呼び出し・JSON mode・画像入力は同じパラメータで動作。logprobs と Batch API は未対応。
• レート制限のヘッダー名が変わります（上限とレート制限）。
• 本番切替の前に tt_test_ キーで CI を通し、その後キー別上限を設定して切り替え。

上限とレート制限

TokenTaro は既定で上限 ON です。新規アカウントは月額上限 ¥10,000 から始まり、80% でメール通知、到達で自動停止します。残高を超えて請求されることはありません。

金額の上限（既定 ON）

レート制限（プラン別・目安）

BYOK のレート制限は各社側の上限がそのまま適用されます（当社側の制限は上記のうち大きい方）。上流の各社が 429 を返した場合は、そのまま 429 upstream_rate_limited として中継します。

429 の扱い

429 には必ず Retry-After（秒）を付けます。その秒数を待ってから、指数バックオフで再試行してください。OpenAI SDK は既定で 2 回まで自動再試行します。

HTTP/1.1 429 Too Many Requests
Retry-After: 4
X-RateLimit-Limit-Requests: 300
X-RateLimit-Remaining-Requests: 0
X-RateLimit-Reset-Requests: 2026-09-22T10:15:04+09:00
X-TokenTaro-Balance-JPY: 2987.0

from openai import OpenAI, RateLimitError
import time

client = OpenAI(base_url="https://api.tokentaro.jp/v1", api_key=key, max_retries=3)

for attempt in range(5):
    try:
        return client.chat.completions.create(model="claude-haiku-4.5", messages=msgs)
    except RateLimitError as e:
        wait = int(e.response.headers.get("Retry-After", 2 ** attempt))
        time.sleep(wait)

エラーコード表

エラーは OpenAI 互換の {"error": {"type", "code", "message"}} 形式で返します。message は日本語です。

{
  "error": {
    "type": "billing_error",
    "code": "limit_reached",
    "message": "月額上限 ¥10,000 に到達しました。上限はダッシュボードで変更できます。",
    "limit_jpy": 10000, "used_jpy": 10000.4, "resets_at": "2026-10-01T00:00:00+09:00"
  }
}

請求書と領収書の取得

適格請求書（インボイス）PDF は毎月 1 日 09:00 に自動発行、領収書はチャージごとに即時発行。どちらもダッシュボードからいつでも再取得できます。

API で取得する

curl https://api.tokentaro.jp/v1/billing/invoices?month=2026-08 \
  -H "Authorization: Bearer $TOKENTARO_API_KEY"

{
  "invoices": [{
    "number": "INV-2026-09-000418", "period": "2026-08",
    "subtotal_jpy": 26666, "tax_jpy": 2667, "total_jpy": 29333,
    "due": "2026-09-30", "pdf_url": "https://api.tokentaro.jp/v1/billing/invoices/INV-2026-09-000418.pdf"
  }]
}

• 宛名・部署・但し書きは 請求先情報 から変更。当月分の再発行も可能です。
• 請求書払い（Business 以上）は初回のみ登記情報の確認があります。支払期限は月末締め・翌月末払い。
• 税の扱い・BYOK のリバースチャージについては 料金ページの FAQ を参照してください。

データの取扱い

送信データを学習に使わず、国内リージョンで処理し、ログは 30 日で消します。ここに書いてあることは利用規約とデータ処理契約（DPA）に同じ文言で載っています。

データの流れと当事者

• 国内モデル：お客様 → TokenTaro（国内 DC）。外部への送信はありません。
• 正規経由（提供開始後）：お客様 → TokenTaro → Azure Japan East / Bedrock 東京 / Google Cloud。当社が委託先、各社が再委託先で、国内リージョンを既定にするため越境移転は発生しません。
• BYOK：お客様 → TokenTaro（国内で処理）→ 各社（お客様の契約）。海外送信の当事者はお客様で、当社は国内の委託先に留まります。

再委託先一覧