Media model reference

Native input schema for every underlying media model the generate_* verbs resolve to. Auto-generated from the catalog.

These are the underlying models the generate_image / generate_video / generate_audio verbs resolve to. You don't call them directly — you pick a model family with a verb and the platform adapts your inputs to the native shape below. This page documents that native shape for reference.

For the verbs, see agent-tools-reference and sdk-runtime-reference. For prices, see the pricing page.

Index


Images

openai/gpt-image-2

GPT Image 2 · text → image

Quality × size matrix. Set quality ∈ low|medium|high and size (e.g. 1024x1024).

Inputs

FieldTypeRequiredDefaultNotes
promptstringThe prompt for image generation. (max 32,000 chars, min 2 chars)
image_sizeenum"landscape_4_3"The size of the generated image. Supports preset names, explicit {width, height}, or 'auto' to let the model pick the best size. Concrete sizes must have both dimensions as multiples of 16, max edge 3840px, aspect ratio <= 3:1, total pixels between 655,360 and 8,294,400. Values: "square_hd" | "square" | "portrait_4_3" | "portrait_16_9" | "landscape_4_3" | "landscape_16_9" | "auto"
num_imagesinteger1Number of images to generate. (≥ 1, ≤ 4)
output_formatenum"png"Output format for the images. Values: "jpeg" | "png" | "webp"
qualityenum"high"Quality for the generated image. Use 'auto' to let the model pick the best quality for the prompt. Values: "auto" | "low" | "medium" | "high"

Output

Saved to your project drive at drive_path (mint a URL with puras.drive.url / the drive_url tool if you need one).

openai/gpt-image-2-edit

GPT Image 2 (edit) · image → image (edit)

Image-to-image edit. Quality × size matrix; provide image_url(s).

Inputs

FieldTypeRequiredDefaultNotes
image_urlsarray<string>The URLs of the images to use as a reference for the generation
promptstringThe prompt for image generation. (max 32,000 chars, min 2 chars)
image_sizeenum"auto"The size of the generated image. Use 'auto' to infer from input images. Values: "square_hd" | "square" | "portrait_4_3" | "portrait_16_9" | "landscape_4_3" | "landscape_16_9" | "auto"
mask_urlstringThe URL of the mask image to use for the generation. This indicates what part of the image to edit
num_imagesinteger1Number of images to generate. (≥ 1, ≤ 4)
output_formatenum"png"Output format for the images. Values: "jpeg" | "png" | "webp"
qualityenum"high"Quality for the generated image. Use 'auto' to let the model pick the best quality for the prompt. Values: "auto" | "low" | "medium" | "high"

Output

Saved to your project drive at drive_path (mint a URL with puras.drive.url / the drive_url tool if you need one).

bytedance/seedream-v4

Seedream v4 · text → image

Inputs

FieldTypeRequiredDefaultNotes
promptstringThe text prompt used to generate the image
enable_safety_checkerbooleantrueIf set to true, the safety checker will be enabled
enhance_prompt_modeenum"standard"The mode to use for enhancing prompt enhancement. Standard mode provides higher quality results but takes longer to generate. Fast mode provides average quality results but takes less time to generate. Values: "standard" | "fast"
image_sizeenum{height: 2048, width: 2048}The size of the generated image. Total pixels must be between 960x960 and 4096x4096. Values: "square_hd" | "square" | "portrait_4_3" | "portrait_16_9" | "landscape_4_3" | "landscape_16_9" | "auto" | "auto_2K" | "auto_4K"
max_imagesinteger1If set to a number greater than one, enables multi-image generation. The model will potentially return up to max_images images every generation, and in total, num_images generations will be carried out. In total, the number of images generated will be between num_images and max_images*num_images. (≥ 1, ≤ 6)
num_imagesinteger1Number of separate model generations to be run with the prompt. (≥ 1, ≤ 6)
seedintegerRandom seed to control the stochasticity of image generation

Output

Saved to your project drive at drive_path (mint a URL with puras.drive.url / the drive_url tool if you need one). Additional metadata available under meta (seed).

bytedance/seedream-v4-edit

Seedream v4 (edit) · image → image (edit)

Edit/composite reference images. Provide image_url (or list) plus a prompt.

Inputs

