トップ ／ クイックスタート

Apimane API クイックスタート

5 分で動かす最短ガイド。既存の OpenAI / Anthropic / DeepL SDK の base_url を 1 行差し替えるだけで、Claude / GPT / Gemini / Mistral / Grok / Groq の 8 社 25 種類以上のモデルを 1 本のキーで利用開始できます。

🎯 5 分で動かす最短手順

Step 1. API ベース URL

本番 API ベース URL:

https://api.apimane.co.jp

動作確認は /healthz で:

curl -s https://api.apimane.co.jp/healthz
# → {"status":"ok","timestamp":"..."}

Step 2. SDK の base_url を差し替え

既存の OpenAI / Anthropic / DeepL SDK の base_url (または api_base) を 1 行差し替えるだけ。下記 SDK 別コード例を参照。

Step 3. 動作確認

下記コード例の sk-cons-... を実際のキーに置き換えて実行 → 応答が返れば完了。

📦 SDK 別の最短コード例

Python (openai SDK)

from openai import OpenAI

client = OpenAI(
    api_key="sk-cons-xxx-xxxxxxxxxxxxxxxxxxxxxxxxx",
    base_url="https://api.apimane.co.jp/v1",  # ← この 1 行だけ追加
)

# Claude を呼ぶ
resp = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "こんにちは"}],
)
print(resp.choices[0].message.content)

# GPT を呼ぶ (同じキーで切替)
resp = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "こんにちは"}],
)

TypeScript / Node.js (openai SDK)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-cons-xxx-xxxxxxxxxxxxxxxxxxxxxxxxx",
  baseURL: "https://api.apimane.co.jp/v1",  // ← 差し替え
});

const resp = await client.chat.completions.create({
  model: "gemini-2.5-pro",  // Claude / GPT / Gemini / Mistral / Grok / Groq を model 指定で切替
  messages: [{ role: "user", content: "こんにちは" }],
});
console.log(resp.choices[0].message.content);

Python (anthropic SDK)

Anthropic 公式 SDK でも、ネイティブ /v1/messages エンドポイントが使えます。

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-cons-xxx-xxxxxxxxxxxxxxxxxxxxxxxxx",
    base_url="https://api.apimane.co.jp",  # ← 差し替え
)

resp = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "こんにちは"}],
)
print(resp.content[0].text)

TypeScript (DeepL Translator)

DeepL API v2 互換なので、deepl-node SDK もそのまま使えます。

import * as deepl from "deepl-node";

const translator = new deepl.Translator(
  "sk-cons-xxx-xxxxxxxxxxxxxxxxxxxxxxxxx",
  { serverUrl: "https://api.apimane.co.jp" },  // ← 差し替え
);

const result = await translator.translateText("Hello world", "en", "ja");
console.log(result.text); // "こんにちは世界"

curl (生のリクエスト)

# OpenAI 互換 (Claude / GPT / Gemini / Mistral / Grok / Groq を切替)
curl -s https://api.apimane.co.jp/v1/chat/completions \
  -H "Authorization: Bearer sk-cons-xxx-xxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "こんにちは"}]
  }'

# DeepL API v2 互換 (翻訳)
curl -s https://api.apimane.co.jp/v2/translate \
  -H "Authorization: Bearer sk-cons-xxx-xxxxxxxxxxxxxxxxxxxxxxxxx" \
  -d "text=Hello world" \
  -d "target_lang=JA"

📋 利用可能なモデル一覧

LLM (6 プロバイダ)

翻訳 (2 プロバイダ)

プロバイダ指定の方法は /v2/translate リクエストで provider=deepl または provider=google-translate を送信。デフォルトは DeepL です。

🎚️ Smart Routing を使う (任意機能)

リクエストごとに最適なモデルを当社が自動選択する補助機能です。既定はオフ、有効化するときだけヘッダーを指定します。

明示モデル指定は常に優先: X-Apimane-Smart-Routing: on でも model に具体名 (例 gpt-4o) を指定したら、そのモデルが使われます。例外は次の 2 つ:

1. Context Window 自動切替: 入力 (prompt + max_tokens の保守見積り) が指定モデルの context window を超える場合、対応可能なモデルへ自動切替
2. フェイルオーバー: 上流が 5xx 連続 3 回 / 30 秒タイムアウト / 429 のとき、別プロバイダの同等品質帯モデルへ自動切替 + リトライ。切替時は応答に X-Apimane-Fallback: true が付き、Discord / Slack に運用通知が飛びます

フォールバック順序の顧客指定 — models 配列

自動選定に任せず、切替先の順序をお客様が指定できます (OpenRouter 互換セマンティクス):

{ "models": ["claude-sonnet-4-6", "gpt-5.4", "gemini-3.5-flash"], "messages": [...] }

• 先頭から試行し、失敗で次へ。課金は実際に応答したモデル基準
• models 指定時は model フィールド・自動選定より常に優先
• グループポリシー外・未知のモデルはスキップ (全滅時のみ 400 models_all_excluded + 理由一覧)
• 最大 8 件

リクエスト単価上限 — X-Apimane-Max-Cost-JPY

リクエスト 1 件の上限を日本円で指定できます (小数可):

X-Apimane-Max-Cost-JPY: 50

• 推定最大コスト (入力単価 × プロンプト + 出力単価 × max_tokens、当日 TTM レートで円換算) が上限を超える場合、実行前に 400 per_request_budget_exceeded — 上流に届かないため課金は一切発生しません
• model: "apimane-auto" と併用すると「上限内で一番良いモデルを自動で選ぶ」動作になります

curl -s https://api.apimane.co.jp/v1/chat/completions \
  -H "Authorization: Bearer sk-cons-xxx-..." \
  -H "Content-Type: application/json" \
  -H "X-Apimane-Smart-Routing: on" \
  -H "X-Apimane-Mode: balanced" \
  -H "X-Apimane-Max-Cost-JPY: 50" \
  -d '{"model": "apimane-auto", "messages": [{"role": "user", "content": "..."}], "max_tokens": 1024}'

📨 レスポンスヘッダー (透明性情報)

/v1/chat/completions の応答には以下のヘッダーが含まれます。

🚨 よくあるエラーと初期トラブルシュート

❓ サポート・問い合わせ

• β 期間中の登録: β 登録フォーム 経由でお申し込みください
• 技術質問・障害連絡: info@apimane.co.jp (本契約後のお客様は 24/7 受付、トリアージは営業日対応)
• セキュリティ詳細: Trust Center をご覧ください

※ 本ページは Apimane API の公開クイックスタートです。最新の更新内容・新機能は トップページ「ロードマップ」セクションをご確認ください。