Pemetaan Rute
| Beban kerja yang ada | URL dasar TokenLab | Titik akhir utama | Catatan migrasi |
|---|---|---|---|
| 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 ketika aplikasi Anda bergantung pada input, alat, atau penanganan output yang spesifik untuk 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 bidang asli Gemini di rute Gemini |
| Generasi media | https://api.tokenlab.sh/v1 | /images, /videos, /music, /3d | Temukan model dengan recommended_for dan harapkan polling asinkron di mana didokumentasikan |
| Manajemen dan penagihan | https://api.tokenlab.sh/v1 | /management/... | Gunakan token manajemen untuk penggunaan sisi server dan rekonsiliasi penagihan |
Migrasi yang Kompatibel dengan OpenAI
GET /v1/models sebelum lalu lintas produksi. Untuk generasi gambar, kirim model secara eksplisit dan baca panduan gambar karena model gambar berbeda lebih dari model chat.
Migrasi Anthropic
/v1/messages untuk penggunaan alat asli Claude, alur pemikiran, dan semantik pesan Anthropic. Jangan terjemahkan bidang yang hanya ada di Anthropic melalui Chat Completions kecuali Anda sengaja ingin mengubah perilaku menjadi kompatibel dengan OpenAI.
Migrasi Gemini
/v1beta ketika aplikasi Anda bergantung pada perilaku asli Gemini.
Migrasi Media
- Kuery
GET /v1/models?recommended_for=image|video|music|3d. - Baca
tokenlab.public_contract_summarydalam respons daftar dantokenlab.public_contractlengkap di mana tersedia. - Kirim
modelsecara eksplisit, terutama untuk titik akhir gambar. - Simpan
task_id,poll_url, titik akhir, model, dan ID pekerjaan Anda sendiri untuk pekerjaan asinkron. - Rekonsiliasi biaya melalui catatan penggunaan dan
billing_transaction_id, bukan ID tugas penyedia.
Rencana Peluncuran Produksi
| Fase | Tujuan | Pemeriksaan |
|---|---|---|
| 1. Inventaris | Daftar titik akhir, model, bidang permintaan, perilaku streaming/asinkron, dan pemilik penagihan | Tidak ada bidang penyedia yang tersembunyi yang dianggap publik |
| 2. Pilot satu rute | Pindahkan satu titik akhir dan satu keluarga model | Bentuk respons, biaya, dan log sesuai harapan |
| 3. Bayangan atau sampel | Bandingkan output yang dipilih dengan penyedia sebelumnya | Kualitas dan latensi yang terlihat oleh pengguna dapat diterima |
| 4. Peluncuran bertahap | Tingkatkan lalu lintas berdasarkan kunci, organisasi, atau fitur flag | Pantau 4xx, 5xx, latensi, keseimbangan, dan pekerjaan asinkron duplikat |
| 5. Pembersihan | Hapus jalur penyedia lama hanya setelah penggunaan stabil | Jalur rollback dan buku panduan dukungan didokumentasikan |
Perangkap Migrasi
- Jangan letakkan setiap model di belakang satu jalur OpenAI Chat Completions jika aplikasi Anda membutuhkan perilaku asli Anthropic, Gemini, atau Responses.
- Jangan menganggap default gambar lama. Kirim
modelsecara eksplisit. - Jangan coba ulang permintaan pembuatan asinkron tanpa memeriksa apakah tugas sudah dibuat.
- Jangan ungkapkan metadata routing penyedia di log atau UI Anda.
- Jangan bandingkan penagihan dengan ID tugas penyedia. Gunakan catatan penggunaan TokenLab.
Referensi API
| Topik | Referensi |
|---|---|
| API Multi-Format | API Multi-Format |
| OpenAI SDK | OpenAI SDK |
| Anthropic SDK | Anthropic SDK |
| Gemini Native | Gemini Native API |
| Generasi Gambar | Generasi Gambar |
| Pekerjaan Asinkron & Polling | Pekerjaan Asinkron & Polling |