Set product
set_productChanges a project's product, or adds photos and videos to it. Same inputs as create_project.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| media | No | Product photos and videos to add by URL (in addition to any found on product_url). For local files use create_media_upload. Media requirements: - Photos: JPEG, PNG or WebP; at least 480×480 px; at most 15 MB. Clear, well-lit shots of the real product, one product per photo, no collages or heavy text overlays. - Videos: MP4 or MOV (H.264 recommended); 1–60 seconds; at most 50 MB; vertical 9:16 recommended. Clips play muted. A video only appears in the ad through a custom-footage moment (add_moment, type custom-footage): uploading it alone does nothing. - Physical products: tag every photo with the view it shows (front, left, rear, a 3/4 view…, `detail` for a close-up, `size-reference` for a scale shot). A front photo is strongly recommended. - `detail` photos, and every photo of a digital product or service, need a description (≤240 characters) of what they show. - At most 8 files per call. | |
| project_id | Yes | The project's id. | |
| product_url | No | The product page. Its name, description, campaign facts and up to 3 photos are imported (5 credits). | |
| product_name | No | ||
| product_type | No | ||
| product_description | No | What the product is and does, factually, in 2–3 sentences. |