API Documentation

Quickstart

teai.ioはOpenAI互換APIを提供します。既存のOpenAI SDKコードを1行変更するだけで利用できます。

1. APIキーを取得

Dashboardでアカウント作成後、APIキーを発行してください。キーはte_で始まります。

2. base_urlを変更

3. コードを実行

from openai import OpenAI

client = OpenAI(
    base_url="https://api.teai.io/v1",
    api_key="te_your_api_key",
)

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

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.teai.io/v1",
  apiKey: "te_your_api_key",
});

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

curl https://api.teai.io/v1/chat/completions \
  -H "Authorization: Bearer te_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Authentication

全てのAPIリクエストにはAuthorizationヘッダーが必要です。

Authorization: Bearer te_your_api_key

APIキーはDashboardで発行・管理できます。キーは発行時に1回だけ表示されるので、安全に保管してください。

Base URL

全てのエンドポイントはこのBase URLからの相対パスです。OpenAI SDKのbase_urlにそのまま設定できます。

POST /v1/chat/completions

チャット補完を生成します。OpenAI Chat Completions API完全互換。

Response

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1710000000,
  "model": "gpt-4o",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "Hello! How can I help you?"
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 8,
    "total_tokens": 20
  }
}

Streaming

"stream": trueを指定すると、SSE (Server-Sent Events) でトークンが逐次返されます。

stream = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Rustの特徴を3つ教えて"}],
    stream=True,
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

const stream = await client.chat.completions.create({
  model: "claude-sonnet-4-6",
  messages: [{ role: "user", content: "Rustの特徴を3つ教えて" }],
  stream: true,
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content || "");
}

curl https://api.teai.io/v1/chat/completions \
  -H "Authorization: Bearer te_your_api_key" \
  -H "Content-Type: application/json" \
  -N \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "Rustの特徴を3つ教えて"}],
    "stream": true
  }'

SSE Event Format

ストリーミング時、各チャンクは以下のフォーマットで返されます。各行は data: プレフィックスで始まり、最終行は data: [DONE] です。

# コンテンツチャンク
data: {"id":"chatcmpl-abc","object":"chat.completion.chunk","created":1710000000,"model":"gpt-4o","choices":[{"index":0,"delta":{"content":"Hello"},"finish_reason":null}]}

# 終了チャンク
data: {"id":"chatcmpl-abc","object":"chat.completion.chunk","created":1710000000,"model":"gpt-4o","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

# ストリーム終端
data: [DONE]

Credits

teai.io はクレジット制を採用しています。1 クレジットはコスト単位であり、トークン数と直接は一致しません。モデルごとに 1K トークンあたりのクレジット消費量が異なります。

• Free プラン: サインアップ時に 100 クレジット付与 + Nemotron 9B は無制限
• 有効期限なし: クレジットは期限切れになりません
• 残高確認: レスポンスの X-Credits-Remaining ヘッダー、または GET /api/v1/auth/me で確認できます

# 残高確認
curl https://api.teai.io/api/v1/auth/me \
  -H "Authorization: Bearer te_your_api_key"

# レスポンス例
{
  "user_id": "usr_abc",
  "credits": 87,
  "plan": "free"
}

GET /v1/models

利用可能な全モデルの一覧を返します。

curl https://api.teai.io/v1/models \
  -H "Authorization: Bearer te_your_api_key"

GET /v1/models/pricing

各モデルの料金情報を含む詳細一覧を返します。

curl https://api.teai.io/v1/models/pricing \
  -H "Authorization: Bearer te_your_api_key"

詳細な料金はPricingページを参照してください。

Tool Calling (Function Calling)

OpenAI互換のFunction Calling形式でツールを定義できます。

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "東京の天気は？"}],
    tools=[{
        "type": "function",
        "function": {
            "name": "get_weather",
            "description": "Get current weather",
            "parameters": {
                "type": "object",
                "properties": {
                    "city": {"type": "string"}
                },
                "required": ["city"]
            }
        }
    }],
)

Python SDK

Installation

pip install openai

Setup

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.teai.io/v1",
    api_key=os.environ["TEAI_API_KEY"],
)

# GPT-4oを使用
r = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "日本の首都は？"}],
)
print(r.choices[0].message.content)

# Claude Sonnetに切り替え（コード変更は1箇所だけ）
r = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Pythonでクイックソートを書いて"}],
)
print(r.choices[0].message.content)

# 無料モデル（Nemotron 9B）
r = client.chat.completions.create(
    model="nemotron-9b-jp",
    messages=[{"role": "user", "content": "自己紹介して"}],
)
print(r.choices[0].message.content)

Node.js SDK

Installation

npm install openai

