YingTu Logo
Проверяем вход через Google…
Вернуться в Seedance
Справочник REST API

API виртуального персонажа

Создаёт приватный AIGC-ассет. URI asset:// можно использовать в видео после перехода статуса в Active.

API виртуального персонажаСоздаёт многоразовый Asset ID из одного публичного HTTPS-адреса изображения.API ассета реального человекаСоздаёт официальную H5-проверку, проверяет результат и выдаёт разрешённый Asset ID.

Эндпоинт

Базовый URL

https://yingtu.ai
POST /api/seedance-assets/virtual-humans
GET /api/seedance-assets/virtual-humans/{id}

Аутентификация

Вход в YingTu или Google не требуется. Используйте ключ LaoZhang в заголовке Authorization: Bearer <LAOZHANG_API_KEY>.

ЗаголовокОбязательноОписание
AuthorizationДаКлюч LaoZhang с Bearer-аутентификацией.
Content-TypeТолько POSTДля операций создания используется application/json.

Запрос

ПолеОбязательноОписание
nameНетНеобязательное имя, до 64 символов.
image_urlДаОбязательная публичная HTTPS-ссылка. Официальный CreateAsset принимает только URL.

Запрос создания

cURL
curl --request POST \
  --url https://yingtu.ai/api/seedance-assets/virtual-humans \
  --header "Authorization: Bearer $LAOZHANG_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "image_url": "https://cdn.example.com/avatar.webp",
    "name": "brand-avatar"
  }'
HTTP request
POST /api/seedance-assets/virtual-humans
Content-Type: application/json
Authorization: Bearer $LAOZHANG_API_KEY

{
  "image_url": "https://cdn.example.com/avatar.webp",
  "name": "brand-avatar"
}

Пример ответа

HTTP/1.1 202 Accepted
Content-Type: application/json

{
	  "request_id": "req_01JZEXAMPLE",
	  "id": "ast_eyJvcGFxdWUiOiJleGFtcGxlIn0",
	  "object": "seedance.asset",
	  "kind": "virtual_human",
	  "name": "brand-avatar",
	  "status": "Processing",
	  "uri": "asset://asset-20260729-example"
	}

Примеры кода

JavaScript · Node.js
const response = await fetch("https://yingtu.ai/api/seedance-assets/virtual-humans", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LAOZHANG_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    image_url: "https://cdn.example.com/avatar.webp",
    name: "brand-avatar",
  }),
});

if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
Python · requests
import os
import requests

response = requests.post(
    "https://yingtu.ai/api/seedance-assets/virtual-humans",
    headers={"Authorization": f"Bearer {os.environ['LAOZHANG_API_KEY']}"},
    json={
        "image_url": "https://cdn.example.com/avatar.webp",
        "name": "brand-avatar",
    },
    timeout=60,
)

response.raise_for_status()
print(response.json())

Проверка статуса ассета

curl --request GET \
	  --url https://yingtu.ai/api/seedance-assets/virtual-humans/ast_eyJvcGFxdWUiOiJleGFtcGxlIn0 \
	  --header "Authorization: Bearer $LAOZHANG_API_KEY"
Ответ статуса
HTTP/1.1 200 OK
Content-Type: application/json

{
	  "request_id": "req_01JZEXAMPLE",
	  "id": "ast_eyJvcGFxdWUiOiJleGFtcGxlIn0",
  "object": "seedance.asset",
  "kind": "virtual_human",
  "status": "Active",
  "uri": "asset://asset-20260729-example",
	  "created_at": "2026-07-29T05:00:00Z",
	  "updated_at": "2026-07-29T05:01:00Z"
}
Failed · HTTP 200
{
  "request_id": "req_01JZEXAMPLE",
  "id": "ast_eyJvcGFxdWUiOiJleGFtcGxlIn0",
  "object": "seedance.asset",
  "kind": "virtual_human",
  "status": "Failed",
  "uri": "asset://asset-20260729-example",
  "failure": {
    "code": "InvalidImage",
    "message": "The image did not pass upstream validation."
  }
}

Ошибки

HTTP-статусКод ошибкиОписаниеПовтор
400invalid_requestНедопустимое тело запроса, поле или значение.Нет
401invalid_api_keyAPI-ключ отсутствует, недействителен или отключён.Нет
403resource_not_ownedПроверка или ассет не принадлежит этому API-ключу либо публичный ID недействителен.Нет
403capability_unavailableДля сервисного аккаунта не включены приватные портретные ассеты.Нет
413payload_too_largeJSON-запрос превышает 16 КБ.Нет
415unsupported_media_typePOST-запрос отправлен не как application/json.Нет
429rate_limit_exceededДостигнут лимит запросов для API-ключа.Да
500internal_errorСервис не смог выполнить запрос.Нет
502upstream_errorОшибка вышестоящего сервиса ассетов или проверки.Да
503authentication_unavailableПроверка API-ключа временно недоступна.Да
503service_unavailableСерверная конфигурация API ассетов временно недоступна.Да
Error object
{
  "error": {
    "code": "invalid_request",
	    "message": "image_url is required.",
    "request_id": "req_01JZEXAMPLE",
    "retryable": false
  }
}

Лимиты и трассировка

Для каждого API-ключа разрешено до 12 POST-запросов создания в час; GET-проверки не учитываются. Права провайдера могут добавлять лимиты. При ограничении возвращаются 429 и Retry-After.

Каждый ответ содержит request_id. Передавайте его поддержке, но не отправляйте полный API-ключ.

X-RateLimit-Limit: <limit>
X-RateLimit-Remaining: <remaining>
X-RateLimit-Reset: <unix-seconds>
Retry-After: <seconds>