Assets de avatar virtual

curl --request POST \
  --url https://api.apimart.ai/v1/seedance2/private-avatar \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "group": {
      "name": "virtual-avatar-group",
      "description": "demo group"
    },
    "project_name": "default",
    "asset_type": "Image",
    "assets": [
      {
        "url": "https://example.com/avatar-a.png",
        "name": "avatar-a"
      },
      {
        "url": "https://example.com/avatar-b.png",
        "name": "avatar-b"
      }
    ]
  }'

curl --request POST \
  --url https://api.apimart.ai/v1/seedance2/private-avatar \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "group_id": "group_xxx",
    "project_name": "default",
    "asset_type": "Image",
    "assets": [
      {
        "url": "https://example.com/avatar-a.png",
        "name": "avatar-a"
      }
    ]
  }'

import requests

url = "https://api.apimart.ai/v1/seedance2/private-avatar"

payload = {
    "group": {
        "name": "virtual-avatar-group",
        "description": "demo group"
    },
    "project_name": "default",
    "asset_type": "Image",
    "assets": [
        {
            "url": "https://example.com/avatar-a.png",
            "name": "avatar-a"
        },
        {
            "url": "https://example.com/avatar-b.png",
            "name": "avatar-b"
        }
    ]
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

const url = "https://api.apimart.ai/v1/seedance2/private-avatar";

const payload = {
  group: {
    name: "virtual-avatar-group",
    description: "demo group"
  },
  project_name: "default",
  asset_type: "Image",
  assets: [
    {
      url: "https://example.com/avatar-a.png",
      name: "avatar-a"
    },
    {
      url: "https://example.com/avatar-b.png",
      name: "avatar-b"
    }
  ]
};

const headers = {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

{
  "code": 200,
  "data": {
    "id": "task_01K...",
    "object": "seedance.avatar.asset.task",
    "status": "processing",
    "progress": 10,
    "model": "seedance-2.0"
  }
}

{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": 401,
    "message": "Authentication failed. Please check your API key.",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Insufficient account balance. Please top up and try again.",
    "type": "payment_required"
  }
}

{
  "error": {
    "code": 429,
    "message": "Too many requests. Please try again later.",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": 500,
    "message": "Internal server error. Please try again later.",
    "type": "server_error"
  }
}

POST

seedance2

private-avatar

curl --request POST \
  --url https://api.apimart.ai/v1/seedance2/private-avatar \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "group": {
      "name": "virtual-avatar-group",
      "description": "demo group"
    },
    "project_name": "default",
    "asset_type": "Image",
    "assets": [
      {
        "url": "https://example.com/avatar-a.png",
        "name": "avatar-a"
      },
      {
        "url": "https://example.com/avatar-b.png",
        "name": "avatar-b"
      }
    ]
  }'

curl --request POST \
  --url https://api.apimart.ai/v1/seedance2/private-avatar \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "group_id": "group_xxx",
    "project_name": "default",
    "asset_type": "Image",
    "assets": [
      {
        "url": "https://example.com/avatar-a.png",
        "name": "avatar-a"
      }
    ]
  }'

import requests

url = "https://api.apimart.ai/v1/seedance2/private-avatar"

payload = {
    "group": {
        "name": "virtual-avatar-group",
        "description": "demo group"
    },
    "project_name": "default",
    "asset_type": "Image",
    "assets": [
        {
            "url": "https://example.com/avatar-a.png",
            "name": "avatar-a"
        },
        {
            "url": "https://example.com/avatar-b.png",
            "name": "avatar-b"
        }
    ]
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

const url = "https://api.apimart.ai/v1/seedance2/private-avatar";

const payload = {
  group: {
    name: "virtual-avatar-group",
    description: "demo group"
  },
  project_name: "default",
  asset_type: "Image",
  assets: [
    {
      url: "https://example.com/avatar-a.png",
      name: "avatar-a"
    },
    {
      url: "https://example.com/avatar-b.png",
      name: "avatar-b"
    }
  ]
};

const headers = {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

{
  "code": 200,
  "data": {
    "id": "task_01K...",
    "object": "seedance.avatar.asset.task",
    "status": "processing",
    "progress": 10,
    "model": "seedance-2.0"
  }
}

{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": 401,
    "message": "Authentication failed. Please check your API key.",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Insufficient account balance. Please top up and try again.",
    "type": "payment_required"
  }
}

{
  "error": {
    "code": 429,
    "message": "Too many requests. Please try again later.",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": 500,
    "message": "Internal server error. Please try again later.",
    "type": "server_error"
  }
}

curl --request POST \
  --url https://api.apimart.ai/v1/seedance2/private-avatar \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "group": {
      "name": "virtual-avatar-group",
      "description": "demo group"
    },
    "project_name": "default",
    "asset_type": "Image",
    "assets": [
      {
        "url": "https://example.com/avatar-a.png",
        "name": "avatar-a"
      },
      {
        "url": "https://example.com/avatar-b.png",
        "name": "avatar-b"
      }
    ]
  }'

