How to call the Qwen-MT-Image translation API - Alibaba Cloud Model Studio

Qwen-MT-Image traduit avec précision le texte présent dans les images tout en préservant la mise en page d'origine. Le modèle prend également en charge les indications de domaine, le filtrage des mots sensibles et l'intervention terminologique.

ImportantLes fonctionnalités décrites dans ce document sont disponibles uniquement dans la région Chine (Pékin). Vous devez utiliser la clé API correspondant à cette région.

ImportantAlibaba Cloud Model Studio a publié un domaine spécifique à l'espace de travail pour la région Chine (Pékin) : https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com. Ce nouveau domaine dédié offre des performances supérieures et une stabilité accrue pour les requêtes d'inférence. Nous vous recommandons de migrer de https://dashscope.aliyuncs.com vers ce nouveau domaine.

{WorkspaceId} correspond à votre ID d'espace de travail, disponible sur la page Workspace Details de la console Alibaba Cloud Model Studio. Le domaine existant reste pleinement fonctionnel.

Présentation du modèle

Langue source : anglais	Japonais
Portugais	Arabe

Langue source : anglais

Japonais

Portugais

Arabe

Modèle	Description	Spécifications de l'image de sortie
qwen-mt-image	Modèle de traduction d'images Qwen. Prend en charge la traduction entre le chinois ou l'anglais et d'autres langues. La traduction directe entre deux langues ni chinoises ni anglaises (par exemple, du japonais au coréen) n'est pas prise en charge. Consultez la section Langues prises en charge.	Format d'image : JPG

Prérequis

Obtenir une clé API et exporter la clé API en tant que variable d'environnement.

HTTP

POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis, remplacez {WorkspaceId} par votre véritable ID d'espace de travail.

L'API HTTP fonctionne en mode asynchrone et comporte deux étapes :

Créer une tâche et obtenir un ID de tâche : envoyez une requête pour créer une tâche. La requête retourne un ID de tâche (task_id).
Interroger le résultat à l'aide de l'ID de tâche : interrogez régulièrement l'état de la tâche avec le task_id jusqu'à son achèvement, puis récupérez l'URL de l'image.

Étape 1 : Créer une tâche et obtenir un ID de tâche

Remarque

Après la création d'une tâche, utilisez le task_id retourné pour interroger le résultat. Le task_id reste valide pendant 24 heures. Interrogez les résultats plutôt que de créer des tâches en double.
Pour consulter un tutoriel, reportez-vous à Postman.

Paramètres de la requête

Traduction d'images

# The following URL is for the Singapore region. When calling, replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
    curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis' \
    --header 'X-DashScope-Async: enable' \
    --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
    --header 'Content-Type: application/json' \
    --data '{
        "model": "qwen-mt-image",
        "input": {
            "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250916/arpjoo/p1000391.webp",
            "source_lang": "en",
            "target_lang": "ja",
            "ext": {
                "config": {
                    "imageSegment": false
                }
            }
        }
    }'

En-têtes de la requête

Content-Type string (Required)

Type de contenu de la requête. Doit être défini à application/json.

Authorization string (Required)

Authentifie la requête à l'aide d'une clé API Model Studio. Exemple : Bearer sk-xxxx.

X-DashScope-Async string (Required)

Active le traitement asynchrone. Les requêtes HTTP ne prennent en charge que les appels asynchrones. La valeur doit être enable.

ImportantSi cet en-tête de requête est absent, l'erreur « current user api does not support synchronous calls » est retournée.

Corps de la requête

model string (Required)

Nom du modèle. Définissez cette valeur à qwen-mt-image.

input object (Required)

Objet de paramètre d'entrée contenant les champs suivants :

Properties

image_url string (Required)

URL d'image accessible publiquement (HTTP ou HTTPS).

Format : JPG, JPEG, PNG, BMP, PNM, PPM, TIFF ou WEBP
Dimensions : la largeur et la hauteur de l'image doivent être comprises entre 15 et 8 192 pixels. Le rapport d'aspect doit se situer entre 1:10 et 10:1.
Taille : 100 Mo maximum
L'URL ne doit pas contenir de caractères chinois.
Exemple : https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250916/arpjoo/p1000391.webp

source_lang string (Required)

La langue source.

Valeurs prises en charge : nom complet de la langue, code de langue ou auto (pour la détection automatique). La valeur n'est pas sensible à la casse.
Limite : doit être différente de target_lang. Au moins l'une des langues (source ou cible) doit être le chinois ou l'anglais.
Exemple : Chinese, en ou auto

