Skip to main content
POST
/
generation
/
google
/
veo-3.1
Veo 3.1
curl --request POST \
  --url https://open.skills.video/api/v1/generation/google/veo-3.1 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>"
}
'
{
  "id": "gen_123",
  "status": "IN_QUEUE",
  "input": {
    "prompt": "a cat walking through neon rain",
    "duration": 5,
    "aspect_ratio": "16:9",
    "n": 1
  },
  "usage": {
    "total": 20,
    "subscription": 20,
    "permanent": 0
  }
}
Realistic, prompt adherence, native audio/dialogue.

Authorizations

​
Authorization
string
header
required

API Key for API endpoints

Body

​
prompt
string
required

Text prompt for video generation

​
mode
string

Generation mode: text-image, reference, or frames

​
reference_image_urls
string[]

Reference images for reference-to-video

​
first_frame_url
string

First frame image for frames mode

​
last_frame_url
string

Last frame image for frames mode

​
duration
default:8

Video duration in seconds

​
resolution
enum<string>
default:1080p

Resolution of the generated video

Available options:
720p,
1080p
​
aspect_ratio
enum<string>
default:16:9

Video aspect ratio

Available options:
16:9,
9:16
​
generate_audio
boolean
default:true

Generate audio with the video

​
negative_prompt
string | null

Description of what to exclude from the generated video

​
seed
integer | null

Random seed. Omit for random generations

Required range: -9007199254740991 <= x <= 9007199254740991
​
n
integer
default:1

Number of results to generate (1-4)

Required range: 1 <= x <= 4

Response

Generation submission accepted

​
id
string
required

Generation id.

​
status
enum<string>
required

Queue status

Available options:
IN_QUEUE,
IN_PROGRESS,
COMPLETED,
FAILED,
CANCELED
​
input
Input · object
required

Normalized input payload for the generation task.

​
usage
object
required

Credit usage breakdown for the request

​
code
string

Machine-readable generation error code. Present when status is FAILED.

​
message
string

Sanitized human-readable failure message. Present when status is FAILED.