FieldTypeRequiredDefaultNotes
image_urlsarray<string>List of URLs of input images for editing. Presently, up to 10 image inputs are allowed. If over 10 images are sent, only the last 10 will be used
promptstringThe text prompt used to edit the image
enable_safety_checkerbooleantrueIf set to true, the safety checker will be enabled
enhance_prompt_modeenum"standard"The mode to use for enhancing prompt enhancement. Standard mode provides higher quality results but takes longer to generate. Fast mode provides average quality results but takes less time to generate. Values: "standard" | "fast"
image_sizeenum{height: 2048, width: 2048}The size of the generated image. The minimum total image area is 921600 pixels. Failing this, the image size will be adjusted to by scaling it up, while maintaining the aspect ratio. Values: "square_hd" | "square" | "portrait_4_3" | "portrait_16_9" | "landscape_4_3" | "landscape_16_9" | "auto" | "auto_2K" | "auto_4K"
max_imagesinteger1If set to a number greater than one, enables multi-image generation. The model will potentially return up to max_images images every generation, and in total, num_images generations will be carried out. In total, the number of images generated will be between num_images and max_images*num_images. The total number of images (image inputs + image outputs) must not exceed 15. (≥ 1, ≤ 6)
num_imagesinteger1Number of separate model generations to be run with the prompt. (≥ 1, ≤ 6)
seedintegerRandom seed to control the stochasticity of image generation

Output

Saved to your project drive at drive_path (mint a URL with puras.drive.url / the drive_url tool if you need one). Additional metadata available under meta (seed).

google/imagen-4

Imagen 4 · text → image

Inputs

FieldTypeRequiredDefaultNotes
promptstringThe text prompt to generate an image from. (max 5,000 chars, min 3 chars)
aspect_ratioenum"1:1"The aspect ratio of the generated image. Values: "1:1" | "16:9" | "9:16" | "4:3" | "3:4"
num_imagesinteger1The number of images to generate. (≥ 1, ≤ 4)
output_formatenum"png"The format of the generated image. Values: "jpeg" | "png" | "webp"
resolutionenum"1K"The resolution of the generated image. Values: "1K" | "2K"
safety_toleranceenum"4"The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict. Values: "1" | "2" | "3" | "4" | "5" | "6"
seedintegerThe seed for the random number generator

Output

Saved to your project drive at drive_path (mint a URL with puras.drive.url / the drive_url tool if you need one).

google/nano-banana-pro

Nano Banana Pro · text → image

Reasoning image gen with strong multi-language text rendering and native up-to-4K output. Set resolution ∈ 1K|2K|4K.

Inputs

FieldTypeRequiredDefaultNotes
promptstringThe text prompt to generate an image from. (max 50,000 chars, min 3 chars)
aspect_ratioenum"1:1"The aspect ratio of the generated image. Values: "auto" | "21:9" | "16:9" | "3:2" | "4:3" | "5:4" | "1:1" | "4:5" | "3:4" | "2:3" | "9:16"
enable_web_searchbooleanfalseEnable web search for the image generation task. This will allow the model to use the latest information from the web to generate the image
limit_generationsbooleanfalseExperimental parameter to limit the number of generations from each round of prompting to 1. Set to True to to disregard any instructions in the prompt regarding the number of images to generate
num_imagesinteger1The number of images to generate. (≥ 1, ≤ 4)
output_formatenum"png"The format of the generated image. Values: "jpeg" | "png" | "webp"
resolutionenum"1K"The resolution of the image to generate. Values: "1K" | "2K" | "4K"
safety_toleranceenum"4"The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict. Values: "1" | "2" | "3" | "4" | "5" | "6"
seedintegerThe seed for the random number generator
system_promptstring""Optional system instruction that steers the model's persona and output style across the request. Leave blank to omit; when provided, it is sent as the system instruction to Gemini (or as a system message on OpenAI-compatible providers). (max 50,000 chars)

Output

Saved to your project drive at drive_path (mint a URL with puras.drive.url / the drive_url tool if you need one).

google/nano-banana-pro-edit

Nano Banana Pro (edit) · image → image (edit)

Edit/compose from up to 14 reference images via image_urls + a prompt. Strong text rendering, native up-to-4K.

Inputs

