Texte
Créer des embeddings multimodaux
Crée des vecteurs d'embedding avec un modèle d'embedding multimodal
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
ID d'un modèle listant multimodal-embedding, tel que qwen3-vl-embedding.
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) etimage_mime_type(string) : Données d'image en Base64 et son type MIME. Pas encore actif.
Nombre de dimensions de chaque vecteur retourné, un entier positif. La valeur maximale dépend du modèle.
Réponse
Toujours list.
Une entrée par élément d'entrée.
Chaque entrée contient :
object(string) :embeddingindex(integer) : Index de l'élément d'entréetext_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_embeddingouaudio_embedding.
Modèle utilisé.
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
{
"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
| Statut | Code | Cause |
|---|---|---|
400 | invalid_request | input est manquant, vide, ou un élément ne contient aucun des champs text, image_url, image_base64 |
400 | unsupported_endpoint | Le modèle ne liste pas multimodal-embedding |
400 | image_input_deferred | Un élément contient une image |
Gérez les autres statuts comme indiqué dans Gérer les erreurs d'API.
Autorisation
BearerAuth Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.
Emplacement: header
En-têtes
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