MiniMax M3.1 Flash

Dùng chính xác ID mô hình MiniMax-M3.1-Flash. Trang mô hình có Playground và giá theo thời gian thực. Đặc tả OpenAPI định nghĩa các trường lồng nhau trong yêu cầu và phản hồi.

Bắt đầu nhanh

curl https://api.seedrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"MiniMax-M3.1-Flash",
    "messages":[{"role":"user","content":"What is 17 multiplied by 23?"}],
    "max_completion_tokens":2048,
    "reasoning_effort":"low"
  }'

Ví dụ này đặt một giới hạn đầu ra; đây không phải giá trị mặc định của mô hình. Hãy giữ khóa trên máy chủ của bạn. Playground dùng tài khoản bạn đang đăng nhập và không yêu cầu dán khóa API.

Định dạng và xác thực

Gửi Content-Type: application/json và Authorization: Bearer $SEEDROUTER_API_KEY. Messages cũng chấp nhận x-api-key; ứng dụng khách SDK có thể thêm anthropic-version: 2023-06-01. Các định dạng này giữ nguyên phần thân yêu cầu và cấu trúc phản hồi gốc.

Tham số

Tất cả các trường đều không bắt buộc, ngoại trừ các trường bắt buộc nêu trên. Bỏ qua trường khác với việc truyền rõ null: trường chỉ chấp nhận null khi OpenAPI khai báo cho phép. Các trường cấp cao nhất không được hỗ trợ sẽ bị loại bỏ; giá trị không hợp lệ trong trường được hỗ trợ sẽ trả về lỗi.

Chat Completions

Messages

Responses

Playground cố định model và cung cấp mọi trường còn lại: 12 mục điều khiển cho Chat, 11 cho Messages và 12 cho Responses. Đối tượng lồng nhau và toàn bộ lịch sử hội thoại được nhập qua các trường JSON. Giá trị không hợp lệ trong trường được hỗ trợ sẽ chặn việc gửi trên trình duyệt.

Suy luận và giới hạn

Cửa sổ ngữ cảnh được tài liệu công bố là 1.000.000 token. Giới hạn đầu ra là 524.288 token, bao gồm suy luận. MiniMax khuyến nghị 131.072 token đầu ra cho các tác vụ phức tạp, nhưng không đặt giá trị này làm mặc định.

Chế độ suy nghĩ luôn bật. Mô hình này không hỗ trợ các thiết lập suy nghĩ disabled, none và minimal. Ngân sách đầu ra nhỏ có thể cạn trước khi xuất hiện văn bản trả lời. Đặc tả API này không hỗ trợ service_tier, đầu vào âm thanh và đầu ra JSON có cấu trúc.

Tổng phần thân yêu cầu không được vượt quá 64 MB. Dịch vụ mô hình xác thực mức sử dụng ngữ cảnh chính xác và nội dung phương tiện từ xa.

Hình ảnh và video

Chat dùng các khối nội dung image_url: {"url":"..."} và video_url: {"url":"..."}. Messages dùng khối hình ảnh/video với đối tượng source: {"type":"url","url":"..."} hoặc {"type":"base64","media_type":"...","data":"..."}. Responses dùng input_image hoặc input_video, trong đó giá trị URL có thể là chuỗi hoặc đối tượng tùy chọn được hỗ trợ.

detail chấp nhận low, default, high, với mặc định là default. fps của video nằm trong khoảng 0.2 đến 5, mặc định là 1. Trường không bắt buộc max_long_side_pixel phải là số nguyên dương khi được cung cấp trong lược đồ lồng nhau.

{
  "model": "MiniMax-M3.1-Flash",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "text", "text": "Describe the main change in this clip."},
      {"type": "video_url", "video_url": {
        "url": "https://example.com/clip.mp4",
        "fps": 1,
        "detail": "default"
      }}
    ]
  }],
  "max_completion_tokens": 2048
}

