คู่มือการผสานรวม API Character AI

ทำไมควรแทนที่ Character AI ด้วย API?

Character AI สะดวก แต่ล็อกตัวละครของคุณไว้ในระบบนิเวศของมัน คุณไม่สามารถบันทึกหน้าต่างบริบทเต็ม ปรับพารามิเตอร์ของโมเดล หรือรับประกันความเป็นส่วนตัวของข้อมูลได้ โซลูชัน API เช่น uncutly AI ให้คุณเข้าถึง LLM แบบ uncensored โดยตรง คุณควบคุมพรอมต์ อุณหภูมิ และลำดับหยุด ซึ่งหมายความว่าตัวละครของคุณจะประพฤติตัวตามที่คุณต้องการ

แพลตฟอร์มแบบกรรมสิทธิ์มักปฏิเสธเนื้อหาที่ถูกต้องตามกฎหมาย พวกเขาอาจตัดเรื่องราวเนื่องจากคำหลักที่ละเอียดอ่อน ด้วย API แชทบอทแบบไม่เซ็นเซอร์ คุณเป็นผู้ตัดสินใจว่าอะไรอนุญาต คุณได้รับจุดสิ้นสุดเดียวที่เชื่อถือได้สำหรับการสร้างข้อความ ความน่าเชื่อถือนี้สำคัญมากเมื่อคุณกำลังสร้างผลิตภัณฑ์ที่ขึ้นอยู่กับพฤติกรรมตัวละครที่สม่ำเสมอ คุณไม่ได้อยู่ภายใต้การควบคุมของทีมตรวจสอบเนื้อหาแบบสุ่มของแพลตฟอร์ม

ขั้นตอนที่ 1: รับคีย์ API ของคุณ

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

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

ขั้นตอนที่ 2: กำหนดค่า Base URL

ไคลเอนต์ LLM ส่วนใหญ่ในปัจจุบันคาดหวังอินเทอร์เฟซที่เข้ากันได้กับ OpenAI คุณต้องชี้ SDK ของคุณไปยัง URL พื้นฐานที่ถูกต้อง สำหรับบริการนี้ เอนด์พอยต์คือ https://api.uncutlyai.com/v1. โครงสร้าง URL นี้เลียนแบบ API มาตรฐานของ OpenAI นั่นหมายความว่าคุณสามารถใช้ไลบรารีที่มีอยู่ได้โดยไม่ต้องเปลี่ยนแปลงโค้ดมากนัก

อัปเดตวัตถุ configuration ของคุณให้รวม base URL นี้ด้วย นอกจากนี้ ให้ตั้งค่า API key ใน authorization header model ID ที่คุณจะใช้คือ "uncensored" โมเดลนี้ได้รับการปรับแต่งเพื่อลดการปฏิเสธและเพิ่มอิสระทางความคิดมากขึ้น จัดการกับบริบทที่ยาวได้ดีถึง 100,000 tokens ความยาวนี้ช่วยให้สามารถเก็บประวัติตัวละครได้อย่างลึกซึ้ง

ขั้นตอนที่ 3: ส่งคำขอ Chat Completion ครั้งแรกของคุณ

สร้างคำขอไปยัง /v1/chat/completions endpoint. endpoint. body ควรประกอบด้วยรายการข้อความ แต่ละข้อความมี role เช่น "system", "user" หรือ "assistant" ข้อความระบบกำหนดบุคลิกของตัวละคร ข้อความผู้ใช้ขับเคลื่อนการสนทนา

นี่คือวิธีที่คุณจัดโครงสร้างคำขอ:

Copycurl https://api.uncutlyai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Show me the API endpoint for text generation"}]
  }'

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

ขั้นตอนที่ 4: จัดการการตอบกลับแบบ Streaming

แอปพลิเคชันแชทจะรู้สึกช้าหากต้องรอให้คำตอบทั้งหมดเสร็จสิ้นก่อน การสตรีมช่วยแก้ปัญหานี้ ตั้งค่า stream ตั้งค่าเป็น true เซิร์ฟเวอร์จะส่งกลับชุดของ Server-Sent Events (SSE) แต่ละเหตุการณ์มีข้อความบางส่วน

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

Copyfrom openai import OpenAI

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

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

ขั้นตอนที่ 5: จัดการ Tokens และต้นทุน

การเข้าใจต้นทุนโทเค็นเป็นสิ่งจำเป็นสำหรับการวางแผนงบประมาณ คุณจ่ายต่อล้านโทเค็น โทเค็นอินพุตราคา $0.15 ต่อล้าน โทเค็นเอาท์พุตราคา $0.50 ต่อล้าน คุณจ่ายเฉพาะโทเค็นที่ผ่านการประมวลผลเท่านั้น ความผิดพลาดไม่คิดเงิน การปฏิเสธก็ไม่คิดเงินเช่นกัน

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

ขั้นตอนที่ 6: นำ Function Calling ไปใช้งาน

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

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

Copyimport OpenAI from "openai";

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

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

ขั้นตอนที่ 7: การจัดการข้อผิดพลาดและขีดจำกัด

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

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

ขั้นตอนที่ 8: ขยายการผสานรวมของคุณ

เมื่อฐานผู้ใช้ของคุณเติบโต การใช้งาน API ของคุณจะเพิ่มขึ้น ตรวจสอบการบริโภคโทเค็นของคุณอย่างใกล้ชิด ใช้ข้อมูลการใช้งานจากการตอบสนองแบบสตรีมเพื่อติดตามค่าใช้จ่าย หากคุณ noticing ค่าใช้จ่ายสูง ให้พิจารณาปรับปรุง prompts ของคุณ prompts ระบบที่สั้นกว่าสามารถลดโทเค็นอินพุตได้

ลองพิจารณาการแคชคำตอบที่พบบ่อย หากผู้ใช้หลายคนถามคำถามเดียวกัน ให้ส่งผลลัพธ์ที่แคชไว้ สิ่งนี้ลดจำนวน API call และประหยัดเงิน คุณยังสามารถกำหนดอัตราจำกัด (rate limiting) บนเซิร์ฟเวอร์ของคุณเองได้ เพื่อป้องกันไม่ให้ผู้ใช้รายใดรายหนึ่งใช้เครดิตของคุณจนหมด การผสานรวมที่ปรับขนาดได้ดีจะยังคงเร็วและเชื่อถือได้