Semak Senarai Semak Pengeluaran API OpenRouter
Senarai semak ini membantu anda bergerak dari prototaip ke pengeluaran apabila menggunakan API OpenRouter dengan model tanpa sensor. Ia merangkumi serasi, pengesahan, penstriman, had, pengebilan, penapis, ralat, penskalaan, dan privasi.
Dikemas kini
Poin utama
- Gunakan POST /v1/chat/completions dengan SDK OpenAI piawai untuk penjanaan teks tidak ditapis.
- Had kadar dikenakan setiap kunci; ikut jejak kebolehcayaan dan permintaan setiap minit untuk mengelakkan ralat 429.
- Kredit prabayar merangkumi penggunaan sebenar; ralat dan penolakan tidak menjejaskan baki anda.
- Respons aliran termasuk penggunaan token dalam bahagian terakhir, membolehkan penjejakan pengebilan yang tepat.
Verifikasi Kompatibilitas API dan Titik Akhir
Gunakan endpoint serasi OpenAI yang standard untuk integrasi yang boleh dipercayai.
Titik akhir utama ialah POST /v1/chat/completions. Ini mengendalikan penjanaan teks untuk sejarah sembang. Penamat sekunder, GET /v1/models, menyenaraikan model yang tersedia. Anda tidak memerlukan penamat penyisipan atau penjanaan imej untuk tugas hanya teks. Ramai pembangun mengandaikan mereka memerlukan lapisan pengaliran kompleks. OpenRouter memudahkan ini dengan mendedahkan satu titik masuk. Anda menghantar beban kerja JSON dengan ID model dan arahan sistem anda. Perkhidmatan ini mengembalikan JSON terstruktur dengan kandungan dan data penggunaan. Reka bentuk ini sepadan dengan jangkaan SDK OpenAI rasmi. Anda boleh bertukar model tanpa mengubah kod klien anda. Hanya kemas kini ID model dalam konfigurasi anda. Pastikan klien anda menyokong skema JSON terkini. Versi lama mungkin menolak parameter baharu. Uji sambungan anda sebelum menyahpepihakan ke pengeluaran. Sahkan bahawa format respons sepadan dengan parser anda.
Konfigurasikan Pengesahan dan Kunci
Selamatkan kunci API anda dalam pembolehubah persekitaran serta-merta selepas penjanaan.
Jana kunci melalui papan pemuka penyedia. Simpan di lokasi selamat. Jangan letak secara keras dalam repositori sumber anda. Hantar melalui Authorization: Bearer <key> header. Setiap kunci dikaitkan dengan akaun tertentu. Anda boleh memutarkan kunci jika anda mengesyaki kebocoran. Sesetengah penyedia membenarkan banyak kunci per akaun. Ini membolehkan anda memisahkan trafik pembangunan dan pengeluaran. Pantau penggunaan per kunci untuk mengesan anomali. Batalkan kunci yang tidak digunakan secara berkala. Gunakan kunci berjangka pendek untuk skrip sementara. Ini mengurangkan kesan letupan jika berlaku pencerobohan. Pastikan versi SDK anda menyokong pengesahan token pembawa. Perpustakaan lama mungkin memerlukan format header berbeza. Semak dokumentasi untuk SDK khusus anda. Sahkan bahawa kunci mempunyai baki yang mencukupi. Kunci yang luput mengembalikan ralat 401. Kunci dengan sifar baki mengembalikan ralat 402. Bezakan antara dua keadaan ini dalam logik anda.
Tangani Penstriman dan Penggunaan Token
Aktifkan penstriman untuk maklum balas pengguna masa nyata dan latensi yang lebih rendah.
Tetapkan stream: true dalam payload permintaan anda. Pelayan menghantar siri Server-Sent Events (SSE). Setiap peristiwa mengandungi blok teks separa. Anda mesti menyusun blok-blok ini untuk membentuk respons penuh. Blok akhir sering termasuk statistik penggunaan token. Ini membolehkan anda menjejak kos secara masa nyata. Tanpa penstriman, anda menunggu keseluruhan respons. Ini meningkatkan latensi yang dirasakan dengan ketara. Penstriman sangat penting untuk antara muka perbualan. Ia mewujudkan kesan menaip yang terasa responsif. Berhati-hati dengan pengendalian ralat semasa penstriman. Jika sambungan terputus, anda kehilangan blok semasa. Logik sambung semula harus mengekalkan keadaan perbualan. Sesetengah SDK mengendalikan penstriman secara automatik. Yang lain memerlukan pendengar acara manual. Pilih pendekatan yang sesuai dengan seni bina anda. Pastikan pengurai anda mengendalikan blok JSON yang tidak lengkap. Jangan andaikan setiap peristiwa adalah objek lengkap. Timbulkkan data sehingga anda mempunyai struktur yang sah.
Pantau Had Kadar dan Serentak
Pantau permintaan anda per minit untuk mengelakkan gangguan perkhidmatan.
OpenRouter mengenakan had kadar yang ketat bagi setiap kunci API. Melangkaui had ini akan mencetuskan ralat 429 Too Many Requests. Anda mesti melaksanakan backoff eksponen dalam logik percubaan semula anda. Permintaan serentak juga dikira terhadap had anda. Semak header respons untuk kuota yang tinggal. Sesetengah pembekal mendedahkan header ini secara langsung. Yang lain memerlukan anda membuat anggaran had daripada ralat. Keconcurrentan tinggi boleh menghabiskan kolam sambungan anda. Pastikan klien anda menguruskan sambungan dengan cekap. Gunakan penumpulan sambungan untuk mengurangkan beban kerja. Pantau kedalaman giliran anda semasa beban puncak. Jika anda mencapai had, tunggu sebelum mencuba semula. Rawakkan masa tunggu anda untuk mengelakkan masalah kumpulan badai. Log semua peristiwa had kadar untuk tujuan penyahpepijatan. Ini membantu mengenal pasti corak dalam penggunaan anda. Laraskan tetapan keconcurrentan anda berdasarkan log ini. Jangan andaikan kunci tunggal boleh mengendalikan trafik tanpa had. Taburkan beban merentasi beberapa kunci jika perlu. Ini memerlukan pengurusan keadaan yang teliti. Pastikan setiap kunci mengekalkan konteksnya sendiri jika diperlukan.
Urus Pengecasan Kripto dan Peningkatan Kredit
Gunakan kredit prabayar untuk menampung penggunaan token tanpa yuran bulanan.
Isi baki akaun anda dengan mata wang kripto. Rangkaian yang disokong termasuk USDT pada TRC20 dan USDC pada Base. Deposit minimum bermula pada $20. Bonus terpakai untuk jumlah yang lebih besar. Anda menerima 5% tambahan untuk $50, 10% untuk $100, dan 15% untuk $200. Kredit tidak pernah luput. Ini sesuai untuk projek jangka panjang. Anda hanya membayar untuk token sebenar yang digunakan. Ralat dan penolakan adalah percuma. Ini melindungi bajet anda daripada kos yang tidak dijangka. Akaun baharu mendapat $0.50 untuk pengujian. Bayaran balik tidak dikeluarkan untuk pembelian standard. Caj berganda akan dibetulkan melalui sokongan. Pastikan dompet anda menyokong rangkaian yang diperlukan. Sahkan alamat kontrak sebelum menghantar. Rangkaian yang salah mungkin mengakibatkan kehilangan dana. Semak baki anda secara berkala. Baki rendah boleh mengganggu perkhidmatan secara tidak dijangka. Automatkan pengisian semula jika boleh. Ini memastikan ketersediaan berterusan untuk tugas kritikal.
Uji Penapis Kandungan dan Penolakan
Sahkan bahawa model berkelakuan seperti yang dijangka dengan prompt uncensored.
Model tanpa sensor mungkin masih mengenakan had keras. Semak sekatan untuk jenis kandungan tertentu. Uji dengan frasa pencetus yang diketahui. Pastikan model memberi respons dengan sesuai. Sesetengah penyedia mengekalkan penapis untuk sebab undang-undang. Sahkan ini sebelum bergantung pada model untuk data sensitif. Uji kes sempadan dalam domain anda. Hantar arahan yang biasanya mencetuskan penolakan. Perhatikan format respons. Adakah ia mengembalikan sebab penolakan? Atau adakah ia menjana kandungan secara senyap? Dokumentasikan tingkah laku ini dalam ujian integrasi anda. Ini mencegah kejutan dalam pengeluaran. Jika model mengubah tingkah lakunya, kemas kini ujian anda. Maklumkan pasukan anda tentang sebarang perubahan besar. Konsistensi adalah kunci untuk kepercayaan pengguna. Pastikan aplikasi anda mengendalikan penolakan dengan baik. Jangan andaikan setiap respons adalah sah. Sahkan struktur output. Semak untuk halusinasi atau ralat pemformatan. Ini memastikan pengalaman pengguna yang boleh dipercayai.
Laksanakan Pengendalian Ralat untuk Permintaan Percuma
Tangani ralat dengan anggun untuk mengekalkan pengalaman pengguna yang lancar.
Ralat rangkaian, masa tamat, dan ralat pelayan boleh berlaku. Laksanakan logik percubaan semula dengan penolakan eksponen. Bezakan antara ralat sementara dan kekal. Ralat 429 adalah sementara. Tunggu dan cuba lagi. Ralat 400 adalah kekal. Semak data input anda. Ralat 500 adalah di pihak pelayan. Cuba semula dengan berhati-hati. Log semua ralat untuk tujuan nyahpepijatan. Sertakan beban permintaan dan badan respons. Ini membantu menghasilkan semula isu dengan cepat. Jangan dedahkan ralat mentah kepada pengguna. Formatkan mereka menjadi mesej mesra pengguna. Tangani ralat penstriman dengan teliti. Putuskan sambungan dari aliran acara. Bersihkan sumber. Pastikan aplikasi anda tidak bocor memori. Uji senario ralat dengan teliti. Simulasikan kehilangan rangkaian. Simulasikan masa tamat pelayan. Sahkan bahawa logik pemulihan anda berfungsi. Ini memastikan kebolehpercayaan di bawah keadaan buruk.
Skalakan dengan Mod JSON dan Pemanggilan Alat
Gunakan output terstruktur untuk pengekstrakan data dan pelaksanaan fungsi yang boleh dipercayai.
Dayakan mod JSON dengan menetapkan response_format: {type: "json_object"}. Ini memaksa model menghasilkan JSON yang sah. Gunakan ini untuk menguraikan data atau menjana konfigurasi. Pemanggilan alat membolehkan model melaksanakan fungsi. Takrifkan alat anda dalamayload permintaan. Model memutuskan bila untuk memanggilnya. Luluskan hasil kembali ke model. Ia boleh menjana respons akhir berdasarkan output. Ini mewujudkan gelung untuk tugas kompleks. Pastikan takrifan alat anda jelas. Alat yang kabur menyebabkan panggilan yang salah. Sahkan output JSON sebelum menguraikan. Ini menghalang ralat masa larian dalam kod anda. Gunakan pemanggilan alat untuk tugas pengekstrakan data. Ia meningkatkan ketepatan dengan ketara. Uji dengan pelbagai format input. Pastikan model mengendalikan kes sempadan. Dokumentasikan alat yang tersedia untuk pasukan anda. Ini memastikan penggunaan yang konsisten merentasi projek.
Semak Dasar Privasi dan Penggunaan Data
Memahami bagaimana data anda disimpan dan digunakan oleh penyedia.
Periksa dasar privasi untuk butiran pengekalan data. Sesetengah penyedia menggunakan data anda untuk latihan. Yang lain menjaganya sebagai rahsia. Pastikan data anda tidak digunakan untuk peningkatan model jika ia penting bagi anda. Verifikasi piawaian penyulitan. Data sepatutnya disulitkan semasa transit dan pada keadaan rehat. Periksa jika log disimpan. Log mungkin mengandungi prompt anda. Pastikan log-log ini selamat. Semak terma perkhidmatan untuk klausa liabiliti. Fahami siapa yang memiliki kandungan yang dijana. Sesetengah penyedia menuntut hak ke atas output anda. Pastikan ini selaras dengan keperluan anda. Padamkan akaun anda jika anda tidak lagi menggunakan perkhidmatan. Verifikasi bahawa data anda telah dipadam. Hubungi sokongan jika anda mempunyai kebimbangan. Dokumentasikan tetapan privasi anda untuk tujuan audit. Ini memastikan pematuhan dengan dasar dalaman.
Soalan lazim
Apakah API OpenRouter dan bagaimana ia berbeza dengan API model langsung?
API OpenRouter adalah antara muka bersatu yang membolehkan anda mengakses pelbagai LLM melalui titik akhir tunggal. Ia memudahkan integrasi dengan menstandardkan permintaan dan respons. Anda boleh bertukar model tanpa mengubah kod klien anda. Ini mengurangkan masa pembangunan dan beban penyelenggaraan.
Bagaimana cara mengendalikan had kadar apabila menggunakan LLM tanpa sensor?
Had had ditetap mengikut kunci API. Anda menerima ralat 429 apabila anda melebihi had. Laksanakan backoff eksponen untuk mencuba semula permintaan. Pantau penggunaan anda untuk kekal dalam had. Pertimbangkan untuk menggunakan pelbagai kunci untuk mengagihkan beban.
Adakah AI tanpa sensor sesuai untuk aplikasi bot sembang NSFW?
Ya, model tanpa sensor direka bentuk untuk mengendalikan kandungan dewasa tanpa penolakan. Mereka membolehkan roleplay dan penulisan kreatif yang lebih fleksibel. Pastikan aplikasi anda mengendalikan output dengan betul. Uji dengan jenis kandungan khusus anda sebelum skala.
Bagaimana cara mengesahkan status had kadar API secara masa nyata?
Periksa header respons untuk maklumat kuota. Sesetengah penyedia memasukkan permintaan yang tinggal dalam header. Jika tidak, lacurkan kiraan penggunaan anda sendiri. Log ralat had kadar untuk mengenal pasti corak. Sesuaikan kekonkurensan anda berdasarkan log ini.
Dapatkan kunci API anda sekarang
Daftar, salin kunci anda, dan kemas kini URL asas. Itu sahaja yang anda perlu lakukan.
