Panduan Cepat: integrasi dalam hitaran menit

1. Instal SDK Anda

Mulai dengan menginstal library resmi untuk bahasa Anda. Sebagian besar pengembang lebih memilih paket standar karena antarmuka yang sesuai dengan yang sudah mereka kenal. Jalankan pip install openai untuk Python atau npm install openai untuk Node.js. Anda hanya membutuhkan satu SDK untuk menangani semua permintaan.

2. Atur URL dasar Anda

Konfigurasikan klien Anda untuk mengarah ke endpoint spesifik kami. Anda harus mengganti URL dasar default untuk mengarahkan lalu lintas dengan benar. Gunakan https://api.unsencoredai.com/v1 sebagai URL dasar Anda. Teruskan kunci API Anda di Authorization header. Konfigurasi ini kompatibel dengan klien OpenAI standar apa pun.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.unsencoredai.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)

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.unsencoredai.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);

3. Kirim permintaan pertama Anda

Kirimkan permintaan completion chat standar untuk menghasilkan teks. ID modelnya adalah uncensored. Anda dapat mengirim prompt sistem untuk mengarahkan perilaku. API mengembalikan respons teks langsung. Gunakan perintah curl di bawah ini untuk menguji konektivitas segera. Periksa respons Anda untuk choices array.

Copycurl https://api.unsencoredai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the version number"}]
  }'

4. Tangani respons streaming

Aktifkan streaming untuk latensi lebih rendah dan output real-time. Atur stream: true dalam permintaan Anda. API mengirim chunk melalui Server-Sent Events. Anda dapat memproses setiap token saat tiba. Ini sangat cocok untuk antarmuka obrolan atau skenario roleplay. Chunk terakhir berisi statistik penggunaan.

Copystream = 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)

5. Konfigurasi parameter

Sesuaikan temperature, top_p, dan stop urutan. Kontrol ini memengaruhi kreativitas dan panjang output. Anda juga dapat menggunakan response_format untuk mode JSON. Jendela konteks mendukung total 100,000 token. Output maksimum adalah 16,000 token per permintaan. Sesuaikan pengaturan ini untuk kasus penggunaan spesifik Anda.

6. Batas, error, dan konteks

Tangani kesalahan dengan baik menggunakan kode status HTTP standar. Kesalahan 401 berarti kunci API Anda tidak valid. Kesalahan 402 menunjukkan kredit prabayar tidak cukup. Kesalahan 429 menandakan Anda mencapai batas 300 permintaan per menit. Jendela konteks Anda adalah 100.000 token. Permintaan di atas 8 MB mungkin gagal. Pengembalian dana tidak diterbitkan untuk kredit, tetapi kesalahan gratis.