target_lang string (Required)

La langue cible.

Valeurs prises en charge : nom complet de la langue ou code de langue. La valeur n'est pas sensible à la casse.
Limite : doit être différente de source_lang. Au moins l'une des langues (source ou cible) doit être le chinois ou l'anglais.
Exemple : Chinese ou en

ext object (Optional)

Champs étendus facultatifs.

Properties

domainHint string (Optional)

Indication de domaine permettant d'adapter le style de traduction à un domaine spécifique. Utilisez l'anglais pour décrire le scénario, le style et les exigences (200 mots maximum pour garantir la qualité).

ImportantLes indications de domaine ne prennent actuellement en charge que l'anglais.

Exemple : These sentences are from seller-buyer conversations on a B2C ecommerce platform. Translate them into clear, engaging customer service language, ensuring the translation is appropriate for handling potential issues or disputes.

sensitives array (Optional)

Mots sensibles à filtrer du texte de l'image avant la traduction. Le filtre effectue une correspondance exacte (sensible à la casse).

Les mots sensibles peuvent appartenir à n'importe quelle langue source ou langue cible prise en charge (50 maximum par requête pour garantir la qualité).

Exemple : ["10 % off entire store", "7-day no-questions-asked return"]

terminologies array (Optional)

Utilisez l'intervention terminologique pour définir des traductions spécifiques pour les termes propres à un domaine. Les langues des paires de termes doivent correspondre à source_lang et target_lang.

Properties

src string (Required)

Texte source du terme. La langue doit être identique à source_lang.

tgtstring (Required)

Texte cible du terme. La langue doit être identique à target_lang.

Exemple : [{"src": "Application Programming Interface", "tgt": "API"}, {"src": "Machine Learning", "tgt": "ML"}]

config object (Optional)

Properties

imageSegmentbool (Optional)

Lorsque cette option est activée, la segmentation du sujet de l'image exclut de la traduction le texte situé sur les sujets de l'image (personnes, produits, logos).

false (par défaut) : traduit tout le texte présent dans l'image.
true : ne traduit pas le texte situé sur les sujets de l'image.

Remarque : ce paramètre s'appelait auparavant skipImgSegment (indiquant s'il faut ignorer la segmentation du sujet de l'image). Pour assurer la rétrocompatibilité, ce paramètre est toujours pris en charge. Toutefois, nous recommandons d'utiliser le nouveau paramètre imageSegment.

Paramètres de la réponse

Réponse réussie

Conservez le task_id afin d'interroger l'état et le résultat de la tâche.

{
        "output": {
            "task_status": "PENDING",
            "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
        },
        "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
    }

Réponse d'erreur

Échec de la création de la tâche. Consultez la section Error codes.

{
        "code": "InvalidApiKey",
        "message": "No API-key provided.",
        "request_id": "7438d53d-6eb8-4596-8835-xxxxxx"
    }

output object

Informations de sortie de la tâche.

Properties

task_id string

ID de la tâche. Valide pour les requêtes pendant 24 heures.

task_status string

État de la tâche.

Enumeration values

PENDING
RUNNING
SUCCEEDED
FAILED
CANCELED
UNKNOWN : la tâche n'existe pas ou son état est inconnu.

request_id string

Identifiant unique de la requête pour le suivi et le dépannage.

message string

Message d'erreur détaillé. Retourné uniquement pour les requêtes ayant échoué. Consultez la section Error codes.

code string

Code d'erreur. Retourné uniquement pour les requêtes ayant échoué. Consultez la section Error codes.

Étape 2 : Interroger le résultat à l'aide de l'ID de tâche

GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id}

Remarque

Le task_id est valide pendant 24 heures. Les ID inexistants ou expirés retournent l'état UNKNOWN.
L'url des tâches réussies reste valide pendant 24 heures. Téléchargez et enregistrez l'image sans tarder.

Paramètres de la requête	Interroger le résultat de la tâche Remplacez `86ecf553-d340-4e21-xxxxxxxxx` par le task_id réel. `# The URL below is for the China (Beijing) region. Replace {WorkspaceId} with your actual workspace ID. URLs vary by region. curl -X GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxx \ --header "Authorization: Bearer $DASHSCOPE_API_KEY"`
En-têtes de la requête
Authorization `string` (Required) Authentifie la requête à l'aide d'une clé API Model Studio. Exemple : Bearer sk-xxxx.
Paramètres de chemin d'URL
task_id `string` (Required) ID de la tâche.