FieldTypeRequiredDefaultNotes
image_urlsarray<string>The URLs of the images to use for image-to-image generation or image editing
promptstringThe prompt for image editing. (max 50,000 chars, min 3 chars)
aspect_ratioenum"auto"The aspect ratio of the generated image. Values: "auto" | "21:9" | "16:9" | "3:2" | "4:3" | "5:4" | "1:1" | "4:5" | "3:4" | "2:3" | "9:16"
enable_web_searchbooleanfalseEnable web search for the image generation task. This will allow the model to use the latest information from the web to generate the image
limit_generationsbooleanfalseExperimental parameter to limit the number of generations from each round of prompting to 1. Set to True to to disregard any instructions in the prompt regarding the number of images to generate
num_imagesinteger1The number of images to generate. (≥ 1, ≤ 4)
output_formatenum"png"The format of the generated image. Values: "jpeg" | "png" | "webp"
resolutionenum"1K"The resolution of the image to generate. Values: "1K" | "2K" | "4K"
safety_toleranceenum"4"The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict. Values: "1" | "2" | "3" | "4" | "5" | "6"
seedintegerThe seed for the random number generator
system_promptstring""Optional system instruction that steers the model's persona and output style across the request. Leave blank to omit; when provided, it is sent as the system instruction to Gemini (or as a system message on OpenAI-compatible providers). (max 50,000 chars)

Output

Saved to your project drive at drive_path (mint a URL with puras.drive.url / the drive_url tool if you need one).

kuaishou/kling-v3-image

Kling v3 (image) · text → image

Inputs

FieldTypeRequiredDefaultNotes
promptstringText prompt for image generation. Max 2500 characters. (max 2,500 chars)
aspect_ratioenum"16:9"Aspect ratio of generated images. Values: "16:9" | "9:16" | "1:1" | "4:3" | "3:4" | "3:2" | "2:3" | "21:9"
elementsarray<elementinput>Optional: Elements (characters/objects) to include in the image for face control. Each element can have a frontal image and optionally reference images
negative_promptstringNegative text prompt. It is recommended to supplement negative prompt information through negative sentences directly within positive prompts
num_imagesinteger1Number of images to generate (1-9). (≥ 1, ≤ 9)
output_formatenum"png"The format of the generated image. Values: "jpeg" | "png" | "webp"
resolutionenum"1K"Image generation resolution. 1K: standard, 2K: high-res. Values: "1K" | "2K"

Output

Saved to your project drive at drive_path (mint a URL with puras.drive.url / the drive_url tool if you need one).

kuaishou/kling-v3-image-edit

Kling v3 (image edit) · image → image (edit)

Edit/compose from a base reference image (+ optional extra references). Provide refs.

Inputs

FieldTypeRequiredDefaultNotes
image_urlstringReference image for image-to-image generation.

Max file size: 10.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s | | prompt | string | ✓ | — | Text prompt for image generation. Max 2500 characters. (max 2,500 chars) | | aspect_ratio | enum | | "16:9" | Aspect ratio of generated images. Values: "16:9" | "9:16" | "1:1" | "4:3" | "3:4" | "3:2" | "2:3" | "21:9" | | elements | array<elementinput> | | — | Optional: Elements (characters/objects) to include in the image for face control | | num_images | integer | | 1 | Number of images to generate (1-9). (≥ 1, ≤ 9) | | output_format | enum | | "png" | The format of the generated image. Values: "jpeg" | "png" | "webp" | | resolution | enum | | "1K" | Image generation resolution. 1K: standard, 2K: high-res. Values: "1K" | "2K" |

Output

Saved to your project drive at drive_path (mint a URL with puras.drive.url / the drive_url tool if you need one).


Videos

bytedance/seedance-2-t2v

Seedance 2.0 — text→video

720p–1080p text-to-video. Audio included. Per-second rate jumps at 1080p.

Inputs

FieldTypeRequiredDefaultNotes
promptstringThe text prompt used to generate the video
aspect_ratioenum"auto"The aspect ratio of the generated video. Use 16:9 for landscape, 9:16 for portrait/vertical, 1:1 for square, 21:9 for ultrawide cinematic, or auto to let the model decide. Values: "auto" | "21:9" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16"
bitrate_modeenum"standard"Output bitrate mode. 'high' requests a higher-quality, larger-file encode from the model; 'standard' uses the default bitrate. Values: "standard" | "high"
durationenum"auto"Duration of the video in seconds. Supports 4 to 15 seconds, or auto to let the model decide based on the prompt. Values: "auto" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "13" | "14" | "15"
generate_audiobooleantrueWhether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech. The cost of video generation is the same regardless of whether audio is generated or not
resolutionenum"720p"Video resolution - 480p for faster generation, 720p for balance, 1080p for high quality, 4k for highest quality. Values: "480p" | "720p" | "1080p" | "4k"

Output

Saved to your project drive at drive_path (mint a URL with puras.drive.url / the drive_url tool if you need one). Additional metadata available under meta (seed).

bytedance/seedance-2-i2v

Seedance 2.0 — image→video

