Accès à l’API MiniMax avec un routeur compatible OpenAI

Accès à l’API MiniMax avec un routeur compatible OpenAI est utile lorsque votre équipe souhaite intégrer MiniMax dans le même workflow de production que le reste de votre pile d’IA. Le chemin direct MiniMax est déjà compatible avec le SDK OpenAI pour les modèles de langage pris en charge. Un chemin via routeur ajoute une URL de base partagée, une couche de clé, une vérification du catalogue, un journal d’utilisation et un seul endroit pour décider quels workloads MiniMax doivent cohabiter avec GPT, Claude, Gemini, DeepSeek, Qwen, Seedance, Veo et d’autres routes de modèles.

Cette mise à jour a été vérifiée le 16 septembre 2026 à partir de la documentation API officielle de MiniMax, de la tarification MiniMax au paiement à l’usage, des documents publics Flatkey, du répertoire de modèles Flatkey et des pages de modèles MiniMax de Flatkey. Considérez chaque modèle, prix et état de route comme un instantané public daté. Vérifiez à nouveau votre compte, votre catalogue et vos conditions avant d’envoyer du trafic de production.

En bref : utilisez MiniMax en direct lorsque vous avez seulement besoin d’un accès au compte MiniMax. Utilisez Flatkey lorsque MiniMax doit être évalué, budgété, consigné et rétabli dans un workflow de routeur multi-fournisseurs.

Réponse rapide : accès à l’API MiniMax avec un routeur compatible OpenAI

Si votre application utilise déjà le SDK OpenAI Python ou JavaScript, MiniMax propose deux chemins d’accès pratiques :

Utilisez ce guide Accès à l’API MiniMax avec un routeur compatible OpenAI comme checklist de lancement. N’approuvez pas la migration simplement parce qu’une réponse d’exemple a fonctionné. Approuvez-la lorsque l’ID exact du modèle, l’endpoint, la forme de la requête, l’unité de tarification, le journal d’utilisation, la règle de repli et le chemin de retour arrière sont tous visibles.

Ce qui a changé depuis l’ancien article MiniMax

L’ancien article public était daté du 16 juin 2026. La mise à jour sûre n’est pas une réécriture cosmétique. MiniMax et Flatkey ont tous deux suffisamment évolué pour que l’article nécessite un langage de route actuel.

Les principales mises à jour sont :

• MiniMax documente désormais MiniMax-M3 comme le dernier modèle de langage série M pris en charge par le SDK OpenAI, avec une fenêtre de contexte de 1 000 000 tokens et la prise en charge des entrées image/vidéo via des parties de contenu de message compatibles OpenAI.
• La génération vidéo MiniMax V2 documente désormais MiniMax-H3 et MiniMax-H3-Max via un flux asynchrone POST /v2/video_generation.
• La tarification MiniMax à l’usage segmente désormais le prix du texte M3 selon le seuil de contexte et le niveau de service, le prix vidéo H3 selon le modèle/la résolution/la durée en secondes, le prix image par image générée, le prix de la parole par heure ou par caractère, et le prix MCP/outils par requête.
• La documentation publique Flatkey expose MiniMax-H3 via le workflow vidéo asynchrone partagé POST /v1/videos.
• Les pages modèles publiques Flatkey vérifiées pendant cette actualisation ont renvoyé 200 pour https://flatkey.ai/models/minimax-h3 et https://flatkey.ai/models/minimax-m2.7 ; https://flatkey.ai/models/minimax-m3 a renvoyé 404. Cela signifie que cet article n’affirme pas l’existence d’une route Flatkey M3 vérifiée.

Ce dernier point est important. Un article sur un routeur devrait aider les équipes à éviter les hypothèses périmées sur les noms de modèles. Si vous ցանկանում utilizar M3 via Flatkey, vérifiez le répertoire de modèles en direct, /v1/models, ou votre console avant de configurer le trafic de production.

Faits source à verrouiller avant de router MiniMax

Utilisez ce tableau source avant de modifier le code :

C’est l’habitude principale en production derrière Accès à l’API MiniMax avec un routeur compatible OpenAI : enregistrez la date de la source, enregistrez l’ID du modèle et enregistrez le chemin de preuve. Les catalogues de modèles changent trop souvent pour que des extraits copiés fassent autorité en dernier ressort.

Configuration directe du SDK OpenAI MiniMax

