Skip to main content
POST
  1. Submit the request with VIDGO_API_KEY. A task_id is returned immediately. Keep it until the task reaches finished or failed.
  2. Use Query Task Status to retrieve the result. If you provide a callback_url, Vidgo sends the result to your webhook when the task finishes or fails.

Seedance 1.0 Pro Image to Video

Turn a still image into a five- or ten-second video with Seedance 1.0 Pro, using text to guide the scene and motion.

Available Models

  • bytedance/seedance/v1/pro/image-to-video - Generate video from image input.

Duration Options

  • 5, 10 seconds - Set duration as a numeric integer. Optional. Default: 5 seconds, only when omitted. Strings, booleans, null and fractional values are rejected. A numeric value such as 5.0 is equivalent to 5.

Key Features

  • Generate video from image input.
  • Accepts exactly 1 image in image_urls.
  • Choose from 720p, 1080p output resolutions.

Advanced Parameters

Set model and optional callback_url at the request root. Place all workflow parameters, including output options, inside input. Send only the input fields supported by this workflow. Unsupported input fields are rejected before credits are deducted. Input URLs must use HTTP(S), include a hostname, and contain no embedded credentials or whitespace. Defaults apply only when optional input fields are omitted; explicit null and empty values are rejected.

Prompt

  • prompt: Required string. Describe the scene and desired motion. After trimming surrounding whitespace, length must be 1-10,000 Unicode characters. Non-string values are rejected.
  • The value must not be blank when supplied.

Image URLs

  • image_urls: Required. Provide publicly accessible image URLs. Supply exactly 1 item. Each item must be an HTTP(S) URL. Base64, a bare string instead of an array, and empty arrays are rejected.

Resolution

  • resolution: Optional. Accepted values: 720p, 1080p. Default: 720p, only when omitted. Aliases, different casing, surrounding whitespace and numeric values are rejected.

Pricing

Both workflows use the same price per generation ($0.005 per credit): Credits are deducted on submission and refunded if the task fails.

Authorizations

Authorization
string
header
required

Use VIDGO_API_KEY.

Body

application/json

Keep model and optional callback_url at the root. Unsupported input fields are rejected. Defaults apply only to omitted fields; null and empty input values are rejected.

model
enum<string>
required

Vidgo public model ID. Must be bytedance/seedance/v1/pro/image-to-video.

Available options:
bytedance/seedance/v1/pro/image-to-video
Example:

"bytedance/seedance/v1/pro/image-to-video"

input
object
required

Input parameters for generation

callback_url
string | null

Optional public HTTP(S) endpoint for task completion notifications. HTTPS is recommended. Omit, use null, or use an empty string to disable callbacks.

Response

Task submitted

code
enum<integer>
required
Available options:
200
data
object
required