Les modèles d'embedding d'Alibaba Cloud Model Studio sont compatibles avec l'API OpenAI. Pour migrer vos applications OpenAI existantes vers Model Studio, ajustez les trois paramètres suivants :
-
base_url : remplacez cette valeur par
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1.Pour les autres régions, modifiez le base_url :
-
api_key : utilisez une clé API Model Studio.
-
model : sélectionnez un nom de modèle dans la liste ci-dessous.
ImportantAlibaba Cloud Model Studio a publié des domaines spécifiques à chaque espace de travail pour les régions Chine (Pékin), Singapour et Chine (Hong Kong). Ces nouveaux domaines dédiés offrent des performances supérieures et une stabilité accrue pour les requêtes d'inférence. Nous vous recommandons de migrer vers ces nouveaux domaines :
- Chine (Pékin) : passez de
https://dashscope.aliyuncs.comàhttps://{WorkspaceId}.cn-beijing.maas.aliyuncs.com - Singapour : passez de
https://dashscope-intl.aliyuncs.comàhttps://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com - Chine (Hong Kong) : passez de
https://cn-hongkong.dashscope.aliyuncs.comàhttps://{WorkspaceId}.cn-hongkong.maas.aliyuncs.com
{WorkspaceId} correspond à l'ID de votre espace de travail. Vous trouverez cette information sur la page Workspace Details de la console Alibaba Cloud Model Studio. Le domaine existant reste pleinement fonctionnel.
Modèles pris en charge
Singapour
| Modèle | Dimensions de l'embedding | Nombre maximal de lignes | Nombre maximal de tokens par ligne (Note) | Prix (pour 1 M de tokens en entrée) | Langues prises en charge | Quota gratuit (Note) |
|---|---|---|---|---|---|---|
text-embedding-v4
| 2 048, 1 536, 1 024 (par défaut), 768, 512, 256, 128 ou 64 | 10 | 8 192 | 0,07 $ | Plus de 100 langues courantes, dont le chinois, l'anglais, l'espagnol, le français, le portugais, l'indonésien, le japonais, le coréen, l'allemand et le russe | 1 million de tokens Valable 90 jours après l'activation de Model Studio |
text-embedding-v3 | 1 024 (par défaut), 768 ou 512 | Plus de 50 langues courantes, dont le chinois, l'anglais, l'espagnol, le français, le portugais, l'indonésien, le japonais, le coréen, l'allemand et le russe | 500 000 tokens Valable 90 jours après l'activation de Model Studio |
Chine (Pékin)
| Modèle | Dimensions de l'embedding | Nombre maximal de lignes | Nombre maximal de tokens par ligne (Note) | Prix (pour 1 M de tokens en entrée) | Langues prises en charge |
|---|---|---|---|---|---|
text-embedding-v4
| 2 048, 1 536, 1 024 (par défaut), 768, 512, 256, 128 ou 64 | 10 | 8 192 | 0,072 $ | Plus de 100 langues courantes, dont le chinois, l'anglais, l'espagnol, le français, le portugais, l'indonésien, le japonais, le coréen, l'allemand et le russe, ainsi que plusieurs langages de programmation |
Chine (Hong Kong)
| Modèle | Dimensions de l'embedding | Nombre maximal de lignes | Nombre maximal de tokens par ligne (Note) | Prix (pour 1 M de tokens en entrée) | Langues prises en charge |
|---|---|---|---|---|---|
text-embedding-v4
| 2 048, 1 536, 1 024 (par défaut), 768, 512, 256, 128 ou 64 | 10 | 8 192 | 0,07 $ | Plus de 100 langues courantes, dont le chinois, l'anglais, l'espagnol, le français, le portugais, l'indonésien, le japonais, le coréen, l'allemand et le russe, ainsi que plusieurs langages de programmation |
Les modèles d'embedding multimodaux, tels que qwen3-vl-embedding et la série tongyi-embedding-vision, ne prennent pas en charge l'API compatible OpenAI. Consultez Embedding multimodal .
Utilisation
Exemples d'appels
Cette section présente des exemples d'entrée de chaîne de caractères utilisant Python (SDK OpenAI) et cURL (HTTP). Pour des exemples impliquant d'autres langages de programmation ou méthodes d'entrée, reportez-vous à Premiers pas avec l'embedding de texte.
SDK OpenAI
Pour appeler le service via le SDK OpenAI, installez au préalable le SDK OpenAI.
import os
from openai import OpenAI
def get_response():
client = OpenAI(
# API keys vary by region. Get your API key: https://www.alibabacloud.com/help/en/model-studio/get-api-key
api_key=os.getenv("DASHSCOPE_API_KEY"), # If you have not configured the environment variable, replace this value with your API key.
# The base_url of the Model Studio service. If you use a model in the China (Beijing) region, replace the URL with https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1.
base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
)
completion = client.embeddings.create(
model="text-embedding-v3", # If you use a model in the China (Beijing) region, replace the model name with text-embedding-v4.
input='The quality of the clothes is excellent. They are beautiful. It was worth the wait. I like them and will buy from here again.',
encoding_format="float"
)
print(completion.model_dump_json())
if __name__ == '__main__':
get_response()
HTTP
Envoyer un appel d'interface
Singapore: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/embeddings
China (Beijing): POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/embeddings
Appel depuis la ligne de commande
# If you use a model in the China (Beijing) region, replace the URL with https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/embeddings
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/embeddings' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "text-embedding-v3",
"input": "The quality of the clothes is excellent. They are beautiful. It was worth the wait. I like them and will buy from here again.",
"encoding_format": "float"
}'
L'exécution du code renvoie le résultat suivant :
Résultat
{
"data": [
{
"embedding": [
0.0023064255,
-0.009327292,
....
-0.0028842222
],
"index": 0,
"object": "embedding"
}
],
"model":"text-embedding-v3",
"object":"list",
"usage":{"prompt_tokens":23,"total_tokens":23},
"id":"f62c2ae7-0906-9758-ab34-47c5764f07e2"
}
Exemple de réponse d'erreur
En cas d'erreur lors d'une requête d'accès, les paramètres code et message de la réponse en indiquent la cause.
{
"error": {
"message": "Incorrect API key provided. ",
"type": "invalid_request_error",
"param": null,
"code": "invalid_api_key"
}
}
Référence API
Référence de l'API d'embedding de texte
Codes d'erreur
Si l'appel du modèle échoue et renvoie un message d'erreur, consultez la rubrique Codes d'erreur pour obtenir des instructions de résolution.