Panduan Awal API

URL Dasar dan Autentikasi

Mulailah dengan mengarahkan klien ke URL dasar kami dan meneruskan kunci Anda di header. Kami menggunakan skema Authorization standar, sehingga SDK OpenAI atau klien kompatibel apa pun dapat langsung berfungsi. Anda tidak perlu mengelola alur OAuth yang rumit atau menunggu persetujuan. Cukup daftar dengan Google atau email, salin kuncinya, dan Anda siap. Endpointnya adalah https://api.aiohnezensur.com/v1 dan menerima Authorization: Bearer YOUR_API_KEY header pada setiap permintaan.

Mengirim Permintaan Pertama Anda

Buat panggilan penyelesaian chat sederhana untuk menguji model uncensored. Permintaan ini mengirim prompt dan menerima respons teks tanpa guardrail korporat biasa. Anda dapat menggunakan alat apa pun yang mendukung protokol OpenAI, tetapi panggilan curl langsung menunjukkan apa yang terjadi di balik layar. Ganti YOUR_API_KEY dengan kunci aktual Anda dari dasbor.

Copycurl https://api.aiohnezensur.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list 5 free open source image generators"}]
  }'

Respons mencakup teks yang dihasilkan dan statistik penggunaan token. Jika Anda mendapatkan respons, integrasi Anda berfungsi dengan benar. Anda sekarang dapat melanjutkan untuk membangun interaksi yang lebih kompleks atau beralih ke klien programatik.

Integrasi SDK Python

Gunakan paket Python resmi OpenAI untuk berinteraksi dengan API kami secara mulus. Atur base URL ke endpoint kami dan berikan kunci Anda sebagai token API. Ini memungkinkan Anda memanfaatkan basis kode yang ada tanpa menulis ulang logika HTTP. ID model adalah uncensored, yang memicu model bahasa besar khusus kami yang disesuaikan untuk output tanpa batasan.

Copyfrom openai import OpenAI

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

Snippet ini menunjukkan pertukaran pesan dasar. Anda dapat menyesuaikan array pesan untuk menyertakan prompt sistem atau riwayat percakapan. SDK menangani serialisasi dan parsing error untuk Anda.

Integrasi SDK Node

Integrasikan API ke aplikasi JavaScript atau TypeScript Anda menggunakan SDK Node. Konfigurasikan base URL dan kunci API seperti contoh Python. Pendekatan ini berfungsi dengan baik untuk rendering sisi server atau mikro layanan backend. SDK mengabstraksi lapisan jaringan, membiarkan Anda fokus pada logika prompt.

Copyimport OpenAI from "openai";

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

Jalankan kode ini untuk melihat model merespons input Anda. Anda dapat melakukan iterasi cepat dengan mengubah konten prompt. Struktur respons sesuai dengan format OpenAI standar, memastikan kompatibilitas dengan alat lain di tumpukan Anda.

Respons Streaming

Aktifkan streaming untuk menerima token saat token tersebut dihasilkan, sehingga mengurangi latensi yang dirasakan. Ini sangat penting untuk antarmuka pengguna yang menampilkan teks secara real-time. Atur stream parameter ke true dalam permintaan Anda. API mengirim serangkaian Server-Sent Events (SSE) alih-alih objek JSON tunggal. Setiap potongan berisi delta parsial dari respons.

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)

Gabungkan delta ini di sisi klien untuk memulihkan pesan lengkap. Metode ini terasa instan bagi pengguna, bahkan untuk output panjang. Chunk terakhir berisi total penggunaan token, memungkinkan Anda menagih secara akurat.

Batas Laju dan Kendala

Memahami batas teknis untuk mencegah kegagalan permintaan dalam produksi. Anda diizinkan 300 permintaan per menit per kunci dan dapat memiliki 8 permintaan konkuren. Tubuh permintaan tidak boleh melebihi 8 MB. Jika Anda melebihi batas ini, API mengembalikan kode status 429. Anda harus menerapkan backoff eksponensial di klien Anda untuk menangani lonjakan ini dengan lancar. Jendela konteks adalah 100.000 token total, dengan output maksimum 16.000 token per permintaan. Kesalahan dan penolakan tidak mengonsumsi kredit, sehingga Anda dapat mencoba lagi dengan aman. Kesalahan autentikasi mengembalikan 401, dan dana tidak cukup mengembalikan 402.