Setup

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.teai.io/v1",
  apiKey: process.env.TEAI_API_KEY,
});

// モデルを自由に切り替え
const models = ["gpt-4o", "claude-sonnet-4-6", "gemini-2.5-flash"];

for (const model of models) {
  const r = await client.chat.completions.create({
    model,
    messages: [{ role: "user", content: "1+1=" }],
  });
  console.log(`${model}: ${r.choices[0].message.content}`);
}

Go SDK

Installation

go get github.com/sashabaranov/go-openai

Setup

package main

import (
    "context"
    "fmt"
    "os"
    openai "github.com/sashabaranov/go-openai"
)

func main() {
    config := openai.DefaultConfig(os.Getenv("TEAI_API_KEY"))
    config.BaseURL = "https://api.teai.io/v1"
    client := openai.NewClientWithConfig(config)

    resp, err := client.CreateChatCompletion(
        context.Background(),
        openai.ChatCompletionRequest{
            Model: "gpt-4o",
            Messages: []openai.ChatCompletionMessage{
                {Role: openai.ChatMessageRoleUser, Content: "Hello!"},
            },
        },
    )
    if err != nil {
        panic(err)
    }
    fmt.Println(resp.Choices[0].Message.Content)
}

Java SDK

Maven

<dependency>
    <groupId>com.openai</groupId>
    <artifactId>openai-java</artifactId>
    <version>0.8.0</version>
</dependency>

Setup

import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.*;

OpenAIClient client = OpenAIOkHttpClient.builder()
    .baseUrl("https://api.teai.io/v1")
    .apiKey(System.getenv("TEAI_API_KEY"))
    .build();

ChatCompletionCreateParams params = ChatCompletionCreateParams.builder()
    .model("gpt-4o")
    .addUserMessage("Hello!")
    .build();

client.chat().completions().create(params)
    .choices()
    .forEach(c -> System.out.println(c.message().content()));

curl

# 環境変数にAPIキーを設定
export TEAI_API_KEY="te_your_api_key"

# Chat Completion
curl https://api.teai.io/v1/chat/completions \
  -H "Authorization: Bearer $TEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

# モデル一覧
curl https://api.teai.io/v1/models \
  -H "Authorization: Bearer $TEAI_API_KEY"

# ストリーミング
curl https://api.teai.io/v1/chat/completions \
  -H "Authorization: Bearer $TEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -N \
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role": "user", "content": "日本の歴史を要約して"}],
    "stream": true
  }'

Error Handling

全てのエラーレスポンスは統一的なJSON形式で返されます。

エラーレスポンス形式

{
  "error": {
    "type": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Retry after 30 seconds.",
    "code": 429,
    "retry_after": 30
  }
}

リトライ戦略

5xx エラーや 429 が返された場合は、エクスポネンシャルバックオフでリトライを推奨します。

# Python: エクスポネンシャルバックオフ例
import time, random

def call_with_retry(fn, max_retries=3):
    for i in range(max_retries):
        try:
            return fn()
        except Exception as e:
            if i == max_retries - 1:
                raise
            wait = (2 ** i) + random.random()
            time.sleep(wait)

Rate Limits

レート制限に達した場合、エラーメッセージが返されます。レスポンスボディのerrorフィールドを確認し、適切な間隔をあけてリトライしてください。

Timeouts

Model Versioning

モデルIDの指定方法により、バージョン固定の有無を制御できます。

• バージョン変更通知: エイリアスが指すバージョンが変更される場合、Changelogで事前告知します
• 旧バージョン保持: 廃止されたバージョンは最低90日間サポートを継続
• 本番環境: 回帰テストの安定性が重要な場合はバージョン固定を推奨

Failover Behavior

teai.ioの自動フェイルオーバーはリクエストの指定方法により動作が異なります。

teai.ioの内部ルーティングはLoadBalancedProviderにより、サーキットブレーカー + ラウンドロビンで自動フェイルオーバーを実現しています。

• 明示的モデル指定: "model": "gpt-4o" のように指定した場合、そのモデルを使用します。プロバイダー障害時はティア内の次のモデルにフェイルオーバーします。
• ティアベースの自動選択: economy / normal / powerful ティアに応じて最適なモデルが自動選択されます。
• 全プロバイダー障害時: Nemotron 9B（セルフホスト）が最終フォールバックとして動作します。

レスポンスの model_used フィールド

レスポンスボディのmodelフィールドに、実際に使用されたモデル名が返されます。フェイルオーバーが発生したかを確認できます。

{
  "model": "claude-sonnet-4-6",  // 実際に使用されたモデル
  "choices": [...]
}

Models

主要モデルの一覧です。全モデルと詳細な料金はPricingページを参照してください。