VI ▾

Cài đặt API MiniMax: Khóa, Base URL và Yêu cầu đầu tiên

Hướng dẫn từng bước để thiết lập API tương thích OpenAI trên minimaxapikey.com: tài khoản, khóa, base URL, yêu cầu đầu tiên. Đây là dịch vụ độc lập, không phải API chính thức của nhà cung cấp mô hình nào.

Cập nhật

Sáu bước ấn tượng dẫn từ một khóa đến một ngăn máy chủ, đại diện cho đường dẫn thiết lập API

Điểm chính

  • Đăng ký bằng Google hoặc email, sau đó nhận $0.50 tín dụng dùng thử trên trang khóa. Không cần thẻ.
  • Base URL là https://api.minimaxapikey.com/v1, model ID là uncensored, xác thực là khóa Bearer.
  • Có hai phương thức: POST /v1/chat/completions và GET /v1/models.
  • 401 nghĩa là khóa sai, và 429 nghĩa là đã đạt giới hạn, vì vậy hãy kiểm tra mã lỗi trong thân phản hồi.

Những gì bạn đang thiết lập

Mọi người tìm kiếm cài đặt API minimax với kỳ vọng về một trong hai điều: nền tảng nhà phát triển MiniMax chính thức, hoặc một endpoint kiểu OpenAI. Trang này đề cập đến cái thứ hai. Dịch vụ đằng sau minimaxapikey.com là một API văn bản tương thích OpenAI chạy một mô hình trọng số mở duy nhất, do một nhà cung cấp độc lập vận hành. Nó không phải API chính thức của MiniMax hay bất kỳ nhà cung cấp mô hình nào khác, và nó không định tuyến yêu cầu giữa các nhà cung cấp. Nếu bạn cần nền tảng của nhà cung cấp, hãy sử dụng trang web của họ.

Những gì bạn nhận được rất đơn giản. Bất kỳ SDK hoặc trình khách OpenAI nào cũng hoạt động sau khi bạn thay đổi base URL và khóa. Có hai phương thức, POST /v1/chat/completions và GET /v1/models, một model ID, uncensored, và cửa sổ ngữ cảnh 100.000 token dùng chung cho prompt và completion. Nó chỉ xử lý văn bản, vì vậy không có tạo hình ảnh, âm thanh hoặc video, không có embeddings và không có fine-tuning. Truyền phát (streaming), gọi hàm và chế độ JSON được hỗ trợ.

Toàn bộ quá trình thiết lập chỉ mất vài phút. Các bước dưới đây được sắp xếp theo thứ tự, và mỗi bước đều có phần kiểm tra để bạn biết nó đã hoạt động trước khi chuyển sang bước tiếp theo.

Bước 1 và 2: tạo tài khoản và nhận dùng thử

  1. Mở trang khóa. Truy cập trang khóa API và đăng ký. Bạn có thể sử dụng Google, hoặc địa chỉ email và mật khẩu.
  2. Nhận tín dụng dùng thử. Sau khi đăng ký, trang khóa có một nút để nhận $0.50 tín dụng dùng thử. Chỉ cần một cú nhấp chuột, không cần thẻ, có hiệu lực trong 7 ngày và giới hạn một lần cho mỗi người.

Dùng thử nhỏ là có chủ đích. Với giá $0.15 cho mỗi 1M input token và $0.50 cho mỗi 1M output token, $0.50 bao gồm một số lượng lớn yêu cầu kiểm tra. Một prompt 1.000 token với câu trả lời 500 token tốn $0.00015 cho input cộng $0.00025 cho output, tức là $0.0004. Chia $0.50 cho số đó cho ra 1.250 yêu cầu như vậy, vì vậy bạn có đủ không gian để thử nghiệm.

