Truy cập MiniMax API với một router tương thích OpenAI

Truy cập MiniMax API với một router tương thích OpenAI hữu ích khi nhóm của bạn muốn MiniMax nằm trong cùng quy trình sản xuất với phần còn lại của ngăn xếp AI. Đường đi trực tiếp của MiniMax đã tương thích với OpenAI SDK cho các mô hình ngôn ngữ được hỗ trợ. Một đường đi qua router bổ sung một base URL dùng chung, một lớp khóa, một bước kiểm tra danh mục, một nhật ký sử dụng và một nơi để quyết định những khối lượng công việc MiniMax nào nên đứng cạnh các tuyến mô hình GPT, Claude, Gemini, DeepSeek, Qwen, Seedance, Veo và các tuyến mô hình khác.

Bản cập nhật này được kiểm tra vào ngày 16 tháng 9 năm 2026 dựa trên tài liệu API chính thức của MiniMax, bảng giá pay-as-you-go của MiniMax, tài liệu công khai của Flatkey, danh mục mô hình của Flatkey và các trang mô hình MiniMax của Flatkey. Hãy xem mọi mô hình, giá và trạng thái tuyến như một ảnh chụp công khai có ghi ngày tháng. Kiểm tra lại tài khoản, danh mục và điều khoản của bạn trước khi gửi lưu lượng sản xuất.

Tóm tắt ngắn gọn: dùng MiniMax trực tiếp khi bạn chỉ cần quyền truy cập tài khoản MiniMax. Dùng Flatkey khi MiniMax cần được đánh giá, lập ngân sách, ghi nhật ký và hoàn nguyên trong một quy trình làm việc router đa nhà cung cấp.

Câu trả lời nhanh: Truy cập MiniMax API với một router tương thích OpenAI

Nếu ứng dụng của bạn đã dùng OpenAI Python hoặc JavaScript SDK, MiniMax có hai đường truy cập thực tế:

Hãy dùng hướng dẫn Truy cập MiniMax API với một router tương thích OpenAI này như danh sách kiểm tra khởi chạy. Đừng phê duyệt việc di chuyển chỉ vì một phản hồi mẫu hoạt động. Hãy phê duyệt khi ID mô hình chính xác, endpoint, cấu trúc yêu cầu, đơn vị giá, nhật ký sử dụng, quy tắc dự phòng và đường hoàn nguyên đều hiển thị rõ.

Những gì đã thay đổi kể từ bài viết MiniMax cũ hơn

Bài viết công khai trước đó được ghi ngày 16 tháng 6 năm 2026. Bản cập nhật an toàn không phải là một bản viết lại mang tính hình thức. Cả MiniMax và Flatkey đều đã thay đổi đủ để bài viết cần ngôn ngữ tuyến hiện tại.

Các cập nhật chính là:

• MiniMax hiện ghi tài liệu MiniMax-M3 là mô hình ngôn ngữ mới nhất thuộc dòng M, được hỗ trợ bởi OpenAI SDK, với cửa sổ ngữ cảnh 1.000.000 token và hỗ trợ đầu vào hình ảnh/video thông qua các phần nội dung thông điệp tương thích OpenAI.
• MiniMax video generation V2 hiện ghi tài liệu MiniMax-H3 và MiniMax-H3-Max thông qua luồng POST /v2/video_generation bất đồng bộ.
• Giá pay-as-you-go của MiniMax hiện tách riêng giá văn bản M3 theo ngưỡng ngữ cảnh và hạng dịch vụ, giá video H3 theo mô hình/độ phân giải/số giây, giá hình ảnh theo mỗi ảnh được tạo, giá giọng nói theo giờ hoặc ký tự, và giá MCP/công cụ theo mỗi yêu cầu.
• Tài liệu công khai của Flatkey hiển thị MiniMax-H3 thông qua quy trình tạo video bất đồng bộ dùng chung POST /v1/videos.
• Các trang mô hình công khai của Flatkey được kiểm tra trong lần làm mới này trả về 200 cho https://flatkey.ai/models/minimax-h3 và https://flatkey.ai/models/minimax-m2.7; https://flatkey.ai/models/minimax-m3 trả về 404. Điều đó có nghĩa là bài viết này không khẳng định một tuyến Flatkey M3 đã được xác minh.

