L’accès à l’API Qwen propose deux voies pratiques pour les équipes qui utilisent déjà des clients au format OpenAI. Vous pouvez appeler Qwen directement via l’interface compatible OpenAI DashScope de Alibaba Cloud Model Studio, ou conserver une seule URL de base du routeur Flatkey et utiliser Qwen aux côtés des autres modèles déjà routés par votre produit.
La voie directe Alibaba Cloud est spécifique à une région. La voie Flatkey utilise https://router.flatkey.ai/v1, une clé Flatkey et un identifiant de modèle Qwen sélectionné dans le catalogue Flatkey actuel avant de tester les journaux, les unités de tarification, la prise en charge des fonctionnalités et le retour en arrière.
Ce guide explique comment utiliser l’accès à l’API Qwen via une seule URL de base compatible OpenAI. Il couvre ce que confirment les documents officiels d’Alibaba Cloud, en quoi Flatkey modifie le modèle opérationnel, et ce qu’il faut vérifier avant de déplacer le trafic de production.
Réponse rapide : accès à l’API Qwen via une seule URL de base Router
Si votre application utilise déjà le SDK Python ou JavaScript d’OpenAI, l’accès à l’API Qwen peut commencer par un simple changement de configuration plutôt que par une réécriture du SDK du fournisseur.
| Décision | Qwen direct dans Model Studio | Qwen via Flatkey |
|---|---|---|
| Clé API | Clé API DashScope de Alibaba Cloud Model Studio | Clé API Flatkey |
| URL de base | URL OpenAI-compatible DashScope spécifique à la région | https://router.flatkey.ai/v1 |
| Objectif principal | Appeler Qwen directement avec une syntaxe compatible OpenAI | Router Qwen aux côtés d’autres fournisseurs derrière une seule clé |
| Choix du modèle | Modèle Qwen issu de la documentation et de la région du compte Alibaba Cloud | Modèle Qwen depuis la tarification ou le tableau de bord Flatkey |
| Validation | Réponse, prise en charge des fonctionnalités, facturation Alibaba Cloud | Réponse, journal d’utilisation Flatkey, unité de tarification, quota, retour arrière |
Utilisez le point de terminaison Model Studio direct lorsque vous avez seulement besoin du contrôle du compte Alibaba Cloud pour Qwen. Utilisez Flatkey lorsque Qwen doit s’intégrer dans le même flux de travail d’accès, de routage, de quota, de journal d’utilisation et de facturation que GPT, Claude, Gemini, DeepSeek, Seedance, les modèles d’image et d’autres familles de modèles.
Ce que confirment les docs Qwen d’Alibaba Cloud
La documentation d’Alibaba Cloud indique que les modèles Qwen dans Model Studio prennent en charge une interface compatible avec OpenAI. La consigne officielle de migration est simple : ajuster la clé API, BASE_URL et le nom du modèle. C’est le même schéma de migration en trois parties auquel la plupart des utilisateurs de SDK compatibles OpenAI s’attendent.
La documentation officielle liste des URL de base spécifiques à chaque région pour les appels SDK :
| Région | URL de base compatible OpenAI |
|---|---|
| Singapour | https://dashscope-intl.aliyuncs.com/compatible-mode/v1 |
| États-Unis (Virginie) | https://dashscope-us.aliyuncs.com/compatible-mode/v1 |
| Chine (Pékin) | https://dashscope.aliyuncs.com/compatible-mode/v1 |
| Hong Kong (Chine) | https://cn-hongkong.dashscope.aliyuncs.com/compatible-mode/v1 |
La référence OpenAI Chat documente également le format complet du point de terminaison de chat, par exemple POST https://dashscope-us.aliyuncs.com/compatible-mode/v1/chat/completions pour les appels aux États-Unis. Les mêmes docs incluent des exemples pour le chat sans streaming, le streaming, l’utilisation dans le dernier bloc de streaming, l’appel d’outils, la sortie JSON, l’entrée image pour les modèles capables de vision, ainsi que des options liées à la recherche.
Cela ne signifie pas que chaque modèle Qwen prend en charge chaque fonctionnalité. Cela signifie que l’accès à l’API Qwen doit être testé fonctionnalité par fonctionnalité : d’abord le chat de base, puis le streaming, les outils, le JSON, la vision, la recherche, ou tout autre point de terminaison réellement utilisé par votre application.
Où Flatkey change la configuration de Qwen
Flatkey modifie la surface opérationnelle autour de l'accès à l'API Qwen. Au lieu de choisir directement une URL de base régionale DashScope dans chaque application, vous pointez votre client compatible OpenAI vers une seule URL de base de routeur :
https://router.flatkey.ai/v1Cette route compte lorsque Qwen n'est pas le seul modèle de votre pile. Le texte public du produit Flatkey positionne la plateforme autour d'une seule clé API, d'une tarification claire, d'une visibilité sur l'utilisation et d'un seul tableau de bord pour les clés, l'utilisation et le routage. La prise en charge de Qwen pour cet article est vérifiée via un instantané en direct du catalogue tarifaire de Flatkey, et non via une affirmation permanente de la page d'accueil.
L'instantané tarifaire Flatkey du jour de publication consulté pour cet article a renvoyé 638 lignes de modèles au total et 63 lignes portant le nom Qwen. Parmi ces lignes Qwen, 28 étaient marquées comme disponibles dans l'instantané, et les lignes Qwen exposaient openai comme type de point de terminaison pris en charge. Considérez cela comme une preuve datée du 16 juin 2026, et non comme une garantie permanente de disponibilité : confirmez l'ID actuel du modèle Qwen dans tarification ou dans le tableau de bord avant le trafic de production.
Modèle de migration de l’URL de base
Conservez l’accès à l’API Qwen dans la configuration au lieu de coder en dur les URL des fournisseurs dans toute votre base de code.
FLATKEY_API_KEY="sk-fk-your-key"
OPENAI_BASE_URL="https://router.flatkey.ai/v1"
FLATKEY_QWEN_MODEL="replace-with-flatkey-qwen-model-id"
# Valeurs directes optionnelles de Model Studio pour comparaison ou retour arrière.
DASHSCOPE_API_KEY="sk-your-dashscope-key"
DASHSCOPE_BASE_URL="https://dashscope-us.aliyuncs.com/compatible-mode/v1"La distinction importante est la propriété de la route. Les tests Qwen directs utilisent une clé DashScope et une URL de base DashScope régionale. Les tests Flatkey utilisent une clé Flatkey et l’URL de base du routeur Flatkey. Ne mélangez pas les clés, les URL de base et les identifiants de modèle entre les deux chemins.
Modèle Python pour Qwen via Flatkey
Modèle uniquement : exécutez ceci avec une clé Flatkey valide et un ID de modèle Flatkey Qwen confirmé avant de l’utiliser en production.
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_QWEN_MODEL"],
messages=[
{
"role": "user",
"content": "Répondez par une seule phrase confirmant que la route Qwen est configurée.",
}
],
)
print(response.choices[0].message.content)
print(response.usage)La forme du code correspond volontairement à une utilisation ordinaire du SDK OpenAI. Le travail de production consiste à choisir le bon ID de modèle, à tester votre ensemble de fonctionnalités et à confirmer que la requête apparaît dans les journaux d’utilisation Flatkey avec le modèle attendu, le statut, l’utilisation des tokens et le coût.
Modèle JavaScript pour Qwen via Flatkey
Modèle uniquement : exécutez ceci avec une clé Flatkey valide et un ID de modèle confirmé provenant du catalogue Flatkey actuel.
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.FLATKEY_API_KEY,
baseURL: process.env.OPENAI_BASE_URL || "https://router.flatkey.ai/v1",
});
const response = await client.chat.completions.create({
model: process.env.FLATKEY_QWEN_MODEL,
messages: [
{
role: "user",
content: "Reply with one sentence confirming the Qwen route is configured.",
},
],
});
console.log(response.choices[0].message.content);
console.log(response.usage);Pour les équipes qui utilisent déjà des clients JavaScript compatibles avec OpenAI, cela rend l'accès à l'API Qwen suffisamment compact pour être examiné en un seul changement de configuration. La route nécessite encore un test de validation avant le trafic réel.
Qwen direct versus Flatkey : quoi tester
La rareté des articles dans les résultats de recherche actuels n’est pas une autre liste de modèles Qwen. La documentation officielle le fait déjà. Le chaînon manquant est une checklist pratique de routage pour décider quand Qwen en direct suffit et quand une seule URL de base constitue la voie opérationnelle la plus propre.
| Besoins du workflow | Vérification directe Qwen | Vérification du routeur Flatkey |
|---|---|---|
| Chat basique | Utilisez la bonne URL de base DashScope régionale et le bon modèle. | Utilisez https://router.flatkey.ai/v1 et un identifiant de modèle Qwen Flatkey. |
| Streaming | Testez stream: true et la gestion finale de l’utilisation dans DashScope. |
Testez les chunks de flux, le comportement des timeouts et la journalisation finale de l’utilisation via Flatkey. |
| Outils/appels de fonctions | Confirmez que le modèle Qwen choisi prend en charge le schéma d’outil que vous envoyez. | Confirmez que le même schéma passe via la route Qwen Flatkey sélectionnée. |
| Sortie JSON | Testez votre modèle exact de response_format. |
Vérifiez la compatibilité du parseur et le comportement des erreurs via le routeur. |
| Entrée visuelle | Sélectionnez un modèle vision Qwen et testez le format de la charge utile de l’image. | Confirmez que le modèle Flatkey accepte la même forme d’entrée d’image. |
| Revue des coûts | Consultez la facturation et la documentation tarifaire d’Alibaba Cloud Model Studio. | Consultez les tarifs Flatkey et les journaux d’utilisation réels. |
| Routage multi-fournisseurs | Exige une configuration fournisseur séparée pour les modèles non Qwen. | Gardez Qwen aux côtés d’autres fournisseurs derrière une seule clé et un seul tableau de bord. |
Runbook de tests de fumée
Un test de fumée de l’accès à l’API Qwen doit démontrer à la fois le comportement de l’API et la visibilité du routeur.
- Choisissez un ID de modèle Qwen parmi la tarification Flatkey actuelle ou le tableau de bord.
- Créez ou sélectionnez une clé Flatkey à faible risque pour les tests.
- Définissez
OPENAI_BASE_URLsurhttps://router.flatkey.ai/v1. - Exécutez une invite de chat simple sans streaming.
- Confirmez que la forme de la réponse fonctionne avec le parseur de votre application.
- Vérifiez les journaux d’utilisation Flatkey pour le modèle, le statut, l’utilisation des jetons et le coût.
- Exécutez un test de mauvais modèle et enregistrez la forme de l’erreur.
- N’exécutez le streaming, les outils, le JSON, la recherche ou la vision que si votre application les utilise.
- Définissez un petit quota avant l’envoi du trafic réel.
- Conservez les paramètres directs DashScope ou du fournisseur précédent comme configuration de retour arrière jusqu’à ce que la route soit stable.
L’objectif n’est pas seulement de faire apparaître une réponse Qwen. L’objectif est de savoir où la requête est passée, combien elle a coûté, à quoi ressemblent les échecs et à quelle vitesse vous pouvez rétablir la route précédente.
Erreurs courantes
- Utiliser une clé API DashScope avec l’URL de base Flatkey, ou une clé Flatkey avec l’URL de base DashScope.
- Copier un nom de modèle Qwen depuis la documentation d’Alibaba Cloud sans confirmer la chaîne du catalogue Flatkey.
- Supposer que chaque paramètre compatible OpenAI se comporte de la même manière sur les chemins directs et routés.
- Ne tester que le chat sans flux alors que la production utilise le streaming, les outils, le JSON, la recherche ou la vision.
- Omettre de vérifier le journal d’utilisation et la tarification Flatkey après une réponse réussie.
- Publier des extraits de code avec des clés semblant réelles ou des identifiants de modèle de production non testés.
Ce sont de petits détails, mais c’est là que la plupart des migrations Qwen API access échouent. Un routeur facilite l’accès ; il ne supprime pas la nécessité de tester la forme exacte de la requête.
Comment cela s’articule avec les guides de migration Flatkey existants
Si c’est votre première migration de routeur, commencez par le guide de migration d’API compatible OpenAI plus général. Il couvre le modèle d’URL de base, les variables d’environnement, les tests de vérification, le retour arrière et les contrôles du tableau de bord qui s’appliquent à tout fournisseur.
Utilisez ensuite ce guide spécifique à Qwen pour les détails du fournisseur : les points de terminaison régionaux DashScope, la sélection du modèle Qwen, les tests de streaming et de fonctionnalités, ainsi que la vérification du catalogue Flatkey. Pour un itinéraire de fournisseur similaire, comparez le guide du routeur Gemini API compatible OpenAI.
Questions fréquentes
Comment puis-je obtenir l'accès à l'API Qwen ?
Vous pouvez obtenir un accès à l'API Qwen directement via Alibaba Cloud Model Studio avec une clé API DashScope, ou acheminer Qwen via Flatkey avec une clé Flatkey et https://router.flatkey.ai/v1. Le chemin direct utilise des URL de base DashScope régionales ; le chemin Flatkey regroupe Qwen dans une passerelle multi-modèles unique.
L'API Qwen est-elle compatible avec OpenAI ?
Alibaba Cloud documente une interface compatible avec OpenAI pour les modèles Qwen dans Model Studio. La migration modifie la clé API, l'URL de base et le nom du modèle. Des tests au niveau des fonctionnalités restent nécessaires pour le streaming, les outils, la sortie JSON, la vision, la recherche et tous les paramètres avancés.
Quelle est l'URL de base directe compatible avec OpenAI pour Qwen ?
Cela dépend de la région. Alibaba Cloud indique des URL de base régionales, notamment https://dashscope-us.aliyuncs.com/compatible-mode/v1 pour les États-Unis (Virginie), https://dashscope-intl.aliyuncs.com/compatible-mode/v1 pour Singapour et https://dashscope.aliyuncs.com/compatible-mode/v1 pour la Chine (Pékin).
Quelle URL de base dois-je utiliser pour Qwen via Flatkey ?
Utilisez https://router.flatkey.ai/v1 pour Qwen via Flatkey. Choisissez ensuite un identifiant de modèle Qwen actuel dans la tarification Flatkey ou dans le tableau de bord, puis testez la requête avant le trafic de production.
Puis-je utiliser le même identifiant de modèle Qwen que dans la documentation Alibaba Cloud dans Flatkey ?
Pas automatiquement. Les chaînes de modèle, les alias, la disponibilité et la prise en charge des points de terminaison peuvent varier selon le catalogue et l'itinéraire. Choisissez l'identifiant du modèle dans Flatkey le jour de vos tests et conservez-le dans la configuration.
Compatible avec OpenAI signifie-t-il une parité fonctionnelle complète ?
Non. Compatible avec OpenAI signifie généralement que les formes courantes des requêtes et des réponses fonctionnent pour les points de terminaison pris en charge. Cela ne garantit pas un comportement identique pour chaque modèle, paramètre, point de terminaison, région, mode de streaming, appel d'outil ou charge utile multimodale.
Comment dois-je budgéter Qwen via un routeur ?
Utilisez la documentation tarifaire Alibaba Cloud pour le contexte direct de Model Studio et la tarification Flatkey pour l'utilisation routée. Vérifiez ensuite le coût réel de chaque requête dans les journaux Flatkey, car les unités de modèle, de cache, de point de terminaison et de modalité peuvent différer.
Consultez les tarifs avant d’acheminer le trafic de production
L’accès à l’API Qwen via un routeur compatible OpenAI est une voie de migration pratique lorsque votre application utilise déjà des appels SDK de style OpenAI. Réduisez le changement au minimum : mettez à jour l’URL de base, utilisez une clé Flatkey, sélectionnez un modèle Qwen actuel, exécutez les tests de validation, et vérifiez l’utilisation et les tarifs avant le déploiement.
Consulter les tarifs pour confirmer les options actuelles des modèles Qwen de Flatkey et les unités de coût avant d’envoyer du trafic de production.
