Dokumentasi API

URL Asas dan pengesahan

Sambungkan aplikasi anda dengan menunjuk ke endpoint khusus kami dan menghantar kunci API unik anda. URL asas untuk semua permintaan ialah https://api.apertusapp.com/v1. Anda memperoleh kunci anda serta-merta selepas mendaftar melalui Google atau e-mel di Dapatkan kunci API halaman. Sertakan kunci ini dalam 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 akaun menjana satu kunci aktif. Jika anda menjana kunci baharu, kunci sebelumnya menjadi tidak sah serta-merta. Ini memastikan kawalan ketat ke atas akses anda tanpa tier langganan atau yuran tidak aktif.

Permintaan pertama

Hantar arahan pertama anda ke endpoint penyelesaian sem untuk menerima teks mentah tanpa tapisan. Gunakan ID model uncensored untuk mengakses model berat terbuka khusus kami yang disesuaikan untuk topik dewasa yang sah dan kontroversi.

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 standard seperti temperature dan top_pRalat dan penolakan tidak menggunakan token, jadi anda hanya membayar untuk apa yang sebenarnya sampai ke model. Pendekatan ini mengekalkan kos yang boleh diramal berbanding agregator yang mengenakan bayaran untuk lebihan laluan.

Integrasi SDK Node

Gunakan SDK Node rasmi untuk mengendalikan mod JSON dan panggilan fungsi dengan cekap. Tetapkan response_format ke {"type": "json_object"} untuk output terstruktur atau menentukan alat untuk tingkah laku 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 ini menyokong panggilan alat dengan tool_choice pilihan. Anda juga boleh menetapkan seed untuk hasil deterministik. Fleksibiliti ini membolehkan anda membina aplikasi kompleks tanpa meninggalkan ekosistem serasi OpenAI.

Respons penstriman

Alirkan token secara masa nyata menggunakan Acara Dihantar Pelayan (SSE) untuk pengalaman pengguna berlatensi rendah. Setiap pecahan mengandungi teks yang dijana, dan pecahan akhir termasuk statistik penggunaan token jumlah.

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)

Penstriman mengurangkan latensi yang dirasakan untuk pengguna akhir. Anda boleh mengganggu aliran jika pengguna menukar fikiran. API mengendalikan protokol SSE secara automatik, memerlukan sedikit kod dari pihak anda.

Tetingkap konteks dan kapasiti

Model ini menyokong tetingkap konteks 100,000 token untuk input dan output yang digabungkan. Anda boleh menentukan sehingga 16,000 token per permintaan, atau kembali kepada 2,048 token jika anda tidak menentukan max_tokens.

Jendela besar ini membolehkan analisis dokumen meluas atau sejarah perbualan panjang. Walau bagaimanapun, kekalkan badan permintaan di bawah 8 MB. Model ini bukan GPT atau Llama; ia adalah model AI tanpa sensor yang berbeza yang dioptimumkan untuk kes penggunaan khusus anda.

Penanganan ralat dan had

Tangani ralat HTTP standard dengan baik untuk mengekalkan aliran aplikasi yang kukuh. A 401 kesilapan menunjukkan kunci API tidak sah atau tiada. A 402 kesilapan bermaksud kredit prabayar anda telah habis. A 429 kesilapan menunjukkan anda telah melebihi 300 permintaan setiap minit atau 8 permintaan serentak.

Kredit tidak luput, jadi anda boleh menghentikan penggunaan dan meneruskannya kemudian. Kesilapan seperti caj berganda dibaiki melalui Halaman Sokongan. Kredit pra-dibayar hanya dikenakan untuk penggunaan token sebenar, memastikan harga yang telus untuk setiap bait.