API Quickstart & การผสานรวม

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

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

คุณจ่ายเฉพาะสำหรับโทเค็นที่ใช้งานจริง ข้อผิดพลาดและการปฏิเสธไม่หักจากเครดิตที่เติมล่วงหน้า บัญชีใหม่จะได้รับเครดิตทดลอง $0.50 ใช้ได้เป็นเวลา 7 วัน คุณสามารถเติมเงินด้วย USDT (TRC20) หรือ USDC (Base) ในจำนวนระหว่าง $20 ถึง $500

Endpoint /v1/chat/completions

ส่งข้อความไปยังจุดจบ chat completions มาตรฐาน ID โมเดลคือ uncensored. มันรับรายการออบเจ็กต์ข้อความที่มีบทบาทเช่น system, user, หรือ assistant. โมเดลไม่ปฏิเสธหัวข้อผู้ใหญ่ที่ถูกต้องตามกฎหมาย เรื่องแต่ง หรือหัวข้อที่ถกเถียงได้ มันเป็นโมเดลโอเพนเวตที่ปรับแต่งสำหรับการตอบโดยตรง

คำขอจะส่งคืนวัตถุ JSON ที่มีข้อความที่สร้างขึ้น หน้าต่างบริบทรองรับโทเค็นรวมกันได้ 100,000 โทเค็นสำหรับคำสั่งเริ่มต้นและผลลัพธ์ ผลลัพธ์จะถูกจำกัดไว้ที่ 16,000 โทเค็นต่อคำขอ เว้นแต่คุณจะระบุค่าที่ต่ำกว่า max_tokens ค่า

Copycurl https://api.hereticproject.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list dependencies for node project"}]
  }'

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

ใช้ไลบรารี Python ทางการพร้อม base URL แบบกำหนดเอง ตั้งค่า api_key ไปยังสตริง API ของคุณ กำหนดค่า base_url ชี้ไปยังเซิร์ฟเวอร์ของ Heretic Project สิ่งนี้ช่วยให้คุณใช้วิธีการที่คุ้นเคยเช่น chat.completions.create() โดยไม่ต้องปรับเปลี่ยนโครงสร้างโค้ดที่มีอยู่ของคุณอย่างมีนัยสำคัญ

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

Copyfrom openai import OpenAI

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

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

SDK ของ Node.js ทำงานเหมือนกับเวอร์ชัน Python เริ่มต้นไคลเอนต์ด้วยคีย์ API และ URL พื้นฐานที่ถูกต้อง คุณสามารถส่งคำขอ completion โดยใช้ลายเซ็นเมธอดเดียวกัน สิ่งนี้สร้างความสม่ำเสมอในส่วนต่างๆ ของสแต็กของคุณ

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

Copyimport OpenAI from "openai";

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

การตอบกลับแบบสตรีมมิ่ง (SSE)

เปิดใช้งานการสตรีมโดยตั้งค่า stream: true ในการร้องขอของคุณ เซิร์ฟเวอร์ส่ง 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)

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

เคารพขีดจำกัดอัตราส่วนเพื่อหลีกเลี่ยงการหยุดชะงักของการบริการ คุณได้รับอนุญาตให้ส่งคำขอได้ 300 คำขอต่อนาทีต่อคีย์ ความพร้อมใช้งานจำกัดอยู่ที่ 8 คำขอพร้อมกัน body คำขอไม่สามารถมีขนาดเกิน 8 MB หากเกินขีดจำกัดเหล่านี้จะคืนค่ารหัสสถานะ 429 รอพักสักครู่ก่อนลองใหม่

Authentication failures return a 401 error. This happens if the key is invalid or expired. A 402 error indicates insufficient prepaid credit. Refund mistakes are handled via the Support page. Credit never expires. The model refuses content involving minors. All other lawful content is accepted.