Thay URL ví dụ bằng URL tệp của bạn có thể truy cập được. Đầu vào nhúng dùng loại MIME base64 phù hợp; MOV dùng video/mov. Các tham chiếu video mm_file:// hiện có được truyền nguyên trạng, nhưng dịch vụ này không cung cấp API tải tệp lên Files. Tài khoản xử lý yêu cầu vẫn phải truy cập được tham chiếu đó.

Công cụ và lịch sử hội thoại

Công cụ hàm mô tả các hành động mà ứng dụng của bạn có thể thực hiện. Lệnh gọi công cụ không chứng minh rằng hành động bên ngoài đã chạy: hãy kiểm tra tên và đối số, thực hiện hành động trong ứng dụng, rồi trả kết quả kèm ID lệnh gọi tương ứng.

Khi tiếp tục hội thoại Chat, giữ toàn bộ tin nhắn assistant, bao gồm reasoning_content và tool_calls; tin nhắn công cụ bắt buộc có tool_call_id. Với Messages, giữ các khối suy nghĩ, chữ ký và các khối tool_use, tool_result. Với Responses, thêm tất cả các mục đầu ra được trả về trước đầu vào tiếp theo của người dùng.

Đừng gộp các lịch sử này thành văn bản trả lời thuần túy. Các lược đồ tham số hàm tùy ý và các trường suy luận được gửi lại đều được giữ nguyên. Tài liệu tham chiếu chính thức của Chat không định nghĩa tham số tool_choice cho mô hình này.

Truyền trực tiếp và các trường phản hồi

Đặt stream: true để nhận sự kiện do máy chủ gửi. Chat phát choices[].delta và kết thúc bằng [DONE]; yêu cầu stream_options: {"include_usage":true} để nhận dữ liệu sử dụng. Messages phát các sự kiện có tên như message_start, cập nhật khối nội dung và message_stop. Responses phát các sự kiện như response.output_text.delta và response.completed.

Khi không truyền trực tiếp, Chat trả về choices[].message, finish_reason và usage. Messages trả về các khối nội dung, stop_reason và dữ liệu sử dụng. Responses trả về các mục output, trạng thái và dữ liệu sử dụng. Hãy giữ toàn bộ phản hồi nếu ứng dụng của bạn cần nhiều thông tin hơn phần trả lời được hiển thị.

Mức sử dụng và giá hiện tại

Bảng giá theo thời gian thực hiển thị cả hai bậc đầu vào. Tổng đầu vào không quá 512.000 token áp dụng bậc đầu tiên; trên 512.000 áp dụng bậc thứ hai. Bậc được chọn quyết định giá của toàn bộ yêu cầu, bao gồm đầu ra và bộ nhớ đệm.

Token đọc và ghi bộ nhớ đệm không bị tính phí lần nữa như đầu vào thông thường. Bộ nhớ đệm tự động kiểm tra các tiền tố lặp lại đủ điều kiện có ít nhất 512 token; không bảo đảm truy xuất trúng bộ nhớ đệm. Không cần dấu đánh dấu bộ nhớ đệm rõ ràng.

Phản hồi cung cấp số lượng token, không cung cấp chi phí bằng tiền. Lịch sử sử dụng tài khoản hiển thị khoản phí cuối cùng. Yêu cầu thất bại không bị tính phí.

Lỗi

Khi xảy ra lỗi, hãy kiểm tra trường không hợp lệ và tài liệu tham chiếu lỗi công khai. Cùng một ID mô hình hỗ trợ ba endpoint văn bản ở trên; không dùng ID này với endpoint embeddings hoặc Gemini.

Tài liệu tham chiếu chính thức

• Gọi mô hình MiniMax
• Tham chiếu Chat Completions
• Tham chiếu Messages
• Tham chiếu Responses
• Tiếp tục sau khi gọi hàm
• Bộ nhớ đệm prompt tự động