Inputs

FieldTypeRequiredDefaultNotes
image_urlstringThe URL of the starting frame image to animate. Supported formats: JPEG, PNG, WebP. Max 30 MB
promptstringThe text prompt describing the desired motion and action for the video
aspect_ratioenum"auto"The aspect ratio of the generated video. Use 16:9 for landscape, 9:16 for portrait/vertical, 1:1 for square, 21:9 for ultrawide cinematic, or auto to infer from the input image. Values: "auto" | "21:9" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16"
bitrate_modeenum"standard"Output bitrate mode. 'high' requests a higher-quality, larger-file encode from the model; 'standard' uses the default bitrate. Values: "standard" | "high"
durationenum"auto"Duration of the video in seconds. Supports 4 to 15 seconds, or auto to let the model decide based on the prompt. Values: "auto" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "13" | "14" | "15"
end_image_urlstringThe URL of the image to use as the last frame of the video. When provided, the generated video will transition from the starting image to this ending image. Supported formats: JPEG, PNG, WebP. Max 30 MB
generate_audiobooleantrueWhether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech. The cost of video generation is the same regardless of whether audio is generated or not
resolutionenum"720p"Video resolution - 480p for faster generation, 720p for balance, 1080p for high quality, 4k for highest quality. Values: "480p" | "720p" | "1080p" | "4k"

Output

Saved to your project drive at drive_path (mint a URL with puras.drive.url / the drive_url tool if you need one). Additional metadata available under meta (seed).

bytedance/seedance-2-r2v

Seedance 2.0 — reference→video

Up to 9 image / 3 video / 3 audio references. Per-second drops 40% when a video reference is passed.

Inputs

FieldTypeRequiredDefaultNotes
promptstringThe text prompt used to generate the video
aspect_ratioenum"auto"The aspect ratio of the generated video. Use 16:9 for landscape, 9:16 for portrait/vertical, 1:1 for square, 21:9 for ultrawide cinematic, or auto to let the model decide. Values: "auto" | "21:9" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16"
audio_urlsarray<string>Reference audio to guide video generation. Refer to them in the prompt as @Audio1, @Audio2, etc. Supported formats: MP3, WAV. Up to 3 files, combined duration must not exceed 15 seconds. Max 15 MB per file.If audio is provided, at least one reference image or video is required
bitrate_modeenum"standard"Output bitrate mode. 'high' requests a higher-quality, larger-file encode from the model; 'standard' uses the default bitrate. Values: "standard" | "high"
durationenum"auto"Duration of the video in seconds. Supports 4 to 15 seconds, or auto to let the model decide based on the prompt. Values: "auto" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "13" | "14" | "15"
generate_audiobooleantrueWhether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech. The cost of video generation is the same regardless of whether audio is generated or not
image_urlsarray<string>Reference images to guide video generation. Refer to them in the prompt as @Image1, @Image2, etc. Supported formats: JPEG, PNG, WebP. Max 30 MB per image. Up to 9 images. Total files across all modalities must not exceed 12
resolutionenum"720p"Video resolution - 480p for faster generation, 720p for balance, 1080p for high quality, 4k for highest quality. Values: "480p" | "720p" | "1080p" | "4k"
video_urlsarray<string>Reference videos to guide video generation. Refer to them in the prompt as @Video1, @Video2, etc. Supported formats: MP4, MOV. Up to 3 videos, combined duration must be between 2 and 15 seconds, total size under 50 MB. Each video must be between ~480p (640x640) and ~720p (834x1112) in resolution

Output

Saved to your project drive at drive_path (mint a URL with puras.drive.url / the drive_url tool if you need one). Additional metadata available under meta (seed).

bytedance/seedance-2-fast-t2v

Seedance 2.0 Fast — text→video

Inputs

FieldTypeRequiredDefaultNotes
promptstringThe text prompt used to generate the video
aspect_ratioenum"auto"The aspect ratio of the generated video. Use 16:9 for landscape, 9:16 for portrait/vertical, 1:1 for square, 21:9 for ultrawide cinematic, or auto to let the model decide. Values: "auto" | "21:9" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16"
bitrate_modeenum"standard"Output bitrate mode. 'high' requests a higher-quality, larger-file encode from the model; 'standard' uses the default bitrate. Values: "standard" | "high"
durationenum"auto"Duration of the video in seconds. Supports 4 to 15 seconds, or auto to let the model decide based on the prompt. Values: "auto" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "13" | "14" | "15"
generate_audiobooleantrueWhether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech. The cost of video generation is the same regardless of whether audio is generated or not
resolutionenum"720p"Video resolution - 480p for faster generation, 720p for balance. Values: "480p" | "720p"

