Skip to main content
POST
Video Diffusion

Headers

Request Body

Image-to-Video Mode

Choose one of two input methods: Option 1: Using existing generated image Option 2: Using prompt with image URL

Video Types

Advanced Parameters

You can add these parameters to your prompt for more control over video generation:

Motion Intensity

Control the amount of movement in the generated video:
  • Low Motion (default): Static scenes with subtle movements
    • Add --motion low to your prompt
  • High Motion: Large camera movements and dramatic motion (may produce artistic effects)
    • Add --motion high to your prompt
Example:

Raw Mode

Reduce automatic system enhancements for more precise control over the output:
  • Add --raw to your prompt
Example:

End Frame Image

Specify the final frame of your video by providing an image URL:
  • Add --end [image_url] to your prompt
Example:

Video Loop

Generate a video where the last frame matches the first frame, creating a seamless loop:
  • Add --loop to your prompt
Example:

Batch Size

Control the number of videos generated in a single task. This affects the cost accordingly:
  • Add --bs [1|2|4] to your prompt
  • Valid values: 1, 2, or 4
  • Default: 4
Example:

Combining Parameters

You can combine multiple parameters in a single prompt: Example:

Example Requests

Image-to-Video (Using existing image)

Image-to-Video (Using image URL)

Response

Returns a task object containing the task information.
This is the initial success response. Use the job_id to check the task status via the Get Task endpoint to retrieve the completed result with video URLs.

Authorizations

x-api-key
string
header
required

API key for authentication

Body

application/json
jobId
string<uuid>
required

ID of the source image generation task (for existing image mode)

imageNo
integer
required

Image number to animate (0/1/2/3) (for existing image mode)

Required range: 0 <= x <= 3
prompt
string

Video generation prompt text (required for prompt mode, optional for existing image mode)

Required string length: 1 - 8192
videoType
integer

Video quality type (0=480p, 1=720p)

Required range: 0 <= x <= 1
callback
string<uri>

Callback URL for task completion notifications

Response

Video generation task created successfully