Điểm cuối cùng đó rất quan trọng. Một bài viết về router nên giúp các nhóm tránh những giả định lỗi thời về tên mô hình. Nếu bạn muốn dùng M3 qua Flatkey, hãy kiểm tra thư mục mô hình trực tiếp, /v1/models, hoặc bảng điều khiển của bạn trước khi cấu hình lưu lượng sản xuất.

Các факт nguồn cần chốt trước khi bạn định tuyến MiniMax

Hãy dùng bảng nguồn này trước khi thay đổi mã:

Đây là thói quen sản xuất chính đằng sau MiniMax API Access With One OpenAI-Compatible Router: lưu ngày nguồn, lưu ID mô hình, và lưu đường dẫn bằng chứng. Danh mục mô hình thay đổi quá thường xuyên để các đoạn mã sao chép trở thành thẩm quyền cuối cùng.

Thiết lập Direct MiniMax OpenAI SDK

Thiết lập Direct MiniMax là bài kiểm tra đầu tiên sạch nhất khi bạn cần hiểu hành vi gốc của nhà cung cấp.

export OPENAI_BASE_URL="https://api.minimax.io/v1"
export OPENAI_API_KEY="your-minimax-api-key"
export MINIMAX_MODEL="MiniMax-M3"

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["OPENAI_API_KEY"],
    base_url=os.environ["OPENAI_BASE_URL"],
)

response = client.chat.completions.create(
    model=os.environ.get("MINIMAX_MODEL", "MiniMax-M3"),
    messages=[
        {"role": "user", "content": "Trả về một câu xác nhận rằng tuyến MiniMax hoạt động."}
    ],
    max_completion_tokens=120,
    extra_body={
        "thinking": {"type": "disabled"}
    },
)

print(response.choices[0].message.content)
print(response.usage)

Hãy dùng MiniMax trực tiếp để tìm hiểu hành vi của nhà cung cấp trước:

• Ứng dụng của bạn cần đầu ra suy luận MiniMax hay câu trả lời trực tiếp?
• Trình xử lý luồng của bạn có chấp nhận các trường phản hồi của MiniMax không?
• Vòng lặp gọi công cụ của bạn có nối thêm toàn bộ thông điệp của assistant khi cần không?
• Bộ phân tích của bạn có phụ thuộc vào các tham số mà MiniMax bỏ qua không?
• Khối lượng công việc của bạn có sử dụng các phần đầu vào hình ảnh hoặc video với MiniMax-M3 không?
• Ứng dụng của bạn có vô tình kỳ vọng đầu vào âm thanh trong đường đi chat tương thích OpenAI không?

Bài kiểm tra trực tiếp đó cho bạn đường cơ sở trước khi đặt MiniMax sau một router.

Thiết lập Flatkey cho MiniMax thông qua một router

Với Flatkey, thiết lập client tương thích OpenAI vẫn theo cùng mẫu dùng cho các mô hình khác: dùng một khóa Flatkey, đặt URL gốc của router Flatkey, và chọn một ID mô hình tồn tại trong danh mục Flatkey hiện tại.

export FLATKEY_API_KEY="sk-your-flatkey-key"
export OPENAI_BASE_URL="https://router.flatkey.ai/v1"

# Ví dụ tuyến chat công khai được xác minh trong bản cập nhật này.
export FLATKEY_MINIMAX_TEXT_MODEL="minimax-m2.7"

# Ví dụ tuyến video công khai được xác minh trong bản cập nhật này.
export FLATKEY_MINIMAX_VIDEO_MODEL="MiniMax-H3"

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["FLATKEY_API_KEY"],
    base_url=os.environ.get("OPENAI_BASE_URL", "https://router.flatkey.ai/v1"),
)

