Envoyer des images et de l’audio
Ajoutez des images, des fichiers et de l’audio à une requête, choisissez l’endpoint selon la sortie voulue, et trouvez les modèles qui acceptent chaque type d’entrée.
Sur les endpoints de texte, le content d’un message peut être une liste de parties au lieu d’une chaîne. Une partie image accepte une URL HTTP(S) ou une URI data: en base64 :
{
"model": "anthropic/claude-sonnet-5.5",
"messages": [
{
"role": "user",
"content": [
{ "type": "text", "text": "What does this chart show?" },
{ "type": "image_url", "image_url": { "url": "https://example.com/chart.png" } }
]
}
]
}
Les autres parties d’entrée suivent le même principe. input_audio envoie des data audio en base64 avec un format comme wav ou mp3. Une partie file envoie un document comme un PDF, soit sous forme d’URL de données base64 dans file_data, soit sous forme de file_id. Un file_id ne peut être lu que par le compte fournisseur qui l’a émis : épinglez ce fournisseur ou envoyez plutôt les données.
Pour d’autres types de sortie, utilisez l’endpoint dédié :
| Vous voulez | Endpoint |
|---|---|
| De la parole à partir de texte | /v1/audio/speech |
| Du texte à partir de parole | /v1/audio/transcriptions (/v1/audio/translations pour l’anglais) |
| Des images | /v1/images/generations, /v1/images/edits |
| Le texte et la mise en page d’une image de document | /v1/ocr, /v1/parse |
/v1/parse accepte une image par requête et n’accepte pas les PDF : convertissez d’abord chaque page en image.
Tous les modèles n’acceptent pas toutes les entrées. Phaseo ne route que vers des fournisseurs qui acceptent les entrées de votre requête ; si aucun ne le fait, vous obtenez 400 unsupported_modalities. Vérifiez d’abord : chaque modèle de GET /v1/models liste modalities.input, et vous pouvez filtrer avec input_types=image. Sur la page Modèles, utilisez les filtres de modalités d’entrée et de sortie.
Vérifiez votre compréhension
Vous avez besoin de la liste des modèles qui acceptent des images en entrée. Quelle est la vérification fiable la plus rapide ?
Mettez-le en pratique
Votre fonctionnalité de reçus envoie une photo à un modèle texte uniquement et obtient 400 unsupported_modalities. Le chef de produit demande si Phaseo est en panne. Que lui répondez-vous, et que changez-vous ?
Afficher la réponseMasquer la réponse
Phaseo n’est pas en panne : aucune route de ce modèle n’accepte d’image en entrée. Choisissez un modèle dont modalities.input inclut image (filtrez GET /v1/models avec input_types=image, ou utilisez le filtre de la page Modèles) et envoyez-lui la même requête.
À retenir
Liens utiles
Dernière vérification le 17 novembre 2026