Panduan Integrasi untuk Pengembang

Autentikasi dan penyiapan URL dasar

Mulai dengan membuat kunci API Anda di dasbor. URL dasarnya adalah HTTPS://api.apiaicheap.com/v1. Kirimkan kunci Anda di header Otorisasi sebagai token bearer.

• Klik "Dapatkan Kunci API" dan masuk dengan Google atau email.
• Salin kunci segera; ditampilkan hanya sekali.

Kunci ini mengautentikasi semua permintaan ke endpoint penyelesaian obrolan.

Contoh Header

Otorisasi: Bearer YOUR_API_KEY

Permintaan pertama dengan cURL

Kirim penyelesaian obrolan dasar untuk menguji pengaturan Anda. Gunakan endpoint POST /v1/chat/completions dengan model "uncensored".

Ini mengonfirmasi saldo kredit dan latensi Anda.

• Atur role menjadi "user".
• Jaga pesan sederhana untuk tes pertama.

Periksa respons untuk bidang teks yang dihasilkan.

• Cari nilai "content".

Jika Anda mendapatkan 200 OK, integrasi Anda sedang berjalan.

Copycurl https://api.apiaicheap.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the null pointer in the login handler"}]
  }'

Integrasi SDK Python

Gunakan pustaka Python resmi OpenAI untuk integrasi yang mudah. Arahkan ke base URL kami dan atur kunci API Anda.

Pendekatan ini menangani percobaan ulang dan parsing JSON secara otomatis.

• Instal pustaka melalui pip.
• Atur parameter base_url ke titik akhir kami.

Panggil metode chat.completions.create.

Masukkan daftar pesan Anda sebagai argumen.

• Termukkan nama model "uncensored".

Akses teks respons melalui atribut objek.

Metode ini bersih dan mudah dibaca untuk skrip produksi.

Copyfrom openai import OpenAI

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

Pengaturan SDK Node.js

SDK Node.js bekerja mirip dengan versi Python. Inisialisasi klien dengan kunci Anda dan URL dasar kami.

Ini memungkinkan Anda menggunakan pola async/await yang akrab.

• Impor paket OpenAI.
• Konfigurasi URL dasar dalam konstruktor.

Buat permintaan completion dengan pesan Anda.

Tangani promise untuk mendapatkan hasilnya.

• Ekstrak konten pesan dari respons.

Catat output untuk memverifikasi bahwa model merespons dengan benar.

Konfigurasi ini ideal untuk server web dan layanan backend.

Copyimport OpenAI from "openai";

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

Respons streaming dengan SSE

Aktifkan streaming dengan mengatur stream menjadi true dalam permintaan Anda. API mengembalikan potongan data saat dihasilkan melalui Server-Sent Events.

Ini mengurangi latensi yang dirasakan bagi pengguna di aplikasi obrolan.

• Atur stream: true dalam payload.
• Proses setiap potongan saat tiba.

Gabungkan potongan-potongan untuk membentuk respons akhir.

Detail penggunaan token muncul di potongan terakhir.

• Periksa bidang "usage" dalam potongan terakhir.

Pendekatan ini menjaga antarmuka pengguna tetap responsif selama generasi yang panjang.

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)

Batas, error, dan jendela konteks

Akun Anda memiliki batas 300 permintaan per menit per kunci. Jendela konteks mendukung 100.000 token total untuk prompt dan penyelesaian.

Kesalahan ditangani dengan kode status HTTP standar.

• 401 menunjukkan kunci API tidak valid atau hilang.
• 402 berarti kredit prabayar Anda telah habis.
• 429 menandakan Anda telah melebihi batas kecepatan.

Penolakan tidak menguras kredit. Error juga gratis.

Output maks adalah 16.000 token per permintaan. Atur max_tokens jika Anda membutuhkan lebih sedikit.

Struktur ini memastikan penagihan dan kinerja yang dapat diprediksi.