response = client.chat.completions.create(
    model=os.environ["FLATKEY_MINIMAX_TEXT_MODEL"],
    messages=[
        {"role": "user", "content": "Trả về một câu xác nhận rằng tuyến MiniMax của Flatkey hoạt động."}
    ],
    max_tokens=120,
)

print(response.choices[0].message.content)
print(response.usage)

Đây là mẫu cơ bản Truy cập MiniMax API với một router tương thích OpenAI. Mã vẫn rất thông thường, nhưng ID mô hình phải lấy từ Flatkey vào ngày bạn kiểm thử. Nếu danh mục hiện tại hiển thị MiniMax-M3, hãy dùng đúng chuỗi hiện tại đó. Nếu không, đừng dán trực tiếp ID mô hình MiniMax vào một tuyến Flatkey rồi cho rằng nó sẽ hoạt động.

Video: MiniMax H3 thông qua Flatkey

Đối với các nhóm media, quyền truy cập MiniMax API thường là về video hơn là chat. Flatkey ghi tài liệu về MiniMax-H3 thông qua một quy trình video không đồng bộ chuyên dụng:

curl --fail-with-body -sS https://router.flatkey.ai/v1/videos \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [
      {
        "type": "text",
        "text": "Một chiếc thuyền giấy băng qua vũng nước mưa trong cảnh macro điện ảnh"
      }
    ],
    "resolution": "768P",
    "duration": 6,
    "ratio": "16:9",
    "aigc_watermark": false
  }'

Hướng dẫn MiniMax H3 của Flatkey cho biết phản hồi bao gồm id và task_id. Lưu lại, thăm dò GET /v1/videos/{task_id}, rồi tải tệp từ metadata.url khi tác vụ hoàn tất.

Cấu hình video này không thể thay thế cho một lượt hoàn thành chat:

• MiniMax-H3 sử dụng dạng mảng content.
• resolution phân biệt chữ hoa chữ thường và chấp nhận 768P hoặc 2K trong hướng dẫn Flatkey.
• duration là một số nguyên từ 4 đến 15 giây.
• Các yêu cầu chỉ có văn bản cần một tỷ lệ không phải adaptive.
• Phương tiện tham chiếu và các điều khiển khung hình đầu/cuối có những quy tắc vai trò khác nhau.
• Các trường usage biểu thị số giây cho phản hồi video H3, không phải token của mô hình ngôn ngữ.

Nếu sản phẩm của bạn cũng so sánh Seedance, Veo hoặc các mô hình video khác, hãy ghép bài viết này với các kiểm tra định tuyến video đa nhà cung cấp của Flatkey. Điều quan trọng không chỉ là một tác vụ video có thành công hay không. Điều quan trọng là hợp đồng đầu ra, đơn vị chi phí, hành vi hàng đợi, trạng thái lỗi và quy tắc dự phòng có phù hợp với quy trình làm việc hay không.

Các đơn vị giá MiniMax cần chuẩn hóa

Giá cả là nơi Truy cập MiniMax API với một router tương thích OpenAI có thể gặp vấn đề. MiniMax không có một bảng giá duy nhất. Nó có nhiều đơn vị giá khác nhau.

Bảng giá Flatkey và các hệ số nhóm tách biệt với bảng giá trực tiếp của MiniMax. Bảng nhà cung cấp trực tiếp cho bạn biết MiniMax tính phí một tài khoản MiniMax như thế nào. Quyết định định tuyến Flatkey nên dựa trên hàng mô hình Flatkey đang hoạt động, nhóm tài khoản của bạn và nhật ký sử dụng sau một yêu cầu thử nghiệm.

Hãy dùng công thức này cho các workflow về media và creator:

