Generate Video

Generate videos from text prompts or images using state-of-the-art AI models.

Endpoint

POST

/api/v1/jobs

Create a generate_video job

Supported Models

Model	Credits	Notes
`veo3`	175	Default. High quality text-to-video
`kling-3.1`	300	Premium quality, longer generation
`seedance`	150	Fast, stylized output
`grok-imagine`	150	Creative and imaginative output

Input Parameters

Request Body

Name	Type	Description
`workflow`required	`string`	"generate_video"
`input.prompt`required	`string`	Text description of the video to generate
`input.model`	`string`Default: `veo3`	Model to use
`input.aspect_ratio`	`string`Default: `16:9`	Aspect ratio (e.g., '16:9', '9:16', '1:1')
`input.image_url`	`string`	Image URL for image-to-video generation
`input.duration`	`number`	Target duration in seconds
`webhookUrl`	`string`	URL to receive completion notification

Example Request

Create Video Job

curl -X POST https://vydra.ai/api/v1/jobs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow": "generate_video",
    "input": {
      "prompt": "A golden retriever running on a beach at sunset, cinematic 4K",
      "model": "veo3",
      "aspect_ratio": "16:9"
    }
  }'

Example Response

Response (201 Created)json

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "running",
  "workflow": "generate_video",
  "creditsCharged": 175,
  "createdAt": "2026-01-26T12:00:00.000Z",
  "_links": {
    "self": "https://vydra.ai/api/v1/jobs/550e8400-e29b-41d4-a716-446655440000",
    "status": "https://vydra.ai/api/v1/jobs/550e8400-e29b-41d4-a716-446655440000"
  }
}

Image-to-Video

Provide an image_url to animate a static image:

Image-to-Video Request Bodyjson

{
  "workflow": "generate_video",
  "input": {
    "prompt": "The character slowly turns and smiles",
    "image_url": "https://example.com/character.png",
    "model": "veo3"
  }
}

Image Requirements

The image URL must be publicly accessible. Supported formats: PNG, JPEG, WebP.