Pengenalan: integrasi dalam masa beberapa minit

1. Pasang SDK anda

Mula dengan memasang pustaka rasmi untuk bahasa anda. Kebanyakan pemaju lebih suka pakej piawai kerana ia sepadan dengan antara muka yang sudah mereka kenal. Jalankan pip install openai untuk Python atau npm install openai untuk Node.js. Anda hanya memerlukan satu SDK untuk mengendalikan semua permintaan.

2. Tetapkan URL asas anda

Konfigurasikan klien anda untuk mengarah ke endpoint khusus kami. Anda mesti mengatasi URL asas lalai untuk menyalurkan trafik dengan betul. Gunakan https://api.unsencoredai.com/v1 sebagai URL asas anda. Hantar kunci API anda dalam Authorization header. Tetapan ini berfungsi dengan mana-mana klien serasi OpenAI standard.

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. Hantar permintaan pertama anda

Hantar permintaan penyelesaian chat standard untuk menjana teks. ID model ialah uncensored. Anda boleh menghantar prompt sistem untuk membimbing tingkah laku. API mengembalikan respons teks langsung. Gunakan arahan curl di bawah untuk menguji sambungan dengan serta-merta. Semak 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 penstriman

Aktifkan penstriman untuk latensi yang lebih rendah dan output masa nyata. Tetapkan stream: true dalam permintaan anda. API menghantar pecahan melalui Acara Dihantar Pelayan. Anda boleh memproses setiap token apabila ia tiba. Ini sesuai untuk antara muka sembang atau senario peranan. Pecahan terakhir mengandungi 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. Konfigurasikan parameter

Laraskan temperature, top_p, dan stop urutan. Kawalan ini mempengaruhi kreativiti dan panjang output. Anda juga boleh menggunakan response_format untuk mod JSON. Jendela konteks menyokong 100,000 token jumlah. Output maksimum ialah 16,000 token per permintaan. Laraskan tetapan ini untuk kes penggunaan khusus anda.

6. Had, ralat, dan konteks

Tangani ralat dengan anggun menggunakan kod status HTTP standard. Ralat 401 bermaksud kunci API anda tidak sah. Ralat 402 menunjukkan kredit prabayar tidak mencukupi. Ralat 429 menandakan anda mencapai had 300 permintaan setiap minit. Jendela konteks anda ialah 100,000 token. Permintaan melebihi 8 MB mungkin gagal. Bayaran balik tidak dikeluarkan untuk kredit, tetapi ralat adalah percuma.