เริ่มต้นใช้งาน: ผสาน API สาว AI

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

API ของเราปฏิบัติตามมาตรฐาน chat-completions ของ OpenAI ทำให้การผสานรวมเป็นไปอย่างง่ายดายสำหรับไคลเอนต์ที่มีอยู่ คุณต้องรวมคีย์ API ของคุณในหัวข้อความยินยอม Authorization ของทุกคำขอ URL พื้นฐานสำหรับเอนด์พอยต์ทั้งหมดคือ https://api.roleplayapi.com/v1 เมื่อใช้ SDK ทางการ ให้อัปเดตการตั้งค่า base_url ให้ชี้ไปยังที่อยู่นี้และระบุคีย์ของคุณเป็น api_key การตั้งค่านี้ทำให้คำขอของคุณไปถึงเอนด์พอยต์แบบไม่เซ็นเซอร์เฉพาะของเราโดยไม่มีการเปลี่ยนแปลงตรรกะมาตรฐานของคุณ

ส่งการส่งข้อความ

เริ่มการสนทนาโดยส่งคำขอ POST ไปยัง /v1/chat/completions ตัวระบุโมเดลคือ uncensored คุณสามารถส่งข้อความจำนวนใดก็ได้ในอาร์เรย์ messages เพื่อสร้างบริบทหรือเริ่มบทสนทนาใหม่ การตอบสนองประกอบด้วยข้อความที่โมเดลสร้าง ซึ่งคุณสามารถสตรีมหรือแยกวิเคราะห์เป็นวัตถุ JSON เอนด์พอยต์นี้จัดการการโต้ตอบข้อความเข้า-ออกหลักที่จำเป็นสำหรับแอปที่ขับเคลื่อนด้วยตัวละคร

Copycurl https://api.roleplayapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

ผสาน SDK Python

ใช้ไลบรารี Python openai ทางการเพื่อโต้ตอบกับ API ด้วยโค้ดเริ่มต้นน้อยที่สุด กำหนดค่าไคลเอนต์ด้วย URL ฐานและคีย์ API ของคุณ จากนั้นเรียก chat.completions.create ด้วยรหัสโมเดล uncensored วิธีนี้ใช้ประโยชน์จากคำแนะนำประเภทและการจัดการข้อผิดพลาดที่มีอยู่ ทำให้คุณสามารถมุ่งเน้นที่ตรรกะแอปพลิเคชันของคุณแทนที่จะเป็นการแยกวิเคราะห์ HTTP วัตถุการตอบสนองให้เข้าถึงเนื้อหาที่สร้างได้โดยตรง

Copyfrom openai import OpenAI

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

ผสาน SDK Node

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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.roleplayapi.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 ในคำขอของคุณ API จะส่งสตรีมของชิ้นส่วนแทนที่จะเป็นการตอบสนองที่สมบูรณ์เพียงรายการเดียว สิ่งนี้มีประโยชน์เป็นพิเศษสำหรับอินเทอร์เฟซแชทที่ผู้ใช้คาดหวังการตอบสนองของตัวละครทันที คุณสามารถประมวลผลแต่ละชิ้นส่วนเมื่อมาถึง อัปเดต UI แบบเพิ่มทีละน้อย สตรีมจะสิ้นสุดเมื่อโมเดลสร้างลำดับโทเคนเสร็จสิ้น

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 คำขอต่อนาทีต่อคีย์ หากเกินขีดจำกัดนี้ API จะส่งรหัสสถานะ 429 การล้มเหลวในการตรวจสอบสิทธิ์จะส่งผลให้เกิดข้อผิดพลาด 401 ในขณะที่เครดิตแบบเติมเงินไม่เพียงพอจะกระตุ้นข้อผิดพลาด 402 หน้าต่างบริบทรองรับโทเคนได้สูงสุด 100,000 โทเคนสำหรับพรอมต์และการส่งข้อความรวมกัน หากต้องการตรวจสอบโมเดลที่มีอยู่ ให้ส่งคำขอ GET ไปยัง /v1/models ตรวจสอบให้แน่ใจว่าร่างกายคำขอของคุณไม่เกิน 8 MB