APIYIのBase URLを設定する3つのパス：/v1 汎用、ルートドメイン対応Claude、/v1beta 対応Gemini

作者注：APIYIプラットフォームにおける3種類のBase URLパスと3つのドメインノードの正しい設定方法を詳しく解説します。開発者が一度の設定で正しく接続し、トラブルを回避できるようサポートします。

AIモデルのAPIを設定する際、Base URLの入力ミスは、開発者が最も頻繁に遭遇する問題の一つです。モデルベンダーごとにパスの仕様が異なり、OpenAIは /v1、Anthropic Claudeはルートドメイン、Google Geminiは /v1beta を使用します。これらの違いを理解していないと、呼び出し時に必ずエラーが発生します。

APIYIプラットフォームは、これら3種類のパス仕様を完全にサポートしており、さらに3つのドメインノード（国内メイン、国内バックアップ、海外専用）を提供することで、世界中どこからでも安定した接続を保証します。本記事では、分かりやすい表とコード例を用いて、あらゆるシナリオで一度の設定で正しく接続できるように解説します。

核心的価値: 本記事を読めば、APIYIのBase URLの完全な設定方法をマスターでき、パスの間違いによる無駄なデバッグ時間を削減できます。

APIYI Base URL 核心要点

要点	说明	价值
3 种路径规范	/v1 通用、根域名适配 Claude、/v1beta 适配 Gemini	一个平台兼容所有主流 SDK
3 个域名节点	国内主力、国内备用、海外专属	全球低延迟 + 高可用容灾
OpenAI 兼容格式	使用 /v1 路径即可调用 GPT、DeepSeek、Llama 等	改一行 base_url 即可迁移
原生 SDK 直连	Claude 和 Gemini 可直接用官方 SDK，无需转换	零改造成本接入

APIYI Base URL 路径规范详解

不同 AI 厂商在设计 API 时，选择了不同的路径风格。这不是随意的，而是各家 SDK 内部的硬性约定：

OpenAI 系（/v1）：OpenAI 从一开始就在 URL 中使用了 /v1 版本前缀。它的 Python SDK 会将你设置的 base_url（包含 /v1）与资源路径（如 /chat/completions）直接拼接。所有 OpenAI 兼容模型——GPT 系列、DeepSeek、Llama、Qwen、MiniMax 等——都遵循这个约定。

Anthropic 系（根域名）：Anthropic 选择了不同的方式——SDK 内部自行拼接 /v1/messages 路径，因此 base_url 只需要填写根域名，不能带 /v1。如果你错误地填了 /v1，SDK 会拼出 /v1/v1/messages，导致 404 错误。

Google Gemini 系（/v1beta）：Google 习惯用 /v1beta 标识尚未 GA（General Availability）的 API。Gemini 的端点格式是 /v1beta/models/{model}:generateContent，SDK 也会自动处理路径拼接。

APIYI Base URL 域名节点选择

APIYI 提供 3 个域名节点，覆盖不同网络环境：

节点	域名	适用场景	说明
国内主力	api.apiyi.com	国内服务器、本地开发	推荐首选，延迟最低
国内备用	b.apiyi.com	主节点异常时切换	容灾备份，保障业务连续性
海外专属	vip.apiyi.com	海外服务器部署	海外线路优化，低延迟直连

🎯 选择建议: 国内用户优先使用 api.apiyi.com，代码中建议同时配置 b.apiyi.com 作为 fallback。海外部署的服务直接用 vip.apiyi.com。所有节点功能完全一致，只是网络线路不同。

---

APIYI Base URL 快速配置

场景一：调用 OpenAI 兼容模型（GPT / DeepSeek / Llama 等）

路径规则：域名 + /v1

import openai

client = openai.OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1"  # 国内主力 + /v1
)

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

场景二：调用 Claude 模型（Anthropic SDK）

路径规则：域名（根域名，不加 /v1）

import anthropic

client = anthropic.Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com"  # 根域名，无路径后缀
)

message = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)
print(message.content[0].text)

场景三：调用 Gemini 模型（Google GenAI SDK）

路径规则：域名 + /v1beta

from google import genai

client = genai.Client(
    api_key="YOUR_API_KEY",
    http_options={"api_version": "v1beta", "base_url": "https://api.apiyi.com"}
)

response = client.models.generate_content(
    model="gemini-2.5-pro",
    contents="Hello!"
)
print(response.text)

建议: 通过 APIYI apiyi.com 获取免费测试额度，以上三种场景均可在 5 分钟内完成配置验证。

APIYI Base URL 完全設定クイックリファレンス

以下の表は、ドメインとパスの組み合わせをまとめたものです。コピー＆ペーストしてそのままご利用いただけます。

APIYI Base URL 設定：OpenAI 互換モデル

ドメインノード	Base URL	対応モデル	対応 SDK
国内主力	https://api.apiyi.com/v1	GPT、DeepSeek、Llama、Qwen、MiniMax 等	OpenAI Python/Node SDK
国内予備	https://b.apiyi.com/v1	同上	同上
海外専用	https://vip.apiyi.com/v1	同上	同上

APIYI Base URL 設定：Claude モデル