Lưu ý các giới hạn của khóa dùng thử: 2 yêu cầu đồng thời và 60 yêu cầu mỗi phút. Khóa đầy đủ, mà bạn nhận được sau khi đã nạp tiền, cho phép 8 yêu cầu đồng thời và 300 mỗi phút. Nếu vòng lặp kiểm tra của bạn chạy song song và bạn thấy lỗi 429, đây là điều đầu tiên cần kiểm tra.

Bước 3: tạo khóa và lưu trữ an toàn

Trên cùng trang đó, tạo khóa API và sao chép nó. Coi nó như mật khẩu. Đặt nó vào biến môi trường hoặc bộ quản lý bí mật, không bao giờ để trong kho lưu trữ, gói front-end hoặc ảnh chụp màn hình. Nếu khóa bị rò rỉ, hãy xóa nó và tạo khóa mới.

# macOS / Linux
export UNCENSORED_KEY="paste-your-key-here"

# Windows PowerShell
$env:UNCENSORED_KEY = "paste-your-key-here"

Mã phía máy chủ nên đọc biến tại thời gian chạy. Mã trình duyệt không bao giờ nên giữ khóa: hãy gửi yêu cầu từ backend của bạn, vì bất cứ thứ gì được gửi đến trình duyệt đều hiển thị với mọi khách truy cập.

Bước 4: liệt kê mô hình để xác nhận khóa

Bài kiểm tra rẻ nhất có thể là endpoint mô hình. Nó không tạo văn bản, vì vậy đây là bài kiểm tra sạch cho khóa, URL và mạng của bạn.

curl -s https://api.minimaxapikey.com/v1/models \
  -H "Authorization: Bearer $UNCENSORED_KEY"

Bạn sẽ nhận được danh sách JSON bao gồm uncensored. Nếu bạn nhận được 401, khóa sai hoặc có khoảng trắng hoặc dấu ngoặc kép thừa xung quanh nó. Nếu kết nối thất bại, hãy kiểm tra xem URL có kết thúc bằng /v1 và bạn đã sử dụng https hay chưa.

Bước 5: gửi yêu cầu chat đầu tiên

Bây giờ là một completion thực sự. Phần body có định dạng chat completions tiêu chuẩn.

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
  }'

Phản hồi chứa choices[0].message.content và khối usage với số lượng token prompt và completion. Hãy xem các tiêu đề phản hồi bằng curl -i. Bạn sẽ thấy X-Request-Id, mà bộ phận hỗ trợ có thể dùng để tìm yêu cầu của bạn, X-Balance-USD, tín dụng còn lại của bạn, và các tiêu đề giới hạn tốc độ X-RateLimit-Limit-Requests và X-RateLimit-Limit-Concurrency.

Các tham số như temperature, top_p, stop, seed và các tham số penalty được chuyển tiếp. max_tokens là tùy chọn. Nếu bạn bỏ qua nó, completion có thể sử dụng phần còn lại của cửa sổ.

Bước 6: cùng một lệnh gọi từ SDK

Khi curl hoạt động, hãy chuyển sang ngôn ngữ bạn thực sự sẽ sử dụng. Chỉ có hai đối số thay đổi từ thiết lập OpenAI tiêu chuẩn.

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);

Để truyền phát, thêm stream: true và đọc các sự kiện gửi từ máy chủ. Số liệu sử dụng sẽ xuất hiện ở cuối luồng. Trang tài liệu bao gồm truyền phát, gọi hàm và chế độ JSON với response_format: {"type":"json_object"}.

Di chuyển dự án OpenAI hiện có

Hầu hết thời gian, dự án bạn muốn kết nối đã hoạt động với thư viện client OpenAI. Trong trường hợp đó, bạn hiếm khi chỉnh sửa mã. Các SDK chính thức đọc các biến môi trường OPENAI_API_KEY và OPENAI_BASE_URL khi bạn không truyền đối số, vì vậy thay đổi triển khai có thể là đủ.