Output

Saved to your project drive at drive_path (mint a URL with puras.drive.url / the drive_url tool if you need one). Additional metadata available under meta (seed).

bytedance/seedance-2-fast-i2v

Seedance 2.0 Fast — image→video

Inputs

FieldTypeRequiredDefaultNotes
image_urlstringThe URL of the starting frame image to animate. Supported formats: JPEG, PNG, WebP. Max 30 MB
promptstringThe text prompt describing the desired motion and action for the video
aspect_ratioenum"auto"The aspect ratio of the generated video. Use 16:9 for landscape, 9:16 for portrait/vertical, 1:1 for square, 21:9 for ultrawide cinematic, or auto to infer from the input image. Values: "auto" | "21:9" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16"
bitrate_modeenum"standard"Output bitrate mode. 'high' requests a higher-quality, larger-file encode from the model; 'standard' uses the default bitrate. Values: "standard" | "high"
durationenum"auto"Duration of the video in seconds. Supports 4 to 15 seconds, or auto to let the model decide based on the prompt. Values: "auto" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "13" | "14" | "15"
end_image_urlstringThe URL of the image to use as the last frame of the video. When provided, the generated video will transition from the starting image to this ending image. Supported formats: JPEG, PNG, WebP. Max 30 MB
generate_audiobooleantrueWhether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech. The cost of video generation is the same regardless of whether audio is generated or not
resolutionenum"720p"Video resolution - 480p for faster generation, 720p for balance. Values: "480p" | "720p"

Output

Saved to your project drive at drive_path (mint a URL with puras.drive.url / the drive_url tool if you need one). Additional metadata available under meta (seed).

bytedance/seedance-2-fast-r2v

Seedance 2.0 Fast — reference→video

Inputs

FieldTypeRequiredDefaultNotes
promptstringThe text prompt used to generate the video
aspect_ratioenum"auto"The aspect ratio of the generated video. Use 16:9 for landscape, 9:16 for portrait/vertical, 1:1 for square, 21:9 for ultrawide cinematic, or auto to let the model decide. Values: "auto" | "21:9" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16"
audio_urlsarray<string>Reference audio to guide video generation. Refer to them in the prompt as @Audio1, @Audio2, etc. Supported formats: MP3, WAV. Up to 3 files, combined duration must not exceed 15 seconds. Max 15 MB per file.If audio is provided, at least one reference image or video is required
bitrate_modeenum"standard"Output bitrate mode. 'high' requests a higher-quality, larger-file encode from the model; 'standard' uses the default bitrate. Values: "standard" | "high"
durationenum"auto"Duration of the video in seconds. Supports 4 to 15 seconds, or auto to let the model decide based on the prompt. Values: "auto" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "13" | "14" | "15"
generate_audiobooleantrueWhether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech. The cost of video generation is the same regardless of whether audio is generated or not
image_urlsarray<string>Reference images to guide video generation. Refer to them in the prompt as @Image1, @Image2, etc. Supported formats: JPEG, PNG, WebP. Max 30 MB per image. Up to 9 images. Total files across all modalities must not exceed 12
resolutionenum"720p"Video resolution - 480p for faster generation, 720p for balance. Values: "480p" | "720p"
video_urlsarray<string>Reference videos to guide video generation. Refer to them in the prompt as @Video1, @Video2, etc. Supported formats: MP4, MOV. Up to 3 videos, combined duration must be between 2 and 15 seconds, total size under 50 MB. Each video must be between ~480p (640x640) and ~720p (834x1112) in resolution

Output

Saved to your project drive at drive_path (mint a URL with puras.drive.url / the drive_url tool if you need one). Additional metadata available under meta (seed).

kuaishou/kling-v3-t2v

Kling v3 Pro — text→video

Set generate_audio: true to enable audio, voice_control: true for voice.

Inputs

FieldTypeRequiredDefaultNotes
aspect_ratioenum"16:9"The aspect ratio of the generated video frame. Values: "16:9" | "9:16" | "1:1"
cfg_scalenumber0.5The CFG (Classifier Free Guidance) scale is a measure of how close you want
        the model to stick to your prompt. (≥ 0, ≤ 1) |

