Ana içeriğe geç
google avatarı

Veo 3.1 Extend Video API

google/veo-3.1/extend-video

Veo ile üretilmiş videoları metin prompt’larıyla uzatın: 7 saniyelik yüksek sadakatli görüntü ve senkronize ses kusursuzca eklenir.

uzatma
üretilen video için saniye başına 0.4

Model girdisi

Input

The text description for the video extension.

The URL of the Veo-generated video to extend. Must be a 720p video with 16:9 or 9:16 aspect ratio.

Text describing what not to include in the video.

The aspect ratio of the video.

You need to be logged in to run this model and view results.
Log in

Model çıktısı

Output

Fill in the input form and click submit to see the output
Logs (1 lines)

Veo 3.1 Extend Video API

Veo 3.1 Extend Video is a image-to-video AI model by google. On ModelRunner it runs through a REST API or via MCP from any AI assistant, at $0.4 per second of video.

POST https://queue.modelrunner.run/google/veo-3.1/extend-video

cURL

# Submit a request to the queue. Input fields go at the top level of the
# body. The optional reserved "metadata" object holds your own flat string
# tags — stored on the request, never sent to the model; filter later with
# GET https://queue.modelrunner.run/requests?metadata=<url-encoded JSON>.
curl -X POST https://queue.modelrunner.run/google/veo-3.1/extend-video \
  -H "Authorization: Key $MRUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "your prompt here",
    "video_url": "https://example.com/input.jpg",
    "metadata": {
      "project": "my-project"
    }
  }'
# → { "request_id": "...", "status_url": "...", "response_url": "..." }

# Poll status_url until "COMPLETED", then fetch the result
curl "https://queue.modelrunner.run/google/veo-3.1/extend-video/requests/$REQUEST_ID/status" \
  -H "Authorization: Key $MRUN_API_KEY"
curl "https://queue.modelrunner.run/google/veo-3.1/extend-video/requests/$REQUEST_ID" \
  -H "Authorization: Key $MRUN_API_KEY"

JavaScript

import { modelrunner } from "@modelrunner/client";

const result = await modelrunner.subscribe("google/veo-3.1/extend-video", {
  input: {
    "prompt": "your prompt here",
    "video_url": "https://example.com/input.jpg"
  },
});
console.log(result);

Python

import os
import requests

headers = {"Authorization": f"Key {os.environ['MRUN_API_KEY']}"}

submitted = requests.post(
    "https://queue.modelrunner.run/google/veo-3.1/extend-video",
    headers=headers,
    json={
      "prompt": "your prompt here",
      "video_url": "https://example.com/input.jpg"
    },
).json()

# Poll submitted["status_url"] until "COMPLETED", then:
result = requests.get(submitted["response_url"], headers=headers).json()

Input parameters

Input parameters of Veo 3.1 Extend Video
NameTypeRequiredDescription
promptstringyesThe text description for the video extension.
video_urlstring (uri)yesThe URL of the Veo-generated video to extend. Must be a 720p video with 16:9 or 9:16 aspect ratio.
negative_promptstringnoText describing what not to include in the video. Default: "".
aspect_ratioenumnoThe aspect ratio of the video. One of: 16:9, 9:16. Default: "16:9".

Machine-readable: OpenAPI schema · llms.txt

Use Veo 3.1 Extend Video from Claude & Cursor (MCP)

Point Claude Code, Claude Desktop, Cursor, or any MCP client at the ModelRunner MCP server and Veo 3.1 Extend Video becomes a tool your assistant can call directly — it authorizes via OAuth (no API key in config) and runs this model with the run_model tool using the endpoint google/veo-3.1/extend-video.

MCP client config (Claude Desktop, Cursor)

{
  "mcpServers": {
    "modelrunner": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.modelrunner.run/mcp"]
    }
  }
}

Claude Code

claude mcp add --transport http modelrunner https://mcp.modelrunner.run/mcp

Then ask your assistant, for example: “Run google/veo-3.1/extend-video on ModelRunner to generate video”. MCP setup guide.

Model Detayları

Model Detayları

# Veo 3.1 ile hikâyenizi uzatın

Bu model, daha önce üretilmiş Veo kliplerini sürdürerek video içeriğini uzatır. Girdi videosunun son karelerini çözümler ve görsel tarzda, ışıkta ve harekette kusursuz süreklilik koruyarak 7 saniyelik ek görüntü üretir. Bu yetenek, kısa klipleri daha uzun ve bütünlüklü anlatılara dönüştürür; buna, yeni görsel aksiyonla kusursuz senkron çalışan ve modelin kendi ürettiği ses de eşlik eder.

Yinelemeli hikâye anlatımı için tasarlanmıştır: özgün girdiyi yeni uzantıyla birleştiren tek bir bütün video dosyası döndürür. Bir çalıştırmanın çıktısını bir sonrakinin girdisi olarak kullanabilirsiniz; yaklaşık 20 ardışık uzatmaya, yani neredeyse 2.5 dakikalık toplam süreye kadar destek verir. Böylece bir özneyi farklı ortamlar boyunca takip etmek ya da daha uzun bir olaylar dizisi kurmak gibi karmaşık sahne gelişimleri mümkün olur.

### Öne Çıkan Özellikler

* **Kusursuz süreklilik:** Kaynak videonun bağlamını, karakterlerini ve estetiğini koruyarak akıcı geçişler sağlar. * **Prompt ile yönetim:** Uzatmayı metin prompt’larıyla yönlendirin; yeni eylemler ekleyebilir, kamera açılarını değiştirebilir ya da anlatının odağını kaydırabilirsiniz. * **Modelin ürettiği ses:** Yeni bölüm için, özgün klibin ortam sesine ve olaylarına uyan tutarlı bir sesi otomatik üretir.

### Kullanım Yönergeleri

UI üzerinden en iyi sonucu almak için girdinizin, altta çalışan motorun şu gereksinimlerini karşıladığından emin olun:

* **Kaynak malzeme:** `video_url` mutlaka Veo ile üretilmiş bir videoyu göstermelidir. * **Teknik özellikler:** Girdi videoları 720p çözünürlükte ve 16:9 ya da 9:16 en-boy oranında olmalıdır. * **Süre sınırı:** Girdi klibi en fazla 141 saniye olmalıdır.

### Örnek Kullanım

ModelRunner javascript client ile çalıştırmak için aşağıdaki kodu kullanın:

```javascript import { modelrunner } from "@modelrunner/client";

const result = await modelrunner.subscribe('google/veo-3.1-extend-video', { input: { "prompt": "Track the butterfly into the garden as it lands on an orange origami flower. A fluffy white puppy runs up and gently pats the flower.", "video_url": "https://storage.googleapis.com/generativeai-downloads/images/Butterfly_original.mp4", "negative_prompt": "blurry, low quality, distorted, watermark", "aspect_ratio": "16:9" } }); ```