# Apa yang Berubah Saat Memigrasikan Request OpenRouter ke API Kompatibel OpenAI Lain? > Mengganti base URL dan API key hanyalah langkah pertama saat meninggalkan OpenRouter. Field chat standar sering dapat dipindahkan, tetapi ID model, header dan ekstensi routing OpenRouter, fallback, streaming, akuntansi penggunaan, input multimodal, error, dan rate limit harus diuji di balik adapter penyedia. # Apa yang Berubah Saat Memigrasikan Request OpenRouter ke API Kompatibel OpenAI Lain? Untuk chat completion dasar, migrasi mungkin dimulai dengan base URL, API key, dan ID model baru. Perilaku production lebih luas daripada bentuk request itu. Routing, header, slug model, fallback, metadata, dan pemilihan penyedia khusus OpenRouter memerlukan pengganti yang disengaja, sedangkan streaming dan tool call memerlukan contract test. Perlakukan kompatibilitas OpenAI sebagai dialek transport bersama, bukan janji bahwa katalog, ekstensi, penagihan, atau perilaku operasional identik. ## Inventarisasi kontrak yang benar-benar digunakan Cari setiap field yang dikirim ke OpenRouter di kode, konfigurasi, dan log. Pengaturan OpenAI SDK yang didokumentasikan memakai `https://openrouter.ai/api/v1`, autentikasi bearer, dan header atribusi opsional. Aplikasi juga mungkin memakai ekstensi routing dan fallback. Buat inventaris sebelum mengubah apa pun: | Permukaan | Sering portabel | Biasanya perlu ditinjau | |---|---|---| | Request chat | `messages`, temperature, batas output | Parameter tidak didukung dan default | | Model | Maksud aplikasi | Slug model khusus penyedia | | Alat | Nama fungsi dan JSON schema | Panggilan paralel, strictness, streaming argumen | | Routing | Tidak ada | Preferensi penyedia, fallback, transforms | | Header | Pola otorisasi | Atribusi dan metadata OpenRouter | | Penggunaan | Jumlah token | Field biaya, cache, lookup request | | Operasi | Kelompok status HTTP | Rate limit, retry, timeout, isi error | ## Perkenalkan adapter penyedia terlebih dahulu Jangan menyebarkan URL dan slug model baru ke seluruh codebase. Tempatkan perbedaan penyedia di balik satu adapter dan ekspos alias tingkat aplikasi. ```python from openai import OpenAI def make_client(base_url: str, api_key: str) -> OpenAI: return OpenAI(base_url=base_url, api_key=api_key) MODEL_MAP = { "coding_default": { "openrouter": "provider/model-slug", "target": "target-model-id", } } ``` Adapter juga harus menerjemahkan field opsional, menormalisasi error, dan memancarkan skema peristiwa umum. ## Ganti semantik model dan routing ID model tidak distandardisasi oleh kompatibilitas OpenAI. Petakan setiap alias aplikasi ke model target dan verifikasi panjang konteks, dukungan alat, structured output, modality, dan harga dari katalog saat ini. OpenRouter mendukung routing dan fallback yang mungkin dinyatakan berbeda atau tidak tersedia di gateway lain. Putuskan apakah kebijakan dibuat ulang di orkestrasi, memakai router target, atau sengaja dihapus. Perubahan fallback diam-diam dapat mengubah biaya dan kualitas. ## Hapus atau terjemahkan ekstensi OpenRouter Tinjau header dan field body khusus OpenRouter. Header atribusi opsional biasanya dapat dihapus saat meninggalkan OpenRouter. Preferensi penyedia, array fallback, plugins, transforms, dan kontrol metadata memerlukan pemetaan eksplisit. Tolak ekstensi tidak dikenal selama pengujian. Mengabaikan field secara diam-diam membuat request terlihat berhasil meski perilakunya berubah. ## Uji kontrak alat dan streaming Tool calling adalah area yang sering berbeda di antara API yang tampak kompatibel. Uji: * penerimaan nama fungsi dan JSON schema; * mode tool choice dan panggilan paralel; * peristiwa argumen alat bertahap; * finish reason dan field refusal; * argumen rusak dan percobaan ulang. Untuk streaming, bandingkan urutan peristiwa yang telah diparse, bukan chunk mentah. Sertakan pembatalan, error di tengah stream, penggunaan akhir, delta kosong, dan retry koneksi. ## Bangun ulang akuntansi penggunaan dan biaya OpenRouter mendokumentasikan metadata generasi seperti model, penyedia, penggunaan token, dan total biaya. Gateway lain mungkin mengembalikan penggunaan dalam completion, menyediakan endpoint lookup terpisah, atau membutuhkan penetapan harga sisi client. Normalisasikan ke ledger Anda sendiri: ```json { "request_id": "internal_123", "provider_request_id": "external_456", "gateway": "target", "model": "resolved-model-id", "input_tokens": 1200, "output_tokens": 340, "cost_usd": 0.0123 } ``` Pisahkan estimasi dari biaya yang direkonsiliasi. Periksa kembali penegakan anggaran sebelum memindahkan agen production. ## Verifikasi bentuk request multimodal Dukungan gambar, audio, dan video bergantung pada model dan endpoint. Meski dua gateway mendukung modality yang sama, mereka dapat berbeda dalam schema content part, upload, akses URL, job asinkron, atau objek output. Buat fixture untuk setiap modality yang digunakan. Jangan menyimpulkan kompatibilitas media dari keberhasilan request teks. ## Uji perilaku operasional Ukur header rate limit, status yang bisa di-retry, timeout, antrean, kontrol regional, idempotency, logging, dan prosedur dukungan. Gunakan dokumentasi penyedia yang mutakhir. Rollout praktis memiliki empat gerbang: 1. Putar ulang golden request set secara offline. 2. Shadow traffic aman tanpa efek yang terlihat pengguna. 3. Canary sebagian kecil traffic berisiko rendah. 4. Perluas hanya selama error, latensi, biaya, dan kondisi output tetap dalam ambang. Pertahankan rollback satu sakelar sampai jalur baru lolos beban yang representatif. ## Putuskan apakah konsolidasi layak OpenRouter tetap cocok ketika katalog LLM yang luas dan kontrol routing sesuai produk. Gateway multimodal lengkap seperti Atlas Cloud dapat menarik ketika satu hubungan kompatibel OpenAI untuk teks, gambar, dan video menyederhanakan stack. Keduanya tetap memerlukan pengujian model dan fitur. Pilih berdasarkan kebutuhan workload yang terukur, bukan diff kode terkecil. ## Kesimpulan Saat memigrasikan traffic OpenRouter, ubah konfigurasi client lalu audit setiap asumsi nonstandar tentang model, routing, alat, streaming, penggunaan, dan operasi. Adapter penyedia dengan golden test menjaga migrasi dapat dibalik dan mencegah regresi semantik tersembunyi. ## FAQ ### Bisakah saya bermigrasi dari OpenRouter hanya dengan mengganti base_url dan api_key? Terkadang untuk request chat sederhana, tetapi integrasi production biasanya juga bergantung pada slug model, opsi routing, header, perilaku streaming, field penggunaan, atau semantik fallback. ### Field OpenRouter mana yang paling mungkin tidak portabel? Preferensi routing penyedia, array fallback model, header atribusi OpenRouter, transforms, plugins, dan metadata khusus OpenRouter adalah titik migrasi umum. Simpan semuanya di luar model request inti. ### Apakah API kompatibel OpenAI memakai nama model yang sama? Tidak. Kompatibilitas biasanya mencakup bentuk request, bukan identitas katalog. Petakan alias model aplikasi secara eksplisit ke ID model saat ini pada setiap gateway. ### Bagaimana menguji streaming setelah migrasi? Rekam urutan peristiwa untuk delta teks, argumen tool call, finish reason, penggunaan, pembatalan, dan error. Bandingkan peristiwa yang sudah diparse, bukan byte mentah, karena framing dapat berbeda. ### Apa rollout migrasi yang paling aman? Gunakan adapter, putar ulang golden request set, shadow sampel kecil tanpa dampak pada pengguna, lalu canary traffic berisiko rendah dengan ambang rollback untuk error, latensi, biaya, dan kondisi output. ### Kapan tim sebaiknya tetap menggunakan OpenRouter? Tetaplah jika katalog LLM yang luas, kontrol routing, dan tooling operasional yang ada lebih bernilai daripada konsolidasi di tempat lain. Dasarkan keputusan pada kebutuhan yang terukur, bukan hanya klaim kompatibilitas.