La configuration directe de MiniMax est le premier test le plus propre lorsque vous devez comprendre le comportement natif du fournisseur.

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": "Retournez une phrase confirmant que la route MiniMax fonctionne."}
    ],
    max_completion_tokens=120,
    extra_body={
        "thinking": {"type": "disabled"}
    },
)

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

Utilisez MiniMax direct pour apprendre d’abord le comportement du fournisseur :

• Votre application a-t-elle besoin de la sortie de réflexion de MiniMax ou de réponses directes ?
• Votre gestionnaire de flux tolère-t-il les champs de réponse de MiniMax ?
• Votre boucle d’appel d’outil ajoute-t-elle le message complet de l’assistant lorsque c’est nécessaire ?
• Votre analyseur dépend-il de paramètres que MiniMax ignore ?
• Votre charge de travail utilise-t-elle des parties d’entrée image ou vidéo avec MiniMax-M3 ?
• Votre application s’attend-elle par erreur à une entrée audio dans le parcours de chat compatible OpenAI ?

Ce test direct vous donne la base de référence avant de placer MiniMax derrière un routeur.

Configuration Flatkey pour MiniMax via un seul routeur

Pour Flatkey, la configuration du client compatible OpenAI suit le même modèle que pour les autres modèles : utilisez une clé Flatkey, définissez l’URL de base du routeur Flatkey et choisissez un ID de modèle qui existe dans le catalogue Flatkey actuel.

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

# Exemple de route de chat publique vérifiée dans cette mise à jour.
export FLATKEY_MINIMAX_TEXT_MODEL="minimax-m2.7"

# Exemple de route vidéo publique vérifiée dans cette mise à jour.
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": "Return one sentence confirming the Flatkey MiniMax route works."}
    ],
    max_tokens=120,
)

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

Voici le schéma de base d’accès à l’API MiniMax avec un seul routeur compatible OpenAI. Le code reste ordinaire, mais l’ID du modèle doit provenir de Flatkey le jour où vous testez. Si le catalogue actuel affiche MiniMax-M3, utilisez la chaîne exacte du moment. Si ce n’est pas le cas, ne collez pas l’ID de modèle MiniMax direct dans une route Flatkey en supposant qu’il fonctionnera.

Vidéo : MiniMax H3 via Flatkey

Pour les équipes média, l’accès à l’API MiniMax concerne souvent la vidéo plutôt que le chat. Flatkey documente MiniMax-H3 via un flux de travail vidéo asynchrone dédié :

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": "A paper boat crosses a rain puddle in a cinematic macro shot"
      }
    ],
    "resolution": "768P",
    "duration": 6,
    "ratio": "16:9",
    "aigc_watermark": false
  }'

Le guide MiniMax H3 de Flatkey indique que la réponse inclut un id et un task_id. Enregistrez-le, interrogez GET /v1/videos/{task_id}, puis téléchargez le fichier depuis metadata.url lorsque la tâche est terminée.

La configuration vidéo n’est pas interchangeable avec une complétion de chat :

• MiniMax-H3 utilise la forme de tableau content.
• resolution est sensible à la casse et accepte 768P ou 2K dans le guide Flatkey.
• duration est un entier de 4 à 15 secondes.
• Les requêtes en texte seul nécessitent un ratio non-adaptive.
• Les médias de référence et les contrôles de première/dernière image ont des règles de rôle différentes.
• Les champs d'utilisation représentent des secondes pour les réponses vidéo H3, et non des jetons de modèle de langage.

Si votre produit compare également Seedance, Veo ou d'autres modèles vidéo, associez cet article aux vérifications de routage vidéo multi-fournisseurs de Flatkey. L'important n'est pas seulement de savoir si une tâche vidéo réussit. L'important est de savoir si le contrat de sortie, l'unité de coût, le comportement de file d'attente, l'état d'échec et la règle de repli sont acceptables pour le workflow.

Unités de tarification MiniMax à normaliser

La tarification est l'endroit où l'accès à l'API MiniMax avec un routeur compatible OpenAI peut poser problème. MiniMax n'est pas une seule grille tarifaire. Ce sont plusieurs unités de tarification.

Les prix Flatkey et les multiplicateurs de groupe sont distincts de la tarification directe de MiniMax. Le tableau du fournisseur direct vous indique comment MiniMax facture un compte MiniMax. Une décision de routage Flatkey doit utiliser la ligne de modèle Flatkey en temps réel, votre groupe de compte et le journal d’utilisation après une requête de test.