| duration | enum | | "5" | The duration of the generated video in seconds. Values: "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "13" | "14" | "15" | | generate_audio | boolean | | true | Whether to generate native audio for the video. Supports Chinese and English voice output. Other languages are automatically translated to English. For English speech, use lowercase letters; for acronyms or proper nouns, use uppercase | | multi_prompt | array<klingv3multipromptelement> | | — | List of prompts for multi-shot video generation. If provided, overrides the single prompt and divides the video into multiple shots with specified prompts and durations | | negative_prompt | string | | "blur, distort, and low quality" | (max 2,500 chars) | | prompt | string | | — | Text prompt for video generation. Either prompt or multi_prompt must be provided, but not both | | shot_type | enum | | "customize" | The type of multi-shot video generation. 'intelligent' lets the model automatically determine shot structure. Values: "customize" | "intelligent" |

Output

Saved to your project drive at drive_path (mint a URL with puras.drive.url / the drive_url tool if you need one).

kuaishou/kling-v3-i2v

Kling v3 Pro — image→video

Inputs

FieldTypeRequiredDefaultNotes
start_image_urlstringURL of the image to be used for the video
cfg_scalenumber0.5The CFG (Classifier Free Guidance) scale is a measure of how close you want
        the model to stick to your prompt. (≥ 0, ≤ 1) |

| duration | enum | | "5" | The duration of the generated video in seconds. Values: "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "13" | "14" | "15" | | elements | array<klingv3comboelementinput> | | — | Elements (characters/objects) to include in the video. Each example can either be an image set (frontal + reference images) or a video. Reference in prompt as @Element1, @Element2, etc | | end_image_url | string | | — | URL of the image to be used for the end of the video | | generate_audio | boolean | | true | Whether to generate native audio for the video. Supports Chinese and English voice output. Other languages are automatically translated to English. For English speech, use lowercase letters; for acronyms or proper nouns, use uppercase | | multi_prompt | array<klingv3multipromptelement> | | — | List of prompts for multi-shot video generation. If provided, divides the video into multiple shots | | negative_prompt | string | | "blur, distort, and low quality" | (max 2,500 chars) | | prompt | string | | — | Text prompt for video generation. Either prompt or multi_prompt must be provided, but not both | | shot_type | enum | | "customize" | The type of multi-shot video generation. 'intelligent' lets the model automatically determine shot structure. Values: "customize" | "intelligent" |

Output

Saved to your project drive at drive_path (mint a URL with puras.drive.url / the drive_url tool if you need one).

kuaishou/kling-o3-r2v

Kling O3 Pro — reference→video

Reference-to-video on the Kling O3 line. Pass refs as image_urls; default 8s.

Inputs

FieldTypeRequiredDefaultNotes
aspect_ratioenum"16:9"The aspect ratio of the generated video frame. Values: "16:9" | "9:16" | "1:1"
durationenum"5"Video duration in seconds (3-15s). Values: "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "13" | "14" | "15"
elementsarray<klingv3comboelementinput>Elements (characters/objects) to include. Reference in prompt as @Element1, @Element2
end_image_urlstringImage to use as the last frame of the video
generate_audiobooleanfalseWhether to generate native audio for the video
image_urlsarray<string>Reference images for style/appearance. Reference in prompt as @Image1, @Image2, etc. Maximum 4 total (elements + reference images) when using video
multi_promptarray<klingv3multipromptelement>List of prompts for multi-shot video generation
promptstringText prompt for video generation. Either prompt or multi_prompt must be provided, but not both
shot_typeenum"customize"The type of multi-shot video generation. 'intelligent' lets the model automatically determine shot structure. Values: "customize" | "intelligent"
start_image_urlstringImage to use as the first frame of the video

Output

Saved to your project drive at drive_path (mint a URL with puras.drive.url / the drive_url tool if you need one).

kuaishou/kling-avatar-v2

Kling AI Avatar v2 Pro — lip-sync · video

Lip-synced talking-head from a portrait image_url + an audio_url. Output duration auto-matches the audio; framing follows the image. Optional prompt for delivery/expression. Billed per second of output.

Inputs

FieldTypeRequiredDefaultNotes
audio_urlstringThe URL of the audio file
image_urlstringThe URL of the image to use as your avatar
promptstring"."The prompt to use for the video generation

Output

Saved to your project drive at drive_path (mint a URL with puras.drive.url / the drive_url tool if you need one).

google/veo-3-t2v

Veo 3 — text→video

Inputs

