Dokumentasi API dan Titik Akhir
Panduan ini menunjukkan cara menyambungkan klien anda ke API serasi OpenAI kami untuk penjanaan teks tanpa sensor. Anda akan menemui URL asas, langkah pengesahan identiti, dan contoh kod untuk bahasa pilihan anda.
Pengesahan dan URL Asas
API memerlukan kunci yang sah untuk setiap permintaan. Anda menjana kunci ini serta-merta apabila anda mendaftar masuk dengan Google atau alamat e-mel. Luluskan kunci dalam Authorization header menggunakan Bearer skema. URL asas untuk semua permintaan adalah HTTPS://api.qwenaipricing.com/v1. URL ini berfungsi dengan SDK OpenAI rasmi dan mana-mana klien serasi dengan hanya mengemas kini konfigurasi asas.
Hujung Sambungan Penyelesaian Sembang
Titik akhir utama ialah POST /v1/chat/completions. Ia menerima badan JSON dengan messages array and a model bidang. Tetapkan ID model kepada "uncensored" untuk mengakses model bahasa besar yang disesuaikan untuk output tanpa sekatan. Anda boleh menentukan peranan sistem, pengguna, dan pembantu untuk menyusun konteks perbualan anda.
curl https://api.qwenaipricing.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What is the monthly cost for the 72B model?"}]
}'
Respons termasuk kandungan yang dijana, statistik penggunaan, dan sebab selesai. Ralat mengembalikan kod HTTP standard seperti 401 untuk kunci tidak sah atau 402 jika kredit pra-dibayar anda telah habis. API tidak menyokong penanam, penjanaan imej, atau titik akhir penalaan halus.
Integrasi SDK Python
Gunakan rasmi openai Python package to interact with the API. Initialize the client by providing your API key and setting the base URL to our endpoint. This allows you to use familiar methods like chat.completions.create() tanpa menulis semula logik klien anda. Perpustakaan mengendalikan pengaturcaraan semula JSON dan penguraian respons secara automatik.
from openai import OpenAI
client = OpenAI(base_url="https://api.qwenaipricing.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)
Masukkan mesej anda sebagai senarai kamus. SDK menyokong semua parameter piawai seperti suhu dan top_p. Pendekatan ini memastikan keserasian dengan kod sedia ada yang mengharapkan antara muka serasi OpenAI.
Integrasi SDK Node.js
SDK Node.js berfungsi serupa dengan versi Python. Pasang openai pakej dan konfigurasikan URL asas dan kunci API. Anda kemudian boleh memanggil endpoint penyelesaian sembang dengan parameter yang anda inginkan. Kaedah ini sesuai untuk aplikasi sisi pelayan atau perkhidmatan backend yang perlu menjana teks secara tidak selanjar.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.qwenaipricing.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);
Kendalikan aliran respons atau janji untuk memproses token yang dijana. SDK menguruskan sambungan HTTP dan pengendalian ralat untuk anda. Anda juga boleh menggunakan GET /v1/models endpoint untuk mengesahkan ID model yang tersedia.
Penggunaan dan Streaming
Aktifkan aliran dengan menetapkan stream: true dalam permintaan anda. API mengembalikan aliran acara dihantar pelayan (SSE) bagi respons separa. Setiap potongan mengandungi sebahagian teks yang dijana. Ini berguna untuk antara muka pengguna masa nyata yang memaparkan teks sejajar ia dijana.
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)
Bungkusan akhir dalam aliran mengandungi penggunaan token jumlah untuk permintaan. Anda boleh menjejak penggunaan kredit pra-dibayar anda dengan memantau statistik penggunaan ini. Ralat semasa penstriman mungkin memutuskan sambungan awal.
Had, Ralat, dan Tetingkap Konteks
Model ini menyokong tetingkap konteks sebanyak 100,000 token untuk gabungan prompt dan penyelesaian. Output maksimum setiap permintaan ialah 16,000 token. Jika anda tidak menetapkan max_tokens, had had ialah 2,048 token. Anda terhad kepada 300 permintaan setiap minit dan 8 permintaan serentak bagi setiap kunci. Kesilapan 429 menunjukkan anda telah melebihi had ini. Permintaan dengan kesilapan atau penolakan tidak menggunakan kredit. API tidak menawarkan jaminan SLA atau pensijilan.
Soalan biasa
Apakah had tetingkap konteks untuk model tanpa sensor?
Model ini menyokong tetingkap konteks sebanyak 100,000 token untuk gabungan prompt dan penyelesaian. Anda boleh menjana sehingga 16,000 token dalam satu permintaan.
Bagaimana cara mengendalikan ralat pengesahan?
Kesilapan 401 menunjukkan kunci API tidak sah atau tiada. Pastikan kunci anda dihantar dalam header Authorization sebagai token Bearer. Jana kunci baharu dari papan pemuka akaun anda jika kunci semasa telah ditarik balik.
Adakah API menyokong penjanaan imej seperti Qwen Image?
Tidak, API ini hanya menyediakan penjanaan teks melalui hujung sambungan chat-completions. Ia tidak menyokong embedding, audio, video, atau penjanaan imej. Anda mesti menggunakan hujung sambungan atau perkhidmatan lain untuk modality tersebut.