API MiniMax: คำขอแรกในห้านาที

ติดตั้ง SDK ของ OpenAI

เริ่มต้นด้วยการติดตั้ง SDK ของ OpenAI อย่างเป็นทางการสำหรับภาษาที่คุณต้องการ ไลบรารีจัดการการกำหนดรูปแบบคำขอและสตรีมมิงโดยอัตโนมัติ ตรวจสอบว่าคุณมี Python 3.8+ หรือ Node.js 18+ ติดตั้งแล้ว รัน pip install openai สำหรับ Python หรือ npm install openai สำหรับ Node SDK ทำให้การโต้ตอบกับเอนด์พอยต์ /v1/chat/completions ง่ายขึ้น มันจัดการส่วนหัว การลองใหม่ และการแยกวิเคราะห์ SSE เพื่อให้คุณสามารถมุ่งเน้นไปที่พรอมต์ได้ สิ่งนี้ใช้งานได้เพราะ API ของเราปฏิบัติตามมาตรฐานการเสร็จสิ้นแชทของ OpenAI คุณไม่จำเป็นต้องใช้ไลบรารีไคลเอนต์แบบกำหนดเอง วิธีการมาตรฐานของ SDK สอดคล้องโดยตรงกับเอนด์พอยต์ของเรา สิ่งนี้ลดเวลาการผสานรวมและใช้ความรู้ที่มีอยู่ของนักพัฒนา

กำหนดค่า URL พื้นฐานและคีย์ของคุณ

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

ส่งการเสร็จสิ้นแชทพื้นฐาน

ส่งคำขอครั้งแรกเพื่อสร้างข้อความ ใช้วิธี POST บน /v1/chat/completions ระบุโมเดลเป็น uncensored ส่งอาร์เรย์ข้อความพร้อมพรอมต์ของผู้ใช้ API จะส่งโทเคนการเติมเต็ม นี่คือคุณลักษณะการสร้างข้อความหลัก รองรับหน้าต่างบริบท 100k คุณสามารถส่งพรอมต์หรือประวัติการสนทนาที่ยาวได้ การตอบกลับรวมถึงข้อความที่สร้างและการใช้งานโทเคน สิ่งนี้เหมาะสำหรับการเขียนเชิงสร้างสรรค์หรือการสนทนาแบบไม่มีข้อจำกัด ตรวจสอบให้แน่ใจว่าเนื้อหาถูกกฎหมาย โมเดลไม่ปฏิเสธหัวข้อสำหรับผู้ใหญ่ มันจะบล็อกเฉพาะเนื้อหาทางเพศที่เกี่ยวข้องกับเด็ก เริ่มต้นอย่างง่ายเพื่อตรวจสอบการเชื่อมต่อ

เปิดใช้งานสตรีมมิง (SSE)

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

ใช้การเรียกใช้เครื่องมือ/ฟังก์ชัน

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

ตรวจสอบโมเดลที่มีอยู่

ตรวจสอบรายการโมเดลผ่าน GET /v1/models เอนด์พอยต์นี้ส่งคืนโมเดลที่มีอยู่ API ของเราให้บริการโมเดลหนึ่งตัว: uncensored มันเป็นโมเดลแบบเปิดน้ำหนัก มันไม่ใช่ GPT, Claude หรือ Gemini การตอบกลับยืนยัน ID ของโมเดล ใช้สิ่งนี้เพื่อตรวจสอบการกำหนดค่าไคลเอนต์ ตรวจสอบให้แน่ใจว่าโค้ดของคุณกำหนดเป้าหมายไปยังโมเดลที่ถูกต้อง เอนด์พอยต์นี้รวดเร็วและเชื่อถือได้ มันส่งคืนข้อมูล JSON คุณสามารถแยกวิเคราะห์สิ่งนี้สำหรับการแสดง UI มันยืนยันว่าคีย์ API ของคุณถูกต้อง ใช้สิ่งนี้สำหรับการตรวจสอบสุขภาพอัตโนมัติ มันเป็นส่วนหนึ่งของสเปคมาตรฐานของ OpenAI ไม่จำเป็นต้องกำหนดค่าเพิ่มเติม สิ่งนี้ทำให้แน่ใจว่าความเข้ากันได้กับเครื่องมือที่มีอยู่

cURL

Copycurl https://api.minimaxapikey.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

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

สตรีมมิง

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)