Panduan inti
Panduan Migrasi
Pindahkan klien OpenAI, Anthropic, Gemini, dan media yang sudah ada ke TokenLab
Pertahankan format permintaan yang sudah digunakan oleh aplikasi Anda. Klien yang kompatibel dengan OpenAI, Anthropic Messages, Gemini REST, dan endpoint media masing-masing memiliki alamat API TokenLab yang sesuai.
Pemetaan API
| API yang Ada | URL dasar TokenLab | Endpoint | Perlu diingat |
|---|---|---|---|
| OpenAI Chat Completions | https://api.tokenlab.sh/v1 | /chat/completions | Perubahan terkecil untuk chat dan pemanggilan fungsi yang kompatibel dengan OpenAI |
| OpenAI Responses | https://api.tokenlab.sh/v1 | /responses | Gunakan jika aplikasi Anda bergantung pada input, tools, atau penanganan output khusus Responses |
| Anthropic SDK | https://api.tokenlab.sh | /v1/messages | Jangan tambahkan /v1 ke URL dasar SDK |
| Gemini REST | https://api.tokenlab.sh | /v1beta/models/:model:generateContent | Pertahankan field asli Gemini pada rute Gemini |
| Pembuatan media | https://api.tokenlab.sh/v1 | /images/generations, /videos/generations, /music/generations, /3d/generations | Temukan model dengan recommended_for dan antisipasi polling asinkron di mana pun didokumentasikan |
| Manajemen dan penagihan | https://api.tokenlab.sh/v1 | /management/... | Panggilan sisi server menggunakan token manajemen, bukan kunci API model |
Resep Migrasi Cepat
OpenAI ke TokenLab
Ubah base_url / baseURL SDK ke https://api.tokenlab.sh/v1, ganti kunci API, dan pilih ID model dari GET /v1/models.
OpenRouter ke TokenLab
Ganti URL dasar OpenRouter dengan https://api.tokenlab.sh/v1. ID model TokenLab tidak menyertakan prefiks penyedia OpenRouter. Gunakan Anthropic Messages atau Gemini hanya jika aplikasi Anda memerlukan field dari format tersebut.
LiteLLM ke TokenLab
Gunakan konfigurasi custom_openai/<model> pada LiteLLM dengan api_base: https://api.tokenlab.sh/v1. Pertahankan alias LiteLLM Anda terpisah dari ID model TokenLab agar keduanya dapat diubah tanpa perlu mengedit prompt aplikasi.
Claude Messages melalui TokenLab
Arahkan klien SDK Anthropic ke https://api.tokenlab.sh dan panggil messages.create. Jangan tambahkan /v1 ke URL dasar SDK; SDK sudah memiliki jalur /v1/messages.
Gemini Native melalui TokenLab
Pertahankan payload Gemini pada https://api.tokenlab.sh/v1beta/models/{model}:generateContent. contents, parts, file, konten yang di-cache, deklarasi fungsi, dan tools bawaan asli Gemini harus tetap berada di rute ini jika aplikasi Anda bergantung pada perilaku Gemini.
Migrasi yang Kompatibel dengan OpenAI
from openai import OpenAI
client = OpenAI(
api_key="sk-your-tokenlab-key",
base_url="https://api.tokenlab.sh/v1",
)
response = client.chat.completions.create(
model="gpt-5.6-terra",
messages=[{"role": "user", "content": "Hello from TokenLab"}],
)Kode retry, timeout, dan streaming Anda yang sudah ada biasanya dapat tetap digunakan. Konfirmasikan ID model dengan GET /v1/models. Permintaan gambar harus menyertakan model secara eksplisit; lihat panduan gambar untuk input khusus model.
Migrasi Anthropic
from anthropic import Anthropic
client = Anthropic(
api_key="sk-your-tokenlab-key",
base_url="https://api.tokenlab.sh",
)
message = client.messages.create(
model="claude-sonnet-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Reply with: Connected to TokenLab."}],
)Gunakan /v1/messages untuk pemanggilan tool Claude, blok pemikiran (thinking blocks), dan field pesan Anthropic. Chat Completions tidak menjamin field tersebut tersedia.
Migrasi Gemini
curl "https://api.tokenlab.sh/v1beta/models/gemini-3.6-flash:generateContent" \
-H "Authorization: Bearer sk-your-tokenlab-key" \
-H "Content-Type: application/json" \
-d '{"contents":[{"parts":[{"text":"Hello"}]}]}'Pertahankan tools bawaan Gemini, referensi File API, konten yang di-cache, deklarasi fungsi, dan bagian konten asli pada /v1beta jika aplikasi Anda bergantung pada perilaku asli Gemini.
Migrasi Media
- Kueri
GET /v1/models?recommended_for=image|video|music|3d. - Baca daftar model dari
GET /v1/modelsdan detail lengkap dariGET /v1/models/{model}. - Kirim
modelsecara eksplisit, terutama untuk endpoint gambar. - Simpan
task_id,poll_url, endpoint, model, dan ID pekerjaan Anda sendiri untuk pekerjaan asinkron. Lakukan polling denganGET /v1/tasks/{id}. - Rekonsiliasi biaya melalui catatan penggunaan dan
billing_transaction_id, bukan ID tugas penyedia.
Pembuatan media dapat selesai secara asinkron, jadi simpan task_id dan poll_url sebelum mengganti integrasi yang ada. Timeout permintaan pembuatan tidak boleh menghasilkan pekerjaan pengguna kedua.
Kendala Migrasi
- Jangan menempatkan setiap model di balik satu jalur OpenAI Chat Completions jika aplikasi Anda memerlukan perilaku asli Anthropic, Gemini, atau Responses.
- Jangan berasumsi menggunakan default gambar yang lama. Kirim
modelsecara eksplisit. - Jangan mencoba ulang (retry) permintaan pembuatan asinkron tanpa memeriksa apakah tugas sudah dibuat sebelumnya.
- Gunakan ID tugas dan catatan penggunaan TokenLab di produk Anda. ID tugas pihak ketiga bukanlah pengenal penagihan.
Referensi API
| Topik | Referensi |
|---|---|
| Multi-Format API | Multi-Format API |
| OpenAI SDK | OpenAI SDK |
| Anthropic SDK | Anthropic SDK |
| Gemini Native | Gemini Native API |
| Pembuatan Gambar | Image Generation |
| Pekerjaan Asinkron & Polling | Async Jobs & Polling |