Baiki kesilapan biasa dengan kunci API claude anda

Ralat format kunci API tidak sah

Halangan paling segera sering merupakan ketidakpadanan format yang mudah. Jika anda sedang memindahkan dari penyedia lain, pastikan string kunci anda tidak mengandungi ruang putih atau baris baru yang boleh memecahkan Authorization header. Our kunci API groq are generated as standard alphanumeric strings, but they must be passed exactly as shown in your dashboard. A common mistake is appending a prefix like sk- atau key- apabila API menjangkakan rentetan mentah.

Sahkan panjang kunci dan set watak. Jika anda menerima ralat 401 Tidak Dibenarkan, semak semula bahawa anda tidak secara tidak sengaja menggunakan kunci baca sahaja dari perkhidmatan lain. Sentiasa jana kunci baharu jika anda mengesyaki ia telah terdedan dalam repositori awam, kerana banyak perkhidmatan menarik balik kunci apabila dikesan dalam git log.

Masalah had kadar dan kekonkurenan

Had kadar melindungi infrastruktur tetapi boleh melemahkan klien yang dikonfigurasi dengan buruk. API kami membenarkan 300 permintaan setiap minit per kunci dan menyokong 8 sambungan konkomitan. Jika anda melebihi had ini, anda akan menerima ralat 429 Terlalu Banyak Permintaan. Untuk mengendalikan ini, laksanakan penangguhan eksponen dalam kod klien anda. Jangan cuba semula segera; tunggu lebih lama antara setiap percubaan.

• Mulakan dengan kelewatan 1 saat.
• Menggandakan kelewatan untuk setiap percubaan semula mencegah masalah kawanan ribut.
• Pantau X-RateLimit-Remaining header jika tersedia.

Untuk pemprosesan secara berbatch, pertimbangkan untuk mengurungkan permintaan daripada menghantar semuanya serentak. Ini memastikan anda kekal dalam had 8 permintaan serentak sambil memaksimumkan kelulusan.

Kesilapan penanganan respons penstriman

Penghantaran secara berstrim melalui Server-Sent Events (SSE) adalah penting untuk pengalaman pengguna masa nyata. Kesalahan biasa ialah memperlakukan strim sebagai blok teks tunggal. Anda mesti menguraikan setiap potongan sejajar dengan ketibaannya. Potongan akhir biasanya mengandungi statistik penggunaan token, yang sepatutnya anda tangkap untuk pengebilan dan analitik. Jika anda menutup sambungan secara terburu-buru, anda mungkin terlepas butiran penting ini.

Pastikan klien anda mengendalikan objek JSON separa dengan betul. LLM menjana token secara berurutan, jadi struktur JSON tidak lengkap sehingga token akhir. Penimbal respons dan hanya uraikan objek JSON lengkap apabila penstriman ditutup. Ini mengelakkan ralat pengekodan semula dan memastikan integriti data.

Tetingkap konteks dan melebihi had token

Model kami menyokong tetingkap konteks 100,000 token, tetapi output maksimum setiap permintaan ialah 16,000 token. Jika anda menetapkan max_tokens secara tidak betul atau membiarkannya, lalai mungkin menjadi 2,048 token, yang boleh memendekkan respons panjang. Sentiasa nyatakan max_tokens secara eksplisit untuk mengawal panjang output dan kos.

Pantau panjang prompt anda. Jika input anda ditambah dengan output yang dijangka melebihi 100,000 token, API akan menolak permintaan tersebut. Gunakan pengira token untuk menganggarkan penggunaan sebelum menghantar dokumen besar. Kejuruteraan prompt yang cekap boleh mengurangkan kos dengan ketara dan meningkatkan latensi.

ID model atau konfigurasi hujung yang salah

Titik akhir adalah POST /v1/chat/completions dengan URL asas https://api.groqapikeys.com/v1. Pastikan anda menggunakan ID model yang betul: uncensored. Menggunakan ID model generik seperti gpt-3.5-turbo mungkin berfungsi jika API serasi, tetapi adalah terbaik untuk menggunakan ID model khusus yang disediakan. Konfigurasi URL asas yang salah adalah punca biasa ralat sambungan.

Sahkan bahawa pustaka klien anda dikonfigurasi untuk menggunakan format OpenAI-compatible. Sesetengah pustaka lama menjangkakan struktur JSON yang berbeza. Periksa dokumentasi untuk SDK khusus anda untuk memastikan keserasian dengan chat/completions endpoint.

mod JSON dan ralat parameter pemanggilan alat

Apabila menggunakan mod JSON, tetapkan response_format ke {"type": "json_object"}. Ini memastikan model mengeluarkan JSON yang sah. Walau bagaimanapun, model mungkin masih secara kebetulan menghasilkan JSON yang tidak sah. Sentiasa bungkus logik pengekodan semula anda dalam blok try-catch dan pertimbangkan untuk menggunakan validator JSON untuk membetulkan ralat sintaks kecil.

Untuk pemanggilan alat, pastikan anda memberikan definisi alat yang betul dalam tools parameter. Model akan menjawab dengan panggilan alat, yang mesti anda laksanakan dan hantar semula ke API. Definisi alat yang tidak selaras boleh menyebabkan kegagalan senyap atau penggunaan alat yang salah.

Pembayaran kripto dan kelewatan baki kredit

Top-up diproses melalui kripto sahaja: USDT (TRC20) atau USDC (Base). Pembayaran tidak serta-merta; ia bergantung pada masa pengesahan blockchain. Manakala kebanyakan transaksi diproses dalam masa beberapa minit, kesesakan rangkaian boleh menyebabkan kelewatan. Semak papan pemuka anda untuk transaksi yang sedang menunggu.

• Topup minimum ialah $20.
• Kredit bonus terpakai: +5% dari $50, +10% dari $100, +15% dari $200.
• Kredit berbayar tidak luput; kredit percubaan luput dalam 7 hari.

Jika baki anda tidak dikemas kini, sahkan hash transaksi dan hubungi sokongan. Jangan hantar semula pembayaran melainkan diarahkan.

Kerisihan privasi dan penggunaan data

Prompt anda tidak digunakan untuk latihan. Ini adalah ciri utama untuk pembangun yang mengendalikan data sensitif. Walau bagaimanapun, pastikan anda menggunakan HTTPS untuk melindungi data semasa transit. API kami tidak menyimpan prompt anda secara kekal; ia diproses secara masa nyata.

Untuk penggunaan perniagaan, pertimbangkan untuk menjana kunci API unik untuk perkhidmatan berbeza bagi mengasingkan data dan mengehadkan pendedahan. Jika kunci dikompromikan, anda boleh mencabutnya tanpa menjejaskan perkhidmatan lain. Ini adalah amalan terbaik untuk mengekalkan keselamatan dan privasi.

Memindahkan daripada kunci API Claude ke alternatif uncensored

Mengalih Keluar daripada kunci API Claude melibatkan pengemas kini URL asas dan ID model. API kami serasi dengan OpenAI, jadi kebanyakan perubahan kod adalah minimum. Gantikan URL asas dengan https://api.groqapikeys.com/v1 dan tetapkan model kepada uncensored.

Uji integrasi anda dengan teliti sebelum dilancarkan. Bandingkan output untuk memastikan model tanpa sensor memenuhi keperluan anda untuk penapisan kandungan. The kunci API groq tawarkan model harga telus tanpa yuran tersembunyi, menjadikannya lebih mudah untuk meramal kos. Pertimbangkan tetingkap konteks 100,000 token dan keupayaan penstriman sebagai kelebihan utama.