export OPENAI_BASE_URL="https://api.minimaxapikey.com/v1"
export OPENAI_API_KEY="paste-your-key-here"
# then in your code, request model "uncensored"

Sửa đổi còn lại là tên mô hình. Một chuỗi như một model ID của OpenAI sẽ không tồn tại ở đây, vì vậy hãy thay thế nó bằng uncensored, tốt nhất là thông qua một giá trị cấu hình để bạn có thể quay lại. Sau đó đọc qua mã cho các tính năng mà dịch vụ không cung cấp. Tạo hình ảnh, âm thanh, embeddings và fine-tuning không khả dụng, vì đây là API trò chuyện chỉ văn bản. Nếu ứng dụng của bạn gọi embeddings để tìm kiếm, bạn sẽ cần một nhà cung cấp khác cho phần đó và có thể giữ phần trò chuyện trên dịch vụ này.

Nó cũng giúp biết mô hình là gì. Đó là một mô hình trọng số mở duy nhất, được tinh chỉnh để trả lời mà không từ chối nội dung cho mục đích sử dụng hợp pháp của người lớn, và một giới hạn cứng duy nhất áp dụng bất kể cài đặt: không có nội dung tình dục liên quan đến người chưa thành niên. Các prompt được viết cho mô hình khác có thể cần điều chỉnh nhỏ, vì mỗi mô hình phản ứng khác nhau với cùng một prompt hệ thống. Hãy chạy các prompt kiểm tra của riêng bạn song song trước khi chuyển lưu lượng thực.

Các cài đặt đáng chọn ngay từ ngày đầu tiên

Một vài quyết định dễ đưa ra khi thiết lập hơn là sau khi ra mắt. Không cái nào trong số chúng khó, nhưng mỗi cái tránh được bất ngờ sau này.

  • Một prompt hệ thống. Đặt hướng dẫn của bạn về giọng điệu, định dạng và vai trò trong một tin nhắn system. Giữ nó ngắn và cụ thể, vì mọi yêu cầu đều lặp lại nó dưới dạng input token.
  • Giới hạn token. max_tokens là tùy chọn, nhưng việc đặt giới hạn là một biện pháp bảo vệ rẻ tiền. Không có nó, một câu trả lời đơn lẻ có thể sử dụng phần còn lại của cửa sổ ngữ cảnh 100.000 token.
  • Truyền phát cho tương tác. Đặt stream: true nếu một người đang chờ phản hồi. Đối với các tác vụ hàng loạt, các yêu cầu thông thường sẽ đơn giản hơn.
  • Quy tắc thử lại cho 429. Coi 429 là tín hiệu để chờ đợi, không phải là thất bại. Khi phản hồi bao gồm Retry-After: 5, chờ trong khoảng thời gian đó và thử lại là bước đi đúng.
  • Kích thước yêu cầu. Giới hạn body là 8 MB. Điều đó nhiều hơn nhiều so với một prompt bình thường cần, nhưng nhật ký hoặc tài liệu dán vào có thể đạt đến đó.

Các prompt không được sử dụng để huấn luyện, điều này quan trọng nếu bạn dự định gửi tài liệu nội bộ hoặc tin nhắn của người dùng. Bạn vẫn là người chịu trách nhiệm về những gì bạn gửi, vì vậy hãy tránh đặt các bí mật mà mô hình không cần vào một prompt.

Nạp tiền sau khi dùng thử

Dùng thử là để kiểm tra xem mọi thứ có hoạt động không. Khi bạn sẵn sàng xây dựng, hãy thêm tín dụng trả trước. Không có đăng ký: bạn trả tiền cho token đã sử dụng, với giá $0.15 cho mỗi 1M input token và $0.50 cho mỗi 1M output token, và tín dụng không bao giờ hết hạn, vì vậy số dư chưa sử dụng không biến mất vào cuối tháng.

