3 cara mengonfigurasi Base URL APIYI: /v1 untuk umum, domain root untuk adaptasi Claude, dan /v1beta untuk adaptasi Gemini

Catatan Penulis: Penjelasan mendalam tentang 3 jalur Base URL dan 3 node domain di platform APIYI, membantu pengembang melakukan konfigurasi dengan benar sejak awal dan menghindari kendala teknis.

Saat mengonfigurasi API untuk Model Bahasa Besar, kesalahan pengisian Base URL adalah salah satu masalah yang paling sering dihadapi pengembang. Vendor model yang berbeda menggunakan spesifikasi jalur yang berbeda—OpenAI menggunakan /v1, Anthropic Claude menggunakan domain root, dan Google Gemini menggunakan /v1beta—jika Anda tidak memahami perbedaan ini, pemanggilan model pasti akan gagal.

Platform APIYI sepenuhnya kompatibel dengan ketiga spesifikasi jalur tersebut dan menyediakan 3 node domain (Utama domestik, Cadangan domestik, dan Khusus luar negeri) untuk memastikan akses yang stabil secara global. Artikel ini akan membantu Anda mengonfigurasi semua skenario dengan tepat melalui tabel dan contoh kode yang jelas.

Nilai Inti: Setelah membaca artikel ini, Anda akan menguasai metode konfigurasi Base URL APIYI secara lengkap dan tidak akan membuang waktu debugging karena kesalahan jalur.

Poin Utama Base URL APIYI

Poin	Penjelasan	Nilai Tambah
3 Spesifikasi Jalur	`/v1` umum, domain root untuk Claude, `/v1beta` untuk Gemini	Satu platform kompatibel dengan semua SDK utama
3 Node Domain	Utama domestik, cadangan domestik, khusus luar negeri	Latensi rendah global + toleransi kesalahan tinggi
Format Kompatibel OpenAI	Gunakan jalur `/v1` untuk memanggil GPT, DeepSeek, Llama, dll.	Migrasi cukup ubah satu baris `base_url`
Koneksi Langsung SDK Asli	Claude dan Gemini bisa pakai SDK resmi tanpa konversi	Integrasi tanpa biaya modifikasi

Penjelasan Detail Spesifikasi Base URL APIYI

Vendor AI yang berbeda memilih gaya jalur yang berbeda saat merancang API. Ini bukan sembarangan, melainkan kesepakatan internal dari SDK masing-masing:

Seri OpenAI (/v1): Sejak awal, OpenAI menggunakan awalan versi /v1 di URL. Python SDK-nya akan langsung menggabungkan base_url yang Anda atur (termasuk /v1) dengan jalur sumber daya (seperti /chat/completions). Semua model yang kompatibel dengan OpenAI—seri GPT, DeepSeek, Llama, Qwen, MiniMax, dll.—mengikuti aturan ini.

Seri Anthropic (Domain Root): Anthropic memilih cara yang berbeda—SDK secara internal menggabungkan jalur /v1/messages sendiri, sehingga base_url hanya perlu diisi dengan domain root, tidak boleh menyertakan /v1. Jika Anda salah memasukkan /v1, SDK akan menghasilkan /v1/v1/messages, yang menyebabkan kesalahan 404.

Seri Google Gemini (/v1beta): Google terbiasa menggunakan /v1beta untuk menandai API yang belum GA (General Availability). Format endpoint Gemini adalah /v1beta/models/{model}:generateContent, dan SDK juga akan menangani penggabungan jalur secara otomatis.

Pemilihan Node Domain Base URL APIYI

APIYI menyediakan 3 node domain untuk mencakup berbagai lingkungan jaringan:

Node	Domain	Skenario Penggunaan	Penjelasan
Utama Domestik	`api.apiyi.com`	Server domestik, pengembangan lokal	Pilihan utama, latensi terendah
Cadangan Domestik	`b.apiyi.com`	Beralih saat node utama bermasalah	Cadangan bencana, menjamin kelangsungan bisnis
Khusus Luar Negeri	`vip.apiyi.com`	Deployment server luar negeri	Optimasi jalur luar negeri, koneksi langsung latensi rendah

🎯 Saran Pemilihan: Pengguna domestik sebaiknya menggunakan api.apiyi.com, dan disarankan untuk mengonfigurasi b.apiyi.com sebagai fallback dalam kode. Layanan yang dideploy di luar negeri langsung gunakan vip.apiyi.com. Fungsi semua node sama persis, hanya jalur jaringannya yang berbeda.

Konfigurasi Cepat Base URL APIYI

Skenario 1: Memanggil model yang kompatibel dengan OpenAI (GPT / DeepSeek / Llama, dll.)

Aturan jalur: Domain + /v1

import openai

client = openai.OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1"  # Utama domestik + /v1
)

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

Skenario 2: Memanggil model Claude (Anthropic SDK)

Aturan jalur: Domain (domain root, tanpa /v1)

import anthropic

client = anthropic.Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com"  # Domain root, tanpa akhiran jalur
)

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

Skenario 3: Memanggil model Gemini (Google GenAI SDK)

