Anleitungen · Vision
Vision: Bilder an offene Modelle senden, verarbeitet in der EU
Vision-Modelle lesen Bilder ebenso wie Text. Sie beschreiben ein Foto, lesen einen Beleg, vergleichen zwei Screenshots, prüfen ein Formular oder beantworten Fragen zu einem Diagramm. Bilder werden in derselben Chat-Anfrage wie Text gesendet, im OpenAI- oder Anthropic-Format, und in europäischen Rechenzentren verarbeitet. Das zählt, wenn darauf Dokumente, Personen oder Kundendaten zu sehen sind.
- 01API-Format: OpenAI und Anthropic
- 02Rechenzentren in der EU
- 03Durch einen AV-Vertrag abgedeckt
import base64, os
from openai import OpenAI
client = OpenAI(base_url="https://api.inference.eu/v1", api_key=os.environ["INFERENCE_EU_API_KEY"])
with open("receipt.jpg", "rb") as f:
image = base64.b64encode(f.read()).decode()
reply = client.chat.completions.create(
model="mistral-small-3.2-24b-instruct",
messages=[{
"role": "user",
"content": [
{"type": "text", "text": "List the items, the VAT rate and the total on this receipt."},
{"type": "image_url", "image_url": {"url": f"data:image/jpeg;base64,{image}"}},
],
}],
max_tokens=500,
)
print(reply.choices[0].message.content)So senden Sie ein Bild
Wählen Sie ein Modell mit Bildverständnis, etwa mistral-small-3.2-24b-instruct, und machen Sie den content der Nutzernachricht zu einer Liste von Teilen statt zu einem String. Ein text-Teil trägt Ihre Frage, ein image_url-Teil das Bild, entweder als öffentliche HTTPS-URL oder als Data-URL mit Base64-Inhalt wie im Beispiel. Mehrere Bilder und Textteile lassen sich in einer Nachricht kombinieren.
Die Antwort kommt als normaler Text in choices[0].message.content. Im Anthropic-Messages-Format nutzen Sie stattdessen einen Block image mit Quelle base64 oder url, in der Responses API ein Element input_image.
Bildgröße, Detailgrad und Tokens
Bilder werden in Tokens umgewandelt, bevor das Modell sie liest, und größere Bilder ergeben mehr Tokens. Das beeinflusst Kosten, Tempo und den verbleibenden Platz im Kontextfenster. Passen Sie Bilder an die Aufgabe an: Für eine allgemeine Beschreibung genügt ein kleines Foto, eine dichte Rechnung oder ein Tabellen-Screenshot braucht genug Auflösung, damit der Text lesbar bleibt.
Nutzen Sie JPEG für Fotos und PNG für Screenshots und Dokumente mit scharfem Text. Schneiden Sie wenn möglich auf den relevanten Bereich zu. Das Feld detail an image_url wird aus Kompatibilitätsgründen akzeptiert; wie es die Verarbeitung ändert, hängt vom Modell ab.
Bewährte Einsatzmuster
Belege und Rechnungen: Senden Sie das Bild mit einem JSON-Schema in response_format und erhalten Sie Lieferant, Datum, Positionen und Summen als strukturierte Daten. Screenshots: Lassen Sie ein Modell einen UI-Fehler beschreiben, einen Fehlerdialog lesen oder ein Design mit der umgesetzten Seite vergleichen. Qualitätskontrolle: Zeigen Sie ein Produktfoto und fragen Sie, ob ein Etikett vorhanden und lesbar ist.
Bei mehrseitigen PDFs ist es oft besser, das Dokument zuerst mit dem Werkzeug zur Dokumentkonvertierung in Markdown umzuwandeln und Text zu senden. Vision nutzen Sie nur für Seiten mit Diagrammen oder Handschrift. Text ist pro Seite günstiger und leichter zu durchsuchen, zu zitieren und zu speichern.
Fehler und Sonderfälle
Ein Bild an ein reines Textmodell ergibt einen 400-Fehler mit dem Hinweis, dass das Modell keine Bilder annimmt; prüfen Sie Modellseite oder GET /v1/models. Bild-URLs müssen öffentlich über HTTPS erreichbar sein. Private, ablaufende oder login-pflichtige Links scheitern, senden Sie dann Base64. Sehr große Dateien können das Größenlimit der Anfrage sprengen, komprimieren Sie sie vorher.
Vision-Modelle können Kleingedrucktes, Handschrift und Zahlen falsch lesen und beschreiben mitunter, was sie erwarten, statt was zu sehen ist. Bei wichtigen Werten wie Rechnungsbeträgen prüfen Sie die Ergebnisse und beziehen einen Menschen ein. Nutzen Sie Vision-Modelle nicht zur Identifizierung von Personen.
Vision: häufige Fragen
Die Fragen, die uns Einkauf, Entwicklung und Rechtsabteilungen am häufigsten stellen. Etwas fehlt? Fragen Sie uns direkt.
Verwandte Seiten
- Chat completionsSenden Sie Chat-Nachrichten im OpenAI-Format an Open-Weight-Modelle. Verarbeitung in Rechenzentren in der EU, keine Nutzung Ihrer Daten für Training.Endpunkte
- Document conversionWandeln Sie PDF-, Word-, PowerPoint- und Excel-Dateien in sauberes Markdown für RAG und Prompts um. Tabellen, Überschriften und Scans, verarbeitet in der EU.Tools
- Structured outputsErhalten Sie von offenen Modellen gültiges JSON nach Ihrem Schema, mit OpenAI-kompatiblen Structured Outputs. JSON-Modus, json_schema, strict und Stolperfallen.Anleitungen
- Image generationErzeugen Sie Bilder aus Textbeschreibungen mit einer OpenAI-kompatiblen Bild-API. Offene Bildmodelle wie FLUX.1 schnell, verarbeitet in der EU.Endpunkte
Verlagern Sie Ihre KI-Workloads auf europäische Infrastruktur
Sagen Sie uns, welche Modelle Sie nutzen und wie viel Verkehr Sie ungefähr haben. Wir antworten innerhalb eines Werktags mit Preisen und nächsten Schritten.
- Antwort innerhalb eines Werktags
- Preise für Ihr Volumen
- AV-Vertrag unterschriftsreif