Bất kỳ số nguyên nào từ $20 đến $500 đều hoạt động. Nạp tiền $50 thêm 5% bonus, $100 thêm 10%, và $200 thêm 15%. Ví dụ nhanh, nạp tiền $100 với bonus 10% cho $110 tín dụng. Với prompt 1.000 token và câu trả lời 500 token từ bước hai, mỗi yêu cầu tốn $0.0004, vì vậy $110 bao gồm 275.000 yêu cầu. Các prompt thực tế thường dài hơn, vì vậy hãy điều chỉnh con số đó theo trung bình của riêng bạn.

Khắc phục các lỗi thiết lập thường gặp

Triệu chứngNguyên nhân có thểCách khắc phục
401 trên mọi lệnh gọiThiếu, sai chính tả hoặc khóa đã thu hồiGửi Authorization: Bearer <key>, không có dấu ngoặc kép thừa
404 hoặc phản hồi HTMLĐường dẫn sai, thường là thiếu /v1Sử dụng base URL đầy đủ kết thúc bằng /v1
Không tìm thấy mô hìnhTên mô hình sao chép từ nhà cung cấp khácSử dụng uncensored
429 với rate_limitedVượt quá giới hạn yêu cầu mỗi phútLàm chậm lại, hoặc nạp tiền để chuyển từ giới hạn dùng thử sang giới hạn đầy đủ
429 với concurrencyQuá nhiều yêu cầu cùng một lúcGiới hạn các lệnh gọi song song ở mức 8 (2 trên khóa dùng thử)
429 với Retry-After: 5Quá tải tạm thờiChờ 5 giây và thử lại
413 hoặc body bị từ chốiYêu cầu vượt quá 8 MBCắt ngắn prompt hoặc chia nhỏ công việc

Khi bạn sẵn sàng cho nhiều hơn mức dùng thử, trang giá cả liệt kê các tùy chọn nạp tiền: bất kỳ số nguyên nào từ $20 đến $500, thanh toán bằng tiền mã hóa (USDT trên TRC20, USDC trên Base), với bonus 5% từ $50, 10% từ $100 và 15% từ $200. Các yêu cầu thất bại hoặc bị từ chối sẽ không bị tính phí, và các prompt không được sử dụng để huấn luyện.

Hỏi đáp

Đây có phải là API MiniMax chính thức không?

Không. Đây là một API độc lập, được lưu trữ, tương thích với OpenAI, phục vụ một mô hình trọng số mở, được tinh chỉnh để trả lời mà không từ chối nội dung cho mục đích sử dụng hợp pháp của người lớn. Nó không phải là API chính thức của bất kỳ nhà cung cấp mô hình nào và không phải là bộ định tuyến giữa các nhà cung cấp.

Tôi có cần thẻ tín dụng để dùng thử không?

Không. Sau khi đăng ký, bạn có thể nhận $0.50 tín dụng dùng thử chỉ với một cú nhấp chuột trên trang khóa API. Tín dụng này có hiệu lực trong 7 ngày và giới hạn một lần cho mỗi người.

Tên mô hình để sử dụng trong yêu cầu là gì?

Sử dụng uncensored. Dịch vụ này cung cấp duy nhất ID mô hình này, và lệnh GET /v1/models sẽ hiển thị nó.

Làm thế nào để thêm nhiều tín dụng hơn sau này?

Nạp tiền với số nguyên bất kỳ từ $20 đến $500. Bonus áp dụng từ $50 (+5%), $100 (+10%) và $200 (+15%), và tín dụng không bao giờ hết hạn.

Tôi có thể sử dụng SDK OpenAI không?

Có. Đặt base_url thành https://api.minimaxapikey.com/v1, dùng khóa của bạn, và truyền tham số mô hình uncensored. Không có gì khác trong mã của bạn cần thay đổi.

Khóa của bạn chỉ cách một biểu mẫu

Tạo tài khoản, sao chép khóa, thay đổi URL cơ sở. Đó là toàn bộ thiết lập.

Lấy khóa API