Apertus ia API Documentation

1. Quickstart: Connect Your First Request

URL asas ialah https://api.apertusia.com/v1. Hantar kunci API anda dalam header Authorization. Pengenal pasti model ialah uncensored. Konfigurasi ini berfungsi dengan mana-mana klien yang serasi OpenAI.

Gunakan arahan cURL ini untuk menguji sambungan serta-merta. Gantikan YOUR_API_KEY dengan kunci sebenar anda.

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"}]
  }'

Ralat pengesahan memulangkan 401. Dana tidak mencukupi memulangkan 402. Had kadar memulangkan 429.

2. Sokongan Parameter: Suhu, Top P, dan Benih

Kawal rawak dengan temperature, kepelbagaian dengan top_p, dan kebolehulangan dengan seed. Parameter ini mengikut konvensyen standard OpenAI. Tetapkan temperature kepada 0.7 untuk output seimbang atau 1.0 untuk kreativiti yang lebih tinggi. Gunakan top_p untuk menghadkan pensampelan kepada jisim kebarangkalian tertinggi. Parameter seed memastikan output yang sama untuk tujuan nyahpepijat.

Contoh cuplikan Python untuk ujian tempatan:

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. Respons Streaming dengan Server-Sent Events

Aktifkan penstriman dengan menetapkan stream: true. API memulangkan pecahan melalui Acara Dihantar Server. Setiap pecahan mengandungi teks separa dan data penggunaan token. Ini mengurangkan latensi yang dirasakan untuk respons panjang. Tangani acara SSE untuk mengemas kini UI anda secara masa nyata.

Contoh Node.js menggunakan SDK rasmi:

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 Mod JSON

Gunakan response_format dengan {"type": "json_object"} untuk output JSON yang ketat. Ini memastikan data terstruktur untuk laluan pemprograman. Aktifkan panggilan fungsi dengan menyediakan larik tools dalam badan permintaan. Model akan mengembalikan panggilan alat dalam format yang dijangka. Gunakan tool_choice untuk memaksa tingkah laku tertentu.

5. Had Kadar Permintaan dan Kekangan Saiz Permintaan

Setiap kunci API menyokong 300 permintaan setiap minit. Permintaan serentak dihadkan kepada 8 per kunci. Saiz badan permintaan maksimum ialah 8 MB. Tetingkap konteks memegang 100,000 token secara keseluruhan. Output maksimum setiap permintaan sehingga ke tetingkap penuh 100,000-token. Biarkan max_tokens tidak ditetapkan, atau tetapkan pada nilai tinggi, untuk mengelakkan pemotongan. Ralat tidak menggunakan kredit. Bayaran balik tidak dikeluarkan, tetapi ralat bilan akan dibetulkan melalui Sokongan.

6. Pengesahan dan Penanganan Ralat

Jana kunci anda melalui papan pemuka. Gunakan log masuk Google atau e-mel. Kunci akan muncul serta-merta. Sertakannya dalam header Authorization: Bearer. Kunci yang tidak sah akan memulangkan ralat 401. Ralat 429 menunjukkan had kadar telah dicapai. Ralat 402 bermaksud kredit prabayar anda telah habis. Muat semula dengan USDT atau USDC. Kredit tidak pernah luput.

Penstriman

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)