accepted_output_cost:
  provider_or_router_cost: "tổng của tất cả các lần thử"
  accepted_outputs: "clip, hình ảnh, tệp âm thanh hoặc phản hồi đã vượt qua kiểm duyệt"
  formula: "provider_or_router_cost / accepted_outputs"
  include:
    - retries
    - fallback attempts
    - rejected outputs
    - regeneration
    - review lane
    - storage handoff

Đầu ra được tạo ra rẻ nhất không phải lúc nào cũng là đầu ra được chấp nhận rẻ nhất.

Kiểm tra nhanh tính tương thích

Chạy bài kiểm tra nhanh này trước khi chuyển bất kỳ lưu lượng production nào:

Điều kiện đạt không phải là niềm tin, mà là bằng chứng. Lưu một request ID hoặc task ID, một model ID, dấu thời gian, đường dẫn route, ảnh chụp màn hình hoặc bản xuất nhật ký sử dụng, và đơn vị chi phí cuối cùng.

Bản ghi đánh giá route MiniMax có thể sao chép

Hãy dùng mẫu này trong issue ra mắt hoặc repository định tuyến của bạn:

minimax_route_review:
  checked_at_utc: "2026-09-16T00:00:00Z"
  owner: "media_platform_team"
  workload: "creator_video_draft | support_chat | voiceover | image_draft"
  route_mode: "direct_minimax | flatkey | dual_route_test"
  direct_minimax:
    base_url: "https://api.minimax.io/v1"
    model_id: "MiniMax-M3"
    docs_checked:
      - "https://platform.minimax.io/docs/api-reference/text-openai-api.md"
      - "https://platform.minimax.io/docs/guides/pricing-paygo.md"
  flatkey:
    base_url: "https://router.flatkey.ai/v1"
    model_id: "replace_with_current_flatkey_model_id"
    catalog_url: "https://flatkey.ai/models"
    model_page_status: "200 | 404 | account_only"
    usage_logs_verified: false
  endpoint_contract:
    path: "/v1/chat/completions | /v1/videos"
    request_shape: "chat_messages | content_array | prompt_string"
    streaming_required: false
    tool_calls_required: false
    image_input_required: false
    video_input_required: false
  cost_review:
    provider_unit: "tokens | seconds | characters | images | hours | requests"
    flatkey_unit: "ghi lại hàng hiện tại"
    accepted_output_cost_target: "USD"
  fallback_policy:
    fallback_enabled: false
    fallback_models: []
    allowed_failure_classes:
      - "timeout"
      - "upstream_5xx"
    blocked_failure_classes:
      - "safety_block"
      - "unsupported_feature"
  rollout:
    first_environment: "staging"
    production_slice: "0%"
    rollback_owner: "engineering"
    next_review_date: "YYYY-MM-DD"

Bản ghi này biến Truy cập MiniMax API với một router tương thích OpenAI thành một quyết định có thể kiểm toán. Bất kỳ ai cũng có thể thấy mô hình nào đã được kiểm thử, tuyến nào đã xử lý nó, đơn vị chi phí nào đã được phê duyệt, và hành vi dự phòng nào được cho phép.

Khi truy cập trực tiếp MiniMax là đủ

Hãy dùng trực tiếp MiniMax khi:

• MiniMax là nhà cung cấp duy nhất trong quy trình.
• Bạn cần một mô hình MiniMax vừa ra mắt trước khi nó xuất hiện trong danh mục của gateway.
• Bạn cần một tính năng gốc của nhà cung cấp mà router không hiển thị.
• Chính sách mua sắm hoặc dữ liệu yêu cầu các kiểm soát trực tiếp từ nhà cung cấp.
• Nhóm của bạn vẫn đang tìm hiểu hành vi của MiniMax và muốn một đường cơ sở sạch.

Truy cập trực tiếp không phải là một thất bại về kiến trúc. Đó là con đường đúng khi tính đặc thù của nhà cung cấp quan trọng hơn sự tập trung hóa.

Khi Flatkey là con đường gọn hơn

