Service 04

Visionati API

Die Visionati API nimmt Bild- oder Medien-URLs entgegen und gibt die Analyse mehrerer Vision-Backends in einer einheitlichen Struktur zurück. Wenn Visionati eine response_uri liefert, ruft der Hub das Ergebnis automatisch ab und bereitet die wichtigsten Inhalte zusätzlich als Zusammenfassung auf.

Endpoint

POST /api/v1/visionati/fetch

Beispiel-Request

curl -X POST -H "X-API-Key: dein-api-hub-key" -H "Content-Type: application/json" -d '{"url":"https://example.com/image.jpg","backend":["claude","gemini"],"feature":["descriptions","tags"],"role":"general","language":"English"}' https://cyber.zap.cloud/api/v1/visionati/fetch

Beispiel-Response

{"ok":true,"data":{"request":{"request_id":"...","status":"processing","response_uri":"https://api.visionati.com/api/results/..."},"resolved":{"request_id":"...","status":"completed","all":{"assets":[{"name":"https://example.com/image.jpg","descriptions":[{"description":"A product photo...","source":"claude"}]}]}},"summary":{"request_id":"...","status":"completed","assets_count":1,"descriptions":[{"asset":"https://example.com/image.jpg","source":"claude","description":"A product photo..."}]}}}

Parameter

NameTypPflichtBeschreibung
url string ja Bild- oder Medien-URL, die Visionati analysieren soll.
backend array nein Ausgewählte Visionati-Backends, zum Beispiel claude oder gemini.
feature array nein Gewünschte Analysefunktionen, z. B. descriptions, tags, colors oder ocr.
role string nein Passendes Rollenprofil für die Bildbeschreibung.
language string nein Ausgabesprache für Beschreibungen.