Seedance 2 Приватные виртуальные аватары
curl --request POST \
--url https://toapis.com/v1/videos/doubao-seedance-2-0/private-avatar/groups \
--header 'Authorization: <authorization>'import requests
url = "https://toapis.com/v1/videos/doubao-seedance-2-0/private-avatar/groups"
headers = {"Authorization": "<authorization>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: '<authorization>'}};
fetch('https://toapis.com/v1/videos/doubao-seedance-2-0/private-avatar/groups', 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://toapis.com/v1/videos/doubao-seedance-2-0/private-avatar/groups",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$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://toapis.com/v1/videos/doubao-seedance-2-0/private-avatar/groups"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://toapis.com/v1/videos/doubao-seedance-2-0/private-avatar/groups")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://toapis.com/v1/videos/doubao-seedance-2-0/private-avatar/groups")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_bodyseedance-2
Seedance 2 Приватные виртуальные аватары
Создание группы виртуальных аватаров, загрузка ассета и проверка его статуса
POST
/
v1
/
videos
/
doubao-seedance-2-0
/
private-avatar
/
groups
Seedance 2 Приватные виртуальные аватары
curl --request POST \
--url https://toapis.com/v1/videos/doubao-seedance-2-0/private-avatar/groups \
--header 'Authorization: <authorization>'import requests
url = "https://toapis.com/v1/videos/doubao-seedance-2-0/private-avatar/groups"
headers = {"Authorization": "<authorization>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: '<authorization>'}};
fetch('https://toapis.com/v1/videos/doubao-seedance-2-0/private-avatar/groups', 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://toapis.com/v1/videos/doubao-seedance-2-0/private-avatar/groups",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$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://toapis.com/v1/videos/doubao-seedance-2-0/private-avatar/groups"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://toapis.com/v1/videos/doubao-seedance-2-0/private-avatar/groups")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://toapis.com/v1/videos/doubao-seedance-2-0/private-avatar/groups")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_bodyДля пользователей из материкового Китая: используйте
https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.- Открыт только минимальный пользовательский workflow
- Загрузка принимает только публичный
source_url - Для генерации можно использовать только ассеты со
status=active
Этот прежний API остается доступным. Для проверки в одной видеозадаче см. проверку материалов по запросу и задайте
private_asset_review: true. При использовании старых asset:// пропустите переключатель или задайте false; новый режим отклоняет такие ссылки.Authorizations
string
обязательно
Все запросы требуют Bearer Token аутентификацию.
Workflow
1. Создание группы ассетов
Вызовите этот интерфейс:POST /v1/videos/doubao-seedance-2-0/private-avatar/groups
- Создает новую группу материалов виртуального аватара
- Возвращает
group_id, который понадобится на шаге загрузки
curl --request POST \
--url https://toapis.com/v1/videos/doubao-seedance-2-0/private-avatar/groups \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "brand-avatar-group",
"description": "Группа ассетов виртуального аватара"
}'
2. Загрузка ассета
Вызовите этот интерфейс:POST /v1/videos/doubao-seedance-2-0/private-avatar/assets
- Загружает один материал в выбранную группу
- Возвращает
asset_id - Запускает асинхронную обработку
asset_type:
imagevideoaudio
source_url должен быть публичным http/https URL.
3. Проверка статуса ассета
Вызовите этот интерфейс:GET /v1/videos/doubao-seedance-2-0/private-avatar/assets/{asset_id}
- Возвращает текущий статус ассета
- Позволяет понять, готов ли ассет для генерации видео
status не станет active.
Использование в генерации видео
Вызовите этот интерфейс:POST /v1/videos/generations
active, используйте asset://<ASSET_ID> в запросе генерации.
{
"image_with_roles": [
{
"url": "asset://asset-20260318071009-*****",
"role": "reference_image"
}
]
}