> ## Documentation Index
> Fetch the complete documentation index at: https://runcrate.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Veo 3 Video API

> Generate AI videos with synchronized audio using Google Veo 3. Text-to-video with automatic sound design through a single API.

export const RuncrateStyles = () => {
  if (typeof document !== 'undefined' && !document.getElementById('runcrate-overrides')) {
    const s = document.createElement('style');
    s.id = 'runcrate-overrides';
    s.textContent = `
      /* Match Runcrate's rounding scale (--radius: 0.75rem) */
      .rounded-sm { border-radius: 0.5rem !important; }   /* 8px */
      .rounded-md { border-radius: 0.625rem !important; } /* 10px */
      .rounded-lg { border-radius: 0.75rem !important; }  /* 12px */
      .rounded-l-sm { border-top-left-radius: 0.5rem !important; border-bottom-left-radius: 0.5rem !important; }
      .rounded-r-sm { border-top-right-radius: 0.5rem !important; border-bottom-right-radius: 0.5rem !important; }
      .rounded-l-md { border-top-left-radius: 0.625rem !important; border-bottom-left-radius: 0.625rem !important; }
      .rounded-r-md { border-top-right-radius: 0.625rem !important; border-bottom-right-radius: 0.625rem !important; }
      .rounded-l-lg { border-top-left-radius: 0.75rem !important; border-bottom-left-radius: 0.75rem !important; }
      .rounded-r-lg { border-top-right-radius: 0.75rem !important; border-bottom-right-radius: 0.75rem !important; }

      /* Cards: never pure white in light mode */
      .card { background-color: #fcfcfc !important; border-radius: 0.75rem !important; }
      html.dark .card { background-color: #141414 !important; }

      /* Docs hero box */
      .rc-hero { background-color: #fcfcfc; border: 1px solid #e0e0e0; }
      html.dark .rc-hero { background-color: #141414; border-color: #242424; }
      html.dark .rc-hero h1 { color: #f5f5f5; }

      /* Runcrate scrollbar — thin, transparent track, hide-until-hover thumb */
      ::-webkit-scrollbar { width: 6px; height: 6px; background-color: transparent; }
      ::-webkit-scrollbar-track { background-color: transparent; }
      ::-webkit-scrollbar-thumb { background-color: rgba(155, 155, 155, 0.5); border-radius: 10px; transition: opacity 0.3s ease; opacity: 0; }
      ::-webkit-scrollbar-thumb:hover { background-color: rgba(155, 155, 155, 0.7); }
      *:hover::-webkit-scrollbar-thumb,
      *:focus::-webkit-scrollbar-thumb,
      *:active::-webkit-scrollbar-thumb { opacity: 1; }
      * { scrollbar-width: thin; scrollbar-color: rgba(155, 155, 155, 0.5) transparent; }
    `;
    document.head.appendChild(s);
  }
  return null;
};

<RuncrateStyles />

Veo 3 generates video with synchronized audio in a single pass. Ambient sounds, dialogue, and effects are inferred from your prompt — no separate audio pipeline.

## Available models

| Model                  | Audio          | Speed  | Best for                 |
| ---------------------- | -------------- | ------ | ------------------------ |
| **Veo 3.0 Audio**      | Auto-generated | Medium | Videos with sound        |
| **Veo 3.0 Fast Audio** | Auto-generated | Fast   | Quick drafts with sound  |
| **Veo 2.0**            | None           | Medium | Silent video, lower cost |

***

## Video with audio

<CodeGroup>
  ```python Python theme={"theme":"github-dark"}
  from runcrate import Runcrate

  client = Runcrate(api_key="rc_live_YOUR_API_KEY")
  job = client.models.generate_video_and_save(
      "cafe-scene.mp4",
      model="google/veo-3.0-audio",
      prompt="Barista pouring latte art, espresso machine hissing, cups clinking, ambient cafe chatter",
      duration=6,
      on_status=lambda j: print(f"  {j.status}..."),
  )
  ```

  ```typescript TypeScript theme={"theme":"github-dark"}
  import Runcrate from '@runcrate/sdk';

  const rc = new Runcrate({ apiKey: 'rc_live_YOUR_API_KEY' });
  const job = await rc.models.generateVideo({
    model: 'google/veo-3.0-audio',
    prompt: 'Barista pouring latte art, espresso machine hissing, cups clinking',
    duration: 6,
  });
  let status = job;
  while (status.status !== 'completed' && status.status !== 'failed') {
    await new Promise(r => setTimeout(r, 5000));
    status = await rc.models.getVideoStatus(job.id);
  }
  await Bun.write('cafe-scene.mp4', await rc.models.downloadVideo(job.id));
  ```

  ```bash curl theme={"theme":"github-dark"}
  curl https://api.runcrate.ai/v1/videos \
    -H "Authorization: Bearer rc_live_YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"model": "google/veo-3.0-audio", "prompt": "Barista pouring latte art, espresso machine hissing", "duration": 6}'
  ```
</CodeGroup>

***

All examples below use the same `client` from above.

## Fast audio drafts

```python theme={"theme":"github-dark"}
client.models.generate_video_and_save(
    "draft.mp4", model="google/veo-3.0-fast-audio",
    prompt="Dog running through autumn leaves, leaves crunching, birds chirping",
    duration=4, on_status=lambda j: print(f"  {j.status}..."),
)
```

***

## Silent video (Veo 2)

When adding your own audio in post-production:

```python theme={"theme":"github-dark"}
client.models.generate_video_and_save(
    "mountains.mp4", model="google/veo-2.0",
    prompt="Aerial drone shot through misty mountain peaks at sunrise, cinematic color grading",
    duration=8, on_status=lambda j: print(f"  {j.status}..."),
)
```

***

## Audio prompting

Be explicit about sounds in your prompt:

```python theme={"theme":"github-dark"}
client.models.generate_video_and_save(
    "storm.mp4", model="google/veo-3.0-audio",
    prompt="Lightning over a dark ocean, deep rumbling thunder, rain hitting water, wind howling",
    duration=8, on_status=lambda j: print(f"  {j.status}..."),
)
```

<Tip>
  Words like "hissing", "clinking", "rustling", and "crackling" in your prompt help the model generate more accurate audio.
</Tip>

***

## Tips

* **Audio is automatic.** The audio variants produce video with matching sound in one pass.
* **Describe sounds explicitly.** "Rain hitting a window" beats "rainy scene" for audio quality.
* **Veo 2 for silent.** If adding your own music/voiceover, use Veo 2.0 to avoid paying for unused audio.
* **Duration.** All Veo models support 4, 6, and 8 second durations.
