Skip to main content
Erstelle ein eigenes Modell in einer von vier Kategorien — style, object, person oder setting — aus 1–10 Referenzbildern. Sobald completed, kann das Modell in Bildgenerierung, Magic Edit und gestyltes Video eingebunden werden.

​
Zwei Wege, Referenzbilder einzureichen

  • Inline — POST /models mit jedem Bild als https url oder inline base64 + mime_type. Am einfachsten für kleine Bilder und Remote-URLs.
  • Presigned Upload — für große Dateien: Rufe POST /models/prepare auf, um presigned PUT-URLs zu erhalten, PUT jede Datei, dann POST /models/{id}/complete, um die Verarbeitung zu starten.
Beide Wege erfordern den models.write Scope.

​
Stets angewandte Instruction

Jedes Modell trägt eine optionale instruction — stets angewandte Guidance (max. 8000 Zeichen). Anders als ein Prompt pro Anfrage wird sie als verbindliche (“MUST FOLLOW”) Vorgabe in jede Bild- und Videogenerierung eingespeist, die das Modell komponiert, sodass Brand-Regeln (“immer ein nahtloser weißer Hintergrund”) greifen, ohne sie bei jedem Aufruf zu wiederholen. Sie ist vom default_prompt des Modells zu unterscheiden — einer KI-generierten Fähigkeitsbeschreibung, die ebenfalls bei der Generierung angehängt wird. Setze sie bei der Erstellung und ändere sie jederzeit mit PATCH /models/{id}; beim Abruf wird sie als user_instruction zurückgegeben.

​
Asynchrones Muster

Die Erstellung gibt 202 Accepted mit einer Modell-id zurück; frage GET /models/{id}/status ab, bis status gleich completed (oder failed) ist. Ein webhook_url gibt dir einen Push-Callback — siehe Webhooks. Die Modellerstellung ist kostenlos — ihr estimated_credits ist 0 —, erfordert aber weiterhin ein aktives Organisations-Abo; eine Organisation ohne nutzbares Abo liefert 402. Siehe Preise.