Lektion 3 von 3 · 9 Minuten

Bilder und Audio senden

Füge einer Anfrage Bilder, Dateien und Audio hinzu, wähle den Endpunkt für die gewünschte Ausgabe und finde Modelle, die jede Eingabe annehmen.

Auf den Text-Endpunkten kann der content einer Nachricht statt eines Strings eine Liste von Teilen sein. Ein Bildteil nimmt eine HTTP(S)-URL oder eine Base64-data:-URI:

{
  "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" } }
      ]
    }
  ]
}

Andere Eingabeteile folgen demselben Muster. input_audio sendet Base64-Audio in data mit einem format wie wav oder mp3. Ein Teil file sendet ein Dokument wie ein PDF, entweder als Base64-Data-URL in file_data oder als file_id. Eine file_id kann nur das Anbieterkonto lesen, das sie ausgestellt hat. Fixiere also diesen Anbieter oder sende stattdessen die Daten.

Für andere Arten von Ausgabe nutzt du den passenden Endpunkt:

Du willstEndpunkt
Sprache aus Text/v1/audio/speech
Text aus Sprache/v1/audio/transcriptions (/v1/audio/translations für Englisch)
Bilder/v1/images/generations, /v1/images/edits
Text und Layout aus einem Dokumentbild/v1/ocr, /v1/parse

/v1/parse nimmt ein Bild pro Anfrage und akzeptiert keine PDFs. Wandle also zuerst jede Seite in ein Bild um.

Nicht jedes Modell nimmt jede Eingabe an. Phaseo routet nur an Anbieter, die die Eingaben in deiner Anfrage akzeptieren; tut das keiner, bekommst du 400 unsupported_modalities. Prüfe das vorher: Jedes Modell in GET /v1/models listet modalities.input, und du kannst mit input_types=image filtern. Nutze auf der Seite Modelle die Filter für Eingabe- und Ausgabemodalitäten.

Prüfe dein Verständnis

Du brauchst eine Liste der Modelle, die Bildeingaben annehmen. Was ist die schnellste zuverlässige Prüfung?

Wende es an

Deine Belegfunktion sendet ein Foto an ein reines Textmodell und bekommt 400 unsupported_modalities. Die Produktmanagerin fragt, ob Phaseo ausgefallen ist. Was sagst du ihr, und was änderst du?

Antwort anzeigen

Phaseo ist nicht ausgefallen: Keine Route dieses Modells nimmt Bildeingaben an. Wähle ein Modell, dessen modalities.input den Wert image enthält (filtere GET /v1/models mit input_types=image oder nutze den Filter auf der Seite „Modelle“), und sende dieselbe Anfrage dorthin.

Das Wichtigste

Sende Bilder, Audio und Dateien als Inhaltsteile, nutze die eigenen Endpunkte für Sprache, Transkription und Bilder und prüfe die Eingabemodalitäten eines Modells, bevor du dich darauf verlässt.

Weiterführende Links

Dein Fortschritt wird in diesem Browser gespeichert.

Zuletzt geprüft am 17. November 2026