Prasyarat: Persediaan SDK
Pasang perpustakaan klien rasmi untuk bahasa pilihan anda sebelum mengkonfigurasi sambungan. Perpustakaan mengendalikan serialisasi JSON, percubaan semula, dan protokol penstriman secara automatik.
Untuk Python, pasang pakej melalui pip. Untuk Node.js, gunakan npm atau yarn untuk menambah kebergantungan ke projek anda.
Pastikan anda menggunakan versi SDK terkini untuk menyokong semua ciri seperti panggilan fungsi dan mod JSON.
Konfigurasi: URL Asas & Kunci
Arahkan klien SDK anda ke URL asas khusus kami dan berikan kunci API yang anda peroleh semasa pendaftaran.
URL asas ialah HTTPS://api.claudellmapi.com/v1. Ini memastikan semua permintaan pergi ke pelayan model tanpa sensor kami sebagai ganti penyedia lalai.
Tetapkan kunci API sebagai pembolehubah persekitaran atau luluskan terus kepada konstruktor klien. Tiada header tambahan diperlukan.
Menghantar Permintaan Pertama Anda
Hantar permintaan penyelesaian sembang mudah untuk mengesahkan sambungan dan kualiti respons. Gunakan ID model 'uncensored' untuk mengakses model tanpa had.
Struktur permintaan meniru format OpenAI standard, menjadikannya mudah untuk menggantikan integrasi sedia ada.
Jangka respons teks mengandungi jawapan model kepada prompt anda.
Mengendalikan Respons Aliran
Dayakan penstriman untuk menerima token sejurus ia dijana, mengurangkan latensi yang dirasakan untuk output panjang.
Tetapkan parameter stream kepada true dalam permintaan anda. SDK akan menghasilkan chunk teks apabila ia tersedia.
Ini sesuai untuk antara muka sembang di mana pengguna menjangkakan maklum balas segera semasa model masih berfikir.
Melaksanakan Pemanggilan Fungsi
Takrifkan alat dalam permintaan anda untuk membolehkan model memulangkan data terstruktur bukan teks biasa.
Nyatakan skema fungsi dan tetapkan tool_choice kepada 'auto' atau nama fungsi khusus.
Model akan memberi respons dengan objek panggilan fungsi yang boleh anda jalankan dalam kod anda. Ini berfungsi dengan lancar dengan model tanpa sensor kami.
Pengendalian Ralat & Had
Tangani ralat HTTP biasa dengan baik untuk mengekalkan pengalaman pengguna yang lancar. Status 401 menunjukkan kunci API tidak sah atau tiada. Status 402 bermaksud kredit prabayar anda telah habis. Status 429 menandakan bahawa anda telah melebihi had kadar 300 permintaan setiap minit.
Tetingkap konteks anda ialah 100,000 token untuk gabungan prompt dan penyelesaian. Permintaan yang melebihi had badan 8 MB juga akan gagal.
cURL
curl https://api.claudellmapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What are the current rate limits for large context windows"}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.claudellmapi.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)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.claudellmapi.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);Aliran
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)