Referencia de REST API

API de recurso de personaje virtual

Crea un recurso AIGC privado. El URI asset:// puede usarse en vídeo cuando el estado sea Active.

API de recurso de personaje virtualCrea un Asset ID reutilizable desde una única URL HTTPS pública.API de recurso de persona realCrea y consulta la verificación H5 oficial y genera un Asset ID autorizado.

Endpoint

Base URL

https://yingtu.ai

POST /api/seedance-assets/virtual-humans

GET /api/seedance-assets/virtual-humans/{id}

Autenticación

El cliente no inicia sesión en YingTu ni Google. Envía la API Key de LaoZhang mediante Authorization: Bearer <LAOZHANG_API_KEY>.

Cabecera	Obligatorio	Descripción
`Authorization`	Sí	API Key de LaoZhang mediante autenticación Bearer.
`Content-Type`	Solo POST	Las operaciones de creación usan application/json.

Solicitud

Campo	Obligatorio	Descripción
`name`	No	Nombre opcional, hasta 64 caracteres.
`image_url`	Sí	URL HTTPS pública obligatoria. CreateAsset oficial solo acepta URL.

Solicitud de creación

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"
}

Ejemplo de respuesta

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"
	}

Ejemplos de código

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())

Consultar estado del recurso

curl --request GET \
	  --url https://yingtu.ai/api/seedance-assets/virtual-humans/ast_eyJvcGFxdWUiOiJleGFtcGxlIn0 \
	  --header "Authorization: Bearer $LAOZHANG_API_KEY"

Respuesta de estado

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."
  }
}

Errores

Estado HTTP	Código de error	Descripción	Reintentable
400	`invalid_request`	El cuerpo, un campo o un valor no son válidos.	No
401	`invalid_api_key`	La API Key falta, no es válida o está deshabilitada.	No
403	`resource_not_owned`	La verificación o el recurso no pertenece a esta API Key, o el ID público no es válido.	No
403	`capability_unavailable`	La cuenta de servicio no tiene habilitados los recursos privados de personas.	No
413	`payload_too_large`	El cuerpo JSON supera los 16 KB.	No
415	`unsupported_media_type`	La solicitud POST no usa application/json.	No
429	`rate_limit_exceeded`	La API Key alcanzó su límite de solicitudes.	Sí
500	`internal_error`	El servicio no pudo completar la solicitud.	No
502	`upstream_error`	El servicio de recursos o verificación devolvió un error.	Sí
503	`authentication_unavailable`	La validación de la API Key no está disponible temporalmente.	Sí
503	`service_unavailable`	La configuración del servidor de la API de recursos no está disponible temporalmente.	Sí

Error object

{
  "error": {
    "code": "invalid_request",
	    "message": "image_url is required.",
    "request_id": "req_01JZEXAMPLE",
    "retryable": false
  }
}

Límites y seguimiento

Cada API Key admite hasta 12 solicitudes POST de creación por hora; las consultas GET no cuentan. Los derechos del proveedor pueden añadir límites. Una solicitud limitada devuelve 429 y Retry-After.

Todas las respuestas incluyen request_id. Inclúyelo al contactar con soporte, pero nunca envíes la API Key completa.

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