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

doubao-seedance-2-0

Ассеты виртуальных аватаров

API отправки приватных ассетов виртуальных аватаров
Поддержка пакетной отправки, до 20 ассетов за один запрос
Автоматически создаёт или повторно использует группы ассетов; возвращает ID задачи для отслеживания статуса
Одобренные ассеты можно напрямую использовать при генерации видео Seedance 2.0

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

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

Authorization

string

обязательно

Все запросы требуют аутентификации через Bearer TokenПолучите ваш API Key:Перейдите на страницу управления API Key, чтобы получить ваш API KeyДобавьте следующий заголовок к каждому запросу:

Authorization: Bearer YOUR_API_KEY

Параметры запроса

group

object

Информация о группе ассетовЕсли group_id не указан, сервер автоматически создаст группу ассетов AIGC на основе этого поля

Показать Поля

name

string

Имя группы ассетов

description

string

Описание группы ассетов

Пример:

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

Взаимоисключающее с group_id — не указывайте оба одновременно

group_id

string

ID существующей группы ассетовЕсли указано, создание группы пропускается и ассеты отправляются напрямую в указанную группу

Взаимоисключающее с group — не указывайте оба одновременно

project_name

string

по умолчанию:"default"

Имя проектаПо умолчанию: default

asset_type

string

по умолчанию:"Image"

Тип ассетаВарианты:

Image — графический ассет (по умолчанию)
Video — видеоассет
Audio — аудиоассет

По умолчанию: Image

assets

array

Список ассетов, поддерживает отправку нескольких ассетов в одном запросе

Максимум 20 ассетов за одну отправку

Показать Поля

url

string

обязательно

URL ассета — должен быть публично доступен

name

string

обязательно

Имя ассета

Пример:

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

url

string

Сокращённая форма для одного ассета: URL ассета

Используйте либо массив assets, либо это поле — не оба сразу. Подходит для отправки одного ассета.

name

string

Сокращённая форма для одного ассета: имя ассета

Используйте либо массив assets, либо это поле — не оба сразу. Подходит для отправки одного ассета.

Ответ

code

integer

Код состояния ответа, 200 при успехе

data

object

Информация о задаче

Показать Поля

string

Локальный ID задачи, используется для запроса статуса модерации ассета

object

string

Тип объекта задачи, всегда seedance.avatar.asset.task

status

string

Начальный статус задачи, processing после отправки

progress

integer

Прогресс задачи (0 ~ 100)

model

string

Используемое имя модели

Примеры

Пример 1: пакетная отправка (автоматическое создание группы)

Если group_id не указан, сервер автоматически создаёт группу ассетов AIGC перед отправкой.

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

Пример 2: добавление ассетов в существующую группу

Укажите group_id, чтобы пропустить создание группы и отправить ассеты напрямую.

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

Пример 3: сокращённая форма для одного ассета

Для одного ассета используйте поля url и name верхнего уровня напрямую.

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

Запрос результата модерации

Отправка ассетов — это асинхронная задача. Используйте эндпоинт Получение статуса задачи для отслеживания:

GET /v1/tasks/{id}

Все одобрены

{
  "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": []
    }
  }
}

Частичный сбой

Если какие-либо ассеты не прошли модерацию, статус задачи становится failed. Успешно одобренные ассеты остаются пригодными к использованию и отображаются в 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 можно напрямую использовать при генерации видео Seedance 2.0
Ассеты в result.failed_assets должны быть заменены или отправлены повторно
Для задач с одним ассетом также возвращается result.asset_url для совместимости

Использование одобренных ассетов

Передайте URL asset://... напрямую в эндпоинт Генерация видео Seedance 2.0:

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

Как только сервер обнаруживает префикс asset://, он отправляет задачу генерации напрямую, не запуская повторную модерацию ассета.

doubao-seedance-2.0 — генерация видео Sora2 — генерация видео

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

​Параметры запроса

​Ответ

​Примеры

​Пример 1: пакетная отправка (автоматическое создание группы)

​Пример 2: добавление ассетов в существующую группу

​Пример 3: сокращённая форма для одного ассета

​Запрос результата модерации

​Все одобрены

​Частичный сбой

​Использование одобренных ассетов

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

Параметры запроса

Ответ

Примеры

Пример 1: пакетная отправка (автоматическое создание группы)

Пример 2: добавление ассетов в существующую группу

Пример 3: сокращённая форма для одного ассета

Запрос результата модерации

Все одобрены

Частичный сбой

Использование одобренных ассетов