v1

latestOpenAPI 3.1.02026-07-26202332.6 KB

Upload File

Upload a file once and get back a file_* reference id you can reuse across generations.

The same reference can be passed to realtime set_image as image_ref, avoiding a re-upload of the underlying bytes on every call.

post/v1/files

Headers

x-api-keystring required

API key for authentication

API key for authentication

User-Agentstring nullable

Response

Successful Response

idstring required
filenamestring nullable required
mime_typestring required
size_bytesinteger required
created_atstring date-time required
expires_atstring date-time nullable required