Le modèle d'embedding de texte généraliste convertit des données textuelles en vecteurs numériques. Ces vecteurs alimentent ensuite des tâches en aval telles que la recherche sémantique, la recommandation, le clustering et la classification.
Présentation des modèles
- Singapour
- Chine (Pékin)
- Chine (Hong Kong)
| Modèle | Dimensions de l'embedding | Nombre maximal de lignes | Nombre maximal de tokens par ligne(Remarque) | Tarif (pour 1 M de tokens en entrée) | Langues prises en charge | Quota gratuit(Remarque) |
|---|---|---|---|---|---|---|
| qwen3.7-text-embedding | 2 560, 2 048, 1 536, 1 024 (par défaut), 768, 512, 256 | 20 | 128 000 | 0,07 $ | Chinois, anglais, espagnol, français, portugais, indonésien, japonais, coréen, allemand, russe, ainsi que plus de 200 autres langues et dialectes majeurs | 1 million de tokensValidité : 90 jours après l'activation de Model Studio |
text-embedding-v4Fait partie de la série Qwen3-Embedding | 2 048, 1 536, 1 024 (par défaut), 768, 512, 256, 128, 64 | 10 | 8 192 | 0,07 $ | Chinois, anglais, espagnol, français, portugais, indonésien, japonais, coréen, allemand, russe, ainsi que plus de 100 autres langues majeures | 1 million de tokensValidité : 90 jours après l'activation de Model Studio |
| text-embedding-v3 | 1 024 (par défaut), 768, 512 | Chinois, anglais, espagnol, français, portugais, indonésien, japonais, coréen, allemand, russe, ainsi que plus de 50 autres langues majeures | 500 000 tokensValidité : 90 jours après l'activation de Model Studio |
Prérequis
Les utilisateurs familiers de l'écosystème OpenAI peuvent utiliser l'API compatible OpenAI pour une migration rapide. L'API DashScope offre quant à elle des fonctionnalités supplémentaires spécifiques.
Obtenir une clé API et exporter la clé API en tant que variable d'environnement. Si vous utilisez un SDK pour effectuer vos appels, installez le SDK DashScope.
Compatibilité OpenAI
Cloud public
Labase_urlà configurer pour les appels SDK :
L'endpointà configurer pour les appels HTTP :POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/embeddings
Remplacez {WorkspaceId} par votre véritable ID d'espace de travail.
Labase_urlà configurer pour les appels SDK :
- Singapour : https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1. Remplacez
WorkspaceIdpar votre véritable ID d'espace de travail. - Chine (Pékin) : https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
- Chine (Hong Kong) : https://{WorkspaceId}.cn-hongkong.maas.aliyuncs.com/compatible-mode/v1. Remplacez
WorkspaceIdpar votre véritable ID d'espace de travail.
- Singapour : POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/embeddings. Remplacez
WorkspaceIdpar votre véritable ID d'espace de travail. - Chine (Pékin) : POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/embeddings
- Chine (Hong Kong) : POST https://{WorkspaceId}.cn-hongkong.maas.aliyuncs.com/compatible-mode/v1/embeddings. Remplacez
WorkspaceIdpar votre véritable ID d'espace de travail.
{WorkspaceId} par votre véritable ID d'espace de travail.
Corps de la requête |
|
modelstringobligatoireNom du modèle à appeler. Consultez le tableau Présentation des modèles pour obtenir la liste des noms de modèles. | |
inputarray<string> or string or fileobligatoireTexte d'entrée à traiter. L'entrée peut être une chaîne, un tableau de chaînes ou un fichier. Les limites de longueur de texte et de taille de lot varient selon la version du modèle :
| |
dimensions integer facultatifDimension des vecteurs d'embedding en sortie. Doit correspondre à l'une des valeurs suivantes : 2560 (uniquement pour qwen3.7-text-embedding),2048 (uniquement pour text-embedding-v4), 1536 (uniquement pour text-embedding-v4), 1024, 768, 512, 256, 128 ou 64. La valeur par défaut est 1024. | |
encoding_format string facultatifFormat des embeddings retournés. Actuellement, seul le format float est pris en charge. |
Objet de réponse | |
dataarrayListe des objets d'embedding résultants.
Propriété embedding listVecteur d'embedding, retourné sous forme de tableau de nombres à virgule flottante.indexintegerIndex du texte d'entrée correspondant dans le tableau d'entrée.objectstringType d'objet. La valeur est toujours embedding. | |
modelstringNom du modèle utilisé pour cet appel. | |
objectstringType d'objet. La valeur est toujours list. | |
usageobject
Propriété prompt_tokensintegerNombre de tokens dans le texte d'entrée.total_tokens integerNombre total de tokens dans l'entrée. Ce décompte dépend de la manière dont le tokenizer du modèle analyse la chaîne d'entrée. | |
| idstringIdentifiant unique de la requête, utilisé pour le suivi et le dépannage. |
DashScope
Cloud public
base_urlpour les appels SDK : https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1
Endpoint pour les appels HTTP : POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/embeddings/text-embedding/text-embedding
Remplacez {WorkspaceId} par votre véritable ID d'espace de travail.
base_urlpour les appels SDK :
- Singapour : https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1. Remplacez
WorkspaceIdpar votre véritable ID d'espace de travail. - Chine (Pékin) : https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1
- Chine (Hong Kong) : https://{WorkspaceId}.cn-hongkong.maas.aliyuncs.com/api/v1. Remplacez
WorkspaceIdpar votre véritable ID d'espace de travail.
- Singapour : POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/embeddings/text-embedding/text-embedding. Remplacez
WorkspaceIdpar votre véritable ID d'espace de travail. - Chine (Pékin) : POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/embeddings/text-embedding/text-embedding
- Chine (Hong Kong) : POST https://{WorkspaceId}.cn-hongkong.maas.aliyuncs.com/api/v1/services/embeddings/text-embedding/text-embedding. Remplacez
WorkspaceIdpar votre véritable ID d'espace de travail.
{WorkspaceId} par votre véritable ID d'espace de travail.
Request body |
|
modelstringrequiredModèle à utiliser. Pour consulter la liste des modèles disponibles, reportez-vous au tableau Présentation des modèles. | |
inputstringouarray<string>requiredTexte à traiter. L'entrée peut être une chaîne de caractères, un tableau de chaînes ou un fichier. La longueur du texte et la taille de lot prises en charge varient selon la version du modèle.
| |
text_type stringoptional
Lors d'un appel HTTP, placez text_typedans l'objet Le texte converti en embeddings peut servir à des tâches en aval telles que la récupération, le clustering et la classification. Pour les tâches asymétriques comme la récupération, il est recommandé de distinguer le texte de requête (query) du texte de document (document) afin d'optimiser les performances. Pour les tâches symétriques telles que l'indexation, le clustering ou la classification, la valeur par défaut du système, document, suffit généralement. | |
dimension integer optional
Lors d'un appel HTTP, placez dimensiondans l'objet Définit la dimension d'embedding pour le vecteur de sortie. Les valeurs valides sont 2560 (uniquement pour qwen3.7-text-embedding),2048 (uniquement pour text-embedding-v4), 1536 (uniquement pour text-embedding-v4), 1024, 768, 512, 256, 128 ou 64. La valeur par défaut est 1024. | |
output_type string optional
Lors d'un appel HTTP, placez output_typedans l'objet Spécifie le type de vecteur de sortie. Ce paramètre s'applique uniquement aux modèles qwen3.7-text-embedding,``text-embedding-v3 et text-embedding-v4. Les valeurs valides sont dense, sparse et dense&sparse. La valeur par défaut est dense, ce qui renvoie uniquement la représentation vectorielle dense. | |
instruct string optionalFournit des instructions personnalisées pour guider le modèle dans la compréhension de l'intention de la requête. Il est recommandé d'utiliser des instructions en anglais, car elles améliorent généralement les performances de 1 % à 5 %. |
Response object | |
status_code stringCode de statut HTTP. La valeur 200 indique un succès. | |
request_id stringIdentifiant unique de la requête. Utilisez cet ID pour tracer et diagnostiquer la requête. | |
code stringCode d'erreur renvoyé en cas d'échec de la requête. Ce champ est vide pour les requêtes réussies. | |
message stringMessage d'erreur détaillé en cas d'échec de la requête. Ce champ est vide pour les requêtes réussies. | |
outputobjectRésultat de la tâche.
Properties embeddings arraySortie du modèle pour la requête. Il s'agit d'un tableau d'objets, chaque objet correspondant à un texte d'entrée.
Properties sparse_embedding arrayReprésentation vectorielle creuse de la chaîne correspondante. Cela s'applique uniquement à text-embedding-v3 et text-embedding-v4.
Properties index integerIndex du token dans le vocabulaire.value floatIndique le poids ou le score d'importance du Token. Plus la valeur est élevée, plus l'importance ou la pertinence du Token dans le contexte textuel actuel est grande.token stringTexte du token.arrayReprésentation vectorielle dense pour la chaîne correspondante.text_index integerIndex du texte correspondant dans le tableau d'entrée. | |
usageobject
Properties total_tokens integerNombre de tokens dans l'entrée, tel que calculé par le tokenizer du modèle. |