Skip to main content

Image Generation - Deploy Model

Publiez un modèle de génération d'images entraîné en tant que service API en ligne.

Prérequis

  • Régions prises en charge : L'API de déploiement de modèles est actuellement disponible uniquement dans la région Singapour. Si vous utilisez d'autres régions, déployez les modèles via la console Model Studio de cette région.
  • Autorisations du compte : Si vous utilisez des sous-comptes Alibaba Cloud (utilisateurs RAM), accordez au sous-compte les autorisations d'appel de modèle, d'entraînement et de déploiement.
  • Configurer les variables d'environnement : Vous avez obtenu une clé API et l'avez configurée comme variable d'environnement.
  • Prérequis : L'entraînement par affinage du modèle est terminé. Appelez d'abord l'API Query Fine-tuning Job pour confirmer que le statut status de la tâche est SUCCEEDED avant de procéder au déploiement.

Déployer un modèle

Chine (Pékin)

POST https://dashscope.aliyuncs.com/api/v1/deployments
  • Singapour
POST https://dashscope-intl.aliyuncs.com/api/v1/deployments
Pour Windows CMD, remplacez $DASHSCOPE_API_KEY par %DASHSCOPE_API_KEY% . Pour PowerShell, remplacez par $env:DASHSCOPE_API_KEY

Paramètres de requête

  • Déployer un modèle
curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/deployments' \
    --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
    --header 'Content-Type: application/json' \
    --data '{
        "model_name": "<replace with model_name>",
        "capacity": 1,
        "plan": "lora"
    }'
En-têtes
Content-Type string (Obligatoire)Valeur fixe : application/json
Authorization string (Obligatoire)Authentification par clé API, au format Bearer sk-xxxx.
Corps de la requête
model_name string (Obligatoire)ID du modèle à déployer (il ne s'agit pas du nom du modèle de base, mais de l'identifiant généré après l'affinage ou l'exportation). Méthode d'obtention :
  • Modèle affiné : Utilisez la valeur output.finetuned_output issue de la réponse de l'API Create Fine-tuning Job.
  • Modèle exporté : Utilisez la valeur output[].model_name issue de la réponse de l'API Query Exported Model Details.
capacity integer (Obligatoire)Nombre d'instances de modèle déployées. Valeur recommandée : 1.
plan string (Obligatoire)Méthode de déploiement. Valeur recommandée pour l'affinage efficace LoRA : lora.

Paramètres de réponse

  • Exemple de réponse réussie
  • Exemple de réponse d'erreur
Champs clés : output.deployed_model (identifiant unique du modèle déployé), output.status (statut du déploiement).
{
        "request_id": "96020b2e-9072-4c8a-9981-xxxxxxxxx",
        "output": {
            "deployed_model": "wan2.7-image-pro-ft-202507011122-xxxx",
            "gmt_create": "2025-07-01T10:30:00.000",
            "gmt_modified": "2025-07-01T10:30:00.000",
            "status": "PENDING",
            "model_name": "wan2.7-image-pro-ft-202507011122-xxxx",
            "base_model": "wan2.7-image-pro",
            "workspace_id": "llm-xxxxxxxxx",
            "charge_type": "post_paid",
            "creator": "12xxxxxxx",
            "modifier": "12xxxxxxx",
            "plan": "lora"
        }
    }
request_id stringIdentifiant unique de la requête.
output objectDétails de la tâche.

Propriétés

deployed_model stringIdentifiant unique du modèle déployé. Utilisé pour interroger le statut de déploiement du modèle et appeler le modèle.model_name stringNom d'identifiant du modèle.status stringStatut du déploiement :
  • PENDING : En cours de déploiement.
  • RUNNING : En cours d'exécution.
  • FAILED : Échec du déploiement.
base_model stringModèle de base utilisé.gmt_create stringHeure de création de la tâche de déploiement.gmt_modified stringHeure de mise à jour de la tâche de déploiement.workspace_id stringID de l'espace de travail associé à la clé API Alibaba Cloud Model Studio. Consultez la rubrique Obtenir l'ID de l'espace de travail.charge_type stringMode de facturation. post_paid indique le paiement à l'utilisation.creator stringID du compte Alibaba Cloud du créateur.modifier stringID du compte Alibaba Cloud de la personne ayant effectué la modification.plan stringMéthode de déploiement.
code stringCode d'erreur. Renvoyé en cas d'échec de l'appel.
message stringDescription détaillée de l'erreur. Renvoyée en cas d'échec de l'appel.

Étape suivante

Le déploiement est une opération asynchrone. Après avoir appelé cette API, interrogez le statut du déploiement via l'API Query and Manage Deployments.