Antimatter

PUT/api/studio/shares/{id}/posterSigned in session

The sharer's own browser draws it from the take: WebP or JPEG, its bytes the body, at most 256 KiB, checked by its bytes. A second poster replaces the first. The signed in account; same origin for a write.

Parameters

Path and query parameters
Field	Type	What it is
id (path)required	string	The link's id: 22 characters of base64url.

Request body

image/webp, required

The document names no fields for this body.

Answer 200

The link, its poster kept.

Fields of the 200 answer
Field	Type	What it is
idrequired	string
objectrequired	string	One of "studio.share".
asset_idrequired	string
job_idrequired	string or null	The job that made the take, when a job did.
doc_asset_idrequired	string or null	The editor's own asset id the file was uploaded under, when one was named.
promptrequired	string or null
modelrequired	string or null
titlerequired	string or null	The title the sharer gave the link, on its page and its card.
settingsrequired	object or null	The take's settings, which a remix from the public feed starts from.
settings.model	string
settings.camera	string
settings.look	string
settings.seconds	number
settings.aspect	string
posterrequired	boolean	A poster frame is kept for the link card.
listed_atrequired	integer or null	Listed in the public feed since (unix seconds), by the sharer's choice.
hiddenrequired	boolean	The operator hid the listing from the feed.
viewsrequired	integer	Visitors who watched it from the feed or its page, each once a UTC day.
urlrequired	string	The page's path on this origin, /studio/share/{id}.
created_atrequired	integer
revoked_atrequired	integer or null

Errors

400OpenAI shaped error.
401OpenAI shaped error.
403OpenAI shaped error.
404OpenAI shaped error.
413OpenAI shaped error.
429OpenAI shaped error.

Every error answers in one shape, with its type, code and the field it names. The whole list is in the docs' Errors section.