Paramètres d’entrée et de sortie des appels à Qwen-MT via l’interface compatible OpenAI ou l’API DashScope.
Références : Traduction automatique (Qwen-MT)
Compatibilité OpenAI
- Région Singapour
- Région Virginie
- Région Pékin
base_url pour le SDK : https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1Endpoint HTTP : POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completionsCommencez par créer une clé API et la configurer comme variable d’environnement. Si vous utilisez le SDK OpenAI, installez-le.
Corps de la requête |
|
model string (Obligatoire) Nom du modèle. Valeurs prises en charge : qwen-mt-plus, qwen-mt-flash, qwen-mt-lite. | |
messages array (Obligatoire)Tableau de messages fournissant le contexte au modèle. Seuls les messages utilisateur sont pris en charge.
Type de message Message utilisateur object (Obligatoire)Message utilisateur contenant la phrase à traduire.
Propriétés content string (Obligatoire)Phrase à traduire.role string (Obligatoire)Rôle du message utilisateur. Doit être défini sur user. | |
stream boolean (Facultatif) Valeur par défaut : false. Active la sortie en streaming. Valeurs possibles :
qwen-mt-flash et qwen-mt-lite renvoient les données de manière incrémentale : chaque fragment contient uniquement le nouveau contenu. qwen-mt-plus les renvoie de manière non incrémentale : chaque fragment contient toute la séquence générée jusqu’à cet instant. Ce comportement ne peut pas être modifié. Exemple : II didnI didn'tI didn't laughI didn't laugh after... | |
stream_options object (Facultatif)Éléments de configuration pour la sortie en streaming. Ce paramètre n'est pris en compte que lorsque stream est défini sur true.
Propriétés include_usage boolean (Facultatif) La valeur par défaut est false.Inclut les informations de consommation de tokens dans le dernier fragment de données.Valeurs valides :
| |
max_tokens integer (Facultatif) Nombre maximal de tokens à générer. Si la sortie dépasse cette valeur, la réponse est tronquée. La valeur par défaut et la valeur maximale correspondent à la longueur de sortie maximale du modèle. Pour en savoir plus, consultez Sélection des modèles. | |
seed integer (Facultatif) Graine aléatoire permettant de reproduire les résultats. Avec la même valeur de seed et les mêmes paramètres, les sorties sont cohérentes. Plage de valeurs : [0, 2 31 -1]. | |
temperature float (Facultatif) Valeur par défaut : 0.65. Température d’échantillonnage contrôlant la diversité du texte généré. Une valeur élevée augmente la diversité ; une valeur faible produit un texte plus déterministe. Plage de valeurs : [0, 2). temperature et top_p contrôlent tous deux la diversité du texte : ne définissez que l’un des deux. | |
top_p float (Facultatif) Valeur par défaut : 0.8. Seuil de probabilité de l’échantillonnage par noyau contrôlant la diversité du texte généré. Une valeur élevée augmente la diversité ; une valeur faible produit un texte plus déterministe. Plage de valeurs : (0, 1.0]. temperature et top_p contrôlent tous deux la diversité du texte : ne définissez que l’un des deux. | |
top_k integer (Facultatif) Valeur par défaut : 1. Taille de l’ensemble des candidats à l’échantillonnage pendant la génération. Par exemple, la valeur 50 limite l’échantillonnage aux 50 tokens les mieux notés. Une valeur élevée augmente le caractère aléatoire ; une valeur faible rend la sortie plus déterministe. Si la valeur est None ou supérieure à 100, top_k est désactivé et seul top_p s’applique. La valeur doit être supérieure ou égale à 0. Ce paramètre n’appartient pas au standard OpenAI. SDK Python : placez-le dans l’objet extra_body extra_body={"top_k": xxx}. SDK Node.js ou appels HTTP : transmettez-le comme paramètre de premier niveau. | |
repetition_penalty float (Facultatif) Valeur par défaut : 1.0. Pénalité appliquée aux répétitions dans les séquences consécutives. Une valeur élevée réduit les répétitions. La valeur 1.0 n’applique aucune pénalité. La valeur doit être supérieure à 0, sans limite supérieure stricte. Ce paramètre n’appartient pas au standard OpenAI. SDK Python : placez-le dans l’objet extra_body extra_body={"repetition_penalty": xxx}. SDK Node.js ou appels HTTP : transmettez-le comme paramètre de premier niveau. | |
translation_options object (Obligatoire)Paramètres de traduction.
Propriétés source_lang string (Obligatoire)Nom complet en anglais de la langue source. Pour plus d'informations, consultez Langues prises en charge. Si vous définissez cette valeur sur auto, le modèle détecte automatiquement la langue d'entrée.target_lang string (Obligatoire)Nom complet en anglais de la langue cible. Pour plus d'informations, consultez Langues prises en charge.terms arrays (Facultatif)Tableau de termes à définir lors de l'utilisation de la fonctionnalité Intervention terminologique.
Propriétés source string (Obligatoire)Terme dans la langue source.target string (Obligatoire)Terme dans la langue cible.arrays (Facultatif)Tableau de mémoires de traduction à définir lors de l'utilisation de la fonctionnalité Mémoire de traduction.
Propriétés source string (Obligatoire)Phrase dans la langue source.target string (Obligatoire)Phrase dans la langue cible.string (Facultatif)Prompt de domaine à définir lors de l'utilisation de la fonctionnalité Prompting par domaine.Les prompts de domaine doivent être rédigés en anglais. extra_body={"translation_options": xxx}. SDK Node.js ou appels HTTP : transmettez-le comme paramètre de niveau supérieur. |
Objet de réponse Chat (sortie sans streaming) | |
id string Identifiant unique de la requête. | |
choices arrayTableau du contenu généré par le modèle.
Propriétés finish_reason stringRaison pour laquelle le modèle a interrompu la génération.Valeurs possibles :
integerIndex de l'objet courant dans le tableau choices.message objectMessage de sortie du modèle.
Propriétés content stringRésultat de la traduction.refusal stringActuellement fixé à null.role stringRôle du message. Cette valeur est toujours assistant.audio objectActuellement fixé à null.function_call objectActuellement fixé à null.tool_calls arrayActuellement fixé à null. | |
created integer Horodatage UNIX de création de la requête. | |
model string Modèle utilisé pour la requête. | |
object string La valeur est toujours chat.completion. | |
service_tier string Valeur actuellement fixée à null. | |
system_fingerprint string Valeur actuellement fixée à null. | |
usage objectConsommation de tokens pour cette requête.
Propriétés completion_tokens integerNombre de tokens présents dans la sortie du modèle.prompt_tokens integerNombre de tokens en entrée.total_tokens integerTotal des tokens consommés, soit prompt_tokens + completion_tokens.completion_tokens_details objectActuellement fixé à null.prompt_tokens_details objectActuellement fixé à null. |
Objet de fragment de réponse Chat (sortie en streaming) | |
id string Identifiant unique de l’appel. Tous les fragments portent le même identifiant. | |
choices arrayTableau du contenu généré par le modèle. Si include_usage est défini sur true, ce tableau est vide dans le dernier fragment.
Propriétés delta objectContenu de sortie renvoyé en mode streaming.
Propriétés content stringRésultat de la traduction. qwen-mt-flash et qwen-mt-lite fournissent des mises à jour incrémentielles, tandis que qwen-mt-plus fournit des mises à jour non incrémentielles.function_call objectActuellement fixé à null.refusal objectActuellement fixé à null.role stringRôle de l'objet message. Ce champ n'est renseigné que dans le premier fragment.stringLe modèle cesse de générer du contenu pour l'une des trois raisons suivantes :
integerIndex de la réponse courante dans le tableau choices. | |
created integer Horodatage UNIX de création de la requête. Tous les fragments portent le même horodatage. | |
model string Modèle utilisé pour la requête. | |
object string La valeur est toujours chat.completion.chunk. | |
service_tier string Valeur actuellement fixée à null. | |
system_fingerprint string Valeur actuellement fixée à null. | |
usage objectTokens consommés par la requête. Cet objet n'est renvoyé dans le dernier fragment que si include_usage vaut true.
Propriétés completion_tokens integerNombre de tokens dans la sortie du modèle.prompt_tokens integerNombre de tokens d'entrée.total_tokens integerNombre total de tokens consommés. Il correspond à la somme de prompt_tokens et de completion_tokens.completion_tokens_details objectActuellement fixé à null.prompt_tokens_details objectActuellement fixé à null. |
DashScope
- Singapore
- Virginie
- Beijing
Endpoint HTTP :
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generationConfiguration de la région pour les appels SDK :- Code Python
- Code Java
Vous devez créer une clé API et l’exporter comme variable d’environnement. Si vous utilisez le SDK DashScope, installez-le.
Corps de la requête |
|
model string (Obligatoire) Nom du modèle. Valeurs prises en charge : qwen-mt-plus, qwen-mt-flash, qwen-mt-lite. | |
messages array (Obligatoire)Tableau de messages fournissant le contexte au modèle. Seuls les messages utilisateur sont pris en charge.
Type de message Message utilisateur object (Obligatoire)Message utilisateur contenant la phrase à traduire.
Propriétés content string (Obligatoire)Phrase à traduire.role string (Obligatoire)Rôle du message utilisateur. Doit être défini sur user. | |
max_tokens integer (Facultatif) Nombre maximal de tokens à générer. Si la sortie dépasse cette valeur, la réponse est tronquée. La valeur par défaut et la valeur maximale correspondent à la longueur de sortie maximale du modèle. Pour en savoir plus, consultez Sélection des modèles.Dans le SDK Java, ce paramètre se nomme maxTokens. Pour les appels HTTP, placez max_tokens dans l’objet parameters. | |
seed integer (Facultatif) Graine aléatoire permettant de reproduire les résultats. Avec la même valeur de seed et les mêmes paramètres, les sorties sont cohérentes. Plage de valeurs : [0, 2 31 -1].Pour les appels HTTP, placez seed dans l’objet parameters. | |
temperature float (Facultatif) Valeur par défaut : 0.65. Température d’échantillonnage contrôlant la diversité du texte généré. Une valeur élevée augmente la diversité ; une valeur faible produit un texte plus déterministe. Plage de valeurs : [0, 2). temperature et top_p contrôlent tous deux la diversité du texte : ne définissez que l’un des deux.Pour les appels HTTP, placez temperature dans l’objet parameters. | |
top_p float (Facultatif) Valeur par défaut : 0.8. Seuil de probabilité de l’échantillonnage par noyau contrôlant la diversité du texte généré. Une valeur élevée augmente la diversité ; une valeur faible produit un texte plus déterministe. Plage de valeurs : (0, 1.0]. temperature et top_p contrôlent tous deux la diversité du texte : ne définissez que l’un des deux.Dans le SDK Java, le paramètre indiqué est topPparameters. | |
repetition_penalty float (Facultatif) Valeur par défaut : 1.0. Pénalité appliquée aux répétitions dans les séquences consécutives. Une valeur élevée réduit les répétitions. La valeur 1.0 n’applique aucune pénalité. La valeur doit être supérieure à 0, sans limite supérieure stricte.Dans le SDK Java, ce paramètre se nomme repetitionPenalty. Pour les appels HTTP, ajoutez repetition_penalty à l’objet parameters. | |
top_k integer (Facultatif) Valeur par défaut : 1. Taille de l’ensemble des candidats à l’échantillonnage pendant la génération. Par exemple, la valeur 50 limite l’échantillonnage aux 50 tokens les mieux notés. Une valeur élevée augmente le caractère aléatoire ; une valeur faible rend la sortie plus déterministe. Si la valeur est None ou supérieure à 100, top_k est désactivé et seul top_p s’applique. La valeur doit être supérieure ou égale à 0.Dans le SDK Java, ce paramètre se nomme topK. Pour les appels HTTP, placez top_k dans l’objet parameters. | |
stream boolean (Facultatif) Active la sortie en streaming. Valeurs possibles :
qwen-mt-flash et qwen-mt-lite renvoient les données de manière incrémentale : chaque fragment contient uniquement le nouveau contenu. qwen-mt-plus les renvoie de manière non incrémentale : chaque fragment contient toute la séquence générée jusqu’à cet instant. Ce comportement ne peut pas être modifié. Exemple : II didnI didn'tI didn't laughI didn't laugh after... Ce paramètre est pris en charge uniquement par le SDK Python. Pour activer le streaming avec le SDK Java, appelez l’interface | |
translation_options object (Obligatoire)Paramètres de traduction.
Propriétés source_lang string (Obligatoire)Nom complet en anglais de la langue source. Pour plus d'informations, consultez Langues prises en charge. Si vous définissez cette valeur sur auto, le modèle détecte automatiquement la langue d'entrée.target_lang string (Obligatoire)Nom complet en anglais de la langue cible. Pour plus d'informations, consultez Langues prises en charge.terms arrays (Facultatif)Tableau de termes à définir lors de l'utilisation de la fonctionnalité Intervention terminologique.
Propriétés source string (Obligatoire)Terme dans la langue source.target string (Obligatoire)Terme dans la langue cible.arrays (Facultatif)Tableau de mémoires de traduction à définir lors de l'utilisation de la fonctionnalité Mémoire de traduction.
Propriétés source string (Obligatoire)Phrase dans la langue source.target string (Obligatoire)Phrase dans la langue cible.string (Facultatif)Prompt de domaine à définir lors de l'utilisation de la fonctionnalité Prompting par domaine.Les prompts de domaine doivent être rédigés en anglais.
Dans le SDK Java, ce paramètre se nomme |
Objet de réponse Chat (identique avec et sans streaming) | |
status_code string Code d’état de la requête. 200 indique une réussite ; les autres valeurs indiquent un échec.Le SDK Java ne renvoie pas ce paramètre. Si l’appel échoue, une exception est levée. Son message contient les valeurs de status_code et de message. | |
request_id string Identifiant unique de la requête.Dans le SDK Java, le paramètre renvoyé se nomme requestId. | |
code string Code d’erreur. Vide en cas de réussite.Seul le SDK Python renvoie ce paramètre. | |
output objectRésultat de l'appel.
Propriétés text stringActuellement fixé à null.finish_reason stringRaison pour laquelle le modèle a cessé de générer du contenu. Valeurs valides :
arraySortie du modèle.
Propriétés finish_reason stringValeurs valides :
objectMessage de sortie du modèle.
Propriétés role stringRôle du message de sortie. Fixé à assistant.content stringRésultat de la traduction.stringModèle utilisé pour cette requête. | |
usage objectConsommation de tokens pour la requête.
Propriétés input_tokens integerNombre de tokens en entrée.output_tokens integerNombre de tokens en sortie.total_tokens integerTotal des tokens, correspondant à la somme de input_tokens et output_tokens. |