URL Dasar dan Autentikasi
Gunakan URL dasar yang disediakan dan kunci API yang valid untuk menghubungkan klien Anda. Endpointnya adalah https://api.qwencodeapikey.com/v1. Anda harus menyertakan kunci Anda di Authorization header setiap permintaan. Ini memastikan layanan mengidentifikasi akun kredit pra-dibayar Anda dengan benar.
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 dapat menghasilkan kunci melalui Google atau email di halaman pendaftaran. Kunci muncul segera. Jaga agar tetap aman, karena kunci ini mengendalikan pengeluaran Anda.
Endpoint Chat Completions
Kirim pesan ke /v1/chat/completions endpoint untuk mendapatkan respons teks. Ini adalah antarmuka standar untuk sebagian besar SDK OpenAI. Anda menentukan model sebagai uncensored dan berikan daftar pesan di messages array. API memproses input Anda dan mengembalikan kelengkapan yang dihasilkan.
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 pustaka klien Anda mengarah ke URL dasar yang benar. ID model uncensored memanggil model bobot terbuka yang disesuaikan untuk mengurangi penolakan. Model ini menangani giliran percakapan seperti API chat lainnya.
Endpoint Models
Kueri GET /v1/models untuk memverifikasi model yang tersedia dan detailnya. Titik akhir ini mengembalikan daftar model yang dapat diakses oleh kunci Anda. Ini membantu Anda mengonfirmasi uncensored model aktif dan siap untuk permintaan. Gunakan ini untuk konfigurasi debug klien sebelum mengirim payload 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);
Periksa struktur respons untuk memastikan SDK Anda dapat mengurai daftar model dengan benar. Titik akhir ini tidak mengonsumsi kredit, sehingga aman untuk pemeriksaan inisialisasi.
Parameter Permintaan dan Streaming
Mendukung parameter standar seperti temperature, top_p, stop, dan seed. Aktifkan streaming dengan mengatur stream: true. API mengirim token melalui Server-Sent Events (SSE). Statistik penggunaan token muncul di chunk terakhir dari stream. Ini memungkinkan tampilan teks yang dihasilkan secara real-time.
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)
Atur max_tokens untuk mengontrol panjang output. Nilai defaultnya adalah 2.048 token. Anda dapat meningkatkannya hingga 16.000 token per permintaan. Sesuaikan parameter untuk menyeimbangkan kreativitas dan presisi dalam respons Anda.
Batas Laju dan Kendala
Setiap kunci mengizinkan 300 permintaan per menit dan 8 permintaan simultan. Ukuran body permintaan maksimum adalah 8 MB. Batas-batas ini mencegah penyalahgunaan dan memastikan kinerja stabil. Jika Anda melebihi laju, Anda menerima error 429. Sesuaikan logika klien Anda untuk menangani percobaan ulang dengan backoff eksponensial.
Jendela konteks mendukung total 100.000 token. Ini termasuk prompt dan completion. Konteks besar memerlukan manajemen token yang hati-hati agar tetap dalam batas.
Mode JSON dan Pemanggilan Fungsi
Gunakan response_format: {"type": "json_object"} untuk output terstruktur. Ini memastikan model mengembalikan JSON yang valid, berguna untuk integrasi programatik. Pemanggilan fungsi bekerja melalui tools parameter. Definisikan alat dalam format OpenAI standar. Model akan memanggil fungsi sesuai kebutuhan.
Kesalahan dan penolakan tidak mengonsumsi kredit. Ini berlaku bahkan jika model menolak permintaan karena batas konten keras. Anda hanya membayar penggunaan token aktual. Kredit tidak pernah kedaluwarsa, sehingga Anda dapat mengisi ulang kapan saja nyaman.
Penanganan Kesalahan dan Penggunaan
Tangani kesalahan HTTP secara elegan. Kesalahan 401 menunjukkan kunci API tidak valid atau kedaluwarsa. Kesalahan 402 berarti kredit prabayar Anda telah habis. Kesalahan 429 menandakan batas laju terlampaui. Periksa badan respons untuk pesan kesalahan terperinci.
Penggunaan dilacak per kunci. Satu kunci aktif per akun menyederhanakan penagihan. Jika Anda membuat kesalahan, seperti pengisian ganda, gunakan halaman Dukungan. Kredit tidak dikembalikan tetapi tetap valid. Kesalahan gratis, sehingga permintaan yang gagal tidak menguras saldo Anda.
Ringkasan dan Praktik Terbaik
Mulai dengan URL dasar dan kunci yang valid. Gunakan uncensored ID model untuk lebih sedikit penolakan. Alirkan respons untuk pengalaman pengguna yang lebih baik. Pantau batas laju untuk menghindari gangguan. Gunakan mode JSON untuk data terstruktur. Tangani kesalahan untuk menjaga keandalan. Kredit adalah pra-bayar dan tidak pernah kedaluwarsa. Isi ulang dengan kripto saat diperlukan. API ini cocok dengan mulus ke basis kode OpenAI yang ada. Tidak perlu SDK baru. Cukup ubah URL dasar dan kunci.
