Memahami URL Asas
URL asas menentukan di mana klien anda menghantar permintaan. Ketidakpadanan di sini menyebabkan kegagalan sambungan serta-merta atau respons model yang tidak dijangka. Ramai pembangun mengandaikan URL OpenAI standard berfungsi secara universal, tetapi penyedia tanpa sensor sering menggunakan hujung berbeza untuk mengalukan trafik ke kumpulan model khusus.
Sahkan bahawa konfigurasi anda menunjuk ke https://api.openrouterabliteratedmodels.com/v1 untuk perkhidmatan kami. Jika anda menggunakan agregator pihak ketiga, pastikan URL asas sepadan dengan dokumentasi mereka dengan tepat. URL yang salah sering mengakibatkan ralat 404 atau respons dari model lalai bukannya varian tidak disensor yang dimaksudkan.
- Semak pembolehubah persekitaran anda untuk
BASE_URLatauAPI_HOST. - Pastukan laluan termasuk
/v1untuk keserasian piawai. - Uji sambungan dengan permintaan senarai model mudah sebelum penggunaan berat.
Mengendalian Had Kadar
Had kadar mengehadkan berapa banyak permintaan yang boleh anda hantar dalam tempoh masa tertentu. API kami mengenakan had 300 permintaan setiap minit per kunci. Melebihi ambang ini mengakibatkan ralat HTTP 429, yang secara sementara menyekat permintaan seterusnya sehingga tetingkap masa ditetapkan semula.
Selain itu, terdapat had permintaan serentak sebanyak 8 permintaan pada masa yang sama per kunci. Jika anda menghantar lebih daripada 8 permintaan serentak, lebihan akan berbaris atau gagal bergantung pada pustaka klien anda. Pantau kekonkurenan aplikasi anda untuk mengelakkan melanggar had keras ini. Gunakan strategi penangguhan eksponen dalam kod anda untuk mengendalikan ralat 429 dengan lancar tanpa membanjiri pelayan.
Perhatikan bahawa setiap kunci adalah unik untuk akaun anda. Berkongsi kunci merentas perkhidmatan berbilang boleh mempercepatkan pencapaian had ini. Jana kunci baru jika anda memerlukan kolam had kadar berasingan untuk bahagian aplikasi yang berbeza.
Respons Berstrim vs Tidak Berstrim
Penstriman mengembalikan data secara berperingkat semasa token dijana, manakala tanpa penstriman menunggu respons penuh. Penstriman penting untuk pengalaman pengguna masa nyata tetapi memerlukan penanganan yang teliti terhadap Peristiwa Dihantar Pelayan (SSE).
Semasa mengalirkan data, pecahan terakhir mengandungi statistik penggunaan token. Jika anda berhenti memproses awal, anda mungkin terlepas data ini. Pastikan klien anda menguraikan mesej SSE terakhir untuk mendapatkan kiraan token input dan output dengan tepat. Respons tanpa aliran lebih mudah tetapi boleh menyebabkan latensi tinggi untuk output yang panjang.
Pilih penstriman untuk antara muka sembang di mana pengguna melihat teks muncul huruf demi huruf. Gunakan bukan penstriman untuk pemprosesan secara berkumpulan atau apabila anda memerlukan respons lengkap sebelum meneruskan. API kami menyokong kedua-dua mod melalui stream parameter dalam badan permintaan.
Ralat Mod JSON
Mod JSON memastikan model mengeluarkan JSON yang sah, yang kritikal untuk integrasi programatik. Kesilapan di sini sering berpunca daripada header yang salah atau ketidakpadanan skema. API memerlukan response_format: {"type": "json_object"} untuk memaksakan output JSON yang ketat.
Jika anda menerima JSON yang rosak, semak definisi skema anda. Model mungkin termasuk blok kod markdown atau teks penjelasan di luar struktur JSON. Gunakan parser yang kukuh yang boleh menanggalkan pagar markdown atau mengesahkan output terhadap skema jangkaan anda. Elakkan skema yang terlalu kompleks yang boleh membingungkan model.
Uji dengan struktur mudah dahulu. Tambah kompleksiti secara beransur-ansur untuk mengenal pasti di mana model menghadapi kesukaran. Pastikan suhu anda ditetapkan dengan sesuai, kerana suhu yang lebih tinggi boleh meningkatkan rawak dan mengurangkan kesahihan JSON.
Kesilapan Kiraan Token
Bilangan token menentukan pengebilan dan penggunaan tetingkap konteks anda. Pengiraan yang salah boleh membawa kepada caj yang tidak dijangka atau respons yang terpotong. API kami mengenakan caj $0.15 setiap 1M token input dan $0.50 setiap 1M token output.
Gunakan perpustakaan penjenakan token yang dipercayai yang sepadan dengan skema penjenakan token model. Model berbeza mungkin menjenakan token ruang putih atau tanda baca dengan berbeza, menyebabkan perbezaan antara kiraan tempatan anda dan kiraan API. Sentiasa bergantung pada penggunaan token yang dikembalikan dalam respons untuk pengebilan yang tepat.
Perhatikan tingkap konteks anda, yang berjumlah 100,000 token secara keseluruhan. Melebihi had ini akan menyebabkan ralat. Potong mesej atau ringkasan lama untuk kekal dalam had. Pantau penggunaan token anda dari semasa ke semasa untuk mengoptimumkan struktur prompt anda dan mengurangkan kos.
Kelewatan Pembayaran Crypto
Top-up crypto melalui USDT (TRC20) atau USDC (Base) diproses serta-merta di pihak kami. Walau bagaimanapun, kesesakan rangkaian kadangkala boleh menyebabkan sedikit kelewatan dalam pengesahan. Pastikan anda menghantar jumlah dan rangkaian yang betul untuk mengelakkan kehilangan.
Top-up berJulat dari $20 hingga $500 dalam jumlah bulat. Kredit bonus terpakai secara automatik: +5% dari $50, +10% dari $100, dan +15% dari $200. Sahkan hash transaksi untuk mengesahkan pembayaran. Jika kredit tidak muncul dalam beberapa minit, semak pelayan pelayar blockchain untuk status transaksi.
Kredit tidak luput, jadi tiada keperluan untuk menggunakannya serta-merta. Kesilapan seperti caj berganda diselesaikan melalui Halaman Sokongan. Simpan rekod transaksi anda untuk rujukan mudah jika timbul isu.
Konfigurasi ID Model
ID model mengenal pasti versi model uncensored yang anda gunakan. Untuk perkhidmatan kami, ID model ialah uncensored. Menggunakan ID yang salah boleh menyebabkan kesilapan atau tingkah laku tidak dijangka.
Pastikan permintaan anda menentukan model: "uncensored" dalam badan permintaan. ID ini menunjuk kepada model berat terbuka khusus kami yang ditala untuk respons tanpa sekatan. Ia bukan pengenal umum tetapi penunjuk khusus ke arah contoh yang dihoskan kami.
Semak dokumentasi perpustakaan klien anda untuk cara menetapkan ID model. Sesetengah perpustakaan menggunakan model bidang, manakala yang lain mungkin menggunakan parameter yang berbeza. Keseragaman dalam penggunaan ID merentas aplikasi anda mengelakkan kekeliruan dan memastikan anda sentiasa memanggil model uncensored yang dimaksudkan.
Pelebihan Tetingkap Konteks
Jendela konteks menghadkan jumlah token keseluruhan yang boleh anda hantar dalam satu permintaan. API kami menyokong jendela 100,000 token, termasuk prompt dan penyelesaian. Melebihi had ini akan menyebabkan ralat.
Untuk mengurus konteks, laksanakan strategi tetinggelan gelongsor. Buang mesej lama atau ringkaskan untuk membebaskan ruang. Pantau kiraan token input anda untuk memastikan ia kekal dalam had 100,000 token. Jika anda melebihi had, API akan menolak permintaan.
Gunakan max_tokens parameter untuk mengawal panjang output. Output maksimum setiap permintaan ialah 16,000 token. Menetapkan parameter ini membantu mencegah penggunaan token yang berlebihan dan mengekalkan respons dalam had yang boleh diurus untuk aplikasi anda.
Dasar Sokongan dan Pemulangan
Kredit tidak dipulangkan sekali digunakan, tetapi ia tidak pernah luput. Jika anda menghadapi isu dengan pembayaran atau perkhidmatan, hubungi Sokongan melalui halaman yang ditetapkan. Kesilapan seperti caj berganda diselesaikan oleh pasukan Sokongan.
Untuk isu teknikal, semak dokumentasi dahulu. API kami mudah, tetapi kes-kes tepi mungkin timbul. Sertakan kunci API anda dan butiran permintaan apabila meminta bantuan. Masa respons berbeza-beza, tetapi kami berusaha menyelesaikan isu dengan cepat.
Perhatikan bahawa kredit adalah pra-dibayar. Anda membayar untuk apa yang anda gunakan, dengan ralat dan penolakan adalah percuma. Model ini memastikan ketelusan dalam pembilkan. Gunakan Halaman Sokongan untuk sebarang percanggahan atau soalan tentang akaun anda.
