Seedance Query Video Generation Task

request

curl --request GET \
  --url https://baze-api.powerbuyin.top/byteplus/api/v3/contents/generations/tasks/{id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://baze-api.powerbuyin.top/byteplus/api/v3/contents/generations/tasks/{id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://baze-api.powerbuyin.top/byteplus/api/v3/contents/generations/tasks/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://baze-api.powerbuyin.top/byteplus/api/v3/contents/generations/tasks/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://baze-api.powerbuyin.top/byteplus/api/v3/contents/generations/tasks/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://baze-api.powerbuyin.top/byteplus/api/v3/contents/generations/tasks/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "cgt-2026****-****",
  "model": "doubao-seedance-2-0-260128",
  "status": "succeeded",
  "content": {
    "video_url": "https://ark-content-generation-cn-beijing.tos-cn-beijing.volces.com/xxx"
  },
  "usage": {
    "completion_tokens": 108900,
    "total_tokens": 108900
  },
  "created_at": 1779348818,
  "updated_at": 1779348874,
  "seed": 78674,
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "framespersecond": 24,
  "service_tier": "default",
  "execution_expires_after": 172800,
  "generate_audio": true,
  "draft": false,
  "priority": 0
}

GET

byteplus

api

contents

generations

tasks

{id}

request

curl --request GET \
  --url https://baze-api.powerbuyin.top/byteplus/api/v3/contents/generations/tasks/{id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://baze-api.powerbuyin.top/byteplus/api/v3/contents/generations/tasks/{id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://baze-api.powerbuyin.top/byteplus/api/v3/contents/generations/tasks/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://baze-api.powerbuyin.top/byteplus/api/v3/contents/generations/tasks/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://baze-api.powerbuyin.top/byteplus/api/v3/contents/generations/tasks/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://baze-api.powerbuyin.top/byteplus/api/v3/contents/generations/tasks/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "cgt-2026****-****",
  "model": "doubao-seedance-2-0-260128",
  "status": "succeeded",
  "content": {
    "video_url": "https://ark-content-generation-cn-beijing.tos-cn-beijing.volces.com/xxx"
  },
  "usage": {
    "completion_tokens": 108900,
    "total_tokens": 108900
  },
  "created_at": 1779348818,
  "updated_at": 1779348874,
  "seed": 78674,
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "framespersecond": 24,
  "service_tier": "default",
  "execution_expires_after": 172800,
  "generate_audio": true,
  "draft": false,
  "priority": 0
}

Authorizations

Authorization

string

header

required

Pass Authorization: Bearer <token> in the request header.

Headers

Content-Type

string

default:application/json

Request content type.

Path Parameters

string

required

The ID of the video generation task you need to query.

Note: The above parameters are Query String Parameters, passed in the URL string.

Response

response

string

Video generation task ID.

model

string

The model name and version used by the task, in model_name-version format.

status

enum<string>

Task status and related information:

queued: In queue.
running: Task running.
cancelled: Task cancelled, automatically deleted after 24h (only queued tasks can be cancelled).
succeeded: Task successful.
failed: Task failed.
expired: Task timed out.`: Task failed.
expired: Task timed out.

Available options:

queued,

running,

cancelled,

succeeded,

failed,

expired

error

object | null

Error message. Returns null on success, returns error data on failure.

Show child attributes

created_at

integer

Unix timestamp (seconds) of task creation time.

updated_at

integer

Unix timestamp (seconds) of the current status update time.

content

object

The output content of the video generation task.

Show child attributes

seed

integer

The seed integer value used for this request.

resolution

string

The resolution of the generated video.

ratio

string

The aspect ratio of the generated video.

duration

integer

The duration of the generated video, in seconds.

Note: Only one of duration and frames will be returned. If frames was not specified in the task creation, duration is returned.

frames

integer

The number of frames of the generated video.

Note: Only one of duration and frames will be returned. If frames was specified in the task creation, frames is returned.

framespersecond

integer

The frame rate of the generated video.

generate_audio

boolean

Whether the generated video contains synchronized audio. Only returned for seedance 2.0 & 2.0 fast, seedance 1.5 pro.

true: The output video contains synchronized audio.
false: The output video has no audio.

tools

object[]

The tools actually used by the model for this request. Not returned if no tools were used.

Show child attributes

safety_identifier

string

Unique identifier of the end user. If this parameter was set when creating the video generation task, the API returns it as-is.

priority

integer

The execution priority of the current request.

draft

boolean

Whether the generated video is a Draft video. Only returned for seedance 1.5 pro.

true: The current output is a Draft video.
false: The current output is a normal video.

draft_task_id

string

Draft video task ID. Returned when generating the final video based on a Draft video.

service_tier

string

The actual service tier used to process the task.

execution_expires_after

integer

Task timeout threshold, in seconds.

usage

object

Token usage for this request.

Show child attributes

Chat Models

Image Models

Video Models

Audio Models

asset library

Seedance Query Video Generation Task

Authorizations

Headers

Path Parameters

Response