Generate Pollinations Video
pollinations_generate_videoGenerate videos from text prompts or reference images using Pollinations video models, returning the final video URL for immediate use.
Instructions
Generate a video from a text prompt using Pollinations video models. This calls GET /video/{prompt} and returns the final media URL plus response metadata. Use this when the user wants text-to-video or image-to-video output. For static images, use pollinations_generate_image instead. Args: - prompt (string, required): Text description of the video. Include subject, scene, motion, camera movement, mood, lighting, style, and any timing notes. - model (string, required): Pollinations video model slug. Known video models include veo, seedance-pro, seedance-2.0, wan, wan-fast, wan-pro, wan-pro-1080p, grok-video-pro, ltx-2, p-video-720p, p-video-1080p, nova-reel. Call pollinations_list_models with modality=video first for current capabilities/pricing. - duration (number, optional, 1-120): Duration in seconds. Model rules vary: veo supports 4, 6, or 8s; seedance supports 2-10s; seedance-2.0 supports 4-15s; wan supports 2-15s; nova-reel supports 6-120s in multiples of 6. - aspectRatio (string, optional): 16:9 or 9:16. Use 16:9 for landscape, 9:16 for vertical/social video. If omitted, Pollinations may derive it from width/height. - width and height (numbers, optional): Requested dimensions. Video models map these to nearest supported resolution tiers such as 480p, 720p, or 1080p. - image (string or string[], optional): Reference frame URL(s). For video, image[0] is the start frame. image[1] is the end frame for models with end_frame support. End frame is documented for veo, seedance, seedance-2.0, and wan-fast; other models may ignore image[1]. - audio (boolean, optional): Request generated audio where supported. For veo, set true to enable audio. wan may generate audio regardless of this flag. - seed (number, optional): Reproducibility seed. Use -1 for random. Supported by seedance and nova-reel; unsupported models may ignore it. - quality (string, optional): low, medium, high, or hd. Unsupported models may ignore it. - safe (string, optional): Comma-separated safety filters: privacy, secrets, sexual, violence, shield, true, nsfw. - save_output (boolean, optional, default true): Download and save the returned video URL to a local file and include the path in the result. - output_dir (string, optional): Directory for saved files. Defaults to NECTAR_OUTPUT_DIR or ./nectar-output relative to the server process. - filename_prefix (string, optional): Prefix for saved video filenames. Nectar sanitizes this value. - response_format (string, optional, default markdown): markdown summary or json metadata. Returns: Markdown or JSON containing the video URL, content type, and content length when available. Examples: Use model=veo duration=8 aspectRatio=16:9 for a polished landscape clip. Use image=[startUrl,endUrl] with seedance-2.0 or wan-fast for first/last-frame interpolation. Use aspectRatio=9:16 for TikTok/Reels style output. Error handling: 401 means missing/invalid POLLINATIONS_API_KEY. 402 means insufficient pollen. 403 means key/model permission issue. 429 means wait and retry. 400 often means invalid duration/aspect/model combination; call pollinations_list_models and retry with supported values.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| safe | No | Optional comma-separated safety filters: privacy, secrets, sexual, violence, shield, true, nsfw. true enables privacy,secrets. nsfw enables sexual,violence. | |
| seed | No | Optional seed. Use -1 for random. Supported by seedance and nova-reel according to current docs; unsupported models may ignore it. | |
| audio | No | Whether to request generated audio when the model supports it. For veo, true enables audio. wan may generate audio regardless. | |
| image | No | Optional reference image URL or up to two URLs. image[0] is the start frame. image[1] is the end frame for models that support end_frame, documented for veo, seedance, seedance-2.0, and wan-fast. | |
| model | Yes | Required Pollinations video model slug. Examples: veo, seedance-pro, seedance-2.0, wan, wan-fast, wan-pro, wan-pro-1080p, grok-video-pro, ltx-2, p-video-720p, p-video-1080p, nova-reel. Call pollinations_list_models with modality=video if unsure. | |
| width | No | Optional requested width in pixels. Video models map this to the nearest supported tier such as 480p, 720p, or 1080p. | |
| height | No | Optional requested height in pixels. Video models map this to the nearest supported tier such as 480p, 720p, or 1080p. | |
| prompt | Yes | Required text description of the video. Include scene, subject, motion, camera movement, style, lighting, and timing notes. | |
| quality | No | Optional quality level. Unsupported models may ignore it. | |
| duration | No | Video duration in seconds. Model support varies: veo 4/6/8; seedance 2-10; seedance-2.0 4-15; wan 2-15; nova-reel 6-120 in multiples of 6. | |
| output_dir | No | Directory where generated video files should be saved. Defaults to NECTAR_OUTPUT_DIR or ./nectar-output. | |
| aspectRatio | No | Optional video aspect ratio. Use 16:9 for landscape and 9:16 for vertical/social video. If omitted, Pollinations may derive it from width and height. | |
| save_output | No | Download and save the generated video URL to a local file. | |
| filename_prefix | No | Optional prefix for saved video filenames. Example: product-teaser or intro-clip. | |
| response_format | No | MCP response format: markdown for readable summaries, json for returned URL/content metadata plus saved_files metadata when saving is enabled. | markdown |