คู่มือเริ่มต้นใช้งาน API Wu Shencha

การตั้งค่าพื้นฐาน

API Wu Shencha ให้บริการอินเทอร์เฟซที่เข้ากันได้กับ OpenAI คุณต้องตั้งค่า base URL และคีย์ API ในโค้ด base URL คือ https://api.wushenchaapi.com/v1 โมเดล ID คือ uncensored ซึ่งเป็นโมเดลแบบเปิดน้ำหนักที่ปรับแต่งมาเพื่อใช้งานแบบไม่เซ็นเซอร์ รองรับเนื้อหาผู้ใหญ่ที่ถูกต้องตามกฎหมาย

คีย์จะแสดงในหน้า "รับคีย์ API" หลังจากลงทะเบียน เนื่องจาก API เข้ากันได้กับ OpenAI คุณสามารถแก้ไขพารามิเตอร์ base_url ใน SDK ทางการเพื่อเชื่อมต่อได้ทันที ไม่ต้องตั้งค่าเส้นทางหรือการตั้งค่าที่ซับซ้อน

อินเทอร์เฟซการเติมข้อความแชท

ใช้เอนด์พอยต์ POST /v1/chat/completions เพื่อส่งคำขอข้อความ อินเทอร์เฟซนี้รองรับรูปแบบข้อความมาตรฐานและส่งข้อความที่สร้างโดยโมเดลกลับออกมา ซึ่งเป็นวิธีการโต้ตอบพื้นฐานที่สุด เหมาะสำหรับสถานการณ์การสร้างข้อความส่วนใหญ่

Body ของคำขอต้องประกอบด้วยฟิลด์ model, messages เป็นต้น ตรวจสอบให้แน่ใจว่าขนาด body ของคำขอไม่เกิน 8 MB หากคีย์ไม่ถูกต้องหรือยอดเงินไม่เพียงพอ API จะส่งรหัสข้อผิดพลาดที่เกี่ยวข้องกลับ

复制curl https://api.wushenchaapi.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."}]
  }'

Python SDK

สำหรับนักพัฒนา Python สามารถใช้ SDK ทางการ openai ได้ เพียงชี้ base_url ไปยังเอนด์พอยต์ของ API Wu Shencha และส่งคีย์ API ของคุณ วิธีนี้รักษาความสอดคล้องกับโค้ดต้นฉบับของ OpenAI ทำให้การย้ายข้อมูลทำได้ง่าย

ตรวจสอบให้แน่ใจว่าได้ติดตั้งเวอร์ชันล่าสุดของ SDK ตัวอย่างโค้ดแสดงวิธีการเริ่มต้นไคลเอนต์และส่งข้อความ วิธีนี้เรียบง่ายและรวดเร็ว เหมาะสำหรับการพัฒนาต้นแบบอย่างรวดเร็ว

复制from openai import OpenAI

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

นักพัฒนา Node.js สามารถใช้แพ็กเกจ npm openai เพื่อเชื่อมต่อได้เช่นกัน โดยตั้งค่า baseURL และ apiKey ซึ่งช่วยให้มีความสอดคล้องข้ามภาษาและลดต้นทุนการเรียนรู้

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

复制import OpenAI from "openai";

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

สตรีมมิง

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

การตอบกลับแบบสตรีมมิงไม่เปลี่ยนพฤติกรรมของโมเดล แต่เปลี่ยนเพียงวิธีการส่งข้อมูล คุณสามารถเลือกโหมดสตรีมมิงหรือไม่สตรีมมิงได้ตามต้องการ

复制stream = 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 ครั้งต่อนาที หน้าต่างบริบทมีขนาด 100,000 โทเคน (รวมพรอมต์และการเติมข้อความ) หากเกินขีดจำกัด API จะส่งข้อผิดพลาด 429 หากคีย์ไม่ถูกต้องจะส่งข้อผิดพลาด 401 และหากยอดเงินไม่เพียงพอจะส่งข้อผิดพลาด 402

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