TokenLab

Texte

Créer des embeddings multimodaux

Crée des vecteurs d'embedding avec un modèle d'embedding multimodal

POST
/v1/multimodal/embeddings

Vue d'ensemble

Utilisez cet endpoint avec les modèles dont les détails mentionnent l'opération multimodal-embedding. Consultez supported_operations dans GET /v1/models/{model} avant d'envoyer une requête. Les modèles d'embedding textuels utilisent Créer un embedding, et cet endpoint renvoie 400 unsupported_endpoint pour ces derniers.

Seule l'entrée texte est active. Une requête avec image_url ou image_base64 renvoie 400 image_input_deferred.

Corps de la requête

modelstringrequis

ID d'un modèle listant multimodal-embedding, tel que qwen3-vl-embedding.

inputobject | arrayrequis

Un élément d'entrée ou un tableau d'éléments. Chaque élément doit comporter au moins l'un des champs ci-dessous, et la réponse contient une entrée par élément.

  • text (string) : Texte à vectoriser.
  • image_url (string) : URL publique de l'image. Pas encore actif.
  • image_base64 (string) et image_mime_type (string) : Données d'image en Base64 et son type MIME. Pas encore actif.
dimensionsinteger

Nombre de dimensions de chaque vecteur retourné, un entier positif. La valeur maximale dépend du modèle.

Réponse

objectstring

Toujours list.

dataarray

Une entrée par élément d'entrée.

Chaque entrée contient :

  • object (string) : embedding
  • index (integer) : Index de l'élément d'entrée
  • text_embedding (array) : Le vecteur d'un élément texte. Une entrée contient un champ vectoriel nommé selon sa modalité : text_embedding, image_embedding, video_embedding ou audio_embedding.
modelstring

Modèle utilisé.

usageobject

Utilisation des tokens avec prompt_tokens et total_tokens, lorsque le modèle la renseigne.

Requête

curl -X POST "https://api.tokenlab.sh/v1/multimodal/embeddings" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3-vl-embedding",
    "input": [
      {"text": "A red bicycle leaning against a brick wall"},
      {"text": "A city street at night"}
    ]
  }'

L'exemple de vecteur est raccourci pour des raisons de lisibilité.

Réponse

Response
{
  "object": "list",
  "data": [
    { "object": "embedding", "index": 0, "text_embedding": [0.0123, -0.0456, 0.0789] },
    { "object": "embedding", "index": 1, "text_embedding": [0.0211, 0.0334, -0.0102] }
  ],
  "model": "qwen3-vl-embedding",
  "usage": { "prompt_tokens": 18, "total_tokens": 18 }
}

Erreurs

StatutCodeCause
400invalid_requestinput est manquant, vide, ou un élément ne contient aucun des champs text, image_url, image_base64
400unsupported_endpointLe modèle ne liste pas multimodal-embedding
400image_input_deferredUn élément contient une image

Gérez les autres statuts comme indiqué dans Gérer les erreurs d'API.

Autorisation

BearerAuth
AuthorizationBearer <token>

Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.

Emplacement: header

En-têtes

X-TokenLab-Delivery-Policy?string

Politique de livraison par requête. Remplace les valeurs par défaut de la clé API et de l'espace de travail. Tente automatiquement TokenLab Verified en premier et peut basculer une fois vers Official uniquement avant la sortie, l'acceptation de la requête ou la création de ressource persistante.

Valeurs possibles

  • "auto"
  • "verified"
  • "official"

Corps de la requête

application/json

Réponse

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json