autoshort_generate_chat_video
Create a video from a natural-language creative brief; AutoShort writes the script from it. To keep an agreed script word for word with your own shots, use autoshort_draft_video instead. To use the user's own pictures ("make a video with these images"), pass image_urls (public https links, up to 6): image 1 becomes scene 1, image 2 scene 2, …; the rest are generated. Naming an image inside the brief does NOT attach it: only image_urls do. If the brief points at a picture you did not pass, the answer carries warnings["IMAGE_IGNORED"] with a warningText (read it to the user), or CHAT_NO_IMAGE_INPUT (retry with image_urls, or proceedWithoutImage: true). Optional captionSecondaryLanguage adds a translated second caption line under the narration captions (e.g. "vi" for English narration with Vietnamese under it); "none" turns it off for this video even if the account default has one; omitted = the account default (off unless the user set one). It costs nothing extra. Costs 40 credits with the default voice (+25 if ElevenLabs narrates); images do not change the price. Rendering is asynchronous: poll autoshort_get_video every 20-30 seconds until status is COMPLETED or FAILED. If get_video returns blockedReason, stop polling and act on it (e.g. top up credits). ROUTING: if the user pasted a cinematic / video-model prompt (camera, lens, lighting, a scene description), do NOT use this tool: it writes its own script and makes narrated still-image scenes. Use autoshort_generate_motion_clip, which sends the prompt as written. Use this tool for narrated stories and facts. videoProvider VEO_3_1_OPERATOR is operator-fulfilled and not guaranteed: it does not turn a prompt into a moving clip.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| message | Yes | Creative brief describing the desired video. | |
| artStyle | No | Art style returned by autoshort_list_niches. | |
| language | No | Narration language. Omit to detect it from the brief. | |
| image_urls | No | Optional. The user's OWN images to use as the first scenes: image 1 = scene 1, image 2 = scene 2, and so on; the remaining scenes are generated as usual. https URLs only, up to 6 per call, JPEG/PNG/WebP, each at most 10 MB and 25 megapixels; at most 30 images per hour per account. Animated WebP uses its first frame; GIF and SVG are rejected. AutoShort downloads each image once, strips EXIF/GPS, re-encodes it and serves it from its own domain (your URL is never linked into the video). Fast (FFMPEG) multi-scene videos only. The answer states how many images were used and for which scenes; more images than scenes is refused, never silently dropped. Only send images the user owns or may use; each is shown as a still with a slow zoom and is never animated or used to generate a person. | |
| aspectRatio | No | ||
| videoProvider | No | FFMPEG for fast multi-scene video; VEO_3_1_OPERATOR for cinematic quality when eligible. | |
| idempotencyKey | No | Retry-safe: a repeat with the same key returns the first answer (replayed: true) and creates nothing. | |
| targetDuration | No | Length in seconds. With image_urls and no targetDuration, 30 is used (6 scenes) so every image has a scene. | |
| proceedWithoutImage | No | Set true to create the video from the text even though the brief points at an image you did not pass in image_urls. Without it, a brief that clearly hands over a file ("the photo I attached", an image URL) is refused with CHAT_NO_IMAGE_INPUT before anything is charged; a softer mention creates the video and returns warnings: ["IMAGE_IGNORED"] + warningText. | |
| captionSecondaryLanguage | No | Second caption line language (translated, shown under the narration captions). "none" = no second line for this video. Omit to use the account default. Same language as the narration = ignored. |