Skip to main content
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo3.1",
    "prompt": "Dolphins leaping in the azure ocean",
    "duration": 8,
    "aspect_ratio": "16:9",
    "image_urls": ["https://cdn.apimart.ai/doc/9998238783208208-9972597b-255d-4e7e-9649-e6ee38a837aa-image_task_01K88B53MTK41PP5KGDTG2PA5P_0.png"]
  }'

{
  "code": 200,
  "data": {
    "created": 1757156493,
    "id": "task_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ",
    "model": "veo3.1",
    "object": "video.generation.task",
    "progress": 0,
    "status": "pending",
    "task_info": {
      "can_cancel": true,
      "estimated_time": 300
    },
    "type": "video"
  }
}

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo3.1",
    "prompt": "Dolphins leaping in the azure ocean",
    "duration": 8,
    "aspect_ratio": "16:9",
    "image_urls": ["https://cdn.apimart.ai/doc/9998238783208208-9972597b-255d-4e7e-9649-e6ee38a837aa-image_task_01K88B53MTK41PP5KGDTG2PA5P_0.png"]
  }'

{
  "code": 200,
  "data": {
    "created": 1757156493,
    "id": "task_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ",
    "model": "veo3.1",
    "object": "video.generation.task",
    "progress": 0,
    "status": "pending",
    "task_info": {
      "can_cancel": true,
      "estimated_time": 300
    },
    "type": "video"
  }
}

​
Authorizations

​
Authorization
string
required
All API endpoints require Bearer Token authenticationGet your API Key:Visit the API Key Management Page to get your API KeyAdd it to the request header:
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
default:"veo3.1"
required
Video generation model nameExample: "veo3.1"
​
prompt
string
required
Text description for video generationMaximum 1000 characters
​
duration
integer
Video duration in secondsFixed value: 8 (VEO3 only supports 8 seconds duration)
​
aspect_ratio
string
Video aspect_ratioSupported formats:
  • 16:9 (Landscape)
  • 9:16 (Portrait)
​
image_urls
array
Array of reference image URLs for image-to-video generation
  • Each element must be a valid image URL
  • Supported formats: .jpeg, .jpg, .png, .webp
  • Maximum file size: 10MB

​
Response

​
created
integer
Task creation timestamp
​
id
string
Unique task identifier
​
model
string
The actual model name used
​
object
string
Object type, fixed as video.generation.task
​
progress
integer
Task completion progress percentage (0-100)
​
status
string
Task statusPossible values:
  • pending - Waiting for processing
  • processing - In progress
  • completed - Completed
  • failed - Failed
​
task_info
object
Task details
​
type
string
Output type, fixed as video
​
usage
object
Billing information