Creative
Beta

creative_upload_url_create

Create a signed file upload URL for the connected workspace.

Operation Write. Requires read-and-write OAuth consent.

Parameters

ParameterTypeRequiredDescription
bodyobjectYesFile metadata.
body.content_typestringYesFile MIME type, for example image/png.
body.size_bytesintegerYesExact size in bytes, from 1 to 2,147,483,648.
body.filenamestringNoOriginal filename, up to 255 characters.
idempotency_keystringYesKey for this upload request.
approval_receiptstringNoReceipt from the plan. Supply it after confirmation.

After confirmation, resubmit the call with its approval_receipt. Within 15 minutes, send the raw file bytes in a client-side PUT to data.upload_url with data.upload_headers unchanged. The signed URL authorizes the PUT. Keep the Orchestor API key out of that request.

After the PUT succeeds, pass data.public_url in body.image_urls to creative_generate_image with a model that accepts reference images. The read URL is valid for seven days from issuance.

Sample prompt

Upload my local product.png and use it as a reference for a new product photo.