MiniMax api: Hướng dẫn bắt đầu nhanh và SDK

Xác thực và Base URL

Sử dụng khóa API được cung cấp và trỏ client của bạn vào URL cơ sở dành riêng. Điểm cuối để tạo phản hồi là https://api.minimaxaiapi.com/v1/chat/completions. Bạn truyền khóa trong Authorization header dưới dạng bearer token. Điều này hoạt động với bất kỳ SDK OpenAI tiêu chuẩn nào vì chúng tôi tuân theo cùng một giao thức.

• Tên tiêu đề: Authorization
• Giá trị tiêu đề: Bearer YOUR_API_KEY
• Base URL: https://api.minimaxaiapi.com/v1

Không cần thiết lập phức tạp. Chỉ cần cập nhật cấu hình trong dự án hiện tại của bạn.

Copycurl https://api.minimaxaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with keys name and age"}]
  }'

Endpoint Hoàn thành Trò chuyện

Gửi yêu cầu POST đến điểm cuối chat completions để nhận phản hồi văn bản. Mã định danh mô hình là uncensored. Bạn phải bao gồm một mảng messages với lịch sử hội thoại của bạn. Hệ thống xử lý đầu vào và trả về văn bản đã tạo dựa trên prompt của bạn.

Điểm cuối này xử lý tất cả việc tạo văn bản. Nó không hỗ trợ embedding, âm thanh hoặc video. Bạn có thể phát trực tiếp phản hồi hoặc đợi toàn bộ khối. Mô hình xử lý ngữ cảnh lên đến tổng cộng 100,000 token.

Copyfrom openai import OpenAI

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

Streaming và Việc Sử Dụng Token

Bật phát trực tiếp bằng cách đặt stream: true trong yêu cầu của bạn. API trả về các Sự kiện gửi từ máy chủ (SSE) cho mỗi token được tạo. Điều này cho phép hiển thị đầu ra theo thời gian thực. Thống kê sử dụng token được bao gồm trong chunk cuối cùng của luồng. Điều này giúp bạn theo dõi chi phí chính xác mà không cần phân tích từng token riêng lẻ.

Streaming làm giảm độ trễ cảm nhận cho các phản hồi dài. Nó lý tưởng cho các giao diện chat và tạo nội dung động. Bạn có thể dừng luồng sớm nếu người dùng ngắt quá trình tạo.

Copyimport OpenAI from "openai";

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

Function Calling và chế độ JSON

Sử dụng tools tham số để kích hoạt gọi hàm. Xác định các hàm của bạn trong thân yêu cầu và để mô hình chọn hàm nào sẽ gọi. Máy tool_choice tham số cho phép bạn buộc một hàm cụ thể hoặc tự chọn. Để xuất JSON nghiêm ngặt, đặt response_format để {"type": "json_object"}. Điều này đảm bảo phản hồi là JSON hợp lệ.

Gọi hàm hữu ích để trích xuất dữ liệu có cấu trúc hoặc kích hoạt các hành động. Chế độ JSON hoàn hảo cho các tích hợp API yêu cầu định dạng dự đoán được. Kết hợp cả hai để có logic ứng dụng mạnh mẽ.

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)

Tham số và Ràng buộc Mô hình

Điều chỉnh hành vi tạo bằng các tham số tiêu chuẩn như temperature, top_p, và stop. Cửa sổ ngữ cảnh tối đa là 100.000 token, bao gồm cả prompt và kết quả. Lượng kết quả tối đa cho mỗi yêu cầu là 16.000 token. Nếu bạn không đặt max_tokens, giới hạn mặc định là 2.048 token.

Sử dụng seed để có kết quả có thể tái lập. Đặt presence_penalty và frequency_penalty để kiểm soát sự lặp lại. Các tham số này cho phép bạn kiểm soát chi tiết sự sáng tạo và tính nhất quán của mô hình. Luôn kiểm tra với trường hợp sử dụng cụ thể của bạn để tìm sự cân bằng phù hợp.

Giới hạn tốc độ và Lỗi

API giới hạn 300 yêu cầu mỗi phút và 8 yêu cầu đồng thời trên mỗi khóa. Nếu bạn vượt quá các giới hạn này, bạn sẽ nhận được lỗi 429. Lỗi 401 cho biết khóa API không hợp lệ hoặc bị thiếu. Lỗi 402 có nghĩa là số dư trả trước của bạn đã hết.

Lỗi không tiêu tốn tín dụng của bạn. Bạn có thể thử lại các yêu cầu thất bại mà không bị phạt. Kích thước thân yêu cầu được giới hạn ở 8 MB. Hãy quản lý độ đồng thời cẩn thận để tránh bị giới hạn tốc độ. Theo dõi mức sử dụng thông qua chunk cuối cùng của các phản hồi luồng.