Skip to main content

OpenAI compatible - Embedding

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.
Alibaba 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
  • Chine (Pékin)
  • Chine (Hong Kong)
ModèleDimensions de l'embeddingNombre maximal de lignesNombre maximal de tokens par ligne (Note)Prix (pour 1 M de tokens en entrée)Langues prises en chargeQuota gratuit (Note)
text-embedding-v4
Série Qwen3-Embedding
2 048, 1 536, 1 024 (par défaut), 768, 512, 256, 128 ou 64108 1920,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 russe1 million de tokensValable 90 jours après l'activation de Model Studio
text-embedding-v31 024 (par défaut), 768 ou 512Plus 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 russe500 000 tokensValable 90 jours après l'activation de Model Studio
qwen3.7-text-embedding2 560, 2 048, 1 536, 1 024 (par défaut), 768, 512, 25620128 0000,07 $201 langues courantes et dialectes, dont le chinois, l'anglais, l'espagnol, le français, le portugais, l'indonésien, le japonais, le coréen, l'allemand et le russeAucun quota gratuit
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
  • HTTP
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()
L'exécution du code renvoie le résultat suivant :
{
  "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.