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 AdaURL dasar TokenLabEndpointPerlu diingat
OpenAI Chat Completionshttps://api.tokenlab.sh/v1/chat/completionsPerubahan terkecil untuk chat dan pemanggilan fungsi yang kompatibel dengan OpenAI
OpenAI Responseshttps://api.tokenlab.sh/v1/responsesGunakan jika aplikasi Anda bergantung pada input, tools, atau penanganan output khusus Responses
Anthropic SDKhttps://api.tokenlab.sh/v1/messagesJangan tambahkan /v1 ke URL dasar SDK
Gemini RESThttps://api.tokenlab.sh/v1beta/models/:model:generateContentPertahankan field asli Gemini pada rute Gemini
Pembuatan mediahttps://api.tokenlab.sh/v1/images/generations, /videos/generations, /music/generations, /3d/generationsTemukan model dengan recommended_for dan antisipasi polling asinkron di mana pun didokumentasikan
Manajemen dan penagihanhttps://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

  1. Kueri GET /v1/models?recommended_for=image|video|music|3d.
  2. Baca daftar model dari GET /v1/models dan detail lengkap dari GET /v1/models/{model}.
  3. Kirim model secara eksplisit, terutama untuk endpoint gambar.
  4. Simpan task_id, poll_url, endpoint, model, dan ID pekerjaan Anda sendiri untuk pekerjaan asinkron. Lakukan polling dengan GET /v1/tasks/{id}.
  5. 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 model secara 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

TopikReferensi
Multi-Format APIMulti-Format API
OpenAI SDKOpenAI SDK
Anthropic SDKAnthropic SDK
Gemini NativeGemini Native API
Pembuatan GambarImage Generation
Pekerjaan Asinkron & PollingAsync Jobs & Polling

Di halaman ini