curl --request POST \
  --url https://api.apimart.ai/v1/seedance2/private-avatar \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "group_id": "group_xxx",
    "project_name": "default",
    "asset_type": "Image",
    "assets": [
      {
        "url": "https://example.com/avatar-a.png",
        "name": "avatar-a"
      }
    ]
  }'

import requests

url = "https://api.apimart.ai/v1/seedance2/private-avatar"

payload = {
    "group": {
        "name": "virtual-avatar-group",
        "description": "demo group"
    },
    "project_name": "default",
    "asset_type": "Image",
    "assets": [
        {
            "url": "https://example.com/avatar-a.png",
            "name": "avatar-a"
        },
        {
            "url": "https://example.com/avatar-b.png",
            "name": "avatar-b"
        }
    ]
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

const url = "https://api.apimart.ai/v1/seedance2/private-avatar";

const payload = {
  group: {
    name: "virtual-avatar-group",
    description: "demo group"
  },
  project_name: "default",
  asset_type: "Image",
  assets: [
    {
      url: "https://example.com/avatar-a.png",
      name: "avatar-a"
    },
    {
      url: "https://example.com/avatar-b.png",
      name: "avatar-b"
    }
  ]
};

const headers = {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

{
  "code": 200,
  "data": {
    "id": "task_01K...",
    "object": "seedance.avatar.asset.task",
    "status": "processing",
    "progress": 10,
    "model": "seedance-2.0"
  }
}

{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": 401,
    "message": "Authentication failed. Please check your API key.",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Insufficient account balance. Please top up and try again.",
    "type": "payment_required"
  }
}

{
  "error": {
    "code": 429,
    "message": "Too many requests. Please try again later.",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": 500,
    "message": "Internal server error. Please try again later.",
    "type": "server_error"
  }
}

Autenticación

string

requerido

Todas las solicitudes requieren autenticación mediante Bearer TokenObtenga su API Key:Visite la página de gestión de API Keys para obtener su API KeyAñada la siguiente cabecera a cada solicitud:

Authorization: Bearer YOUR_API_KEY

Parámetros de la solicitud

object

Información del grupo de assetsSi no se proporciona group_id, el servidor creará automáticamente un grupo de assets AIGC basado en este campo

Mostrar Campos

string

Nombre del grupo de assets

string

Descripción del grupo de assets

Ejemplo:

{
  "group": {
    "name": "virtual-avatar-group",
    "description": "demo group"
  }
}

Mutuamente excluyente con group_id — no proporcione ambos a la vez

string

ID de un grupo de assets existenteCuando se proporciona, omite la creación del grupo y envía los assets directamente al grupo especificado

Mutuamente excluyente con group — no proporcione ambos a la vez

string

predeterminado:"default"

Nombre del proyectoPredeterminado: default

string

predeterminado:"Image"

Tipo de assetOpciones:

Image - Asset de imagen (predeterminado)
Video - Asset de video
Audio - Asset de audio

Predeterminado: Image

array

Lista de assets, admite enviar varios assets en una sola solicitud

Máximo de 20 assets por envío

Mostrar Campos

string

requerido

URL del asset — debe ser accesible públicamente

string

requerido

Nombre del asset

Ejemplo:

{
  "assets": [
    {
      "url": "https://example.com/avatar-a.png",
      "name": "avatar-a"
    },
    {
      "url": "https://example.com/avatar-b.png",
      "name": "avatar-b"
    }
  ]
}

string

Atajo para asset único: URL del asset

Use el array assets o este campo — no ambos. Adecuado para enviar un único asset.

string

Atajo para asset único: nombre del asset

Use el array assets o este campo — no ambos. Adecuado para enviar un único asset.

Respuesta

integer

Código de estado de la respuesta, 200 en caso de éxito

object

Información de la tarea

Mostrar Campos

string

ID local de la tarea, usado para consultar el estado de revisión del asset

string

Tipo de objeto de la tarea, siempre seedance.avatar.asset.task

string

Estado inicial de la tarea, processing tras el envío

integer

Progreso de la tarea (0 ~ 100)

string

Nombre del modelo en uso

Ejemplos

Ejemplo 1: Envío por lotes (crear grupo automáticamente)

Cuando no se proporciona group_id, el servidor crea automáticamente un grupo de assets AIGC antes del envío.

{
  "group": {
    "name": "virtual-avatar-group",
    "description": "demo group"
  },
  "project_name": "default",
  "asset_type": "Image",
  "assets": [
    {
      "url": "https://example.com/avatar-a.png",
      "name": "avatar-a"
    },
    {
      "url": "https://example.com/avatar-b.png",
      "name": "avatar-b"
    }
  ]
}

Ejemplo 2: Añadir assets a un grupo existente

Proporcione group_id para omitir la creación del grupo y enviar directamente.

{
  "group_id": "group_xxx",
  "project_name": "default",
  "asset_type": "Image",
  "assets": [
    {
      "url": "https://example.com/avatar-a.png",
      "name": "avatar-a"
    }
  ]
}

Ejemplo 3: Atajo para asset único

Para un único asset, use directamente los campos url y name de nivel superior.

{
  "group_id": "group_xxx",
  "url": "https://example.com/avatar.png",
  "asset_type": "Image",
  "name": "avatar-1"
}

Consultar el resultado de la revisión

El envío de assets es una tarea asíncrona. Use el endpoint Obtener estado de tarea para hacer polling:

GET /v1/tasks/{id}

Todos aprobados

{
  "code": 200,
  "data": {
    "id": "task_01K...",
    "status": "completed",
    "progress": 100,
    "result": {
      "assets": [
        {
          "asset_id": "asset_a",
          "asset_url": "asset://asset_a",
          "status": "Active"
        },
        {
          "asset_id": "asset_b",
          "asset_url": "asset://asset_b",
          "status": "Active"
        }
      ],
      "usable_assets": [
        {
          "asset_id": "asset_a",
          "asset_url": "asset://asset_a",
          "status": "Active"
        },
        {
          "asset_id": "asset_b",
          "asset_url": "asset://asset_b",
          "status": "Active"
        }
      ],
      "failed_assets": []
    }
  }
}

Fallo parcial

Si algún asset no supera la revisión, el estado de la tarea pasa a failed. Los assets aprobados con éxito siguen siendo utilizables y aparecen en result.usable_assets.

{
  "code": 200,
  "data": {
    "id": "task_01K...",
    "status": "failed",
    "progress": 100,
    "result": {
      "assets": [
        {
          "asset_id": "asset_a",
          "asset_url": "asset://asset_a",
          "status": "Active"
        },
        {
          "asset_id": "asset_b",
          "asset_url": "asset://asset_b",
          "status": "Failed"
        }
      ],
      "usable_assets": [
        {
          "asset_id": "asset_a",
          "asset_url": "asset://asset_a",
          "status": "Active"
        }
      ],
      "failed_assets": [
        {
          "asset_id": "asset_b",
          "asset_url": "asset://asset_b",
          "status": "Failed"
        }
      ]
    },
    "error": {
      "code": "task_failed",
      "message": "Some assets failed review"
    }
  }
}

result.usable_assets[].asset_url puede usarse directamente en la generación de video de Seedance 2.0
Los assets en result.failed_assets deben reemplazarse o reenviarse
Las tareas de un único asset también devuelven result.asset_url por compatibilidad

Uso de assets aprobados

Pase la URL asset://... directamente al endpoint de Generación de video Seedance 2.0:

{
  "model": "seedance-2.0",
  "prompt": "The character walks naturally along a city street",
  "image_urls": ["asset://asset_a"],
  "duration": 5,
  "resolution": "720p"
}

Una vez que el servidor detecta el prefijo asset://, envía la tarea de generación directamente sin desencadenar otra revisión del asset.

Visión general

Modelos

Serie de texto

Serie de imágenes

Serie de video

Serie de audio

Serie de Moderación

Gestión de subidas

Gestión de tareas

Gestión de cuenta

Assets de avatar virtual

Autenticación

Parámetros de la solicitud

Respuesta

Ejemplos

Ejemplo 1: Envío por lotes (crear grupo automáticamente)

Ejemplo 2: Añadir assets a un grupo existente

Ejemplo 3: Atajo para asset único

Consultar el resultado de la revisión

Todos aprobados

Fallo parcial

Uso de assets aprobados

​Autenticación

​Parámetros de la solicitud

​Respuesta

​Ejemplos

​Ejemplo 1: Envío por lotes (crear grupo automáticamente)

​Ejemplo 2: Añadir assets a un grupo existente

​Ejemplo 3: Atajo para asset único

​Consultar el resultado de la revisión

​Todos aprobados

​Fallo parcial

​Uso de assets aprobados

Autenticación

Parámetros de la solicitud

Respuesta

Ejemplos

Ejemplo 1: Envío por lotes (crear grupo automáticamente)

Ejemplo 2: Añadir assets a un grupo existente

Ejemplo 3: Atajo para asset único

Consultar el resultado de la revisión

Todos aprobados

Fallo parcial

Uso de assets aprobados