Migrez votre application Anthropic vers Model Studio en modifiant trois paramètres. Cette rubrique détaille les paramètres de requête et de réponse, avec des exemples de code.
api_key: Remplacez cette valeur par la clé API Model Studio.base_url: Utilisez un endpoint Model Studio listé ci-dessous.model: Spécifiez le nom d'un modèle pris en charge, tel queqwen3.7-plus.
- Singapore
- China (Beijing)
- Germany (Frankfurt)
- US (Virginia)
- Japan (Tokyo)
base_url :https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropicURL de requête HTTP :POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic/v1/messages{WorkspaceId} par votre ID d'espace de travail.
Authentification : Transmettez votre clé API Model Studio via l'en-tête x-api-key ou Authorization: Bearer.
Corps de la requête |
Python |
model string (Obligatoire)Nom du modèle. Modèles pris en charge :
Modèles pris en charge Qwen-Max : qwen4-max, qwen3.8-max, qwen3.7-max, qwen3.7-max-2026-05-20, qwen3.7-max-2026-06-08Qwen-Plus : qwen3.7-plus, qwen3.7-plus-2026-05-26, qwen3.6-plus, qwen3.6-plus-2026-04-02, qwen3.5-plus, qwen3.5-plus-2026-04-20, qwen3.5-plus-2026-02-15, qwen-plus, qwen-plus-latestQwen-Flash : qwen3.7-flash, qwen3.7-flash-2026-07-15, qwen3.6-flash, qwen3.6-flash-2026-04-16, qwen3.5-flash, qwen3.5-flash-2026-02-23, qwen-flash, qwen-flash-2025-07-28Qwen-Coder : qwen3-coder-flashQwen-VL : qwen3-vl-plusModèles open source Qwen : qwen3.6-27b, qwen3.5-397b-a17b, qwen3.5-122b-a10b, qwen3.5-27b, qwen3.5-35b-a3bModèles tiersdeepseek-v4-pro, deepseek-v4-flash-0731, kimi-k3.1-pro, kimi-k2.7-code, kimi-k2.6, kimi-k2.5, glm-5.2, glm-5.1, glm-5, MiniMax-M2.5, deepseek-v4.1-flash-1017 | |
max_tokens integer (Obligatoire)
| |
system string or array (Facultatif)Prompt système définissant le comportement du modèle. system est un paramètre de niveau supérieur ; le tableau messages n'accepte pas le rôle system.Une chaîne équivaut à un seul bloc type="text". Transmettez un tableau pour marquer des points d'arrêt de mise en cache du prompt.
Propriétés type string (Obligatoire)Valeur fixe : text.text string (Obligatoire)Texte du prompt système.cache_control object (Facultatif)Point d'arrêt de mise en cache du prompt. En cas de succès du cache, les requêtes suivantes sont facturées au tarif de lecture du cache. Contient uniquement type, fixé à ephemeral.
Propriétés (Qwen4) Pris en charge uniquement par qwen4-max. Les marqueurs des blocs Qwen4 acceptent aussi ttl : 5m ou 1h, par défaut 5m. Voir Cache explicite (Qwen4).type string (Obligatoire)ephemeralttl string (Facultatif)TTL du cache. Accepte 5m et 1h ; valeur par défaut : 5m. | |
messages array (Obligatoire)Tableau des messages, organisé en tours alternés user/assistant.
Élément du tableau messages role string (Obligatoire)Rôle du message. Valeurs valides : user, assistant.content string or array (Obligatoire)Chaîne de texte brut ou tableau de contenu structuré. Une chaîne équivaut à un seul bloc content avec type="text".
Types d'éléments du tableau content
thinking (qwen4-max) type stringthinkingthinking stringsignature stringRésumé du raisonnement et signature chiffrée. Renvoyez le bloc thinking complet sans modification dans les requêtes suivantes.
Propriétés type string (Obligatoire)Valeur fixe : text.text string (Obligatoire)Contenu textuel.cache_control object (Facultatif)Point d'arrêt de mise en cache du prompt. Contient uniquement type, fixé à ephemeral.
Propriétés (Qwen4) Pris en charge uniquement par qwen4-max. Les marqueurs des blocs Qwen4 acceptent aussi ttl : 5m ou 1h, par défaut 5m. Voir Cache explicite (Qwen4).type string (Obligatoire)ephemeralttl string (Facultatif)TTL du cache. Accepte 5m et 1h ; valeur par défaut : 5m.
Propriétés type string (Obligatoire)Valeur fixe : image.source object (Obligatoire)Source des données de l'image.
Propriétés type string (Obligatoire)Valeurs valides : url (URL d'image publique), base64 (encodé en Base64).url stringURL publique de l'image. Obligatoire lorsque type est url.media_type stringType MIME de l'image, par exemple image/jpeg. Obligatoire lorsque type est base64.data stringDonnées de l'image encodées en Base64. Obligatoire lorsque type est base64.
Propriétés type string (Obligatoire)Valeur fixe : video.source object (Obligatoire)Source des données vidéo.
Propriétés type string (Obligatoire)Valeurs valides : url (URL vidéo publique), base64 (encodé en Base64).url stringURL publique de la vidéo. Obligatoire lorsque type est url.media_type stringType MIME de la vidéo, par exemple video/mp4. Obligatoire lorsque type est base64.data stringDonnées vidéo encodées en Base64. Obligatoire lorsque type est base64.
Propriétés type string (Obligatoire)Valeur fixe : document.source object (Obligatoire)La source du document PDF contient les champs suivants :
Propriétés type string (Obligatoire)Valeur fixe : tool_use.id string (Obligatoire)Identifiant unique de l'appel d'outil, utilisé pour associer le résultat dans un tool_result ultérieur.name string (Obligatoire)Nom de l'outil appelé.input object (Obligatoire)Paramètres d'entrée de l'appel d'outil. La structure dépend du input_schema de l'outil correspondant dans tools.cache_control object (Facultatif)Point d'arrêt de mise en cache du prompt. Contient uniquement type, fixé à ephemeral. Le contenu de l'appel d'outil participe au préfixe du cache.
Propriétés (Qwen4) Pris en charge uniquement par qwen4-max. Les marqueurs des blocs Qwen4 acceptent aussi ttl : 5m ou 1h, par défaut 5m. Voir Cache explicite (Qwen4).type string (Obligatoire)ephemeralttl string (Facultatif)TTL du cache. Accepte 5m et 1h ; valeur par défaut : 5m.
Propriétés type string (Obligatoire)Valeur fixe : tool_result.tool_use_id string (Obligatoire)Correspond à l'id du bloc tool_use.content string (Obligatoire)Contenu renvoyé par l'outil.cache_control object (Facultatif)Point d'arrêt de mise en cache du prompt. Contient uniquement type, fixé à ephemeral.
Propriétés (Qwen4) Pris en charge uniquement par qwen4-max. Les marqueurs des blocs Qwen4 acceptent aussi ttl : 5m ou 1h, par défaut 5m. Voir Cache explicite (Qwen4).type string (Obligatoire)ephemeralttl string (Facultatif)TTL du cache. Accepte 5m et 1h ; valeur par défaut : 5m. | |
cache_control object (Facultatif)Pris en charge uniquement par qwen4-max. Active le cache automatique à la racine ; des points manuels peuvent aussi être définis sur les blocs de contenu. type est fixé à ephemeral. Transmettez les paramètres non standard à la racine via extra_body dans le SDK Python, ou directement dans le SDK Node.js et curl. Voir Cache explicite (Qwen4).
Propriétés type string (Obligatoire)ephemeralttl string (Facultatif)TTL du cache. Accepte 5m et 1h ; valeur par défaut : 5m.boolean (Facultatif)Active ou désactive le streaming. Valeur par défaut : false. | |
temperature number (Facultatif)Contrôle la diversité du texte généré. Plage de valeurs : [0, 2). Des valeurs plus élevées produisent des résultats plus aléatoires.Cette plage diffère de la plage officielle d'Anthropic ([0,0, 1,0]). Lors d'une migration depuis Anthropic, vérifiez la valeur de ce paramètre. | |
top_p number (Facultatif)Seuil de probabilité pour l'échantillonnage par noyau.
| |
top_k integer (Facultatif)Taille de l'ensemble de candidats lors de l'échantillonnage. | |
stop_sequences array (Facultatif)Séquences de texte déclenchant l'arrêt de la génération. La sortie se termine avant la séquence correspondante.Après une correspondance, stop_reason dans la réponse conserve la valeur end_turn, et la réponse n'inclut pas la séquence détectée. | |
thinking object (Facultatif)kimi-k3.1-pro active la réflexion par défaut.Configuration de la réflexion étendue. Lorsqu'elle est activée, le modèle raisonne avant de répondre et la réponse inclut des blocs de contenu de type thinking. Tous les modèles ne prennent pas en charge le mode réflexion.
Propriétés type string (Obligatoire)Valeurs valides : enabled (activer le mode réflexion), disabled (désactiver le mode réflexion).budget_tokens integer (Facultatif)Nombre maximal de tokens pour le processus de réflexion. La relation avec max_tokens dépend du modèle ; consultez la description du paramètre max_tokens. Un budget plus élevé permet une analyse plus approfondie des questions complexes. Prend effet lorsque type est enabled.display string (facultatif)qwen4-max: "summarized". Résumé et chiffrement du raisonnement.Par défaut, le raisonnement complet est renvoyé. Après activation, le raisonnement original n’est plus renvoyé en clair : le résumé sert à l’affichage et le contenu chiffré à restaurer l’historique. | |
tools array (Facultatif)Définitions d'outils pour l'appel de fonction.
Élément du tableau tools name string (Obligatoire)Nom de l'outil.description string (Facultatif)Description de la fonction de l'outil.input_schema object (Obligatoire)Définition JSON Schema des paramètres d'entrée de l'outil.kimi-k3.1-pro (déployé sur Alibaba Cloud Model Studio) prend en charge web_search et web_fetch à Pékin, Singapour, aux États-Unis (Virginie), en Allemagne (Francfort), au Japon (Tokyo) et en Chine (Hong Kong).deepseek-v4.1-flash-1017 prend en charge les outils de recherche web web_search et de récupération de pages web web_fetch. Pour les exigences et les exemples de requêtes compatibles Anthropic, consultez Extracteur web. | |
qwen4-max: web_search, web_fetch.Ajoutez l'outil nommé web_fetch à tools et incluez l'outil nommé web_search dans la même requête. Le point de terminaison est https://{WorkspaceId}.{region}.maas.aliyuncs.com/apps/anthropic.
web_fetch (qwen4-max) type stringweb_fetch_20250910name stringweb_fetchmax_uses integerobject (Facultatif)Stratégie de sélection d'outil :
| |
output_config object (Facultatif)
Propriétés effort string (Facultatif)qwen4-maxValeurs prises en charge : low, high (par défaut) et xhigh.medium est associé à high ; max est associé à xhigh.Contrôle l'intensité d'inférence des modèles. Les valeurs valides et les valeurs par défaut varient selon le modèle. Valeur par défaut : max.Pour kimi-k3.1-pro (déployé sur Alibaba Cloud Model Studio), la valeur par défaut est max. Les valeurs prises en charge sont max (raisonnement approfondi), high (raisonnement renforcé), medium (raisonnement modéré) et low (raisonnement léger).Valeurs valides :
xhigh. Les valeurs valides sont xhigh, medium et low ; max et high sont mappés sur xhigh.Modèles pris en charge : qwen3.8-max/qwen3.8-flash, glm-5.2 et deepseek-v4-pro.format object (Facultatif)Configuration des sorties structurées. Lorsqu'elle est activée, le modèle renvoie une chaîne JSON. Le comportement varie selon le modèle :
Propriétés type string (Obligatoire)Valeur fixe : json_schema.schema object (Obligatoire)Objet JSON Schema conforme à la spécification standard. Doit inclure type (type de données), properties (définitions des champs), required (tableau des noms de champs obligatoires) et additionalProperties (doit être défini sur false). |
Réponse non-streaming | Exemple de réponseL’exemple de réponse suivant utilise qwen3.8-max pour illustrer les champs de réponse. | |||||||||||||||||||||||||||||||||||||||||||||||
id stringIdentifiant unique du message. | ||||||||||||||||||||||||||||||||||||||||||||||||
type stringValeur fixe : message. | ||||||||||||||||||||||||||||||||||||||||||||||||
role stringValeur fixe : assistant. | ||||||||||||||||||||||||||||||||||||||||||||||||
model stringModèle utilisé pour la génération. | ||||||||||||||||||||||||||||||||||||||||||||||||
content arrayTableau de contenu.
Types d'éléments du tableau content Texte
Propriétés type stringValeur fixe : text.text stringRéponse textuelle générée par le modèle.
Propriétés type stringValeur fixe : thinking.thinking stringRaisonnement du modèle avant la réponse finale.signature stringqwen4-max, thinking.display="summarized": Un bloc thinking d’Anthropic Messages contient le résumé thinking et la signature chiffrée. Le streaming transmet thinking_delta, puis un signature_delta complet ; texte et outils suivent la fermeture du bloc. La signature peut être vide si le chiffrement échoue ou sans raisonnement.thinking.display != "summarized": Actuellement fixée à une chaîne vide.
Propriétés type stringValeur fixe : tool_use.id stringIdentifiant unique de l'appel d'outil, utilisé pour faire correspondre le tool_result.name stringNom de l'outil appelé.input objectParamètres d'entrée de l'appel d'outil.web_fetch_tool_result)
Résultat de récupération web
| ||||||||||||||||||||||||||||||||||||||||||||||||
stop_reason stringRaison de l'arrêt de la génération. Valeurs valides : end_turn (achèvement normal), max_tokens (limite de tokens atteinte), tool_use (appel d'outil). | ||||||||||||||||||||||||||||||||||||||||||||||||
stop_sequence stringToujours null. | ||||||||||||||||||||||||||||||||||||||||||||||||
usage objectStatistiques d'utilisation des tokens.Dans les appels en streaming, le champ usage de l'événement message_start contient uniquement input_tokens et output_tokens. Les quatre champs complets sont renvoyés dans l'événement message_delta.
Propriétés input_tokens integerTokens d'entrée.output_tokens integerTokens de sortie.cache_creation_input_tokens integerTokens consommés pour la création du cache.cache_read_input_tokens integerTokens consommés par les lectures du cache.server_tool_use object
server_tool_use web_search_requests integerNombre de requêtes de recherche web.web_fetch_requests integerNombre de requêtes de récupération de pages web.
Propriétés (Qwen4) Voir Cache explicite (Qwen4).input_tokens integerUniquement les tokens d’entrée qui ne sont ni lus depuis le cache ni écrits dans le cache. Le total est la somme de ce champ, des lectures et des créations de cache.output_tokens integerTokens de sortie.cache_creation_input_tokens integerTokens consommés pour la création du cache.cache_read_input_tokens integerTokens consommés par les lectures du cache.server_tool_use object
server_tool_use web_search_requests integerNombre de requêtes de recherche web.web_fetch_requests integerNombre de requêtes de récupération de pages web.objectDétails de création du cache par TTL. La somme des tokens des deux TTL correspond au total écrit dans le cache pour cette requête.
Propriétés ephemeral_5m_input_tokens integerTokens écrits dans un cache de 5 minutes.ephemeral_1h_input_tokens integerTokens écrits dans un cache d’une heure.objectDétails de lecture du cache. cached_tokens est égal à cache_read_input_tokens ; ne cumulez pas ces valeurs.
Propriétés cached_tokens integerTokens d’entrée lus depuis le cache. |
Réponse en streaming | Exemple de réponse en streamingL’exemple de réponse suivant utilise qwen3.8-max pour illustrer les champs de réponse. |
message_startPremier événement du flux, marque le début du message.
Propriétés type stringValeur fixe : message_start.message objectObjet message initial. content est un tableau vide, et usage contient uniquement input_tokens et output_tokens. | |
content_block_startMarque le début d'un bloc de contenu.
Propriétés type stringValeur fixe : content_block_start.index integerIndex basé sur 0 correspondant à la position dans le tableau content.content_block objectObjet initial du bloc de contenu. La valeur de type est text, thinking ou tool_use, server_tool_use, web_search_tool_result, web_fetch_tool_result. Pour le type tool_use, le champ input est un objet vide dans cet événement, et les paramètres d'entrée complets sont assemblés à partir des deltas content_block_delta suivants. | |
content_block_deltaMise à jour incrémentielle du bloc de contenu. Plusieurs deltas sont envoyés par bloc.
Propriétés type stringValeur fixe : content_block_delta.index integerIndex du bloc de contenu associé.delta objectObjet delta. Valeurs de type :
| |
content_block_stopMarque la fin d'un bloc de contenu.
Propriétés type stringValeur fixe : content_block_stop.index integerIndex du bloc de contenu terminé. | |
message_deltaEnvoyé après la fin de tous les blocs de contenu. Contient la raison d'arrêt et l'utilisation finale des tokens.
Propriétés type stringValeur fixe : message_delta.delta objectContient stop_reason et stop_sequence. Pour les valeurs valides, reportez-vous au tableau Réponse non-streaming ci-dessus.usage objectStatistiques complètes d'utilisation des tokens, incluant input_tokens, output_tokens, cache_creation_input_tokens et cache_read_input_tokens. | |
message_stopDernier événement, marque la fin du message.
Propriétés type stringValeur fixe : message_stop.De plus, les réponses en streaming envoient périodiquement des événements ping ({"type":"ping"}) pour maintenir la connexion active. Les clients peuvent les ignorer. |
FAQ
Après avoir configuré Claude Desktop ou Claude Code, le test de connexion échoue avecModel discovery — Gateway /v1/models returned HTTP 404, ou l'URL de requête contient/v1/v1/models. Comment résoudre ce problème ?
La fonctionnalité de découverte de modèles des clients tels que Claude Desktop et Claude Code ajoute automatiquement /v1/models à l'URL de base configurée. Vérifiez les deux points suivants :
- Ne terminez pas l'URL de base par/v1/ : elle doit se terminer par
/apps/anthropic(par exemple, pour Chine (Pékin), utilisezhttps://dashscope.aliyuncs.com/apps/anthropic; consultez les informations d'endpoint ci-dessus pour les autres régions). Si vous saisissez par erreur.../apps/anthropic/v1/, le client ajoute/v1/modelset produit le chemin dupliqué/v1/v1/models, ce qui renvoie une erreur HTTP 404. Par conséquent, si vous obtenez une erreur 404, vérifiez d'abord si l'URL de requête réelle contient un doublon/v1/v1/; le cas échéant, supprimez le/v1/final de l'URL de base. - Ajoutez manuellement des modèles pour ignorer la découverte : L'endpoint compatible Anthropic de Model Studio fournit uniquement l'API Messages (
/v1/messages) et ne propose pas d'endpoint de liste de modèles (/v1/models), de sorte que la requête de découverte de modèles renvoie également une erreur 404. Ajoutez manuellement des modèles (par exemple,qwen3.7-plus) sous Models dans le client pour contourner la découverte automatique.