TH ▾

การตั้งค่า API MiniMax: คีย์, Base URL และการส่งคำขอครั้งแรก

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

อัปเดต

ขั้นตอนที่โดดเด่นหกขั้นตอนนำจากคีย์ไปยังชั้นวางเซิร์ฟเวอร์ แสดงถึงเส้นทางการตั้งค่า 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: สร้างบัญชีและรับเครดิตทดลอง

  1. เปิดหน้าคีย์ ไปที่ หน้า API key แล้วเข้าสู่ระบบ คุณสามารถใช้ Google หรือที่อยู่อีเมลพร้อมรหัสผ่าน
  2. รับเครดิตทดลองใช้ หลังจากสมัครสมาชิก หน้าคีย์จะมีปุ่มสำหรับรับเครดิตทดลองใช้มูลค่า $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 นั่นคือการตั้งค่าทั้งหมด

รับคีย์ API