ドメインノード	Base URL	対応モデル	対応 SDK
国内主力	https://api.apiyi.com	Claude Opus 4.6、Sonnet 4.6、Haiku 等	Anthropic Python/TS SDK
国内予備	https://b.apiyi.com	同上	同上
海外専用	https://vip.apiyi.com	同上	同上

APIYI Base URL 設定：Gemini モデル

ドメインノード	Base URL	対応モデル	対応 SDK
国内主力	https://api.apiyi.com/v1beta	Gemini 2.5 Pro、2.5 Flash 等	Google GenAI SDK
国内予備	https://b.apiyi.com/v1beta	同上	同上
海外専用	https://vip.apiyi.com/v1beta	同上	同上

🎯 設定のアドバイス: これら3つのパスの違いは、各社 SDK の内部実装によるものであり、APIYI 側の特殊な要件ではありません。この覚え方を活用してください——OpenAI は /v1 を付け、Claude は付けず、Gemini は /v1beta を付ける——これだけで設定ミスを防げます。

---

APIYI Base URL よくあるエラーとトラブルシューティング

よくあるエラーのトラブルシューティング：

エラー現象	考えられる原因	解決策
404 Not Found	OpenAI SDK で /v1 が不足、または Anthropic SDK で /v1 が余分	パスが SDK の仕様と一致しているか確認
400 Bad Request	Gemini SDK のパスバージョンが不一致	/v1beta を使用しているか確認
Connection Timeout	ドメインノードの選択が不適切	国内なら api.apiyi.com、海外なら vip.apiyi.com を使用
SSL Error	https:// 接頭辞の不足	すべてのノードで HTTPS を使用する必要があります
二重スラッシュ // エラー	base_url の末尾に / がある	末尾のスラッシュを削除してください

よくある質問

Q1: OpenAI SDK を使用して Claude モデルを呼び出す際、Base URL には何を入力すべきですか？

OpenAI SDK を使用して Claude を呼び出す場合（APIYI の OpenAI 互換インターフェース経由）、Base URL には https://api.apiyi.com/v1 を入力してください。GPT を呼び出す場合と同じです。ルートドメインを使用する必要があるのは、Anthropic 公式 SDK を使用する場合のみです。重要な違いは、呼び出すモデルではなく、どの SDK を使用しているかという点にあります。

Q2: 3つのドメインノードに機能の違いはありますか？

機能は完全に同一で、違いはネットワーク経路の最適化のみです。api.apiyi.com は国内（中国）からの遅延が最も少なく、vip.apiyi.com は海外からの遅延が最も少なくなります。b.apiyi.com は国内向けのバックアップ・災害対策用ノードです。コード内でフォールバック機構を構成し、メインノードがタイムアウトした際に自動的にバックアップノードへ切り替わるようにすることをお勧めします。

Q3: Base URL の設定が正しいか素早く検証する方法は？

APIYI プラットフォームを使用した検証をお勧めします：

1. APIYI (apiyi.com) にアクセスしてアカウントを登録し、APIキーを取得します。
2. 本記事のコード例を使用し、YOUR_API_KEY を置き換えて実行します。
3. 正常なレスポンスが返ってくれば設定は正解です。404 や 400 エラーが出る場合は、パスが SDK の仕様と一致しているか確認してください。

---

まとめ

APIYI の Base URL 設定における重要なポイント：

1. パスのルール: OpenAI SDK は /v1、Anthropic SDK はルートドメイン（パスのサフィックスなし）、Google GenAI SDK は /v1beta を使用します。
2. ドメインの選択: 国内は api.apiyi.com を優先し、海外は vip.apiyi.com、バックアップには b.apiyi.com を使用してください。
3. 注意点: Anthropic SDK に /v1 を付けないこと、OpenAI SDK で /v1 を忘れないこと、末尾にスラッシュを付けないことに注意してください。

「OpenAI は /v1 を付け、Claude は付けない、Gemini は /v1beta を付ける」というルールを覚えておけば、設定ミスを防げます。

APIYI (apiyi.com) で無料枠を取得して素早く検証することをお勧めします。当プラットフォームはこれら3つのパス仕様すべてに統一して対応しており、主要なすべてのモデルのモデル呼び出しをサポートしています。

📚 参考資料

1. OpenAI API ドキュメント: API 接続および SDK の使用方法

   • リンク: platform.openai.com/docs/api-reference
   • 説明: OpenAI 公式 API リファレンス。/v1 パスの仕様を理解するために。

2. Anthropic API ドキュメント: Claude モデル接続ガイド

   • リンク: docs.anthropic.com/en/api/getting-started
   • 説明: Anthropic SDK の base_url 仕様を理解するために。

3. Google AI for Developers: Gemini API 接続説明

   • リンク: ai.google.dev/gemini-api/docs
   • 説明: /v1beta パスおよび GenAI SDK の設定を理解するために。

4. APIYI プラットフォームドキュメント: クイックスタートおよび設定ガイド

   • リンク: docs.apiyi.com
   • 説明: APIキーの取得、モデルリスト、マルチノード設定について。

---

著者: APIYI 技術チーム
技術交流: コメント欄での議論を歓迎します。その他の資料については、APIYI ドキュメントセンター（docs.apiyi.com）をご覧ください。