Paramètres de la réponse

Tâche réussie - contenu traduisible détecté

Les données de la tâche (état de la tâche et URL des images) ne sont conservées que pendant 24 heures, puis automatiquement supprimées. Enregistrez les images générées sans tarder.

{
    "request_id": "5fec62eb-bf94-91f8-b9f4-f7f758e4e27e",
    "output": {
        "task_id": "72c52225-8444-4cab-ad0c-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-08-13 18:11:16.954",
        "scheduled_time": "2025-08-13 18:11:17.003",
        "end_time": "2025-08-13 18:11:23.860",
        "image_url": "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx?Expires=xxx"
    },
    "usage": {
        "image_count":1
    }
}

Tâche réussie - aucun contenu traduisible

Si l'image ne contient aucun texte traduisible (par exemple, après la segmentation du sujet), la tâche réussit tout de même et est facturée normalement, mais retourne le message No text detected for translation.

{
        "request_id": "0ccb84aa-e034-431d-9d54-08e14fxxxxxx",
        "output": {
            "task_id": "34ec4208-97d6-498b-a390-9173f7xxxxxx",
            "task_status": "SUCCEEDED",
            "submit_time": "2026-01-12 17:56:23.625",
            "scheduled_time": "2026-01-12 17:56:23.656",
            "end_time": "2026-01-12 17:56:25.324",
            "image_url": "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.jpg?Expires=xxx",
            "message": "No text detected for translation"
        },
        "usage": {
            "image_count": 1
        }
    }

Échec de la tâche

Lorsqu'une tâche échoue, task_status prend la valeur FAILED, accompagnée d'un code et d'un message d'erreur. Consultez la section Error codes.

{
        "request_id": "daad9007-6acd-9fb3-a6bc-d55902b9c9ff",
        "output": {
            "task_id": "fe8aa114-d9f1-4f76-b598-xxxxxx",
            "task_status": "FAILED",
            "submit_time": "2025-08-20 09:54:21.911",
            "scheduled_time": "2025-08-20 09:54:21.984",
            "end_time": "2025-08-20 12:55:00.818",
            "code": "InternalError",
            "message": "xxxxxx"
        }
    }

outputobject

Informations relatives à la sortie de la tâche.

Properties

task_id string

ID de la tâche. Valide pour les requêtes pendant 24 heures.

task_status string

État de la tâche.

Enumeration values

PENDING
RUNNING
SUCCEEDED
FAILED
CANCELED
UNKNOWN : la tâche n'existe pas ou son état est inconnu.

submit_time string

Heure de soumission de la tâche. L'heure est exprimée en UTC+8 et le format est AAAA-MM-JJ HH:mm:ss.SSS.

scheduled_time string

Heure d'exécution de la tâche. L'heure est exprimée en UTC+8 et le format est AAAA-MM-JJ HH:mm:ss.SSS.

end_time string

Heure d'achèvement de la tâche. L'heure est exprimée en UTC+8 et le format est AAAA-MM-JJ HH:mm:ss.SSS.

image_url string

URL de l'image générée par le modèle (mêmes dimensions que la source, format JPG, valide pendant 24 heures). Téléchargez et enregistrez l'image sans tarder.

code string

Code d'erreur. Retourné uniquement pour les requêtes ayant échoué. Consultez la section Error codes.

messagestring

Informations détaillées sur l'échec de la requête. Pour plus d'informations, consultez la section Error messages.

Généralement non retourné pour les requêtes réussies. Retourné uniquement lorsque l'image ne contient aucun texte traduisible (par exemple, après la segmentation du sujet). La tâche réussit tout de même et est facturée normalement, en retournant le message No text detected for translation.

usage object

Statistiques d'utilisation. Celles-ci ne sont comptabilisées que pour les tâches réussies.

Properties

image_count integer

Nombre d'images générées (toujours égal à 1).

request_id string

Identifiant unique de la requête pour le suivi et le dépannage.

Langues prises en charge

Au moins l'une des langues (source ou cible) doit être le chinois ou l'anglais. La traduction directe entre d'autres paires de langues (par exemple, du japonais au coréen) n'est pas prise en charge. Définissez source_lang sur auto pour activer la détection automatique de la langue.

