PICVID für Entwickler

Authentifizierung

Jede Anfrage braucht Authorization: Bearer pv_live_…. Ein Schlüssel handelt als das Mitglied, das ihn erstellt hat, im Arbeitsbereich, in dem er erstellt wurde – Monatslimits und Rollen gelten wie im Studio. Bis zu 120 Anfragen pro Minute und Schlüssel, 20 Generierungen pro Minute und Person.

Schnellstart

# 1) Modell und Einstellungen nachsehen
curl https://picvid.prooflog.de/api/v1/models/seedance-2 -H "Authorization: Bearer $PICVID_API_KEY"

# 2) Generierung starten
curl https://picvid.prooflog.de/api/v1/generations \
  -H "Authorization: Bearer $PICVID_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2",
    "prompt": "Ein roter Fuchs läuft durch verschneiten Wald, Kamerafahrt",
    "settings": { "duration": 5, "resolution": "720p" },
    "media": [{ "url": "<Ergebnis-URL eines Bildes>", "role": "start" }]
  }'

# 3) Abfragen, bis status = completed | failed | blocked | canceled
curl https://picvid.prooflog.de/api/v1/generations/<id> -H "Authorization: Bearer $PICVID_API_KEY"

Einstellungen und erlaubte Werte stehen unter settings des Modells; unbekannte Werte werden mit einer klaren Meldung abgelehnt. Referenzen (media) müssen von PICVID stammen: frühere Ergebnisse oder Dateien aus POST /api/v1/uploads (danach mit PUT und den gelieferten Headern hochladen).

Endpunkte

Fehler kommen einheitlich als {"error": {"code": "…", "message": "…"}}:

• 400 invalid_request / invalid_setting / invalid_media – Anfrage passt nicht zum Modell – die Meldung nennt das Feld
• 401 unauthorized – Schlüssel fehlt, ist falsch oder widerrufen
• 402 insufficient_credits – Zu wenig Guthaben
• 403 plan_required / member_limit – Tarif ohne API oder Monatslimit des Mitglieds erreicht
• 404 model_not_found / not_found – Unbekanntes Modell oder fremde Generierung
• 429 rate_limited / concurrency_limit – Zu viele Anfragen bzw. zu viele gleichzeitige Läufe

MCP – Claude & andere KI-Assistenten

Server-Adresse (Streamable HTTP): https://picvid.prooflog.de/api/mcp. In Claude.ai unter Einstellungen → Connectors als eigenen Connector hinzufügen – die Anmeldung läuft über dein PICVID-Konto (OAuth), dort wählst du den Arbeitsbereich, der die Credits bezahlt. Programme ohne OAuth nutzen einen API-Schlüssel als Bearer-Token.

claude mcp add --transport http picvid https://picvid.prooflog.de/api/mcp \
  --header "Authorization: Bearer $PICVID_API_KEY"