Vision

Alle Claude-Modelle akzeptieren Bilder. Übergeben Sie sie inline als Base64 oder als URL in einem Image-Inhaltsblock.

Image-Inhaltsblock

Mischen Sie Text- und Bildblöcke im selben content-Array. Das Modell behandelt sie als einen einzigen geordneten Strom.

{
"model": "claude-sonnet-5-5",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": [
{ "type": "text", "text": "Describe this image in one sentence." },
{
"type": "image",
"source": {
"type": "base64",
"media_type": "image/png",
"data": "iVBORw0KGgoAAAANSUhEUgAAA..."
}
}
]
}
]
}

URL als Quelle

Die API akzeptiert auch eine öffentliche HTTPS-URL: Wir laden das Bild serverseitig ab und geben es an das Modell weiter.

{
"type": "image",
"source": {
"type": "url",
"url": "https://example.com/diagram.png"
}
}

Formate & Limits

• Medientypen: image/jpeg, image/png, image/gif, image/webp.
• Bis zu 20 Bilder pro Anfrage und 5 MB pro Bild vor der Base64-Kodierung.
• Animierte GIFs werden auf das erste Bild reduziert.
• Vision-Tokens werden als Eingabe-Tokens abgerechnet – ein typisches Bild mit 1024×1024 Pixeln kostet ~1600 Tokens.

Python (Datei → Base64)

import base64, mimetypes
from anthropic import Anthropic
client = Anthropic(base_url="https://api.oneprovider.dev")
def encode_image(path: str):
with open(path, "rb") as f:
data = base64.standard_b64encode(f.read()).decode("ascii")
return {
"type": "base64",
"media_type": mimetypes.guess_type(path)[0] or "image/png",
"data": data,
}
msg = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=512,
messages=[{
"role": "user",
"content": [
{"type": "text", "text": "What's in this screenshot?"},
{"type": "image", "source": encode_image("./screen.png")},
],
}],
)
print(msg.content[0].text)

Ein Modell für Vision wählen

• OCR und dichter Text – claude-opus-5-5, wenn Genauigkeit wichtiger ist als die Kosten.
• Beschreibung von Objekten und Szenen – claude-sonnet-5-5 als ausgewogener Standard.
• Einfache Diagramme und UI-Screenshots – claude-haiku-5-5 für günstige Stapelverarbeitung; verlagern Sie komplexe Fälle auf Sonnet oder Opus.

Kurze Antworten

Welche base URL verwende ich?

Claude Code und die Anthropic-SDKs verwenden https://api.oneprovider.dev. OpenAI-SDKs und OpenAI-kompatible Clients verwenden https://api.oneprovider.dev/v1. Ein Schlüssel funktioniert an beiden Adressen; die Modellliste finden Sie auf der Modellseite , die Preise auf der Preisseite .

Wie authentifiziere ich mich?

Senden Sie den unveränderten sk-…-Schlüssel in x-api-key oder Authorization: Bearer: nur eines von beiden, nie beide. Bewahren Sie den Schlüssel in einer Umgebungsvariable auf, nicht in einer Datei, die ins Repository committet wird. Mehr zur Authentifizierung .

Wo bekomme ich einen Schlüssel?

Öffnen Sie Ihr Konto im Telegram-Bot @oneprovider_robot oder auf app.oneprovider.dev, laden Sie das Guthaben auf und tippen Sie auf „Schlüssel ausstellen“. Jeder Schlüssel kann ein eigenes Ausgabenlimit haben. Konto & API-Schlüssel .

Was bedeuten 401, 404 und 429?

401: Der Schlüssel fehlt, ist falsch geschrieben oder steht im falschen Header; fügen Sie den ganzen Schlüssel ohne Anführungszeichen und Leerzeichen ein. 404: meist eine falsche base URL, zum Beispiel ein fehlendes oder doppeltes /v1. 429 mit „Insufficient balance“: Das Guthaben des Kontos oder das Ausgabenlimit des Schlüssels ist aufgebraucht – laden Sie auf, statt es erneut zu versuchen; jedes andere 429 ist ein Rate-Limit, warten Sie dann die Zeit aus Retry-After ab. Details: Fehlercodes und Fehlerbehebung .

Warum brechen Streams ab oder werden zurückgesetzt?

VPN- und VLESS-Proxys puffern SSE oft oder stören die HTTP/2-Aushandlung. OneProvider hat keine regionalen Beschränkungen und puffert keine Streams – schalten Sie den Proxy aus und versuchen Sie es erneut.

Wohin wende ich mich, wenn das nicht reicht?

Schreiben Sie @Oneproviderhelpbot auf Telegram oder öffnen Sie „Support“ im Web-Konto – mit HTTP-Statuscode und genauer Fehlermeldung. So arbeitet der Support .