Appelez l'endpoint GET /api/v1/models pour obtenir la liste des modèles disponibles sur Model Studio. Vous pouvez filtrer par fournisseur, type de modalité, capacité et mode de déploiement afin d'obtenir des informations telles que la tarification et la longueur du contexte.
Prérequis
Vous devez avoir créé une clé API et l'avoir configurée comme variable d'environnement DASHSCOPE_API_KEY. Pour plus d'informations, consultez Configurer une clé API dans les variables d'environnement.
Requête
Méthode HTTP : GET
URL de la requêteRemplacez {WorkspaceId} par votre ID d'espace de travail.
Région | Endpoint |
|---|---|
Singapour | |
Chine (Pékin) |
|
Chine (Hong Kong) | |
Allemagne (Francfort) |
|
Japon (Tokyo) |
|
États-Unis (Virginie) |
Définissez Authorization: Bearer {API_KEY} dans l'en-tête de la requête.
Paramètres de la requête
Tous les paramètres sont transmis via la chaîne de requête (query string).
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
providers | Array[String] | Non | Filtre par fournisseur de modèle. Valeurs valides :
Exemple : |
inference_providers | Array[String] | Non | Filtre par fournisseur d'inférence. Valeurs valides :
|
capabilities | Array[String] | Non | Filtre par type de modalité. Valeurs valides :
Exemple : |
features | Array[String] | Non | Filtre par capacité du modèle. Valeurs valides :
|
context_window | Integer | Non | Filtre par longueur de contexte. Renvoie les modèles dont la longueur de contexte est supérieure ou égale à la valeur spécifiée. Exemple : |
service_site | String | Non | Filtre par mode de déploiement. Sans ce paramètre, tous les modes de déploiement sont renvoyés. Valeurs valides :
|
supports | Array[String] | Non | Filtre par cas d'utilisation pris en charge. Valeur par défaut :
|
deployment_methods | Array[String] | Non | Filtre par méthode de déploiement. Valeurs valides :
|
deployment_ptu_service_tiers | Array[String] | Non | Filtre par type de PTU. Définissez également |
name | String | Non | Recherche approximative par nom de modèle. Exemple : |
model | String | Non | Correspondance exacte par ID de modèle. Exemple : |
language | String | Non | Langue de la réponse. Valeurs valides : |
page_no | Integer | Non | Numéro de page, à partir de 1. Valeur par défaut : |
page_size | Integer | Non | Nombre de modèles par page. Valeur par défaut : |
Paramètres de la réponse
| Paramètre | Type | Description |
|---|---|---|
request_id | String | ID de requête pour le dépannage. |
output.total | Number | Nombre total de modèles correspondants. |
output.page_no | Number | Numéro de la page actuelle. |
output.page_size | Number | Nombre d'éléments par page. |
output.models[].model | String | ID du modèle, utilisé pour spécifier le modèle lors des appels API. |
output.models[].name | String | Nom d'affichage du modèle. |
output.models[].description | String | Description du modèle. |
output.models[].provider | String | Fournisseur du modèle, par exemple |
output.models[].inference_provider | String | Fournisseur d'inférence, par exemple |
output.models[].capabilities | Array[String] | Types de modalités pris en charge par le modèle. Les valeurs correspondent à celles du paramètre de requête |
output.models[].features | Array[String] | Capacités prises en charge par le modèle. Les valeurs correspondent à celles du paramètre de requête |
output.models[].published_time | String | Date de publication du modèle au format |
output.models[].inference_metadata | Object | Informations sur les modalités d'entrée et de sortie du modèle. Contient les champs suivants :
|
output.models[].model_info | Object | Informations sur la longueur de contexte du modèle. La valeur
|
output.models[].prices | Array[Object] | Informations tarifaires. Chaque élément contient :
|
Exemples de requêtes
Exemple 1 : Lister tous les modèles de génération de textecurl "https://dashscope-intl.aliyuncs.com/api/v1/models?capabilities=TG&page_no=1&page_size=20" \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header "Content-Type: application/json"
curl "https://dashscope-intl.aliyuncs.com/api/v1/models?providers=qwen&capabilities=TG&capabilities=Reasoning&page_no=1&page_size=100" \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header "Content-Type: application/json"
Exemple de réponse
{
"code": null,
"message": null,
"success": true,
"output": {
"total": 168,
"page_no": 1,
"page_size": 10,
"models": [
{
"model": "qwen3.8-max",
"name": "Qwen3.8-Max",
"description": "The Max model in the Qwen3 series, designed for complex agent scenarios.",
"features": [
"function-calling",
"structured-outputs",
"web-search"
],
"prices": [
{
"prices": [
{
"type": "input_token",
"price": "2",
"price_unit": "per million tokens",
"price_name": "Input"
},
{
"type": "output_token",
"price": "8",
"price_unit": "per million tokens",
"price_name": "Output"
}
],
"range_name": "Default"
}
],
"published_time": "2025-11-11 12:00:00",
"inference_metadata": {
"response_modality": ["Text"],
"request_modality": ["Text"]
},
"model_info": {
"context_window": 131072,
"max_input_tokens": 130048,
"max_output_tokens": 16384,
"max_reasoning_tokens": null
}
},
{
"model": "qwen-image-3.0-pro",
"name": "Qwen-Image-3.0-Pro",
"description": "The Max model in the Qwen image generation series.",
"features": ["model-experience"],
"prices": [
{
"prices": [
{
"type": "image_number",
"price": "0.075",
"price_unit": "per image",
"price_name": "Image Generation"
}
],
"range_name": "Default"
}
],
"published_time": null,
"inference_metadata": {
"response_modality": ["Image"],
"request_modality": ["Text"]
},
"model_info": {
"context_window": null,
"max_input_tokens": null,
"max_output_tokens": null,
"max_reasoning_tokens": null
}
}
]
},
"request_id": "d5f5201f-ee7a-9e3d-8569-bc0eedec21f9"
}
Codes d'erreur
En cas d'échec de l'appel, un message d'erreur s'affiche. Pour plus d'informations sur les codes d'erreur et les solutions, consultez Messages d'erreur.
Documentation associée
- Lister les quotas de modèles
- Liste des modèles