เริ่มต้นใช้งาน API Mukenetsu AI

การตั้งค่าพื้นฐานและ URL พื้นฐาน

Mukenetsu AI ออกแบบมาเป็น REST API ที่เข้ากันได้กับ OpenAI ทำให้คุณสามารถใช้ไคลเอนต์หรือ SDK ของ OpenAI ที่มีอยู่ได้ด้วยการเปลี่ยนแปลงเพียงเล็กน้อย ใช้ URL พื้นฐานต่อไปนี้เพื่อสื่อสารกับ API

https://api.mukenetsuapi.com/v1

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

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

การตรวจสอบสิทธิ์และคีย์ API

API เข้าถึงได้ด้วยการยืนยันผ่านเฮดเดอร์Authorization: Bearer <API_KEY> ใช้คีย์ API ของ Mukenetsu AI ที่สร้างตอนสมัครสมาชิก กำหนดคีย์ API หนึ่งต่อหนึ่งต่อบัญชี แต่สามารถสร้างใหม่ได้ตลอดเวลา หากสร้างคีย์ใหม่ คีย์เก่าจะหมดอายุ โปรดระวัง

หากเกิดข้อผิดพลาดในการตรวจสอบสิทธิ์ มักจะส่งสถานะ 401 (Unauthorized) หรือ 402 (Payment Required) กลับมา 401 หมายถึงคีย์ผิดหรือหมดอายุ ส่วน 402 หมายถึงเครดิตในบัญชีไม่เพียงพอ เครดิตเป็นแบบเติมเงินล่วงหน้า สามารถเติมด้วยคริปโทเคอร์เรนซี (USDT, USDC) จำนวน $10 ขึ้นไป

เอนด์พอยต์การเติมข้อความแชท

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

ตัวอย่างด้านล่างแสดงวิธีการสร้างข้อความพื้นฐานโดยใช้ curl พารามิเตอร์ที่จำเป็นได้แก่ โมเดล ID ข้อความ และตัวเลือกการเปิดใช้งานสตรีมมิง

コピーcurl https://api.mukenetsuapi.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."}]
  }'

เอนด์พอยต์นี้ไม่ได้ให้บริการฟังก์ชันเช่น เอมเบดดิ้ง (embeddings) การสร้างภาพ หรือการแปลงเสียง โดยเน้นเฉพาะการเติมข้อความและการสร้างข้อความเท่านั้น

สตรีมมิง (SSE)

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

หากคุณใช้ Python OpenAI SDK หรือไลบรารีไคลเอนต์ Node.js การระบุตัวเลือกstream=True จะทำให้การประมวลผลสตรีมมิงเกิดขึ้นโดยอัตโนมัติ ตัวจัดการเหตุการณ์จะรับชิ้นส่วนโทเคนต่อโทเคน

コピーfrom openai import OpenAI

client = OpenAI(base_url="https://api.mukenetsuapi.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 ของ Mukenetsu AI รองรับการใช้งานเครื่องมือ (ฟังก์ชัน) ซึ่งช่วยให้การเชื่อมต่อกับ API หรือฐานข้อมูลภายนอกทำได้ง่ายขึ้น โดยรวมฟิลด์ tools และพารามิเตอร์ tool_choice ในบอดีคำขอเพื่อสั่งให้โมเดลดำเนินการฟังก์ชันเฉพาะ

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

コピーimport OpenAI from "openai";

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

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

ขีดจำกัดอัตราและข้อจำกัด

API มีการจำกัดการใช้งานดังนี้: สูงสุด 300 คำขอต่อนาที และขนาดบอดี้คำขอสูงสุด 8 MB หากเกินขีดจำกัดเหล่านี้ จะส่งข้อผิดพลาด 429 (Too Many Requests) กลับมา หน้าต่างบริบทคือ 100,000 โทเคน (ผลรวมของพรอมต์และข้อความที่สร้าง) ข้อความหรือเอกสารที่ยาวเกินกว่านี้ต้องแบ่งส่งอย่างเหมาะสม

เมื่อรับการตอบสนองแบบสตรีมมิง ให้ปฏิบัติตามลำดับเหตุการณ์ดังต่อไปนี้

コピー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)

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