Langue	Code	En tant que langue source	En tant que langue cible
Chinois	zh	Supported	Supported
Anglais	en	Supported	Supported
Coréen	ko	Supported	Supported
Japonais	ja	Supported	Supported
Russe	ru	Supported	Supported
Espagnol	es	Supported	Supported
Français	fr	Supported	Supported
Portugais	pt	Supported	Supported
Italien	it	Supported	Supported
Allemand	de	Supported	Not supported
Vietnamien	vi	Supported	Supported
Malais	ms	Not supported	Supported
Thaï	th	Not supported	Supported
Indonésien	id	Not supported	Supported
Arabe	ar	Not supported	Supported

Facturation et limites de taux

Pour connaître le quota gratuit et les tarifs, consultez la section Model pricing.
Pour les limites de taux, reportez-vous à Rate limits.
La facturation s'effectue par image générée avec succès. Les appels échoués et les erreurs n'entraînent aucun frais .
Si une image ne contient aucun texte traduisible (ou aucun texte en dehors des zones de sujet après segmentation), la tâche réussit tout de même et est facturée normalement, en retournant le message No text detected for translation.

Codes d'erreur

Si l'appel du modèle échoue et retourne un message d'erreur, consultez la section Error codes pour résoudre le problème.

FAQ

Q : Pourquoi le contenu de l'image n'est-il pas traduit ?

La fonctionnalité de segmentation du sujet exclut de la traduction le texte situé sur les sujets de l'image (personnes, produits, logos). Pour traduire tout le texte présent dans l'image, définissez ext.config.imageSegment sur false.

Q : Comment convertir un lien d'image temporaire en lien permanent ?

Il n'est pas possible de convertir directement les liens temporaires en liens permanents. Téléchargez l'image via un service backend, puis importez-la dans OSS pour obtenir un lien permanent.

Exemple de code : télécharger une image sur votre machine locale

import requests

def download_and_save_image(image_url, save_path):
    try:
        response = requests.get(image_url, stream=True, timeout=300) # Set a timeout.
        response.raise_for_status() # Raise an exception if the HTTP status code is not 200.
        with open(save_path, 'wb') as f:
            for chunk in response.iter_content(chunk_size=8192):
                f.write(chunk)
        print(f"Image successfully downloaded to: {save_path}")
        # You can add the logic to upload to permanent storage here.
    except requests.exceptions.RequestException as e:
        print(f"Image download failed: {e}")

if __name__ == '__main__':
    image_url = "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx?Expires=xxx"
    save_path = "image-translation.jpg"
    download_and_save_image(image_url, save_path)

Q : Comment consulter les métriques d'invocation du modèle ?

R : Une heure après l'achèvement d'une invocation de modèle, accédez à la page Monitoring (Singapore) ou Monitoring (China (Beijing)) pour consulter des métriques telles que le nombre d'invocations et le taux de réussite. Pour plus d'informations, consultez la section Billing and cost management.

Q : Comment obtenir la liste d'autorisation de noms de domaine pour le stockage d'images ?

R : Les images générées par les modèles sont stockées dans OSS. L'API retourne une URL publique temporaire. Pour configurer une liste d'autorisation de pare-feu pour cette URL de téléchargement, notez ce qui suit : le stockage sous-jacent peut changer dynamiquement. Cette rubrique ne fournit pas de liste d'autorisation fixe de noms de domaine OSS afin d'éviter les problèmes d'accès causés par des informations obsolètes. Si vous avez des exigences en matière de contrôle de sécurité, contactez votre gestionnaire de compte pour obtenir la dernière liste de noms de domaine OSS.

Présentation du modèle

Prérequis

HTTP

Étape 1 : Créer une tâche et obtenir un ID de tâche

Paramètres de la requête

Traduction d'images

En-têtes de la requête

Corps de la requête

Paramètres de la réponse

Réponse réussie

Réponse d'erreur

Étape 2 : Interroger le résultat à l'aide de l'ID de tâche

Paramètres de la requête

Interroger le résultat de la tâche

En-têtes de la requête

Paramètres de chemin d'URL

Paramètres de la réponse

Tâche réussie - contenu traduisible détecté

Tâche réussie - aucun contenu traduisible

Échec de la tâche

Langues prises en charge

Facturation et limites de taux

Codes d'erreur

FAQ

Q : Pourquoi le contenu de l'image n'est-il pas traduit ?

Q : Comment convertir un lien d'image temporaire en lien permanent ?

Q : Comment consulter les métriques d'invocation du modèle ?

Q : Comment obtenir la liste d'autorisation de noms de domaine pour le stockage d'images ?