Dokumentasi API untuk Pelengkap Chat Tanpa Sekatan

Mula Cepat: Sambungkan dalam Python atau JavaScript

Sambungkan ke API dengan mengemas kini URL asas anda dan menetapkan kunci API anda. Hujung sambungan ini menerima permintaan penyelesaian chat piawai dan mengembalikan teks. Anda tidak perlu memasang perpustakaan khusus jika anda menggunakan SDK OpenAI rasmi, kerana antara muka sepadan dengan spesifikasi mereka dengan tepat.

Mulakan dengan permintaan HTTP mudah untuk mengesahkan sambungan. Gunakan arahan curl di bawah untuk menghantar arahan asas kepada uncensored model. Gantikan YOUR_API_KEY dengan kunci yang dijana pada papan pemuka anda.

Copycurl https://api.aiplayrolebest.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set the character persona to a grumpy detective"}]
  }'

Untuk pembangun Python, prosesnya hampir sama. Mulakan klien dengan kunci anda dan URL asas yang betul. Ini memastikan semua permintaan disalurkan melalui pelayan tanpa penapisan kami sambil mengekalkan keserasian dengan perkakas sedia ada.

Copyfrom openai import OpenAI

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

Pengguna JavaScript boleh mencapai hasil yang sama menggunakan SDK Node. Tetapkan baseURL sifat ke titik akhir kami. Pendekatan ini membolehkan anda mengintegrasikan API ke dalam pelayan web atau perkhidmatan backend dengan perubahan kod yang minimum.

Copyimport OpenAI from "openai";

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

Pengesahan dan pengurusan kunci API

Pengesahihan bergantung pada satu kunci API yang dihantar dalam header. Hantar kunci ini dalam Authorization header untuk setiap permintaan. Jika kunci tiada atau tidak sah, API mengembalikan ralat 401 serta-merta. Ini memastikan akses selamat kepada kredit pra-dibayar anda.

Jana kunci anda di papan pemuka. Kunci ditunjukkan sekali semasa penciptaan. Simpan dengan selamat dalam pembolehubah persekitaran anda. Jangan kongsi secara awam. Setiap akaun menyokong satu kunci aktif pada satu masa. Penjanaan kunci baharu akan membatalkan kunci sebelumnya serta-merta.

Gunakan kunci dalam permintaan anda seperti ini: Authorization: Bearer YOUR_API_KEY. Format header standard ini berfungsi dengan semua SDK utama. Simpan kunci anda untuk iterasi pantas semasa pembangunan.

Parameter hujung sambungan penyelesaian sembang

Hantar permintaan ke /v1/chat/completions endpoint.endpoint. Sertakan array mesej anda dan tetapkan model kepada uncensored. Anda boleh laraskan parameter seperti temperature dan top_p untuk mengawal kreativiti. Nilai yang lebih tinggi menghasilkan respons yang lebih pelbagai.

Tetapkan max_tokens untuk membatasi panjang output. Lalai ialah 2,048 token jika tidak dinyatakan. Model menyokong jendela konteks 100,000 token untuk prompt ditambah penyelesaian. Ini membolehkan perbualan panjang tanpa pemotongan. Laraskan presence_penalty dan frequency_penalty untuk mengurangkan pengulangan dalam senario peranan.

Gunakan stop parameter untuk menghentikan penjanaan pada frasa tertentu. Ini membantu mematuhi struktur dialog. The seed parameter memastikan output yang boleh direplikasi untuk pengujian. Alat-alat ini memberikan anda kawalan tepat ke atas tingkah laku model.

Data penggunaan respons aliran

Aktifkan aliran dengan menetapkan stream: true dalam permintaan anda. API mengembalikan potongan teks sejajar ia dijana. Ini mengurangkan latensi yang dirasakan untuk pengguna akhir. Setiap potongan termasuk teks separa dan metadata.

Data penggunaan muncul dalam segmen akhir. Ini termasuk jumlah token input dan output. Semak usage field in the last response object. This allows accurate billing verification without separate API calls. Track token consumption in real-time.

Tangani penghentian aliran dengan berhati-hati. Pastikan anda memproses semua kepingan sebelum menutup sambungan. Kepingan akhir mengandungi statistik penggunaan lengkap. Data ini penting untuk memantau kos dan prestasi dalam aplikasi pengeluaran.

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)

Penanganan ralat dan had kadar

API mengenakan had 300 permintaan setiap minit per kunci. Permintaan serentak dibatasi pada lapan per kunci. Badan permintaan tidak boleh melebihi 8 MB. Melebihi had ini mengembalikan ralat 429. Laksanakan backoff eksponen untuk menangani lonjakan sementara.

Ralat lazim termasuk 401 untuk kunci tidak sah dan 402 untuk kredit tidak mencukupi. Respon 402 menunjukkan baki prabayar anda telah habis. Tambah saldo akaun anda untuk meneruskan perkhidmatan. Ralat tidak menggunakan token, jadi mencuba semula selepas membetulkan isu adalah percuma.

Periksa badan respons untuk mesej ralat terperinci. API mengembalikan objek JSON dengan jenis ralat dan mesej. Gunakan maklumat ini untuk mengesahkan kerosakan dengan cepat. Pengendalian ralat yang betul memastikan pengalaman yang lancar untuk pengguna anda semasa tempoh trafik tinggi.

mod JSON dan panduan pemanggilan fungsi

Gunakan mod JSON dengan menetapkan response_format ke {"type": "json_object"}. Ini memaksa model menghasilkan JSON yang sah. Sangat sesuai untuk pengekstrakan data terstruktur atau respons API. Pastikan prompt anda menerangkan skema yang dikehendaki dengan jelas.

Pemanggilan fungsi membolehkan model memanggil alat. Takrifkan alat dalam badan permintaan. Model memulangkan panggilan alat apabila sesuai. Tangani panggilan ini dalam logik aplikasi anda. Ini membolehkan aliran kerja berbilang langkah yang kompleks.

Gabungkan mod JSON dengan panggilan fungsi untuk integrasi yang kukuh. Sahkan output JSON di sisi klien. Gunakan tool_choice parameter untuk mengawal apabila fungsi dipanggil. Fleksibiliti ini menyokong pelbagai seni bina aplikasi. Pastikan alat anda ditakrifkan dengan baik untuk prestasi optimum.

Butiran model dan had tetingkap konteks

The uncensored model menyokong tetingkap konteks 100,000 token. Ini termasuk prompt input dan penyelesaian output. Output maksimum ialah 16,000 token per permintaan. Ini membolehkan senario roleplay yang meluas tanpa terputus di tengah ayat.

Model ini mempunyai berat terbuka dan disesuaikan untuk kandungan tanpa sekatan. Ia tidak menolak topik dewasa yang sah. Ia bukan model GPT, Claude, atau vendor lain. Permintaan diproses pada pelayan khusus kami. Ini memastikan prestasi yang konsisten dan latensi rendah.

Pantau penggunaan konteks untuk kekal dalam had. API menjejak penggunaan token dengan tepat. Kesilapan dan penolakan tidak menggunakan token. Model pengebilan telus ini membantu anda meramal kos. Rancang tetingkap konteks anda untuk memaksimumkan nilai.