Dokumentasi API

URL Dasar dan autentikasi

Hubungkan aplikasi Anda dengan mengarah ke endpoint khusus kami dan meneruskan kunci API unik Anda. URL dasar untuk semua permintaan adalah https://api.apertusapp.com/v1. Anda mendapatkan kunci Anda segera setelah mendaftar melalui Google atau email di Dapatkan kunci API halaman. Sertakan kunci ini di Authorization header untuk setiap permintaan.

Copycurl https://api.apertusapp.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run curl test with empty headers"}]
  }'

Setiap akun menghasilkan satu kunci aktif. Jika Anda membuat kunci baru, kunci sebelumnya menjadi tidak berlaku secara instan. Ini memastikan kontrol ketat atas akses Anda tanpa langganan atau biaya diam.

Permintaan pertama

Kirim prompt pertama Anda ke endpoint chat completions untuk menerima teks mentah, tanpa filter. Gunakan ID model uncensored untuk mengakses model open-weight spesifik kami yang disesuaikan untuk topik dewasa yang sah dan kontroversial.

Copyfrom openai import OpenAI

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

API menerima parameter standar seperti temperature dan top_p. Kesalahan dan penolakan tidak mengonsumsi token, sehingga Anda hanya membayar untuk apa yang sebenarnya mencapai model. Pendekatan ini menjaga biaya tetap dapat diprediksi dibandingkan dengan agregator yang membebankan biaya untuk overhead pengalihan.

Integrasi SDK Node

Gunakan SDK Node resmi untuk menangani mode JSON dan pemanggilan fungsi secara efisien. Atur response_format ke {"type": "json_object"} untuk output terstruktur atau mendefinisikan alat untuk perilaku seperti agen.

Copyimport OpenAI from "openai";

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

Model mendukung panggilan alat dengan tool_choice opsi. Anda juga dapat mengatur seed untuk hasil deterministik. Fleksibilitas ini memungkinkan Anda membangun aplikasi kompleks tanpa meninggalkan ekosistem yang kompatibel dengan OpenAI.

Respons streaming

Stream token secara real-time menggunakan Server-Sent Events (SSE) untuk pengalaman pengguna berlatensi rendah. Setiap potongan berisi teks yang dihasilkan, dan potongan terakhir menyertakan statistik penggunaan token total.

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)

Streaming mengurangi latensi yang dirasakan bagi pengguna akhir. Anda dapat menghentikan stream jika pengguna berubah pikiran. API menangani protokol SSE secara otomatis, memerlukan sedikit kode dari sisi Anda.

Jendela konteks dan kapasitas

Model ini mendukung jendela konteks 100.000 token untuk input dan output secara gabungan. Anda dapat menentukan hingga 16.000 token per permintaan, atau kembali ke 2.048 token jika Anda melewatkan max_tokens.

Jendela besar ini memungkinkan analisis dokumen ekstensif atau riwayat percakapan panjang. Namun, jaga agar badan permintaan tetap di bawah 8 MB. Model ini bukan GPT atau Llama; ini adalah model AI tanpa sensor yang dioptimalkan untuk kasus penggunaan spesifik Anda.

Penanganan kesalahan dan batasan

Tangani kesalahan HTTP standar dengan baik untuk mempertahankan aliran aplikasi yang kuat. A 401 error menunjukkan kunci API tidak valid atau hilang. A 402 error berarti kredit prabayar Anda telah habis. A 429 error menandakan bahwa Anda telah melebihi 300 permintaan per menit atau 8 permintaan bersamaan.

Kredit tidak pernah kedaluwarsa, sehingga Anda dapat menghentikan penggunaan dan melanjutkan nanti. Kesalahan seperti pembebanan ganda diperbaiki melalui halaman Dukungan. Kredit prabayar dibebankan hanya untuk konsumsi token aktual, memastikan harga transparan untuk setiap byte.