Skip to main content
POST
/
v1beta
/
models
/
veo-3.1-fast-generate-preview:predictLongRunning
veo (image to video)
curl --request POST \
  --url https://api.example.com/v1beta/models/veo-3.1-fast-generate-preview:predictLongRunning
Gemini’s veo 3.1 fast generate preview for the image to video API.
curl --location 'https://api.gptproto.com/v1beta/models/veo-3.1-fast-generate-preview:predictLongRunning' \
  --header 'x-goog-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "instances": [
        {
            "prompt": "Generate a video of a real-life model posing for a photoshoot.\n\nRequirements:\n1. Maintain the models appearance, posture, clothing, equipment, lighting, color, background, and composition exactly as in the image.\n2. The product must be fully visible from the front throughout, without being obscured, blurred, or distorted, ensuring clear product details, complete structure, and visible brand logos.\n3. The models movements should match the outfit scene, with very subtle natural movements such as breathing, weight shifts, shoulder and neck relaxation, and posture adjustments.\n4. The camera remains completely still, with no panning, zooming, shaking, or focal length changes, and the model is always shown in full-body proportions.\n5. The visual style is natural and realistic, with soft and even lighting, a clean and consistent background, without AI stylization, fictional elements, color shifts, or exposure fluctuations.",
            "image": {
                "mimeType": "image/png",
                "bytesBase64Encoded": "iVBORw0KGgoAAAANSUhEUgAAA2AAAASgCAIAAAARv7zJAAAgAElEQVR42kz99XdbWb/"
            }
        }
    ],
    "parameters": {
        "aspectRatio": "9:16"
    }
}'
{
  "error": {
    "message": "Invalid signature",
    "type": "401"
  }
}

Parameters

Parameters

ParameterTypeRequiredDefaultDescription
instancesarray✅ Yes-An array of instances containing the video generation parameters The text prompt describing the video animation you want to generate from the image
imageobject✅ Yes-The source image information The URI of the source image file (must be a valid Google Cloud Storage or Generative Language API file URI). Either uri or bytesBase64Encoded must be provided.
mimeTypestring❌ No-The MIME type of the image (e.g., image/png, image/jpeg). Required when using bytesBase64Encoded.
bytesBase64Encodedstring❌ No-Base64-encoded image data. Either uri or bytesBase64Encoded must be provided.
parametersobject❌ No-Additional parameters for video generation The duration of the output video in seconds. Default: 8
aspectRatiostring❌ No-The aspect ratio of the output video. Options: 9:16, 16:9, 1:1. Default: 9:16
resolutionstring❌ No-The resolution of the output video. Options: 720p, 1080p