Aturan jalur: Domain + /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="Halo!"
)
print(response.text)

Saran: Dapatkan kuota uji coba gratis melalui APIYI apiyi.com, ketiga skenario di atas dapat dikonfigurasi dan diverifikasi dalam waktu 5 menit.

Tabel Referensi Cepat Konfigurasi Base URL APIYI

Berikut adalah kombinasi lengkap domain × path yang bisa langsung Anda salin dan gunakan:

Konfigurasi Base URL APIYI: Model Kompatibel OpenAI

Node Domain	Base URL	Model yang Didukung	SDK yang Didukung
Utama Domestik	`https://api.apiyi.com/v1`	GPT, DeepSeek, Llama, Qwen, MiniMax, dll.	OpenAI Python/Node SDK
Cadangan Domestik	`https://b.apiyi.com/v1`	Sama seperti di atas	Sama seperti di atas
Eksklusif Luar Negeri	`https://vip.apiyi.com/v1`	Sama seperti di atas	Sama seperti di atas

Konfigurasi Base URL APIYI: Model Claude

Node Domain	Base URL	Model yang Didukung	SDK yang Didukung
Utama Domestik	`https://api.apiyi.com`	Claude Opus 4.6, Sonnet 4.6, Haiku, dll.	Anthropic Python/TS SDK
Cadangan Domestik	`https://b.apiyi.com`	Sama seperti di atas	Sama seperti di atas
Eksklusif Luar Negeri	`https://vip.apiyi.com`	Sama seperti di atas	Sama seperti di atas

Konfigurasi Base URL APIYI: Model Gemini

Node Domain	Base URL	Model yang Didukung	SDK yang Didukung
Utama Domestik	`https://api.apiyi.com/v1beta`	Gemini 2.5 Pro, 2.5 Flash, dll.	Google GenAI SDK
Cadangan Domestik	`https://b.apiyi.com/v1beta`	Sama seperti di atas	Sama seperti di atas
Eksklusif Luar Negeri	`https://vip.apiyi.com/v1beta`	Sama seperti di atas	Sama seperti di atas

🎯 Saran Konfigurasi: Perbedaan ketiga path ini ditentukan oleh implementasi internal dari masing-masing SDK, bukan persyaratan khusus dari APIYI. Ingat aturan praktis ini—OpenAI pakai /v1, Claude tidak pakai, Gemini pakai /v1beta—maka Anda tidak akan salah konfigurasi.

Kesalahan Umum dan Pemecahan Masalah Base URL APIYI

Pemecahan masalah kesalahan umum:

Gejala Kesalahan	Kemungkinan Penyebab	Solusi
404 Not Found	OpenAI SDK kurang `/v1`, atau Anthropic SDK kelebihan `/v1`	Periksa apakah path sesuai spesifikasi SDK
400 Bad Request	Versi path Gemini SDK tidak cocok	Pastikan menggunakan `/v1beta`
Connection Timeout	Pemilihan node domain tidak tepat	Gunakan `api.apiyi.com` untuk domestik, `vip.apiyi.com` untuk luar negeri
SSL Error	Kurang awalan `https://`	Semua node wajib menggunakan HTTPS
Error garis miring ganda `//`	Ada `/` tambahan di akhir base_url	Hapus garis miring di bagian akhir

Pertanyaan Umum (FAQ)

Q1: Apa yang harus diisi pada Base URL saat memanggil model Claude menggunakan OpenAI SDK?

Jika Anda menggunakan OpenAI SDK untuk memanggil Claude (melalui antarmuka kompatibel OpenAI dari APIYI), isi Base URL dengan https://api.apiyi.com/v1, sama seperti saat memanggil GPT. Anda hanya perlu menggunakan domain root jika menggunakan SDK resmi Anthropic. Perbedaan kuncinya terletak pada SDK mana yang Anda gunakan, bukan pada model yang Anda panggil.

Q2: Apakah ada perbedaan fungsi antara ketiga node domain tersebut?

Fungsinya benar-benar sama, perbedaannya hanya terletak pada optimalisasi jalur jaringan. api.apiyi.com memiliki latensi terendah di dalam negeri (Indonesia/Asia), vip.apiyi.com memiliki latensi terendah untuk akses luar negeri, dan b.apiyi.com adalah node cadangan untuk pemulihan bencana di dalam negeri. Disarankan untuk mengonfigurasi mekanisme fallback dalam kode Anda agar node utama secara otomatis beralih ke node cadangan jika terjadi timeout.

Q3: Bagaimana cara memverifikasi konfigurasi Base URL dengan cepat?

Kami merekomendasikan penggunaan platform APIYI untuk verifikasi:

Kunjungi apiyi.com untuk mendaftar akun dan mendapatkan kunci API.
Gunakan contoh kode dalam artikel ini, ganti YOUR_API_KEY dengan kunci Anda, lalu jalankan.
Jika respons yang dikembalikan normal, berarti konfigurasi sudah benar; jika muncul error 404 atau 400, periksa apakah path sudah sesuai dengan spesifikasi SDK.

Kesimpulan

