Apertus ia API Documentation

1. Quickstart: Connect Your First Request

URL dasar adalah https://api.apertusia.com/v1. Masukkan kunci API Anda di header Authorization. Pengenal model adalah uncensored. Konfigurasi ini berfungsi dengan klien apa pun yang kompatibel dengan OpenAI.

Gunakan perintah cURL ini untuk menguji konektivitas segera. Ganti YOUR_API_KEY dengan kunci API Anda yang sebenarnya.

Copycurl https://api.apertusia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 5 python libraries for web scraping"}]
  }'

Kesalahan autentikasi mengembalikan 401. Dana tidak cukup mengembalikan 402. Batas laju mengembalikan 429.

2. Parameter yang Didukung: Temperature, Top P, dan Seed

Kontrol keacakan dengan temperature, keragaman dengan top_p, dan reproduktibilitas dengan seed. Parameter-parameter ini mengikuti konvensi standar OpenAI. Atur temperature ke 0.7 untuk output yang seimbang atau 1.0 untuk kreativitas yang lebih tinggi. Gunakan top_p untuk membatasi sampling hanya pada massa probabilitas tertinggi. Parameter seed memastikan output yang identik untuk tujuan debugging.

Contoh cuplikan Python untuk pengujian lokal:

Copyfrom openai import OpenAI

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

3. Tanggapan Streaming dengan Server-Sent Events

Aktifkan streaming dengan mengatur stream: true. API mengembalikan potongan data melalui Server-Sent Events. Setiap potongan berisi teks parsial dan data penggunaan token. Hal ini mengurangi latensi yang dirasakan untuk respons panjang. Tangani peristiwa SSE untuk memperbarui UI Anda secara real-time.

Contoh Node.js menggunakan SDK resmi:

Copyimport OpenAI from "openai";

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

4. Konfigurasi Function Calling dan Mode JSON

Gunakan response_format dengan {"type": "json_object"} untuk output JSON yang ketat. Ini memastikan data terstruktur untuk pipeline pemrograman. Aktifkan pemanggilan fungsi dengan menyediakan array tools dalam body permintaan. Model akan mengembalikan panggilan alat dalam format yang diharapkan. Gunakan tool_choice untuk memaksa perilaku tertentu.

5. Batas Laju dan Batasan Ukuran Permintaan

Setiap kunci API mendukung 300 permintaan per menit. Permintaan bersamaan dibatasi hingga 8 per kunci. Ukuran badan permintaan maksimum adalah 8 MB. Jendela konteks menampung total 100,000 token. Output maksimum per permintaan hingga seluruh jendela 100,000 token. Biarkan max_tokens tidak diatur, atau atur ke nilai tinggi, untuk menghindari pemotongan. Kesalahan tidak mengonsumsi kredit. Pengembalian dana tidak diberikan, tetapi kesalahan penagihan akan diperbaiki melalui Dukungan.

6. Autentikasi dan Penanganan Error

Buat kunci Anda melalui dasbor. Gunakan login Google atau email. Kunci akan muncul secara langsung. Sertakan dalam header Authorization: Bearer. Kunci yang tidak valid akan mengembalikan status 401. Kesalahan 429 menunjukkan batas laju telah habis. Kesalahan 402 berarti kredit prabayar Anda telah habis. Isi ulang dengan USDT atau USDC. Kredit tidak pernah kedaluwarsa.

Streaming

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)