Create project
create_projectStarts a new video ad for a product. Give product_url to import it, or product_name and product_description; add photos and videos by URL with media. Returns the project and the next step.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "create_project"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Defaults to the product name. | |
| 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. | |
| language | No | Ask the user which language the ad is spoken in unless it is obvious (a Spanish market means "es"). Default en. One of: en (English), cs (Czech), nl (Dutch), de (German), it (Italian), pl (Polish), sk (Slovak), es (Spanish). Set it BEFORE the creative brief and script (create_project or set_narrator_voice): they are written in it. | |
| product_url | No | The product page. Its name, description, campaign facts and up to 3 photos are imported (7 credits). | |
| product_name | No | ||
| product_type | No | ||
| video_quality | No | Ask the user first. standard (default, affordable) or premium (Seedance 2.5, most realistic; English only for now, so not with a non-English language). It also decides how set_actor casts the actor: premium casts them on Seedream 5.0, the only faces Seedance films. | |
| language_accent | No | Optional regional accent, e.g. "Castilian Spanish" or "Mexican Spanish". Defaults to a native accent of the language; changing the language clears it. | |
| product_description | No | What the product is and does, factually, in 2–3 sentences. |