Poin utama konfigurasi Base URL APIYI:

Aturan Path: OpenAI SDK menggunakan /v1, Anthropic SDK menggunakan domain root (tanpa akhiran path), dan Google GenAI SDK menggunakan /v1beta.
Pemilihan Domain: Prioritaskan api.apiyi.com untuk akses lokal, gunakan vip.apiyi.com untuk luar negeri, dan b.apiyi.com sebagai cadangan.
Tips Menghindari Kesalahan: Jangan menambahkan /v1 pada Anthropic SDK, jangan melewatkan /v1 pada OpenAI SDK, dan jangan tambahkan garis miring (slash) di bagian akhir.

Ingat rumusnya—OpenAI pakai /v1, Claude tidak pakai, Gemini pakai /v1beta—dengan begitu konfigurasi Anda tidak akan salah.

Disarankan untuk mendapatkan kuota gratis melalui apiyi.com untuk verifikasi cepat. Platform ini secara seragam mendukung ketiga spesifikasi path tersebut dan mendukung pemanggilan API untuk semua model utama.

📚 Referensi

Dokumentasi API OpenAI: Petunjuk akses API dan penggunaan SDK
- Tautan: platform.openai.com/docs/api-reference
- Penjelasan: Referensi API resmi OpenAI, memahami spesifikasi jalur /v1
Dokumentasi API Anthropic: Panduan akses model Claude
- Tautan: docs.anthropic.com/en/api/getting-started
- Penjelasan: Memahami spesifikasi base_url SDK Anthropic
Google AI for Developers: Petunjuk akses API Gemini
- Tautan: ai.google.dev/gemini-api/docs
- Penjelasan: Memahami jalur /v1beta dan konfigurasi SDK GenAI
Dokumentasi Platform APIYI: Panduan akses cepat dan konfigurasi
- Tautan: docs.apiyi.com
- Penjelasan: Cara mendapatkan kunci API, daftar model, dan konfigurasi multi-node

Penulis: Tim Teknis APIYI
Diskusi Teknis: Mari berdiskusi di kolom komentar. Untuk materi lebih lanjut, silakan kunjungi pusat dokumentasi APIYI di docs.apiyi.com

3 cara mengonfigurasi Base URL APIYI: /v1 untuk umum, domain root untuk adaptasi Claude, dan /v1beta untuk adaptasi Gemini

Poin Utama Base URL APIYI

Penjelasan Detail Spesifikasi Base URL APIYI

Pemilihan Node Domain Base URL APIYI

Konfigurasi Cepat Base URL APIYI

Skenario 1: Memanggil model yang kompatibel dengan OpenAI (GPT / DeepSeek / Llama, dll.)

Skenario 2: Memanggil model Claude (Anthropic SDK)

Skenario 3: Memanggil model Gemini (Google GenAI SDK)

Tabel Referensi Cepat Konfigurasi Base URL APIYI

Konfigurasi Base URL APIYI: Model Kompatibel OpenAI

Konfigurasi Base URL APIYI: Model Claude

Konfigurasi Base URL APIYI: Model Gemini

Kesalahan Umum dan Pemecahan Masalah Base URL APIYI

Pertanyaan Umum (FAQ)

Kesimpulan

📚 Referensi

OpenClaw Mengakses Claude: 2 Cara Konfigurasi – Mode Kompatibel OpenAI vs Format Asli Claude, Tutorial Lengkap

API Seedream 5.0 Lite Diluncurkan: Pilihan Baru Pembuatan Gambar AI yang Lebih Murah dari 4.5 ($0.035/gambar)

Gratis Coba Nano Banana 2: APIYI Beri Kredit $0.05, 2 Cara Uji Pembuatan Gambar Tanpa Biaya

Menguasai Model Seed 2.0 Lite 260228: Proksi Resmi BytePlus Diluncurkan, 256K Jendela Konteks Hanya $0.25/M Token Analisis Menyeluruh

Gemini 3.1 Pro Preview API Sudah Tersedia di APIYI: Analisis 6 Peningkatan Inti yang Menggandakan Performa Inferensi

3 Langkah Konfigurasi OpenCode Mengakses Stasiun Relay API, Membuka Akses 400+ Model AI Secara Bebas

Poin Utama Base URL APIYI

Penjelasan Detail Spesifikasi Base URL APIYI

Pemilihan Node Domain Base URL APIYI

Konfigurasi Cepat Base URL APIYI

Skenario 1: Memanggil model yang kompatibel dengan OpenAI (GPT / DeepSeek / Llama, dll.)

Skenario 2: Memanggil model Claude (Anthropic SDK)

Skenario 3: Memanggil model Gemini (Google GenAI SDK)

Tabel Referensi Cepat Konfigurasi Base URL APIYI

Konfigurasi Base URL APIYI: Model Kompatibel OpenAI

Konfigurasi Base URL APIYI: Model Claude

Konfigurasi Base URL APIYI: Model Gemini

Kesalahan Umum dan Pemecahan Masalah Base URL APIYI

Pertanyaan Umum (FAQ)

Kesimpulan

📚 Referensi

Similar Posts