FieldTypeRequiredDefaultNotes
promptstringThe text prompt describing the video you want to generate. (max 20,000 chars)
aspect_ratioenum"16:9"The aspect ratio of the generated video. Values: "16:9" | "9:16"
auto_fixbooleantrueWhether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them
durationenum"8s"The duration of the generated video. Values: "4s" | "6s" | "8s"
generate_audiobooleantrueWhether to generate audio for the video
negative_promptstringA negative prompt to guide the video generation
resolutionenum"720p"The resolution of the generated video. Values: "720p" | "1080p"
safety_toleranceenum"4"The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict. Values: "1" | "2" | "3" | "4" | "5" | "6"
seedintegerThe seed for the random number generator

Output

Saved to your project drive at drive_path (mint a URL with puras.drive.url / the drive_url tool if you need one).

google/veo-3-i2v

Veo 3 — image→video

Inputs

FieldTypeRequiredDefaultNotes
image_urlstringURL of the input image to animate. Should be 720p or higher resolution in 16:9 or 9:16 aspect ratio. If the image is not in 16:9 or 9:16 aspect ratio, it will be cropped to fit
promptstringThe text prompt describing how the image should be animated. (max 20,000 chars)
aspect_ratioenum"auto"The aspect ratio of the generated video. Values: "auto" | "16:9" | "9:16"
auto_fixbooleanfalseWhether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them
durationenum"8s"The duration of the generated video. Values: "4s" | "6s" | "8s"
generate_audiobooleantrueWhether to generate audio for the video
negative_promptstringA negative prompt to guide the video generation
resolutionenum"720p"The resolution of the generated video. Values: "720p" | "1080p"
safety_toleranceenum"4"The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict. Values: "1" | "2" | "3" | "4" | "5" | "6"
seedintegerThe seed for the random number generator

Output

Saved to your project drive at drive_path (mint a URL with puras.drive.url / the drive_url tool if you need one).

google/veo-3-fast-t2v

Veo 3 Fast — text→video

Inputs

FieldTypeRequiredDefaultNotes
promptstringThe text prompt describing the video you want to generate. (max 20,000 chars)
aspect_ratioenum"16:9"The aspect ratio of the generated video. Values: "16:9" | "9:16"
auto_fixbooleantrueWhether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them
durationenum"8s"The duration of the generated video. Values: "4s" | "6s" | "8s"
generate_audiobooleantrueWhether to generate audio for the video
negative_promptstringA negative prompt to guide the video generation
resolutionenum"720p"The resolution of the generated video. Values: "720p" | "1080p"
safety_toleranceenum"4"The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict. Values: "1" | "2" | "3" | "4" | "5" | "6"
seedintegerThe seed for the random number generator

Output

Saved to your project drive at drive_path (mint a URL with puras.drive.url / the drive_url tool if you need one).

google/veo-3-fast-i2v

Veo 3 Fast — image→video

Inputs

FieldTypeRequiredDefaultNotes
image_urlstringURL of the input image to animate. Should be 720p or higher resolution in 16:9 or 9:16 aspect ratio. If the image is not in 16:9 or 9:16 aspect ratio, it will be cropped to fit
promptstringThe text prompt describing how the image should be animated. (max 20,000 chars)
aspect_ratioenum"auto"The aspect ratio of the generated video. Values: "auto" | "16:9" | "9:16"
auto_fixbooleanfalseWhether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them
durationenum"8s"The duration of the generated video. Values: "4s" | "6s" | "8s"
generate_audiobooleantrueWhether to generate audio for the video
negative_promptstringA negative prompt to guide the video generation
resolutionenum"720p"The resolution of the generated video. Values: "720p" | "1080p"
safety_toleranceenum"4"The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict. Values: "1" | "2" | "3" | "4" | "5" | "6"
seedintegerThe seed for the random number generator

Output

Saved to your project drive at drive_path (mint a URL with puras.drive.url / the drive_url tool if you need one).

google/veo-3.1-r2v

Veo 3.1 — reference→video

Reference-to-video on Veo 3.1. Pass reference images as image_urls.

Inputs

FieldTypeRequiredDefaultNotes
image_urlsarray<string>URLs of the reference images to use for consistent subject appearance
promptstringThe text prompt describing the video you want to generate. (max 20,000 chars)
aspect_ratioenum"16:9"The aspect ratio of the generated video. Values: "16:9" | "9:16"
auto_fixbooleanfalseWhether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them
durationstring"8s"The duration of the generated video
generate_audiobooleantrueWhether to generate audio for the video
resolutionenum"720p"The resolution of the generated video. Values: "720p" | "1080p" | "4k"
safety_toleranceenum"4"The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict. Values: "1" | "2" | "3" | "4" | "5" | "6"

