Quick Answer
Remember this: OpenAI models need /v1, Claude uses root domain only, Gemini needs /v1beta. Incorrect Base URL is the most common integration issue.
| Model Family | Base URL | SDK |
|---|
| GPT / DeepSeek / Llama / Qwen etc. | https://api.apiyi.com/v1 | OpenAI SDK |
| Claude series | https://api.apiyi.com | Anthropic SDK |
| Gemini series | https://api.apiyi.com | Google GenAI SDK (set api_version: "v1beta") |
Why Different Base URLs for Different Models?
This is determined by each vendor’s SDK implementation:
- OpenAI SDK: Appends resource paths after
base_url, so /v1 must be included
- Anthropic SDK: Internally appends
/v1/messages — adding /v1 yourself results in /v1/v1/messages (404 error)
- Google GenAI SDK: Uses
/v1beta path, SDK handles concatenation automatically
Code Examples
OpenAI-Compatible Models (GPT / DeepSeek / Llama etc.)
import openai
client = openai.OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.apiyi.com/v1" # Domain + /v1
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)
Claude Models (Anthropic SDK)
import anthropic
client = anthropic.Anthropic(
api_key="YOUR_API_KEY",
base_url="https://api.apiyi.com" # Root domain only, NO /v1
)
message = client.messages.create(
model="claude-sonnet-4-20250514",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello!"}]
)
print(message.content[0].text)
Gemini Models (Google GenAI SDK)
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)
Common mistake for Claude users: When using the official Anthropic SDK, Base URL should be https://api.apiyi.com only — do NOT add /v1. However, if you’re calling Claude through OpenAI SDK’s compatible mode, you DO need /v1.
Domain Node Selection
API.YI provides 3 domain nodes with identical features, differing only in network routing optimization:
| Node | Domain | Use Case |
|---|
| Domestic Primary | api.apiyi.com | Domestic servers, local development (recommended) |
| Domestic Backup | b.apiyi.com | Failover when primary is unavailable |
| Overseas Exclusive | vip.apiyi.com | Overseas server deployment |
We recommend configuring a fallback node in your code for automatic switching to improve service availability.
Common Error Troubleshooting
| Error | Possible Cause | Solution |
|---|
| 404 Not Found | Missing /v1 in OpenAI SDK, or extra /v1 in Anthropic SDK | Verify path matches SDK specification |
| 400 Bad Request | Gemini SDK path version mismatch | Confirm using /v1beta |
| Connection Timeout | Wrong domain node | Use api.apiyi.com domestically, vip.apiyi.com overseas |
| SSL Error | Missing https:// prefix | All nodes require HTTPS |
| Double Slash Error | Trailing / in base_url | Remove trailing slash |
Full Configuration Reference
OpenAI-Compatible Models
| Node | Base URL |
|---|
| Domestic Primary | https://api.apiyi.com/v1 |
| Domestic Backup | https://b.apiyi.com/v1 |
| Overseas Exclusive | https://vip.apiyi.com/v1 |
Claude Models (Anthropic SDK)
| Node | Base URL |
|---|
| Domestic Primary | https://api.apiyi.com |
| Domestic Backup | https://b.apiyi.com |
| Overseas Exclusive | https://vip.apiyi.com |
Gemini Models
| Node | Base URL |
|---|
| Domestic Primary | https://api.apiyi.com |
| Domestic Backup | https://b.apiyi.com |
| Overseas Exclusive | https://vip.apiyi.com |
When using the Google GenAI SDK for Gemini, set base_url to the root domain and api_version: "v1beta" — the SDK will automatically construct the full path.