Utilisez cette formule pour les workflows média et créateurs :

accepted_output_cost:
  provider_or_router_cost: "sum of all attempts"
  accepted_outputs: "clips, images, audio files, or responses that passed review"
  formula: "provider_or_router_cost / accepted_outputs"
  include:
    - retries
    - fallback attempts
    - rejected outputs
    - regeneration
    - review lane
    - storage handoff

Le résultat généré le moins cher n’est pas toujours le résultat accepté le moins cher.

Test de fumée de compatibilité

Exécutez ce test de fumée avant de déplacer tout trafic de production :

La condition de réussite repose sur des preuves, pas sur la confiance. Enregistrez un ID de requête ou un ID de tâche, un ID de modèle, un horodatage, le chemin de la route, une capture d’écran ou une exportation du journal d’utilisation, ainsi que l’unité de coût finale.

Enregistrement de revue de route MiniMax copiable

Utilisez ce modèle dans votre ticket de lancement ou votre dépôt de routage :

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: "record current row"
    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"

Cette fiche transforme MiniMax API Access With One OpenAI-Compatible Router en une décision vérifiable. Chacun devrait pouvoir voir quel modèle a été testé, quel routeur l’a pris en charge, quelle unité de coût a été approuvée et quel comportement de repli est autorisé.

Quand MiniMax en direct suffit

Utilisez MiniMax en direct lorsque :

• MiniMax est le seul fournisseur dans le workflow.
• Vous avez besoin d’un modèle MiniMax récemment lancé avant qu’il n’apparaisse dans le catalogue d’une passerelle.
• Vous avez besoin d’une fonctionnalité native du fournisseur que le routeur n’expose pas.
• Les politiques d’achat ou de données exigent des contrôles directs du fournisseur.
• Votre équipe apprend encore le comportement de MiniMax et souhaite une base de référence propre.

L’accès direct n’est pas un échec d’architecture. C’est la bonne voie lorsque la spécificité du fournisseur compte plus que la centralisation.

Quand Flatkey est la voie la plus propre

Utilisez Flatkey lorsque MiniMax n’est qu’un chemin parmi d’autres dans un système de modèles plus large :

• Le produit compare MiniMax avec GPT, Claude, Gemini, DeepSeek, Qwen, Seedance, Veo ou d’autres fournisseurs.
• Un workflow de création a besoin de routes texte, image, voix et vidéo sous un seul processus de revue.
• La finance veut une seule trace d’utilisation au niveau de la requête au lieu de plusieurs consoles fournisseur.
• Les responsables de plateforme ont besoin de sous-clés, de quotas, de listes d’autorisation de modèles, de revues de route ou de contrôles de rollback.
• L’équipe utilise déjà les clients SDK OpenAI et veut choisir le modèle via la configuration.
• Les décisions de repli et d’état de santé des routes doivent être observables.

Flatkey ne supprime pas les tests au niveau du fournisseur. Il rend les tests et les preuves plus faciles à gérer entre plusieurs fournisseurs.

Erreurs courantes

• Mélanger les identifiants : une clé MiniMax doit être associée à l’URL de base MiniMax, et une clé Flatkey doit être associée à l’URL de base Flatkey.
• Utiliser MiniMax-M3 dans du code Flatkey sans vérifier que le catalogue Flatkey actuel expose exactement cette route.
• Considérer la compatibilité directe du SDK OpenAI avec MiniMax comme une parité complète avec l’API OpenAI.
• Ignorer les mises en garde de MiniMax concernant function_call obsolète non pris en charge, n: 1, les paramètres ignorés et l’entrée audio dans le chemin de chat compatible OpenAI.
• Ne tester que le chat alors que la charge de travail en production utilise le streaming, les outils, l’entrée d’image, l’entrée vidéo ou des tâches vidéo asynchrones.
• Comparer les prix des jetons, les secondes vidéo, les caractères de synthèse vocale et les prix des images dans un seul tableau sans normaliser selon la sortie acceptée.
• Activer le basculement d’un modèle vidéo vers un autre sans vérifier la durée, la résolution, la prise en charge de l’audio/des références et le comportement de modération.
• Publier du code d’exemple avec des clés qui semblent réelles ou des identifiants de modèle obsolètes.

Liens internes pour l’étape suivante

