API MiniMax: Yêu cầu đầu tiên trong năm phút

Cài đặt SDK OpenAI

Bắt đầu bằng cách cài đặt SDK OpenAI chính thức cho ngôn ngữ bạn chọn. Thư viện tự động xử lý định dạng yêu cầu và truyền phát. Đảm bảo bạn đã cài đặt Python 3.8+ hoặc Node.js 18+. Chạy pip install openai cho Python hoặc npm install openai cho Node. SDK giúp đơn giản hóa tương tác với endpoint /v1/chat/completions. Nó quản lý các tiêu đề, thử lại và phân tích SSE để bạn có thể tập trung vào prompt. Điều này hoạt động vì API của chúng tôi tuân theo tiêu chuẩn hoàn thành trò chuyện OpenAI. Bạn không cần thư viện khách hàng tùy chỉnh. Các phương thức SDK tiêu chuẩn ánh xạ trực tiếp đến các endpoint của chúng tôi. Điều này giảm thời gian tích hợp và tận dụng kiến thức hiện có của nhà phát triển.

Cấu hình URL cơ sở & Khóa của bạn

Đặt khóa API và URL cơ sở trong các biến môi trường của bạn. URL cơ sở của chúng tôi là https://api.minimaxapikey.com/v1. Điều này cho phép bạn sử dụng các khách hàng OpenAI tiêu chuẩn mà không cần sửa đổi. Tạo tài khoản để tạo khóa của bạn. Khóa được hiển thị ngay sau khi đăng ký. Không cần thẻ cho bản dùng thử. Lưu khóa một cách an toàn. Truyền nó dưới dạng tiêu đề hoặc biến môi trường. SDK sử dụng OPENAI_API_KEY theo mặc định. Bạn có thể ghi đè URL cơ sở để trỏ đến máy chủ của chúng tôi. Điều này đảm bảo tất cả các yêu cầu đều đi đến mô hình không kiểm duyệt. Xác minh khóa của bạn hoạt động bằng một lệnh ping đơn giản. Bước này ngăn các lỗi xác thực sau này.

Gửi yêu cầu hoàn thành trò chuyện cơ bản

Gửi yêu cầu đầu tiên để tạo văn bản. Sử dụng phương thức POST trên /v1/chat/completions. Chỉ định mô hình là uncensored. Truyền một mảng tin nhắn với prompt của người dùng. API trả về một token hoàn thành. Đây là tính năng tạo văn bản cốt lõi. Nó hỗ trợ cửa sổ ngữ cảnh 100k token. Bạn có thể gửi các prompt dài hoặc lịch sử hội thoại. Phản hồi bao gồm văn bản được tạo và mức sử dụng token. Điều này rất lý tưởng cho việc viết sáng tạo hoặc đối thoại không giới hạn. Đảm bảo nội dung là hợp pháp. Mô hình không từ chối các chủ đề người lớn. Nó chỉ chặn nội dung tình dục liên quan đến trẻ vị thành niên. Hãy bắt đầu đơn giản để xác minh kết nối.

Bật truyền phát (SSE)

Để có đầu ra theo thời gian thực, hãy bật truyền phát. Đặt tham số stream thành true. API trả về các Sự kiện do máy chủ gửi (SSE). Mỗi đoạn chứa một phần của phản hồi. Điều này giảm độ trễ cảm nhận. Người dùng thấy văn bản xuất hiện khi nó được tạo. SDK tự động xử lý phân tích các đoạn. Bạn có thể hiển thị văn bản từng phần trong giao diện người dùng. Điều này rất quan trọng cho các giao diện trò chuyện. Truyền phát hoạt động với tất cả các phản hồi của mô hình. Nó không ảnh hưởng đến việc đếm token. Mỗi đoạn bao gồm dữ liệu sử dụng ở cuối. Sử dụng điều này để cải thiện trải nghiệm người dùng. Nó cảm thấy phản hồi nhanh hơn so với việc chờ đợi phản hồi đầy đủ. Cấu hình khách hàng của bạn để đệm các đoạn chính xác.

Sử dụng gọi công cụ/hàm

Hỗ trợ đầu ra có cấu trúc với gọi hàm. Xác định các công cụ trong thân yêu cầu. Mô hình có thể gọi các hàm dựa trên prompt. Điều này cho phép tích hợp với các hệ thống bên ngoài. Truyền các định nghĩa công cụ và tin nhắn của người dùng. Phản hồi bao gồm một đối tượng gọi công cụ. Thực thi hàm và đưa kết quả trở lại. Điều này hoạt động với các SDK OpenAI tiêu chuẩn. Nó cho phép các quy trình làm việc phức tạp. Bạn có thể xây dựng các đại lý hoặc trợ lý. Mô hình duy trì ngữ cảnh qua các lần gọi. Điều này rất mạnh mẽ cho tự động hóa. Đảm bảo các định nghĩa công cụ của bạn chính xác. API xử lý việc định tuyến các đầu ra công cụ. Nó giữ cho cuộc trò chuyện mạch lạc. Sử dụng điều này cho việc tạo nội dung động.

Kiểm tra các mô hình khả dụng

Xác minh danh sách mô hình qua GET /v1/models. Endpoint này trả về các mô hình khả dụng. API của chúng tôi phục vụ một mô hình: uncensored. Đây là một mô hình trọng số mở. Nó không phải là GPT, Claude hoặc Gemini. Phản hồi xác nhận ID mô hình. Sử dụng điều này để gỡ lỗi cấu hình khách hàng. Đảm bảo mã của bạn nhắm mục tiêu vào mô hình chính xác. Endpoint này nhanh và đáng tin cậy. Nó trả về dữ liệu JSON. Bạn có thể phân tích cú pháp điều này để hiển thị giao diện người dùng. Nó xác minh khóa API của bạn là hợp lệ. Sử dụng điều này cho các kiểm tra sức khỏe tự động. Nó là một phần của thông số kỹ thuật OpenAI tiêu chuẩn. Không cần cấu hình bổ sung. Điều này đảm bảo tương thích với các công cụ hiện có.

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

Truyền phát

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)