menggunakan base_url yang salah
Menggunakan URL asas OpenAI piawai menyebabkan permintaan anda gagal atau disalurkan ke model yang berbeza sepenuhnya. API kami memerlukan anda menukar base_url ke https://api.whatisopenrouterai.com/v1. Satu baris konfigurasi ini memastikan SDK anda menyambung ke pelayan kami bukannya infrastruktur OpenAI global.
Ramai pembangun menyalin tampal kod sedia ada mereka tanpa mengemas kini pembolehubah ini. Jika anda meninggalkan URL lalai, anda akan sama ada mendapat ralat 404 atau melanggar model yang tidak tanpa sensor. Sentiasa sahkan sambungan dengan memeriksa /v1/models endpoint. Anda sepatutnya melihat ID model khusus kami disenaraikan di sana. Ini mengesahkan bahawa perutean adalah betul sebelum anda menghantar permintaan penyelesaian pertama anda.
melupakan untuk menetapkan model id
Walaupun dengan URL asas yang betul, membiarkan ID model kosong akan memilih model generik atau lama. Anda mesti menetapkan secara eksplisit model parameter kepada "uncensored" dalam setiap permintaan. Ini memberitahu lapisan pengarah kami untuk melayani model berat terbuka khusus yang ditala untuk kandungan tanpa sekatan.
Tanpa arahan eksplisit ini, anda mungkin menerima model yang berbeza dengan peraturan penyelarasan yang berbeza. Sesetengah model menolak topik dewasa yang sah secara lalai. Dengan memaksa uncensored ID, you guarantee the behavior you expect. Check your code for any hardcoded model names that might override your SDK defaults.
mengabaikan had token dan ralat
Melampaui tingkap konteks 100,000 token atau had output 16,000 token menyebabkan kegagalan permintaan serta-merta. API kami mengenakan had output maksimum 16,000 token per permintaan. Jika anda tidak menetapkan max_tokens, nilai lalai ialah hanya 2,048 token. Ini sering terlalu pendek untuk tugas penalaran kompleks.
Kesilapan dan penolakan tidak menggunakan kredit pra-bayar anda. Walau bagaimanapun, permintaan yang tidak sah yang melanggar had kadar atau melebihi saiz badan (8 MB) masih dikira terhadap kuota anda. Pantau header respons anda untuk penggunaan token. Laraskan kejuruteraan prompt anda agar muat dalam tetingkap konteks. Ini mencegah percubaan semula yang mahal dan memastikan aliran data yang lancar.
memahami pengebilan pra-dibayar
Baki akaun anda dikaitkan dengan kredit prabayar, bukan langganan bulanan. Kami caj $0.15 bagi setiap 1M token input dan $0.50 bagi setiap 1M token output. Ralat adalah percuma, tetapi penyelesaian berjaya akan menggunakan kredit. Anda mesti menambah baki melalui kripto untuk mengekalkan ketersediaan perkhidmatan.
Kami menerima USDT (TRC20) atau USDC (Base) untuk penambahan baki. Deposit minimum bermula pada $20. Bonus terpakai pada tahap yang lebih tinggi: +5% dari $50, +10% dari $100, dan +15% dari $200. Kredit tidak pernah luput. Pastikan baki anda positif sebelum menjalankan batch besar. Semak papan pemuka untuk mengesahkan baki semasa dan transaksi terkini anda.
membingungkan penstriman dengan respons standard
Penstriman melalui SSE mengubah cara anda menafsirkan aliran respons. Respons piawai mengembalikan satu objek JSON. Penstriman mengembalikan beberapa potongan. Anda mesti mengendalikan potongan akhir untuk mendapatkan statistik penggunaan token yang tepat.
Implementasi penstriman kami termasuk penggunaan token dalam chunk terakhir. Jika anda menghentikan pembacaan penstriman awal, anda mungkin terlepas data ini. Pastikan pustaka klien anda menyokong SSE dengan betul. Ini penting untuk aplikasi masa nyata di mana anda memaparkan token semasa penjanaan. Penstriman yang dikonfigurasi dengan salah boleh menyebabkan teks tidak lengkap atau keadaan UI yang rosak.
ralat konfigurasi tool_choice
Salah tool_choice tetapan boleh menghalang pemanggilan fungsi daripada berfungsi seperti yang dikehendaki. Anda boleh memaksa alat tertentu atau membiarkan model membuat keputusan. Konfigurasi yang salah sering menyebabkan model mengabaikan fungsi yang tersedia.
Gunakan tool_choice untuk mengawal sama ada model memanggil alat secara automatik. Tetapkan ia kepada "auto" untuk fleksibiliti atau nyatakan ID alat untuk tingkah laku ketat. Pastikan definisi fungsi anda sepadan dengan skema yang dijangka. Ini mengelakkan ralat masa larian apabila model cuba memanggil fungsi yang tidak wujud. Ujian definisi alat anda dengan teliti sebelum menyebarkan ke pengeluaran.
mod json_object yang hilang
Tanpa response_format: {"type": "json_object"}, model mungkin mengeluarkan markdown atau teks biasa. Ini mengganggu pengurai yang mengharapkan JSON yang ketat. Aktifkan mod JSON untuk memastikan output yang konsisten dan boleh diuraikan.
Ciri ini penting untuk integrasi dengan sistem hujung yang memerlukan data berstruktur. Ia mengurangkan beban pemprosesan semula dengan ketara. Sentiasa mengesahkan skema output dalam kod klien anda. Ini memastikan ketahanan terhadap halusinasi model yang jarang berlaku. Gunakan mod ini apabila mengekstrak entiti atau menjana fail konfigurasi.
kejutan had kadar
API kami membenarkan 300 permintaan setiap minit per kunci. Melebihi had ini akan menghasilkan respons 429 Too Many Errors. Permintaan serentak dihadkan kepada 8 per kunci. Rancang tetapan serentak anda dengan sewajarnya.
Jika anda menjalankan beberapa proses, pastikan mereka berkongsi kunci yang sama atau jana kunci berasingan. Setiap akaun menyokong satu kunci aktif. Kunci baharu akan menggantikan kunci lama. Pantau header had kadar anda dalam respons. Laksanakan penangguhan eksponen dalam logik cubaan semula anda. Ini menghalang kegagalan bertingkat semasa tempoh trafik tinggi.
kelewatan tambahan baki crypto
Transaksi crypto mungkin mengambil masa untuk disahkan pada blockchain. Kredit anda mungkin tidak muncul serta-merta selepas menghantar dana. Gunakan rangkaian yang betul: TRC20 untuk USDT atau Base untuk USDC. Menghantar ke rangkaian yang salah menyebabkan kehilangan dana.
Top-up bermula dari $20 hingga $500. Pastikan anda menghantar jumlah tepat atau mengambil kira yuran rangkaian. Semak hash transaksi pada pelayar blockchain. Jika kredit tertunda, hubungi sokongan dengan ID transaksi. Jangan andaikan pembayaran gagal serta-merta. Kesabaran semasa kesesakan rangkaian adalah kunci kepada operasi yang lancar.
