Use Veo 3 in OpenClaw.
Veo 3 is Google DeepMind's video generation model that produces 1080p clips up to 8 seconds with native audio — synchronized dialogue, ambient sound, and music generated alongside the video. OpenClaw agents call it through the same RunAPI key and endpoint used for chat, with no extra skills to install.
Generate a cinematic video clip with native audio using Google Veo 3 through RunAPI.
Requirements:
- Read the API key from RUNAPI_API_KEY. Do not hardcode the key.
- Send a POST request to https://runapi.ai/api/v1/veo_3_1/text_to_video
- Set model to "veo-3.1".
- Write a descriptive prompt including scene, camera movement, and audio cues.
- Set duration_seconds to 4, 6, or 8.
- Set aspect_ratio to "16:9", "9:16", or "auto".
- The task is async. Poll the returned task_id until status is "completed".
- When done, read the video URL from the response output.
curl -X POST https://runapi.ai/api/v1/veo_3_1/text_to_video \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "veo-3.1",
"prompt": "A woman walks through a bustling Tokyo street at night, neon signs reflecting on wet pavement. She speaks into her phone: I just arrived. Ambient city noise, distant car horns, light rain.",
"duration_seconds": 8,
"aspect_ratio": "16:9"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "veo-3.1"
}
Use Veo 3 in OpenClaw in three steps
Configure RunAPI
Set the RUNAPI_API_KEY environment variable. If you already configured RunAPI as an OpenClaw provider for chat, the same key works for video generation — no additional setup or provider accounts.
export RUNAPI_API_KEY=runapi_xxx
Call Veo 3 text_to_video
Send a POST to the text_to_video endpoint with model set to veo-3.1. Include a prompt with scene descriptions and audio cues (dialogue, ambient sounds). Set duration_seconds to 4, 6, or 8 and aspect_ratio to 16:9 or 9:16.
POST /api/v1/veo_3_1/text_to_video
Poll for the result
The endpoint returns a task_id immediately. Poll the task status endpoint until the status changes to completed, then retrieve the output video URL. The video includes synchronized audio generated from your prompt.
GET /api/v1/veo_3_1/text_to_video/tsk_abc123
Veo 3 text_to_video parameters
| Parameter | Type | Description |
|---|---|---|
model |
string |
Required. veo-3.1 (standard quality) or veo-3.1-fast (lower cost, faster generation). |
prompt |
string |
Required. Scene description including visual action, camera movement, and audio cues for dialogue or ambient sound. |
duration_seconds |
integer |
Optional. Video length in seconds. Accepted values: 4, 6, 8. Defaults to 8. |
aspect_ratio |
string |
Optional. Output aspect ratio. Accepted values: 16:9, 9:16, auto. |
input_mode |
string |
Optional. Generation mode. text (default), first_and_last_frames (keyframe-guided), or reference (style reference). |
first_frame_image_url |
string |
Optional. URL of the first frame image. Used when input_mode is first_and_last_frames. |
last_frame_image_url |
string |
Optional. URL of the last frame image. Used when input_mode is first_and_last_frames. |
reference_image_urls |
array |
Optional. URLs of style reference images. Used when input_mode is reference. |
callback_url |
string |
Optional. Webhook URL that receives a POST when the task completes. |
What is Veo 3 on OpenClaw?
Veo 3 is Google DeepMind's video model that produces lifelike, cinematic visuals with spot-on ambient audio built in. It generates 1080p clips up to 8 seconds with synchronized dialogue, sound effects, and music -- no separate audio pipeline needed. OpenClaw agents call it through the RunAPI endpoint using the same API key configured for chat.
Veo 3 use cases
Street interview and talking scenes
Generate short video scenes with characters speaking dialogue. Describe the conversation in your prompt and Veo 3 produces synchronized lip movement and ambient city noise together.
Atmospheric and landscape content
Create travel vlogging scenes, rain-soaked urban environments, or foggy nature shots where Veo 3's ambient sound generation adds depth without post-production audio work.
Product demo videos with voiceover
Generate product showcase clips where a narrator describes features. Include the voiceover text in your prompt and Veo 3 renders both the visual demo and spoken audio in one pass.
Veo 3 + OpenClaw questions
Yes. OpenClaw agents call the RunAPI Veo 3 text_to_video endpoint directly. Set model to veo-3.1 and send the request with the same RUNAPI_API_KEY you use for chat. No additional skills, plugins, or Google Cloud accounts required.
Veo 3 is a paid model on RunAPI. Each generation is billed per task based on duration and quality tier. veo-3.1-fast costs less than veo-3.1. Check the RunAPI pricing page for current rates. No subscription required -- you pay per generation.
Veo 3 generates both video and synchronized audio in a single pass, which takes more processing time. Generation typically takes 60 to 180 seconds. Use veo-3.1-fast for quicker turnaround when iterating on drafts.
Yes. RunAPI exposes extend_video and upscale_video endpoints for Veo 3. Pass the source_task_id from the original generation to extend the clip, or upscale to 1080p or 4K resolution. Both are async and billed separately.
Veo 3 generates clips of 4, 6, or 8 seconds at up to 1080p base resolution. You can upscale completed videos to 4K using the upscale_video endpoint. Aspect ratio options are 16:9, 9:16, and auto.
OpenClaw general setup
Not configured yet? Start with the RunAPI setup guide for OpenClaw.
OpenClaw setup guide →Try Veo 3 in OpenClaw today.
Get a free RunAPI key, paste the prompt into OpenClaw, and generate cinematic video with native audio using Google Veo 3.