Doubao Task Status Query
curl --request GET \
--url https://www.token-nova.com/v1/videos/{task_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://www.token-nova.com/v1/videos/{task_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://www.token-nova.com/v1/videos/{task_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://www.token-nova.com/v1/videos/{task_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://www.token-nova.com/v1/videos/{task_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))
}HttpResponse<String> response = Unirest.get("https://www.token-nova.com/v1/videos/{task_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://www.token-nova.com/v1/videos/{task_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": "video_bbfbc1d2-ab22-44ca-b9dd-bc16983acac2",
"object": "video",
"model": "doubao-seedance-1-5-pro_720p",
"status": "processing",
"progress": 50,
"created_at": 1761635478,
"seconds": "5",
"size": "720x720"
}
{
"id": "video_bbfbc1d2-ab22-44ca-b9dd-bc16983acac2",
"object": "video",
"model": "doubao-seedance-1-5-pro_720p",
"status": "completed",
"progress": 100,
"created_at": 1761635478,
"completed_at": 1761635600,
"expires_at": 1761722000,
"seconds": "5",
"size": "720x720",
"video_url": "https://example.com/video/output.mp4"
}
{
"id": "video_bbfbc1d2-ab22-44ca-b9dd-bc16983acac2",
"object": "video",
"model": "doubao-seedance-1-5-pro_720p",
"status": "failed",
"progress": 0,
"created_at": 1761635478,
"completed_at": 1761635500,
"expires_at": 1761721900,
"seconds": "5",
"size": "720x720",
"error": {
"message": "Generation failed, please try again",
"code": "GENERATION_FAILED"
}
}
OpenAI Format
Doubao Task Status Query
Use GET /v1/videos/{task_id} to query Doubao video task status and results.
GET
https://www.token-nova.com
/
v1
/
videos
/
{task_id}
Doubao Task Status Query
curl --request GET \
--url https://www.token-nova.com/v1/videos/{task_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://www.token-nova.com/v1/videos/{task_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://www.token-nova.com/v1/videos/{task_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://www.token-nova.com/v1/videos/{task_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://www.token-nova.com/v1/videos/{task_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))
}HttpResponse<String> response = Unirest.get("https://www.token-nova.com/v1/videos/{task_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://www.token-nova.com/v1/videos/{task_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": "video_bbfbc1d2-ab22-44ca-b9dd-bc16983acac2",
"object": "video",
"model": "doubao-seedance-1-5-pro_720p",
"status": "processing",
"progress": 50,
"created_at": 1761635478,
"seconds": "5",
"size": "720x720"
}
{
"id": "video_bbfbc1d2-ab22-44ca-b9dd-bc16983acac2",
"object": "video",
"model": "doubao-seedance-1-5-pro_720p",
"status": "completed",
"progress": 100,
"created_at": 1761635478,
"completed_at": 1761635600,
"expires_at": 1761722000,
"seconds": "5",
"size": "720x720",
"video_url": "https://example.com/video/output.mp4"
}
{
"id": "video_bbfbc1d2-ab22-44ca-b9dd-bc16983acac2",
"object": "video",
"model": "doubao-seedance-1-5-pro_720p",
"status": "failed",
"progress": 0,
"created_at": 1761635478,
"completed_at": 1761635500,
"expires_at": 1761721900,
"seconds": "5",
"size": "720x720",
"error": {
"message": "Generation failed, please try again",
"code": "GENERATION_FAILED"
}
}
Doubao Task Status Query
After submitting a Doubao series task, query it viaGET /v1/videos/{task_id}.
- The query path is
GET /v1/videos/{task_id}. - A successful response returns an OpenAI-style
videoobject. - After the task is completed, the result can be read from
video_url.
Method and Path
GET /v1/videos/{task_id}
Request Example
curl https://www.token-nova.com/v1/videos/video_bbfbc1d2-ab22-44ca-b9dd-bc16983acac2 \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
resp = requests.get(
"https://www.token-nova.com/v1/videos/video_bbfbc1d2-ab22-44ca-b9dd-bc16983acac2",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(resp.json())
const response = await fetch(
"https://www.token-nova.com/v1/videos/video_bbfbc1d2-ab22-44ca-b9dd-bc16983acac2",
{
headers: {
Authorization: "Bearer YOUR_API_KEY",
},
}
);
console.log(await response.json());
Response Example
{
"id": "video_bbfbc1d2-ab22-44ca-b9dd-bc16983acac2",
"object": "video",
"model": "doubao-seedance-1-5-pro_720p",
"status": "processing",
"progress": 50,
"created_at": 1761635478,
"seconds": "5",
"size": "720x720"
}
{
"id": "video_bbfbc1d2-ab22-44ca-b9dd-bc16983acac2",
"object": "video",
"model": "doubao-seedance-1-5-pro_720p",
"status": "completed",
"progress": 100,
"created_at": 1761635478,
"completed_at": 1761635600,
"expires_at": 1761722000,
"seconds": "5",
"size": "720x720",
"video_url": "https://example.com/video/output.mp4"
}
{
"id": "video_bbfbc1d2-ab22-44ca-b9dd-bc16983acac2",
"object": "video",
"model": "doubao-seedance-1-5-pro_720p",
"status": "failed",
"progress": 0,
"created_at": 1761635478,
"completed_at": 1761635500,
"expires_at": 1761721900,
"seconds": "5",
"size": "720x720",
"error": {
"message": "Generation failed, please try again",
"code": "GENERATION_FAILED"
}
}
Authentication
Authorization: Bearer YOUR_API_KEY
Path Parameters
string
required
Task ID, consistent with the
id returned by the generation endpoint.Response
string
Task ID.
string
Fixed as
video.string
Model name.
string
Task status. Possible values include
processing, failed, and completed.integer
Progress percentage (0-100).
integer
Creation time (Unix timestamp).
integer
Completion time (Unix timestamp), returned only when the task is completed or failed.
integer
Expiration time (Unix timestamp).
string
Video duration (seconds).
string
Video dimensions, for example
720x720.string
Video download URL, returned only when the status is
completed.string
Source video ID for remixing, if any.
object
Error information, returned only when the status is
failed.string
Error message.
string
Error code.
