เอกสาร API

URL ฐานและการตรวจสอบสิทธิ์

เชื่อมต่อแอปพลิเคชันของคุณโดยชี้ไปที่เอนด์พอยต์เฉพาะของเราและส่งคีย์ API เฉพาะของคุณ URL พื้นฐานสำหรับคำขอทั้งหมดคือ https://api.apertusapp.com/v1.คุณได้รับคีย์ของคุณทันทีหลังจากสมัครสมาชิกผ่าน Google หรืออีเมลบน รับ API key หน้าเว็บ รวมคีย์นี้ไว้ใน Authorization header สำหรับการร้องขอทุกชิ้น

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

แต่ละบัญชีสร้างคีย์ที่ใช้งานอยู่หนึ่งคีย์ หากคุณสร้างคีย์ใหม่ คีย์ก่อนหน้าจะหมดอายุทันที ซึ่งช่วยให้คุณสามารถควบคุมการเข้าถึงได้อย่างเข้มงวดโดยไม่ต้องมีชั้นการสมัครสมาชิกหรือค่าธรรมเนียมเมื่อไม่ได้ใช้งาน

คำขอครั้งแรก

ส่ง prompt แรกไปยัง endpoint chat completions เพื่อรับข้อความดิบที่ไม่มีการกรอง ใช้ ID ของโมเดล uncensored เพื่อเข้าถึงโมเดลโอเพนเวตเฉพาะของเราที่ปรับแต่งสำหรับหัวข้อผู้ใหญ่ที่ถูกต้องตามกฎหมายและหัวข้อที่ถกเถียง

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 ยอมรับพารามิเตอร์มาตรฐานเช่น temperature และ top_p. ข้อผิดพลาดและการปฏิเสธไม่ใช้โทเค็น ดังนั้นคุณจึงจ่ายเฉพาะสิ่งที่ไปถึงโมเดลจริง ๆ วิธีการนี้ทำให้ต้นทุนคาดการณ์ได้เมื่อเทียบกับผู้รวมบริการที่เรียกเก็บเงินสำหรับค่าโอเวอร์เฮดของการเปลี่ยนเส้นทาง

การผสานรวม Node SDK

ใช้ Node SDK ทางการเพื่อจัดการ JSON mode และ function calling อย่างมีประสิทธิภาพ ตั้งค่า response_format เพื่อ {"type": "json_object"} สำหรับผลลัพธ์แบบมีโครงสร้างหรือกำหนดเครื่องมือสำหรับพฤติกรรมคล้ายเอเจนต์

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);

โมเดลรองรับการเรียกใช้เครื่องมือด้วย tool_choice ตัวเลือก คุณยังสามารถตั้งค่า seed สำหรับผลลัพธ์ที่แน่นอน ความยืดหยุ่นนี้ช่วยให้คุณสร้างแอปพลิเคชันที่ซับซ้อนได้โดยไม่ต้องออกจากระบบนิเวศที่เข้ากันได้กับ OpenAI

การตอบสนองแบบสตรีม

ส่งโทเค็นแบบเรียลไทม์โดยใช้ Server-Sent Events (SSE) เพื่อประสบการณ์ผู้ใช้ที่มีเวลาแฝงต่ำ แต่ละชิ้นข้อมูลจะมีข้อความที่สร้าง และชิ้นข้อมูลสุดท้ายจะรวมสถิติการใช้โทเค็นรวม

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)

การสตรีมลดการรับรู้ความล่าช้าสำหรับผู้ใช้งาน คุณสามารถหยุดสตรีมได้หากผู้ใช้เปลี่ยนใจ API จัดการโปรโตคอล SSE โดยอัตโนมัติ โดยต้องการโค้ดเพียงเล็กน้อยจากฝั่งของคุณ

หน้าต่างบริกและความจุ

โมเดลรองรับหน้าต่างบริบทขนาด 100,000-token สำหรับทั้งอินพุตและเอาต์พุตรวมกัน คุณสามารถระบุค่าได้สูงสุด 16,000 tokens ต่อคำขอ หรือใช้ค่าสำรองที่ 2,048 tokens หากไม่ระบุ max_tokens.

หน้าต่างขนาดใหญ่ Allows ให้สามารถวิเคราะห์เอกสารอย่างกว้างขวางหรือประวัติการสนทนาที่ยาวได้ อย่างไรก็ตาม โปรดรักษาขนาดร่างกายคำขอไว้ต่ำกว่า 8 MB โมเดลไม่ใช่ GPT หรือ Llama; มันเป็นโมเดล AI แบบไร้การเซ็นเซอร์ที่แตกต่างกันที่ปรับให้เหมาะสมสำหรับกรณีการใช้งานเฉพาะของคุณ

การจัดการข้อผิดพลาดและขีดจำกัด

จัดการข้อผิดพลาด HTTP มาตรฐานอย่างเหมาะสมเพื่อรักษาโฟลว์แอปพลิเคชันที่แข็งแกร่ง A 401 error บ่งชี้ว่าคีย์ API ไม่ถูกต้องหรือหายไป A 402 error หมายถึงเครดิตพรีเพดของคุณหมดแล้ว A 429 error บ่งชี้ว่าคุณเกิน 300 คำขอต่อนาที หรือ 8 คำขอพร้อมกัน

เครดิตไม่หมดอายุ ดังนั้นคุณสามารถหยุดใช้งานและกลับมาใหม่ได้ ความผิดพลาดเช่นการเรียกเก็บเงินซ้ำจะแก้ไขผ่านหน้า Support เครดิตแบบเติมเงินจะถูกเรียกเก็บเฉพาะสำหรับการบริโภคโทเค็นจริง ๆ เพื่อให้การกำหนดราคาโปร่งใสสำหรับทุกไบต์