Hãy dùng Flatkey khi MiniMax chỉ là một tuyến trong một hệ thống mô hình rộng hơn:

• Sản phẩm so sánh MiniMax với GPT, Claude, Gemini, DeepSeek, Qwen, Seedance, Veo hoặc các nhà cung cấp khác.
• Một quy trình của creator cần các tuyến văn bản, hình ảnh, giọng nói và video dưới một quy trình rà soát duy nhất.
• Bộ phận tài chính muốn một dấu vết sử dụng ở cấp yêu cầu thay vì nhiều bảng điều khiển của từng nhà cung cấp.
• Chủ sở hữu nền tảng cần sub-key, hạn mức, allowlist mô hình, rà soát tuyến hoặc kiểm soát rollback.
• Nhóm đã dùng các client OpenAI SDK và muốn lựa chọn mô hình trong cấu hình.
• Việc quyết định fallback và trạng thái sức khỏe của tuyến cần có thể quan sát được.

Flatkey không loại bỏ việc kiểm thử ở cấp nhà cung cấp. Nó giúp việc kiểm thử và bằng chứng dễ quản lý hơn giữa các nhà cung cấp.

Những lỗi thường gặp

• Trộn lẫn thông tin xác thực: một khóa MiniMax phải đi với URL gốc MiniMax, và một khóa Flatkey phải đi với URL gốc Flatkey.
• Sử dụng MiniMax-M3 trong mã Flatkey mà không kiểm tra xem danh mục Flatkey hiện tại có hiển thị chính xác tuyến đó hay không.
• Coi khả năng tương thích trực tiếp của MiniMax với OpenAI SDK là tương đương đầy đủ với OpenAI API.
• Bỏ qua các lưu ý của MiniMax về function_call đã lỗi thời, không được hỗ trợ, n: 1, các tham số bị bỏ qua, và đầu vào âm thanh trong đường dẫn chat tương thích OpenAI.
• Chỉ kiểm thử chat trong khi tải công việc thực tế dùng streaming, công cụ, đầu vào hình ảnh, đầu vào video, hoặc các công việc video bất đồng bộ.
• So sánh giá token, giây video, ký tự giọng nói và giá hình ảnh trong một bảng mà không chuẩn hóa theo đầu ra được chấp nhận.
• Bật cơ chế dự phòng từ một mô hình video sang mô hình khác mà không kiểm tra thời lượng, độ phân giải, hỗ trợ âm thanh/tham chiếu, và hành vi kiểm duyệt.
• Xuất bản mã mẫu với các khóa trông có vẻ thật hoặc ID mô hình đã lỗi thời.

Liên kết nội bộ cho bước tiếp theo

Nếu đây là lần đầu bạn di chuyển sang Flatkey, hãy bắt đầu với hướng dẫn bắt đầu nhanh API Flatkey và quy trình API AI hợp nhất rộng hơn. Để xem xét hàng mô hình, hãy dùng hướng dẫn danh mục mô hình AI. Với chính sách video, hãy kết hợp nội dung này với định tuyến Seedance vs Veo API, danh sách kiểm tra truy cập Veo API, và hướng dẫn định tuyến tác tử đa phương thức.

Câu hỏi thường gặp

Làm thế nào để tôi có quyền truy cập MiniMax API?

Bạn có thể truy cập MiniMax API trực tiếp thông qua nền tảng MiniMax với khóa API trả theo mức sử dụng, hoặc định tuyến các mô hình MiniMax được hỗ trợ qua Flatkey với khóa Flatkey và https://router.flatkey.ai/v1. Dùng MiniMax trực tiếp cho kiểm thử gốc của nhà cung cấp và dùng Flatkey cho định tuyến đa nhà cung cấp, nhật ký, xem xét thanh toán, và chính sách dự phòng.

MiniMax API có tương thích với OpenAI không?