Output

Saved to your project drive at drive_path (mint a URL with puras.drive.url / the drive_url tool if you need one).


Audio

elevenlabs/scribe-v2

ElevenLabs Scribe v2 — speech→text

Speech-to-text with word-level timestamps. Pass audio_url; the call returns text + words (each with start/end seconds) instead of a file. Pass keyterms (brand / proper nouns) to bias the transcription. Billed per second of audio.

Inputs

FieldTypeRequiredDefaultNotes
audio_urlstringURL of the audio file to transcribe
diarizebooleantrueWhether to annotate who is speaking
keytermsarray<string>[]Words or sentences to bias the model towards transcribing. Up to 100 keyterms, max 50 characters each. Adds 30% premium over base transcription price
language_codestringLanguage code of the audio
tag_audio_eventsbooleantrueTag audio events like laughter, applause, etc

Output

Returns the transcript inline as text plus a words array (each word carries start/end seconds and type) and a detected language_code. No file is produced, so drive_path is empty.

elevenlabs/tts-v3

ElevenLabs v3 — expressive text→speech

Expressive multilingual text-to-speech (74 languages) that reads inline audio tags — wrap a cue in square brackets ([excited], [whispers], [laughs], [sighs], [sarcastic], [British accent]) and v3 shapes the read accordingly; the tag is acted, never spoken. Pass text, an optional voice (preset name like "Aria"/"Roger" or a voice id), and stability (0.0 = most expressive and tag-responsive, 0.5 = balanced, 1.0 = steadiest/least tag-responsive). v3 tunes delivery through tags + stability, so it ignores the style/speed/similarity_boost knobs — pick elevenlabs/tts-multilingual-v2 when you need those instead. Billed per character of text.

Inputs

FieldTypeRequiredDefaultNotes
textstringThe text to convert to speech. (max 5,000 chars, min 1 chars)
apply_text_normalizationenum"auto"This parameter controls text normalization with three modes: 'auto', 'on', and 'off'. When set to 'auto', the system will automatically decide whether to apply text normalization (e.g., spelling out numbers). With 'on', text normalization will always be applied, while with 'off', it will be skipped. Values: "auto" | "on" | "off"
language_codestringLanguage code (ISO 639-1) used to enforce a language for the model
stabilitynumber0.5Voice stability (0-1). (≥ 0, ≤ 1)
timestampsbooleanfalseWhether to return timestamps for each word in the generated speech
voicestring"Rachel"The voice to use for speech generation

Output

Saved to your project drive at drive_path (mint a URL with puras.drive.url / the drive_url tool if you need one).

elevenlabs/tts-multilingual-v2

ElevenLabs Multilingual v2 — text→speech

Natural multilingual text-to-speech (29 languages) with fine delivery controls — stability, style, speed, similarity_boost. Does not interpret audio tags (use elevenlabs/tts-v3 for [excited]/[whispers]-style direction). Pass text (and an optional voice). Billed per character of text.

Inputs

FieldTypeRequiredDefaultNotes
textstringThe text to convert to speech. (min 1 chars)
apply_text_normalizationenum"auto"This parameter controls text normalization with three modes: 'auto', 'on', and 'off'. When set to 'auto', the system will automatically decide whether to apply text normalization (e.g., spelling out numbers). With 'on', text normalization will always be applied, while with 'off', it will be skipped. Values: "auto" | "on" | "off"
language_codestringLanguage code (ISO 639-1) used to enforce a language for the model. An error will be returned if language code is not supported by the model
next_textstringThe text that comes after the text of the current request. Can be used to improve the speech's continuity when concatenating together multiple generations or to influence the speech's continuity in the current generation
previous_textstringThe text that came before the text of the current request. Can be used to improve the speech's continuity when concatenating together multiple generations or to influence the speech's continuity in the current generation
similarity_boostnumber0.75Similarity boost (0-1). (≥ 0, ≤ 1)
speednumber1Speech speed (0.7-1.2). Values below 1.0 slow down the speech, above 1.0 speed it up. Extreme values may affect quality. (≥ 0.7, ≤ 1.2)
stabilitynumber0.5Voice stability (0-1). (≥ 0, ≤ 1)
stylenumber0Style exaggeration (0-1). (≥ 0, ≤ 1)
timestampsbooleanfalseWhether to return timestamps for each word in the generated speech
voicestring"Rachel"The voice to use for speech generation

Output

Saved to your project drive at drive_path (mint a URL with puras.drive.url / the drive_url tool if you need one).