Creative
Betacreative_upload_url_create
Create a signed file upload URL for the connected workspace.
Operation Write. Requires read-and-write OAuth consent.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
body | object | Yes | File metadata. |
body.content_type | string | Yes | File MIME type, for example image/png. |
body.size_bytes | integer | Yes | Exact size in bytes, from 1 to 2,147,483,648. |
body.filename | string | No | Original filename, up to 255 characters. |
idempotency_key | string | Yes | Key for this upload request. |
approval_receipt | string | No | Receipt 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.