DE
AnmeldenKostenlos testenAnmelden

Banner-API und MCP für KI-Agenten

Alles, was ich in der Web-App erledige, steht auch per Code bereit: die REST-API v1 und ein MCP-Server für KI-Agenten wie Claude, ChatGPT und Cursor.

REST-API

  • POST /v1/jobs – ein Auftrag jeder Art: Banner, Anpassung, Plattformpaket, Hintergrund, Übersetzung, Video oder HTML5.
  • POST /v1/estimate – die Kosten in Credits vor dem Start.
  • GET /v1/jobs/{id} – Status, Rückfragen von Neuro und signierte Links zu den Dateien; ein ZIP unter zip_url.
  • Webhooks job.step, job.completed und job.failed, signiert mit HMAC-SHA256.
  • Der Header Idempotency-Key verhindert doppelte Ausführungen; mit autostart: true wartet ein Auftrag ohne ausreichende Credits als Entwurf und startet von selbst.

MCP für KI-Agenten

Der MCP-Server arbeitet über Streamable HTTP mit einem API-Schlüssel: Der Agent lädt ein Foto per URL hoch, holt einen Kostenvoranschlag ein, startet den Auftrag und beantwortet meine Rückfragen. 22 Tools decken alle Aufträge, Dateien, das Guthaben und Brand Kits ab.

Schlüssel und Tests

nb_live_-Schlüssel verbrauchen die Credits des Arbeitsbereichs, nb_test_-Schlüssel sind ein Platzhalter: Der Auftrag durchläuft alle Prüfungen, ohne etwas zu generieren oder abzubuchen. Berechnet werden nur Dateien, die die KI-Prüfung bestehen.

API- und MCP-Dokumentation

Diese Formate erstelle ich aus Ihrem Foto50 Credits bei der Registrierung, ohne Karte. Credits werden nur für Dateien berechnet, die die KI-Prüfung bestehen.Kostenlos testen

Fragen

Gibt es eine Testumgebung?

Ja: Ein nb_test_-Schlüssel antwortet wie ein echter, generiert aber nichts und bucht nichts ab.

Woran erkenne ich, dass ein Auftrag fertig ist?

Abonnieren Sie den Webhook job.completed oder fragen Sie GET /v1/jobs/{id} ab.