CAMPAIGN初回チャージで +1,000 円分のトークン プレゼント。¥5,000 からお始めいただけます。プランを見る →
API Reference

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-5-5 — コーディングが得意で、いちばん人気のモデルです
  • claude-opus-5-5 — 高度な推論や難しい設計判断に向いています

OpenAI

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

DeepSeek（推奨お試し・NEW）

  • deepseek-v4-flash — 高速・低コスト。チャットや要約など軽量タスクに最適です
  • deepseek-v4-pro — 高度な推論・コーディングに対応した上位モデルです

その他の対応モデル（2026-10 追加）

  • claude-fable-5 — Anthropic の最上位クラスモデル
  • claude-opus-5 / claude-sonnet-5 — Claude 5 世代
  • grok-4.5 — xAI
  • glm-5.3 / glm-5.3-flash — Zhipu AI
  • kimi-k3 — Moonshot AI
  • gpt-6-sol / gpt-6.1-sol — OpenAI GPT-6 Sol 系
  • claude-opus-4-7 — Anthropic Claude Opus 4.7
  • claude-haiku-5-5 — Anthropic Claude Haiku 5.5（軽量・低価格）
  • gemini-4-argon / gemini-4-argon-high / gemini-4-argon-medium / gemini-4-argon-low — Google
  • gemini-3-pro-preview / gemini-3.1-pro-preview / gemini-3.5-flash 〜 gemini-3.8-flash — Google

音楽生成

/v1/chat/completions に曲のイメージを日本語で送ると、生成された楽曲（mp3）のダウンロードリンクが返ります。1 回の生成ごとの定額課金です（トークン数は課金に影響しません）。1 曲の生成には 30 秒〜数分かかります。

  • Lyria-3.5 — ボーカル・伴奏付きの完全な楽曲（最長約 5 分）
  • Lyria-3pro — ボーカル・伴奏付きの楽曲（最長約 3 分）
  • 応答に含まれる音声リンクは一時 URL のため、一定期間で失効する場合があります。お早めにダウンロードして保存してください。

動画生成

OpenAI Videos 互換の非同期 API です。POST /v1/videos に model・prompt・seconds・size を送るとタスク ID が返り、GET /v1/videos/{id} で進捗と完成動画の URL（result_urls）を取得できます。1 本ごとの定額課金で、生成に失敗した場合は自動で返金されます。

生成には内容や混雑状況により数分〜数十分かかります。result_urls の動画リンクは生成元の一時 URL で、1〜2 日程度で失効します。完成後はお早めにダウンロードしてご自身の環境に保存してください。失効後の再取得・再発行はできません。

  • seedance-2.5-lite — ByteDance Seedance 2.5（720P・5〜30 秒・参照画像 9 枚まで）
  • seedance-2.5 — 参照画像 30 枚＋参照音声 10 件（720P・4〜30 秒）
  • seedance-2.5-plus — 参照画像 30 枚＋参照動画 10 件＋参照音声 10 件（720P・5〜30 秒）
  • seedance-2.5-pro — 全パラメータ対応の高品質版（720P・4〜30 秒）

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

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

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

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

リクエスト例

cURL

curl https://api.tokenya.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-tokenya-XXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "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-5-5",
    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.6-terra",
  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 を返します
  • 使用履歴は管理画面 パネル → ログ で確認できます
レート制限: デフォルトでは特に制限なし。大量並列リクエストが必要な場合は [email protected] までご相談ください。

エラー

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

{
  "error": {
    "type": "insufficient_quota",
    "message": "残高が不足しています。チャージしてください。",
    "code": "402"
  }
}
← はじめての方へClaude Code 連携 →
LINE で相談