API のご案内

tokenya.ai は OpenAI Chat Completions 互換 の API を提供しています。既存の OpenAI SDK / curl / ライブラリをそのまま使えます。

BASE_URL

https://api.tokenya.ai/v1

既存コードの OPENAI_API_BASE または baseURL 設定を上記に変更するだけで、すべてのリクエストが tokenya 経由で処理されます。

認証

全ての API リクエストに Authorization: Bearer <API_KEY> ヘッダーを付与してください。API キーは管理画面 パネル → トークン から発行できます。

Authorization: Bearer sk-tokenya-XXXXXXXXXXXXXXXXXXXX

主な対応モデル

Anthropic

• claude-sonnet-4-6 — コーディングが得意で、いちばん人気のモデルです
• claude-opus-4-6 — 高度な推論や難しい設計判断に向いています

OpenAI

• gpt-5-4 — 幅広い用途で使える定番モデルです
• gpt-5-5 — 最新世代。より高度な推論とコード生成に対応しています

DeepSeek（推奨お試し・NEW）

• deepseek-v4-flash — 高速・低コスト。チャットや要約など軽量タスクに最適です
• deepseek-v4-pro — 高度な推論・コーディングに対応。Claude Sonnet 級の性能を抑えた単価で

マルチモーダル（近日対応予定）

現在準備中です。以下のモデルは近日中の対応を予定しております:

• sora-2 / veo-3 — 動画生成
• midjourney — 画像生成
• whisper-1 — 音声からテキストへ
• tts-1 — テキストから音声へ

この他にも、Google Gemini や Claude Haiku などのモデルを順次追加してまいります。すべて同じ残高でご利用いただけます。最新の対応モデルとモデル別の単価は、管理画面の パネル → モデル価格 でご確認ください。

リクエスト例

cURL

curl https://api.tokenya.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-tokenya-XXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [
      {"role": "system", "content": "あなたは親切な日本語アシスタントです。"},
      {"role": "user", "content": "東京の天気を教えてください"}
    ],
    "stream": false
  }'

Python (OpenAI SDK)

from openai import OpenAI

client = OpenAI(
    api_key="sk-tokenya-XXXX",
    base_url="https://api.tokenya.ai/v1",
)

response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[
        {"role": "user", "content": "Hello, tokenya!"}
    ],
)
print(response.choices[0].message.content)

Node.js (TypeScript)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.TOKENYA_API_KEY,
  baseURL: "https://api.tokenya.ai/v1",
});

const res = await client.chat.completions.create({
  model: "gpt-5-4",
  messages: [{ role: "user", content: "Hello" }],
});
console.log(res.choices[0].message.content);

ストリーミング

"stream": true を付けると Server-Sent Events 形式でレスポンスが届きます。OpenAI 公式と同じフォーマットです。

残高の管理

• 各リクエストで使用したトークン数 × モデル単価 × tier ratio(0.85 / 0.80 / 0.75)が残高から差し引かれます
• 残高が 0 になると HTTP 402 Payment Required を返します
• 使用履歴は管理画面 パネル → ログ で確認できます

エラー

OpenAI 互換のエラーフォーマットです。

{
  "error": {
    "type": "insufficient_quota",
    "message": "残高が不足しています。チャージしてください。",
    "code": "402"
  }
}