การตั้งค่า API MiniMax: คีย์, Base URL และการส่งคำขอครั้งแรก
นี่คือการตั้งค่าทีละขั้นตอนสำหรับ API ที่เข้ากันได้กับ OpenAI บน minimaxapikey.com: บัญชี คีย์ Base URL และคำขอแรก เป็นบริการอิสระ ไม่ใช่ API ทางการของผู้จัดจำหน่ายโมเดลใด ๆ
อัปเดต

จุดสำคัญ
- สมัครสมาชิกด้วย Google หรืออีเมล แล้วรับเครดิตทดลอง $0.50 ที่หน้าคีย์ ไม่จำเป็นต้องใช้บัตร
- Base URL คือ https://api.minimaxapikey.com/v1, model ID คือ uncensored การตรวจสอบสิทธิ์คือคีย์ Bearer
- มีสองวิธี: POST /v1/chat/completions และ GET /v1/models
- 401 หมายถึงคีย์ไม่ถูกต้อง และ 429 หมายถึงถึงขีดจำกัดแล้ว ดังนั้นให้ตรวจสอบรหัสข้อผิดพลาดใน body
สิ่งที่คุณกำลังตั้งค่า
ผู้คนค้นหา minimax api setup โดยคาดหวังสิ่งใดสิ่งหนึ่ง: แพลตฟอร์มผู้พัฒนา MiniMax ทางการ หรือเอนด์พอยต์สไตล์ OpenAI ที่ใช้งานแทนกันได้ หน้าเว็บนี้ครอบคลุมกรณีหลัง บริการที่อยู่เบื้องหลัง minimaxapikey.com คือ API ข้อความที่โฮสต์และเข้ากันได้กับ OpenAI ซึ่งรันโมเดลแบบเปิดน้ำหนักเพียงตัวเดียว ดำเนินการโดยผู้ให้บริการอิสระ ไม่ใช่ API ทางการของ MiniMax หรือผู้จัดจำหน่ายโมเดลรายอื่น และไม่เปลี่ยนเส้นทางคำขอข้ามผู้จัดจำหน่าย หากคุณต้องการแพลตฟอร์มของผู้จัดจำหน่าย ให้ใช้เว็บไซต์ของพวกเขา
สิ่งที่คุณได้รับนั้นเรียบง่าย SDK หรือไคลเอนต์ OpenAI ใด ๆ ทำงานได้เมื่อคุณเปลี่ยน Base URL และคีย์ มีสองวิธี คือ POST /v1/chat/completions และ GET /v1/models มีโมเดล ID เพียงตัวเดียว คือ uncensored และมีหน้าต่างบริบท 100,000 โทเคนที่ใช้ร่วมกันระหว่างพรอมต์และการสร้างข้อความ รองรับเฉพาะข้อความ ดังนั้นจึงไม่มีการสร้างภาพ เสียง หรือวิดีโอ ไม่มี embeddings และไม่มี fine-tuning รองรับสตรีมมิง การเรียกใช้ฟังก์ชัน และโหมด JSON
การตั้งค่าทั้งหมดใช้เวลาเพียงไม่กี่นาที ขั้นตอนด้านล่างเรียงตามลำดับ และแต่ละขั้นตอนมีขั้นตอนตรวจสอบเพื่อให้คุณทราบว่าทำงานสำเร็จก่อนดำเนินการต่อ
ขั้นตอนที่ 1 และ 2: สร้างบัญชีและรับเครดิตทดลอง
- เปิดหน้าคีย์ ไปที่ หน้า API key แล้วเข้าสู่ระบบ คุณสามารถใช้ Google หรือที่อยู่อีเมลพร้อมรหัสผ่าน
- รับเครดิตทดลองใช้ หลังจากสมัครสมาชิก หน้าคีย์จะมีปุ่มสำหรับรับเครดิตทดลองใช้มูลค่า $0.50 เพียงคลิกเดียว ไม่ต้องใช้บัตร และใช้งานได้ 7 วัน จำกัดเพียงหนึ่งครั้งต่อบุคคล
เครดิตทดลองใช้มีจำนวนน้อยโดยตั้งใจ ราคา $0.15 ต่อ 1M input tokens และ $0.50 ต่อ 1M output tokens ทำให้ $0.50 สามารถครอบคลุมคำขอทดสอบได้จำนวนหนึ่ง พรอมต์ขนาด 1,000 tokens พร้อมคำตอบ 500 tokens มีต้นทุน input $0.00015 และ output $0.00025 รวมเป็น $0.0004 การนำ $0.50 มาหารด้วยจำนวนนี้จะได้ 1,250 คำขอแบบเดียวกัน ดังนั้นคุณจึงมีพื้นที่เพียงพอสำหรับการทดลอง
โปรดทราบข้อจำกัดของคีย์ทดลอง: คำขอพร้อมกัน (parallel requests) ได้ 2 คำขอ และ 60 คำขอต่อนาที คีย์แบบเต็มซึ่งได้หลังจากเติมเงินแล้ว จะอนุญาตคำขอพร้อมกัน 8 คำขอ และ 300 คำขอต่อนาที หากลูปทดสอบของคุณทำงานแบบขนานและพบข้อผิดพลาด 429 ให้ตรวจสอบจุดนี้เป็นอันดับแรก
ขั้นตอนที่ 3: สร้างคีย์และจัดเก็บอย่างปลอดภัย
บนหน้าเดียวกัน ให้สร้าง API key และคัดลอกไว้ ถือว่าเป็นรหัสผ่าน เก็บไว้ในตัวแปรสภาพแวดล้อมหรือตัวจัดการความลับ (secrets manager) ห้ามเก็บใน repository, bundle ของ front-end หรือภาพหน้าจอ หากคีย์รั่วไหล ให้ลบออกและสร้างคีย์ใหม่
# macOS / Linux
export UNCENSORED_KEY="paste-your-key-here"
# Windows PowerShell
$env:UNCENSORED_KEY = "paste-your-key-here"
โค้ดฝั่งเซิร์ฟเวอร์ควรอ่านตัวแปรนี้ขณะรันไทม์ โค้ดบนเบราว์เซอร์ไม่ควรเก็บคีย์ไว้เลย: ให้ส่งคำขอจาก backend ของคุณแทน เพราะทุกอย่างที่ส่งไปยังเบราว์เซอร์จะมองเห็นได้โดยผู้เยี่ยมชมทุกคน
ขั้นตอนที่ 4: แสดงรายการโมเดลเพื่อยืนยันคีย์
การทดสอบที่ประหยัดที่สุดคือการใช้เอนด์พอยต์โมเดล มันไม่สร้างข้อความ จึงเป็นการตรวจสอบคีย์ URL และเครือข่ายของคุณอย่างสะอาด
curl -s https://api.minimaxapikey.com/v1/models \
-H "Authorization: Bearer $UNCENSORED_KEY"
คุณควรได้รับรายการ JSON ที่มี uncensored หากได้รับข้อผิดพลาด 401 แสดงว่าคีย์ไม่ถูกต้องหรือมีช่องว่างหรือเครื่องหมายคำพูดเกินมา หากการเชื่อมต่อล้มเหลว ให้ตรวจสอบว่า URL ลงท้ายด้วย /v1 และคุณใช้ https
ขั้นตอนที่ 5: ส่งคำขอแชทครั้งแรก
ตอนนี้เป็นการสร้างข้อความจริง โครงสร้างของ body คือรูปแบบ chat completions มาตรฐาน
curl -s https://api.minimaxapikey.com/v1/chat/completions \
-H "Authorization: Bearer $UNCENSORED_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Explain what an API key is in two sentences."}
],
"temperature": 0.7
}'
การตอบกลับมี choices[0].message.content และบล็อก usage ที่มีจำนวนโทเคนของพรอมต์และการสร้างข้อความ ตรวจสอบส่วนหัวของ response ด้วย curl -i คุณจะเห็น X-Request-Id ซึ่งฝ่ายสนับสนุนสามารถใช้เพื่อค้นหาคำขอของคุณ, X-Balance-USD ซึ่งเป็นเครดิตคงเหลือของคุณ และส่วนหัวขีดจำกัดอัตรา X-RateLimit-Limit-Requests และ X-RateLimit-Limit-Concurrency
พารามิเตอร์เช่น temperature, top_p, stop, seed และค่าปรับจะถูกส่งผ่าน max_tokens เป็นตัวเลือก หากไม่ระบุ การสร้างข้อความอาจใช้พื้นที่ที่เหลือของหน้าต่าง
ขั้นตอนที่ 6: เรียกใช้คำสั่งเดียวกันผ่าน SDK
เมื่อ curl ทำงานได้แล้ว ให้ย้ายไปใช้ภาษาที่คุณจะใช้จริง มีเพียงสองอาร์กิวเมนต์ที่เปลี่ยนแปลงจากการตั้งค่า OpenAI มาตรฐาน
from openai import OpenAI
import os
client = OpenAI(
base_url="https://api.minimaxapikey.com/v1",
api_key=os.environ["UNCENSORED_KEY"],
)
reply = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Give me three names for a hiking app."}],
)
print(reply.choices[0].message.content)
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.minimaxapikey.com/v1",
apiKey: process.env.UNCENSORED_KEY,
});
const reply = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Give me three names for a hiking app." }],
});
console.log(reply.choices[0].message.content);
สำหรับการสตรีมมิง ให้เพิ่ม stream: true และอ่าน server-sent events ข้อมูลการใช้งานจะมาถึงที่ท้ายสตรีม หน้า เอกสาร ครอบคลุมการสตรีมมิง, การเรียกใช้ฟังก์ชัน (function calling) และโหมด JSON ด้วย response_format: {"type":"json_object"}
การย้ายโปรเจกต์ OpenAI ที่มีอยู่
ส่วนใหญ่แล้วโปรเจกต์ที่คุณต้องการเชื่อมต่อจะทำงานร่วมกับไลบรารีไคลเอนต์ของ OpenAI อยู่แล้ว ในกรณีนั้นคุณแทบไม่ต้องแก้ไขโค้ดเลย SDK ทางการจะอ่านตัวแปรสภาพแวดล้อม OPENAI_API_KEY และ OPENAI_BASE_URL เมื่อคุณไม่ได้ส่งอาร์กิวเมนต์ ดังนั้นการเปลี่ยนแปลงการปรับใช้ (deployment) อาจเพียงพอ
export OPENAI_BASE_URL="https://api.minimaxapikey.com/v1"
export OPENAI_API_KEY="paste-your-key-here"
# then in your code, request model "uncensored"
การแก้ไขที่เหลือเพียงอย่างเดียวคือชื่อโมเดล สตริงเช่น ID ของโมเดล OpenAI จะไม่มีที่นี่ ดังนั้นให้แทนที่ด้วย uncensored โดยควรทำผ่านค่า config เพื่อให้สามารถสลับกลับได้ จากนั้นอ่านโค้ดเพื่อตรวจสอบฟีเจอร์ที่บริการนี้ไม่มี การสร้างภาพ, เสียง, embeddings และการปรับแต่ง (fine-tuning) ไม่มีให้บริการ เนื่องจากนี่คือ API แชทสำหรับข้อความเท่านั้น หากแอปของคุณเรียกใช้ embeddings สำหรับการค้นหา คุณจะต้องใช้ผู้ให้บริการอื่นสำหรับส่วนนั้นและสามารถใช้แชทบนบริการนี้ต่อไปได้
การทราบข้อมูลโมเดลก็ช่วยได้เช่นกัน โมเดลนี้เป็นโมเดลแบบเปิดน้ำหนักเพียงตัวเดียว ที่ปรับแต่งมาเพื่อตอบคำถามโดยไม่ปฏิเสธเนื้อหาสำหรับการใช้งานผู้ใหญ่ที่ถูกต้องตามกฎหมาย และมีข้อจำกัดหนึ่งข้อที่บังคับใช้ไม่ว่าจะตั้งค่าอย่างไร: ไม่มีเนื้อหาทางเพศที่เกี่ยวข้องกับผู้เยาว์ พรอมต์ที่เขียนสำหรับโมเดลอื่นอาจต้องปรับเล็กน้อย เนื่องจากแต่ละโมเดลตอบสนองต่อระบบพรอมต์เดียวกันแตกต่างกัน ควรทดสอบพรอมต์ของคุณเองคู่กันก่อนเปลี่ยนการใช้งานจริง
การตั้งค่าที่ควรเลือกในวันแรก
การตัดสินใจบางอย่างเป็นเรื่องง่ายกว่าที่จะทำในช่วงตั้งค่ามากกว่าหลังเปิดตัว ไม่มีอะไรยาก แต่แต่ละการตัดสินใจช่วยหลีกเลี่ยงความประหลาดใจในภายหลัง
- พรอมต์ระบบ ใส่คำแนะนำของคุณเกี่ยวกับน้ำเสียง รูปแบบ และบทบาทในข้อความ
systemเก็บให้สั้นและเฉพาะเจาะจง เพราะทุกคำขอจะนำมันไปใช้ซ้ำเป็น input tokens - การจำกัดโทเคน
max_tokensเป็นตัวเลือก แต่การจำกัดจำนวนเป็นมาตรการป้องกันที่ประหยัด หากไม่มีข้อจำกัด คำตอบเดียวอาจใช้พื้นที่ที่เหลือของหน้าต่าง 100,000 tokens - สตรีมมิงสำหรับการใช้งานแบบโต้ตอบ ตั้งค่า
stream: trueหากมีผู้ใช้รอรับคำตอบ สำหรับการประมวลผลแบบแบตช์ การใช้คำขอธรรมดาจะง่ายกว่า - กฎการลองใหม่สำหรับ 429 ให้ถือว่า 429 เป็นสัญญาณให้รอ ไม่ใช่ความล้มเหลว เมื่อการตอบกลับมี
Retry-After: 5การพักตามเวลานั้นแล้วลองใหม่คือวิธีที่ถูกต้อง - ขนาดของคำขอ ขนาดสูงสุดของ body คือ 8 MB ซึ่งมากกว่าที่พรอมต์ปกติต้องการ แต่การวางล็อกหรือเอกสารอาจมีขนาดถึงขีดจำกัดนี้ได้
พรอมต์ไม่ถูกนำไปใช้ในการฝึกโมเดล ซึ่งสำคัญหากคุณวางแผนส่งเอกสารภายในหรือข้อความของผู้ใช้ คุณยังคงเป็นผู้รับผิดชอบสิ่งที่ส่งไป ดังนั้นควรหลีกเลี่ยงการใส่ข้อมูลลับที่โมเดลไม่จำเป็นต้องรู้ลงในพรอมต์
การเติมเงินหลังจากใช้เครดิตทดลอง
เครดิตทดลองใช้ใช้เพื่อตรวจสอบว่าทุกอย่างทำงานได้ เมื่อคุณพร้อมที่จะเริ่มพัฒนา ให้เติมเครดิตแบบเติมเงินล่วงหน้า ไม่มีระบบสมาชิก: คุณจ่ายตามจำนวนโทเคนที่ใช้ ในอัตรา $0.15 ต่อ 1M input tokens และ $0.50 ต่อ 1M output tokens และเครดิตไม่หมดอายุ ดังนั้นยอดคงเหลือที่ไม่ได้ใช้จะไม่หายไปเมื่อสิ้นเดือน
จำนวนเต็มใดๆ ตั้งแต่ $20 ถึง $500 สามารถเติมได้ การเติม $50 รับโบนัส 5% การเติม $100 รับโบนัส 10% และการเติม $200 รับโบนัส 15% ตัวอย่างเช่น การเติม $100 พร้อมโบนัส 10% จะได้เครดิต $110 จากพรอมต์ขนาด 1,000 โทเคนและคำตอบขนาด 500 โทเคนตามขั้นตอนที่สอง แต่ละคำขอมีค่าใช้จ่าย $0.0004 ดังนั้น $110 สามารถรองรับคำขอได้ 275,000 ครั้ง พรอมต์จริงมักจะมีขนาดยาวกว่านี้ ดังนั้นให้ปรับขนาดตัวเลขนี้ตามค่าเฉลี่ยของคุณ
การแก้ไขข้อผิดพลาดทั่วไปในการตั้งค่า
| อาการ | สาเหตุที่เป็นไปได้ | การแก้ไข |
|---|---|---|
| สถานะ 401 ทุกครั้งที่เรียกใช้ | คีย์หายไป พิมพ์ผิด หรือถูกเพิกถอน | ส่ง Authorization: Bearer <key> โดยไม่มีเครื่องหมายคำพูดเพิ่มเติม |
| สถานะ 404 หรือการตอบสนองเป็น HTML | เส้นทางผิด มักเกิดจากการขาด /v1 | ใช้ base URL เต็มที่ลงท้ายด้วย /v1 |
| ไม่พบโมเดล | ชื่อโมเดลที่คัดลอกมาจากผู้ให้บริการรายอื่น | ใช้ uncensored |
429 พร้อม rate_limited | เกินขีดจำกัดคำขอต่อนาที | ลดความเร็วลง หรือเติมเงินเพื่อเปลี่ยนจากขีดจำกัดแบบทดลองใช้เป็นขีดจำกัดเต็ม |
429 พร้อม concurrency | คำขอพร้อมกันมากเกินไป | จำกัดคำขอพร้อมกันไว้ที่ 8 (2 สำหรับคีย์แบบทดลองใช้) |
429 พร้อม Retry-After: 5 | โอเวอร์โหลดชั่วคราว | รอ 5 วินาทีแล้วลองใหม่ |
| สถานะ 413 หรือ body ถูกปฏิเสธ | คำขอเกิน 8 MB | ลดขนาดพรอมต์หรือแบ่งงาน |
เมื่อคุณพร้อมที่จะใช้งานมากกว่าขีดจำกัดแบบทดลองใช้ หน้ากำหนดราคา จะแสดงตัวเลือกการเติมเงิน: จำนวนเต็มใดๆ ตั้งแต่ $20 ถึง $500 ชำระด้วยคริปโต (USDT บน TRC20, USDC บน Base) พร้อมโบนัส 5% จาก $50, 10% จาก $100 และ 15% จาก $200 คำขอที่ล้มเหลวหรือถูกปฏิเสธจะไม่ถูกเรียกเก็บเงิน และพรอมต์ไม่ถูกนำไปใช้ในการฝึกโมเดล
คู่มือเพิ่มเติม
ถาม-ตอบ
นี่คือ API ทางการของ MiniMax ใช่หรือไม่?
ไม่ใช่ เป็น API ที่โฮสต์แยกต่างหากและเข้ากันได้กับ OpenAI ซึ่งให้บริการโมเดลแบบเปิดน้ำหนักเพียงตัวเดียว โดยปรับแต่งให้ตอบคำถามโดยไม่มีการปฏิเสธเนื้อหาสำหรับการใช้งานผู้ใหญ่ที่ถูกต้องตามกฎหมาย ไม่ใช่ API ทางการของผู้จัดจำหน่ายโมเดลรายใด และไม่ใช่ตัวเปลี่ยนเส้นทางข้ามผู้จัดจำหน่าย
ฉันต้องใช้บัตรเครดิตเพื่อทดลองใช้หรือไม่
ไม่ใช่ หลังจากสมัครสมาชิก คุณสามารถรับเครดิตทดลองใช้ฟรีมูลค่า $0.50 ได้เพียงคลิกเดียวที่หน้าคีย์ API เครดิตนี้ใช้งานได้ 7 วัน และจำกัดเพียงหนึ่งครั้งต่อบุคคล
ชื่อโมเดลที่ใช้ในคำขอคืออะไร
ใช้ uncensored บริการเปิดเผยโมเดล ID เดียวนี้ และ GET /v1/models จะแสดงโมเดลนี้
ฉันจะเติมเครดิตเพิ่มเติมในภายหลังได้อย่างไร
เติมเงินจำนวนเต็มใดก็ได้ตั้งแต่ $20 ถึง $500 รับโบนัสเมื่อเติม $50 (+5%), $100 (+10%) และ $200 (+15%) และเครดิตไม่หมดอายุ
ฉันสามารถใช้ SDK ของ OpenAI ได้หรือไม่
ใช่ ตั้งค่า base_url เป็น https://api.minimaxapikey.com/v1, ใช้คีย์ของคุณ และส่งโมเดล uncensored ส่วนอื่นในโค้ดของคุณไม่ต้องเปลี่ยนแปลง
คีย์ของคุณอยู่ห่างแค่แบบฟอร์มเดียว
สร้างบัญชี คัดลอกคีย์ และเปลี่ยน base URL นั่นคือการตั้งค่าทั้งหมด