URL Asas dan Pengesahan
Gunakan URL asas yang disediakan dan kunci API yang sah untuk menyambungkan klien anda. Endpoint ialah https://api.qwencodeapikey.com/v1. Anda mesti memasukkan kunci anda dalam Authorization header setiap permintaan. Ini memastikan perkhidmatan mengenal pasti akaun kredit pra-dibayar anda dengan betul.
curl https://api.qwencodeapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Check my api key validity status"}]
}'
Anda boleh menjana kunci melalui Google atau e-mel pada halaman pendaftaran. Kunci muncul serta-merta. Simpan dengan selamat, kerana ia mengawal perbelanjaan anda.
Hujung Sambungan Penyelesaian Sembang
Hantar mesej ke /v1/chat/completions endpoint untuk mendapatkan respons teks. Ini adalah antara muka standard untuk kebanyakan SDK OpenAI. Anda menentukan model sebagai uncensored dan berikan senarai mesej dalam messages array. API memproses input anda dan mengembalikan penyelesaian yang dijana.
from openai import OpenAI
client = OpenAI(base_url="https://api.qwencodeapikey.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)
Pastikan perpustakaan klien anda menunjuk ke URL asas yang betul. ID model uncensored memicu model berat terbuka yang disesuaikan untuk kurang penolakan. Ia mengendalikan giliran perbualan sama seperti API chat lain.
Hujung Model
Query GET /v1/models ke mengesahkan model yang tersedia dan butiran mereka. Hujung titik ini mengembalikan senarai model yang boleh diakses oleh kunci anda. Ia membantu anda mengesahkan uncensored model adalah aktif dan sedia untuk permintaan. Gunakan ini untuk menyahpepijat konfigurasi klien sebelum menghantar beban penuh.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.qwencodeapikey.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);
Semak struktur respons untuk memastikan SDK anda menguraikan senarai model dengan betul. Hujung ini tidak menggunakan kredit, menjadikannya selamat untuk semakan inisialisasi.
Parameter Permintaan dan Aliran
Menyokong parameter standard seperti temperature, top_p, stop, dan seed. Aktifkan penstriman dengan menetapkan stream: true. API ini menghantar token melalui Acara yang Dikirim Pelayan (SSE). Statistik penggunaan token muncul dalam keping terakhir aliran. Ini membolehkan paparan teks yang dijana secara masa nyata.
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
Tetapkan max_tokens untuk mengawal panjang output. Lalaiannya ialah 2,048 token. Anda boleh meningkatkannya sehingga 16,000 token setiap permintaan. Laraskan parameter untuk mengimbangkan kreativiti dan ketepatan dalam respons anda.
Had had laju dan kekangan
Setiap kunci membolehkan 300 permintaan setiap minit dan 8 permintaan serentak. Saiz badan permintaan maksimum ialah 8 MB. Had-had ini mencegah penyalahgunaan dan memastikan prestasi stabil. Jika anda melebihi kadar tersebut, anda menerima ralat 429. Laraskan logik klien anda untuk mengendalikan percubaan semula dengan penangguhan eksponen.
Jendela konteks menyokong jumlah 100,000 token. Ini termasuk prompt dan penyelesaian. Konteks besar memerlukan pengurusan token yang teliti untuk kekal dalam had.
Mod JSON dan Pemanggilan Fungsi
Gunakan response_format: {"type": "json_object"} untuk output terstruktur. Ini memastikan model mengembalikan JSON yang sah, berguna untuk integrasi programatik. Panggilan fungsi berfungsi melalui tools parameter. Takrifkan alat dalam format OpenAI standard. Model akan memanggil fungsi apabila diperlukan.
Kesilapan dan penolakan tidak menelan kredit. Ini terpakai walaupun model menolak permintaan kerana had kandungan keras. Anda hanya membayar untuk penggunaan token sebenar. Kredit tidak luput, jadi anda boleh menambah nilai bila mudah.
Penanganan Ralat dan Penggunaan
Tangani ralat HTTP dengan baik. Ralat 401 menunjukkan kunci API tidak sah atau luput. Ralat 402 bermaksud kredit pra-bayar anda telah habis. Ralat 429 menandakan had kadar melebihi. Semak badan respons untuk mesej ralat terperinci.
Penggunaan ditjejak mengikut kunci. Satu kunci aktif per akaun memudahkan penyebaran bil. Jika anda membuat kesilapan, seperti caj berganda, gunakan halaman Sokongan. Kredit tidak dipulangkan tetapi kekal sah. Kesilapan adalah percuma, jadi permintaan yang gagal tidak mengurangkan baki anda.
Ringkasan dan Amalan Terbaik
Mulakan dengan URL asas dan kunci yang sah. Gunakan uncensored ID model untuk lebih sedikit penolakan. Alirkan respons untuk pengalaman pengguna yang lebih baik. Pantau had kadar untuk mengelakkan gangguan. Gunakan mod JSON untuk data terstruktur. Tangani ralat untuk mengekalkan kebolehpercayaan. Kredit adalah pra-dibayar dan tidak pernah luput. Muat naik dengan kripto apabila diperlukan. API ini sesuai dengan lancar ke dalam kod OpenAI sedia ada. Tiada SDK baru diperlukan. Hanya ubah URL asas dan kunci.
