Entwicklerdokumente

neofashion.ai-API

Generieren Sie Produktfotos, Videos und Kampagnenbilder programmgesteuert. Dieselbe API, die die Plattform verwendet – steht Ihrer Integration vom ersten Tag an zur Verfügung.

Basis-URL

Alle Endpoints sind unter /api/v1 versioniert und werden über HTTPS bereitgestellt. Die Web-App nutzt dieselben Endpoints — es gibt keine privaten, nur für die UI bestimmten Routen.

Base URL

https://app.neofashion.ai/api/v1

Authentifizierung

Jede Anfrage wird mit einem Bearer-Token authentifiziert. Zwei Token-Typen werden unterstützt; beide lösen in denselben Workspace-Kontext auf.

API-Key

Für Server-zu-Server-Integrationen. Erstellen Sie Keys in den Workspace-Einstellungen; jeder Key ist auf Ihren Workspace beschränkt. Verfügbar in Enterprise-Plänen.

Authorization: Bearer ne_live_xxxxxxxxxxxx

Session-JWT

Wird von der Web-App beim Login ausgestellt. Für die Plattform-UI selbst und kurzlebige, nutzerbezogene Aufrufe.

Authorization: Bearer eyJhbGci...

Alle Anfragen enthalten ein source-Feld (ui oder api) sowie optional api_key_id für Audit- und Abrechnungszwecke.

Endpoints

Die zentralen Endpoints für Generierung und Abruf. Länger laufende Aufgaben wie Video- und Bulk-Generierung laufen asynchron — fragen Sie die Generierung ab oder verfolgen Sie Status-Updates in der App.

Methode	Endpoint	Beschreibung
POST	`/api/v1/generate/image`	Generieren Sie ein einzelnes Produktfoto
POST	`/api/v1/generate/video`	Erstellen Sie ein kurzes Modevideo
POST	`/api/v1/generate/bulk`	Asynchroner Batch-Generierungsauftrag
POST	`/api/v1/sketch-to-photo`	Skizze → Foto in Kampagnenqualität
GET	`/api/v1/generations`	Generationen auflisten (paginiert)
GET	`/api/v1/generations/:id`	Generierungsdetails + Status
GET	`/api/v1/credits/balance`	Aktueller Guthabenstand
GET	`/api/v1/personas`	Workspace-Personas
GET	`/api/v1/models`	Marken-DNA / Personas API

Antwortformat

Jeder Endpoint gibt denselben Envelope zurück: data, meta (verbrauchte Credits, verbleibende Credits, Request-ID) und error. Genau eines von data oder error ist gesetzt.

Erfolg

{
  "data": {
    "id": "gen_01hwz...",
    "status": "completed",
    "output_url": "https://...",
    "credits_used": 50
  },
  "meta": {
    "credits_used": 50,
    "credits_remaining": 7950,
    "request_id": "req_01hwz..."
  },
  "error": null
}

Fehler

{
  "data": null,
  "meta": { "request_id": "req_01hwz..." },
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Credit balance too low for this operation.",
    "details": { "required": 50, "available": 20 }
  }
}

Rate Limits

Limits gelten pro Workspace. Bei Überschreitung gibt die API 429 RATE_LIMITED mit einem retry-after-Header zurück.

Plan	Rate Limit
Enterprise	`Maßgeschneidert – vertraglich vereinbart, mit SLA`

Fehlercodes

Fehler werden im Feld error mit einem stabilen code, einer lesbaren Nachricht und strukturierten Details zurückgegeben.

Code	HTTP	Bedeutung
`INSUFFICIENT_CREDITS`	402	Das Workspace-Guthaben reicht für die angeforderte Aktion nicht aus. Laden Sie Credits auf oder upgraden Sie, um fortzufahren.
`UNAUTHORIZED`	401	Das Token fehlt, ist abgelaufen oder ungültig.
`FORBIDDEN`	403	Das Token ist gültig, doch Plan oder Rolle erlauben diese Aktion nicht.
`NOT_FOUND`	404	Die Ressource existiert nicht oder gehört zu einem anderen Workspace.
`RATE_LIMITED`	429	Zu viele Anfragen — wiederholen Sie die Anfrage nach dem angegebenen Intervall.
`PROVIDER_ERROR`	502	Ein vorgelagerter KI-Anbieter ist fehlgeschlagen. Credits werden erstattet und die Anfrage kann wiederholt werden.

API-Zugang

Bereit für die Integration?

API-Zugang ist in Enterprise-Plänen verfügbar, inklusive geführtem Onboarding und SLA. Buchen Sie eine Demo; wir gehen Ihre Integration gemeinsam durch.

Demo buchen Preise ansehen