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.
Présentation du modèle
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
- Après la création d'une tâche, utilisez le
task_idretourné 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 |
|
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. | |
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).
string (Required)La langue source.
string (Required)La langue cible.
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é).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.object (Optional)
Properties imageSegment bool (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).
Remarque : ce paramètre s'appelait auparavant |
Paramètres de la réponse |
Conservez le task_id afin d'interroger l'état et le résultat de la tâche. |
output objectInformations de sortie de la tâche.
Properties task_id stringID de la tâche. Valide pour les requêtes pendant 24 heures.task_status stringÉtat de la tâche.
Enumeration values
| |
request_id stringIdentifiant unique de la requête pour le suivi et le dépannage. | |
message stringMessage d'erreur détaillé. Retourné uniquement pour les requêtes ayant échoué. Consultez la section Error codes. | |
code stringCode 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}
- Le
task_idest valide pendant 24 heures. Les ID inexistants ou expirés retournent l'étatUNKNOWN. - L'
urldes tâches réussies reste valide pendant 24 heures. Téléchargez et enregistrez l'image sans tarder.
Paramètres de la requête |
Remplacez 86ecf553-d340-4e21-xxxxxxxxx par le task_id réel. |
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 |
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. |
outputobjectInformations relatives à la sortie de la tâche.
Properties task_id stringID de la tâche. Valide pour les requêtes pendant 24 heures.task_status stringÉtat de la tâche.
Enumeration values
stringHeure 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 stringHeure 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 stringHeure 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 stringURL 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 stringCode d'erreur. Retourné uniquement pour les requêtes ayant échoué. Consultez la section Error codes.messagestringInformations 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 objectStatistiques d'utilisation. Celles-ci ne sont comptabilisées que pour les tâches réussies.
Properties image_count integerNombre d'images générées (toujours égal à 1). | |
request_id stringIdentifiant 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
Exemple de code : télécharger une image sur votre machine locale



