Starts a video generation for the signed-in user (text-to-video, image-to-video, motion control, Seedance edit/extend, Genjutsu, etc.). When to use: only after estimate_cost with matching inputs. Cost: spends credits up to max_credits when queued. Returns: generation_id and polling guidance. See estimate_cost for which source fields apply to each mode.
View input schema
{
"type": "object",
"properties": {
"model_id": {
"description": "Video model slug.",
"minLength": 1,
"title": "Model Id",
"type": "string"
},
"prompt": {
"description": "User prompt; required for most modes.",
"minLength": 1,
"title": "Prompt",
"type": "string"
},
"max_credits": {
"description": "User-approved credit ceiling from estimate_cost.",
"minimum": 0,
"title": "Max Credits",
"type": "integer"
},
"mode": {
"default": "text_to_video",
"description": "Video generation mode.",
"enum": [
"text_to_video",
"image_to_video",
"motion_control",
"motion_transfer",
"object_swap",
"restyle",
"video_edit",
"video_extend",
"reference_to_video"
],
"title": "Mode",
"type": "string"
},
"template_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Genjutsu: Explore template slug.",
"title": "Template Slug"
},
"video_upload_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Genjutsu: source video upload id. reference_to_video: one reference video (prefer reference_video_upload_ids).",
"title": "Video Upload Id"
},
"video_generation_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Genjutsu: source video generation id.",
"title": "Video Generation Id"
},
"video_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Genjutsu: source video https URL.",
"title": "Video Url"
},
"image_upload_ids": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Genjutsu slots; also reference images for reference_to_video and kling-4 video_edit (upload ids).",
"title": "Image Upload Ids"
},
"image_generation_ids": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Genjutsu slots; also reference images for reference_to_video and kling-4 video_edit (image generation ids).",
"title": "Image Generation Ids"
},
"image_urls": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Genjutsu slots; also reference images for reference_to_video and kling-4 video_edit (https URLs).",
"title": "Image Urls"
},
"preset_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Genjutsu restyle preset id.",
"title": "Preset Id"
},
"character_upload_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "motion_control: character still upload id.",
"title": "Character Upload Id"
},
"character_generation_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "motion_control: character still generation id.",
"title": "Character Generation Id"
},
"character_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "motion_control: character still https URL.",
"title": "Character Image Url"
},
"motion_upload_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "motion_control: motion clip upload id.",
"title": "Motion Upload Id"
},
"motion_generation_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "motion_control: motion clip generation id.",
"title": "Motion Generation Id"
},
"motion_video_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "motion_control: motion clip https URL.",
"title": "Motion Video Url"
},
"duration": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Output duration in seconds when applicable.",
"title": "Duration"
},
"aspect_ratio": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Output aspect ratio when supported.",
"title": "Aspect Ratio"
},
"quality": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Video quality tier (model-specific).",
"title": "Quality"
},
"generate_audio": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Whether to generate audio when supported.",
"title": "Generate Audio"
},
"options": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "Model-specific extra options.",
"title": "Options"
},
"source_generation_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "image_to_video: start frame from a Vidaro image generation id.",
"title": "Source Generation Id"
},
"source_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "image_to_video: https URL of start image.",
"title": "Source Image Url"
},
"source_upload_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "image_to_video: upload id of start image.",
"title": "Source Upload Id"
},
"source_video_generation_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "video_edit/extend: source Vidaro video generation id.",
"title": "Source Video Generation Id"
},
"source_video_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "video_edit/extend: source video https URL.",
"title": "Source Video Url"
},
"source_video_upload_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "video_edit/extend: source video upload id.",
"title": "Source Video Upload Id"
},
"result_index": {
"default": 0,
"description": "When source generation has multiple outputs, pick result index.",
"minimum": 0,
"title": "Result Index",
"type": "integer"
},
"end_frame_upload_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "image_to_video: optional end frame as an upload id (models with an end-frame slot; see get_model images.slots).",
"title": "End Frame Upload Id"
},
"end_frame_generation_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "image_to_video: optional end frame from a completed Vidaro image generation id.",
"title": "End Frame Generation Id"
},
"end_frame_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "image_to_video: optional end frame as a public https image URL.",
"title": "End Frame Image Url"
},
"keyframe_upload_ids": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "image_to_video: ordered middle keyframes as upload ids (e.g. kling-4, max 8; see get_model images.lists).",
"title": "Keyframe Upload Ids"
},
"keyframe_generation_ids": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "image_to_video: middle keyframes from Vidaro image generation ids (added after keyframe_upload_ids).",
"title": "Keyframe Generation Ids"
},
"keyframe_image_urls": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "image_to_video: middle keyframes as https image URLs (added last).",
"title": "Keyframe Image Urls"
},
"reference_video_upload_ids": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "reference_to_video: reference videos as upload ids (kling-4 max 5, minimax-h3 max 3).",
"title": "Reference Video Upload Ids"
},
"reference_video_generation_ids": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "reference_to_video: reference videos from Vidaro video generation ids.",
"title": "Reference Video Generation Ids"
},
"reference_video_urls": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "reference_to_video: reference videos as public https URLs.",
"title": "Reference Video Urls"
}
},
"required": [
"model_id",
"prompt",
"max_credits"
],
"title": "generate_videoArguments"
}