Skip to main content

Seedance 1.0

Generate high-quality videos from text prompts and images using the Seedance 1.0 model.

Endpoint​

POST https://api.azerion.ai/v1/contents/generations/tasks

Description​

Seedance 1.0 is an advanced video generation model that creates high-quality videos from text prompts and reference images. It supports various generation modes including text-to-video, image-to-video with specific frame controls, and style referencing.

Unlike synchronous generation endpoints, this endpoint initiates an asynchronous task and returns a task ID. You must then poll the status endpoint to retrieve the generated video.

Authentication​

This endpoint requires authentication using an API key.

Request Parameters​

  • model (string, required): Model ID. Use seedance-1-0-pro-250528 (Pro), seedance-1-0-pro-fast-251015 (Pro Fast), seedance-1-0-lite-i2v-250428 (Lite I2V), or other available versions.
  • content (array, required): A list of content objects defining the input.
    • type (string): Type of content (text or image_url).
    • text (string, optional): The prompt text.
    • image_url (object, optional): Object containing the url of the image.
    • role (string, optional): Role of the image (e.g., reference_image, first_frame, last_frame).
  • ratio (string, optional): Aspect ratio (e.g., adaptive).
  • duration (integer, optional): Duration in seconds (e.g., 5).
  • resolution (string, optional): Resolution (e.g., 1080p).
  • camerafixed (boolean, optional): Whether the camera is fixed.

Response​

A successful request returns a JSON response containing the task ID, which is used to check the status and retrieve the result.

Example Requests​

Text to Video​

Generate a video from a text description.

curl -X POST https://api.azerion.ai/v1/contents/generations/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{
    "model": "seedance-1-0-pro-250528",
    "content": [
        {
            "type": "text",
            "text": "Multiple shots. A detective enters a dimly lit room. He examines the clues on the table and picks up an item from the surface. The camera cuts to a shot of him deep in thought. --resolution 1080p  --duration 5 --camerafixed false"
        }
    ]
}'

Image to Video (First Frame)​

Animate a static image as the starting frame.

curl -X POST https://api.azerion.ai/v1/contents/generations/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{
    "model": "seedance-1-0-pro-fast-251015",
    "content": [
         {
            "type": "text",
            "text": "A girl holding a fox, the girl opens her eyes, looks gently at the camera, the fox hugs affectionately, the camera slowly pulls out, the girl’s hair is blown by the wind  --ratio adaptive  --dur 5"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://ark-doc.tos-ap-southeast-1.bytepluses.com/doc_image/i2v_foxrgirl.png"
            }
        }
    ]
}'

Image to Video with Reference Images​

Use multiple reference images to control characters and style.

curl -X POST https://api.azerion.ai/v1/contents/generations/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{
    "model": "seedance-1-0-lite-i2v-250428",
    "content": [
        {
            "type": "text",
            "text": "A boy wearing glasses and a blue T-shirt from [Image 1] and a corgi dog from [Image 2], sitting on the lawn from [Image 3], in 3D cartoon style"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://ark-doc.tos-ap-southeast-1.bytepluses.com/doc_image/seelite_ref_1.png"
            },
            "role": "reference_image"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://ark-doc.tos-ap-southeast-1.bytepluses.com/doc_image/seelite_ref_2.png"
            },
            "role": "reference_image"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://ark-doc.tos-ap-southeast-1.bytepluses.com/doc_image/seelite_ref_3.png"
            },
            "role": "reference_image"
        }
    ]
  }'

Image to Video (First and Last Frames)​

Specify both the start and end frames for controlled transitions.

curl -X POST https://api.azerion.ai/v1/contents/generations/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{
    "model": "seedance-1-0-pro-250528",
    "content": [
         {
            "type": "text",
            "text": "Create a 360-degree orbiting camera shot based on this photo."
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://ark-doc.tos-ap-southeast-1.bytepluses.com/doc_image/seepro_first_frame.jpeg"
            },
            "role": "first_frame"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://ark-doc.tos-ap-southeast-1.bytepluses.com/doc_image/seepro_last_frame.jpeg"
            },
            "role": "last_frame"
        }
    ]
}'

Task Management​

Get Task Status​

Check the progress of a generation task.

GET https://api.azerion.ai/v1/contents/generations/tasks/{task_id}
curl -X GET https://api.azerion.ai/v1/contents/generations/tasks/cgt-20251222220032-wpnm9 \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

List Tasks​

List recent generation tasks.

GET https://api.azerion.ai/v1/contents/generations/tasks
curl -X GET "https://api.azerion.ai/v1/contents/generations/tasks?page_num=1&page_size=5" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Delete Task​

Delete a generation task.

POST https://api.azerion.ai/v1/contents/generations/tasks/{task_id}

Note: The deletion endpoint uses the POST method.

curl -X POST https://api.azerion.ai/v1/contents/generations/tasks/cgt-20251219051611-tx2md \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"