Ein Modell aktualisieren
Aktualisiere die editierbaren Felder (Name, Default-Prompt, Instruction) eines deiner Modelle.
name, default_prompt und instruction sind editierbar; Eigentums- und
Datenschutzfelder können nicht geändert werden. instruction ist die stets angewandte Guidance des Modells
(max. 8000 Zeichen), die als verbindliche (“MUST FOLLOW”) Vorgabe in jede Bild- und Videogenerierung
eingespeist wird, die das Modell komponiert — sie entspricht dem user_instruction, das beim
Abruf des Modells zurückgegeben wird. Lasse ein Feld weg, um es unverändert zu
lassen — sende es nicht als explizites null (sende einen leeren String, um instruction zu löschen).
Unbekannte oder zu einer anderen Organisation gehörende ids liefern
404 not_found. Erfordert den models.write Scope.Autorisierungen
Organization API key as a bearer token: Authorization: Bearer samsa_sk_....
Pfadparameter
Body
PATCH /models/{id} body — the publicly editable fields only (ADR §10, ticket §3).
Ownership / privacy fields (owner_id, private, organization_id) are
intentionally NOT accepted. A field may be omitted (left unchanged) but must not
be sent as an explicit null — the runtime rejection lives in
_reject_explicit_null (mirroring ApiKeyUpdate), and
_string_only_patch_schema keeps the EXPORTED OpenAPI honest by advertising
each field as a plain string (no null branch) so generated clients and
the API playground cannot offer null as a value (SAM-639).
New model name.
1 - 100"Renamed Model"
New default prompt / capability description.
2000"A refined flat-design illustration in the Acme brand palette."
New always-applied model instruction (max 8000 chars) — injected into every generation that composes the model. Accepted on write under the name instruction (mirroring model creation); it maps to the user_instruction field returned on read (PublicModelDetail).
8000"Always render on a clean, seamless white background."
Antwort
Successful Response
A single model with full detail — the GET /models/{id} body (ADR §10).
"Acme Brand Style"
Creation status: pending, processing, completed, or failed.
pending, processing, completed, failed "completed"
True when the model is completed AND active — usable for generation.
true
Model category — one of style, object, person, setting.
style, object, person, setting "style"
Presigned, time-limited HTTPS thumbnail URL (null when the model has none).
"https://cdn.samsa.ai/models/…/thumbnail.webp?X-Amz-Signature=…"
Presigned, time-limited HTTPS URLs of the reference images used to create the model.
Free-text guidance for how to use the model.
"Use for hero banners and social posts."
The model's default prompt / capability description.
"A bold flat-design illustration in the Acme brand palette."
Trigger words associated with the model.