MiniMax ghi tài liệu về việc sử dụng OpenAI SDK với https://api.minimax.io/v1 làm URL gốc cho các mô hình ngôn ngữ được hỗ trợ. Khả năng tương thích là ở cấp tính năng. MiniMax ghi chú các lưu ý về tham số OpenAI bị bỏ qua, n: 1, function_call đã lỗi thời không được hỗ trợ, và không có đầu vào âm thanh trong đường dẫn nội dung tin nhắn chat tương thích OpenAI.

Mô hình ngôn ngữ MiniMax hiện tại nào nên kiểm tra trước tiên?

Tài liệu chính thức của MiniMax liệt kê MiniMax-M3 là mô hình ngôn ngữ dòng M mới nhất, với cửa sổ ngữ cảnh 1.000.000 token và hỗ trợ đa phương thức cho đầu vào hình ảnh và video. Với Flatkey, hãy kiểm tra danh mục trực tiếp trước khi cho rằng ID mô hình chính xác đó có sẵn qua router.

Tôi có thể dùng MiniMax-M3 qua Flatkey không?

Đừng giả định điều này chỉ từ tài liệu MiniMax trực tiếp. Trong lần làm mới ngày 16 tháng 9 năm 2026 này, trang chi tiết model minimax-m3 công khai của Flatkey trả về 404, trong khi minimax-m2.7 và MiniMax-H3 trả về 200. Hãy kiểm tra thư mục model Flatkey hiện tại của bạn, /v1/models, hoặc bảng điều khiển trước khi cấu hình M3 thông qua Flatkey.

Tôi dùng video MiniMax-H3 qua Flatkey như thế nào?

Sử dụng POST https://router.flatkey.ai/v1/videos với model MiniMax-H3, một mảng content, resolution là 768P hoặc 2K, thời lượng từ 4 đến 15, và một tỷ lệ hợp lệ. Lưu ID tác vụ trả về, thăm dò GET /v1/videos/{task_id}, rồi tải xuống từ metadata.url khi hoàn tất.

Tôi nên so sánh giá MiniMax qua router như thế nào?

Bắt đầu từ đơn vị trực tiếp của MiniMax, sau đó kiểm tra hàng model Flatkey và nhật ký sử dụng của bạn. Văn bản dùng đơn vị token, video dùng giây, speech có thể dùng giờ hoặc ký tự, tạo ảnh dùng giá theo mỗi ảnh, và công cụ có thể dùng giá theo mỗi yêu cầu. Hãy so sánh chi phí trên mỗi đầu ra được chấp nhận sau các lần thử lại và các đầu ra bị từ chối, không chỉ giá niêm yết.

Flatkey có thay thế việc kiểm thử tuyến trực tiếp của MiniMax không?

Không. Flatkey có thể tập trung hóa quản lý khóa, định tuyến model, nhật ký sử dụng, và xem xét thanh toán, nhưng bạn vẫn cần kiểm thử đúng model, endpoint, dạng yêu cầu, đơn vị giá, quy tắc dự phòng, và hành vi lỗi mà sản phẩm của bạn sẽ dùng.

Kết luận cuối cùng

Truy cập MiniMax API với một router tương thích OpenAI nên kết thúc bằng một bản ghi tuyến có ngày tháng, chứ không chỉ là việc thay đổi base_url. Xác nhận hành vi trực tiếp của MiniMax, chọn đúng hàng model Flatkey nếu bạn định tuyến qua Flatkey, chạy kiểm thử nhanh chat và video riêng biệt, chuẩn hóa giá theo đầu ra được chấp nhận, và giữ cơ chế rollback trong cấu hình. Sau đó dùng thư mục model, trang giá, quickstart, tài liệu video, và nhật ký sử dụng của Flatkey để giữ MiniMax trong cùng vòng đánh giá vận hành với phần còn lại của hệ model của bạn.

Đối với các đội ngũ media và sản phẩm, Truy cập MiniMax API với một router tương thích OpenAI là thói quen thực tế của việc xem mỗi lần ra mắt model như một quyết định tuyến có bằng chứng đi kèm.