Si c’est votre première migration vers Flatkey, commencez par le guide de démarrage rapide de l’API Flatkey et le flux de travail d’API IA unifiée plus large. Pour la revue des lignes du modèle, utilisez le guide du catalogue de modèles IA. Pour la politique vidéo, associez cela au routage API Seedance vs Veo, à la liste de vérification d’accès à l’API Veo et au guide de routage des agents multimodaux.

Questions fréquentes

Comment obtenir l’accès à l’API MiniMax ?

Vous pouvez obtenir l’accès à l’API MiniMax directement via la plateforme MiniMax avec une clé API pay-as-you-go, ou acheminer les modèles MiniMax pris en charge via Flatkey avec une clé Flatkey et https://router.flatkey.ai/v1. Utilisez MiniMax en direct pour les tests natifs du fournisseur et Flatkey pour le routage multi-fournisseurs, les journaux, l’examen de la facturation et la politique de repli.

L’API MiniMax est-elle compatible avec OpenAI ?

MiniMax documente l’utilisation du SDK OpenAI avec https://api.minimax.io/v1 comme URL de base pour les modèles de langage pris en charge. La compatibilité est au niveau des fonctionnalités. MiniMax documente des mises en garde concernant les paramètres OpenAI ignorés, n: 1, la prise en charge absente de l’obsolète function_call et l’absence d’entrée audio dans le chemin de contenu de message de chat compatible OpenAI.

Quel est le modèle de langage MiniMax actuel à vérifier en premier ?

La documentation officielle de MiniMax indique MiniMax-M3 comme le dernier modèle de langage de la série M, avec une fenêtre de contexte de 1 000 000 de jetons et une prise en charge multimodale de l’entrée image et vidéo. Pour Flatkey, consultez le catalogue en direct avant de supposer que cet identifiant de modèle exact est disponible via le routeur.

Puis-je utiliser MiniMax-M3 via Flatkey ?

Ne le supposez pas à partir de la seule documentation directe de MiniMax. Lors de cette actualisation du 16 septembre 2026, la page publique de détail du modèle Flatkey minimax-m3 renvoyait 404, tandis que minimax-m2.7 et MiniMax-H3 renvoyaient 200. Vérifiez votre répertoire de modèles Flatkey actuel, /v1/models ou la console avant de configurer M3 via Flatkey.

Comment utiliser la vidéo MiniMax-H3 via Flatkey ?

Utilisez POST https://router.flatkey.ai/v1/videos avec le modèle MiniMax-H3, un tableau content, une resolution de 768P ou 2K, une durée comprise entre 4 et 15, ainsi qu’un ratio valide. Enregistrez l’ID de tâche renvoyé, interrogez GET /v1/videos/{task_id}, puis téléchargez depuis metadata.url une fois terminé.

Comment dois-je comparer les tarifs MiniMax via un routeur ?

Partez de l’unité directe MiniMax, puis vérifiez la ligne de modèle Flatkey et votre journal d’utilisation. Le texte utilise des unités de jetons, la vidéo utilise des secondes, la synthèse vocale peut utiliser des heures ou des caractères, la génération d’images utilise une tarification par image, et les outils peuvent utiliser une tarification par requête. Comparez le coût par sortie acceptée après les nouvelles tentatives et les sorties rejetées, pas seulement le prix catalogue.

Flatkey remplace-t-il les tests de routage direct de MiniMax ?

Non. Flatkey peut centraliser la gestion des clés, le routage des modèles, les journaux d’utilisation et la revue de la facturation, mais vous devez tout de même tester le modèle exact, l’endpoint, la forme de la requête, l’unité de prix, la règle de repli et le comportement d’erreur que votre produit utilisera.

Conclusion finale

L’accès à l’API MiniMax avec un routeur compatible OpenAI doit se terminer par un enregistrement de route daté, pas seulement par une modification de base_url. Confirmez le comportement direct de MiniMax, choisissez la ligne de modèle Flatkey exacte si vous passez par Flatkey, exécutez séparément des tests de fumée pour le chat et la vidéo, normalisez les tarifs par sortie acceptée et gardez le retour arrière dans la configuration. Utilisez ensuite le répertoire de modèles, la page de tarification, le guide de démarrage rapide, la documentation vidéo et les journaux d’utilisation de Flatkey pour intégrer MiniMax dans la même boucle de revue opérationnelle que le reste de votre pile de modèles.

Pour les équipes médias et produit, l’accès à l’API MiniMax avec un routeur compatible OpenAI est l’habitude pratique de considérer chaque lancement de modèle comme une décision de routage accompagnée de preuves.