Virtual Avatar Assets

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

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

Authentication

Authorization

string

required

All requests require Bearer Token authenticationGet your API Key:Visit the API Key Management page to obtain your API KeyAdd the following header to each request:

Authorization: Bearer YOUR_API_KEY

Request Parameters

group

object

Asset group informationIf group_id is not provided, the server will automatically create an AIGC asset group based on this field

Show Fields

name

string

Asset group name

description

string

Asset group description

Example:

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

Mutually exclusive with group_id — do not provide both at the same time

group_id

string

Existing asset group IDWhen provided, skips group creation and submits assets directly to the specified group

Mutually exclusive with group — do not provide both at the same time

project_name

string

default:"default"

Project nameDefault: default

asset_type

string

default:"Image"

Asset typeOptions:

Image - Image asset (default)
Video - Video asset
Audio - Audio asset

Default: Image

assets

array

Asset list, supports submitting multiple assets in one request

Maximum 20 assets per submission

Show Fields

url

string

required

Asset URL — must be publicly accessible

name

string

required

Asset name

Example:

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

url

string

Single-asset shorthand: asset URL

Use either assets array or this field — not both. Suitable for submitting a single asset.

name

string

Single-asset shorthand: asset name

Use either assets array or this field — not both. Suitable for submitting a single asset.

Response

code

integer

Response status code, 200 on success

data

object

Task information

Show Fields

string

Local task ID, used to query asset review status

object

string

Task object type, always seedance.avatar.asset.task

status

string

Initial task status, processing after submission

progress

integer

Task progress (0 ~ 100)

model

string

Model name in use

Examples

Example 1: Batch submit (auto-create group)

When group_id is not provided, the server automatically creates an AIGC asset group before submitting.

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

Example 2: Append assets to an existing group

Provide group_id to skip group creation and submit directly.

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

Example 3: Single-asset shorthand

For a single asset, use the top-level url and name fields directly.

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

Query Review Result

Asset submission is an asynchronous task. Use the Get Task Status endpoint to poll:

GET /v1/tasks/{id}

All Approved

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

Partial Failure

If any asset fails review, the task status becomes failed. Successfully approved assets remain usable and appear in 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 can be used directly in Seedance 2.0 video generation
Assets in result.failed_assets must be replaced or resubmitted
Single-asset tasks also return result.asset_url for compatibility

Using Approved Assets

Pass the asset://... URL directly to the Seedance 2.0 Video Generation endpoint:

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

Once the server detects the asset:// prefix, it submits the generation task directly without triggering another asset review.

doubao-seedance-2.0 Video Generation Sora2 Video Generation

Overview

Text Series

Image Series

Video Series

Audio Series

Moderation Series

Upload Management

Task Management

Account Management

Virtual Avatar Assets

Authentication

Request Parameters

Response

Examples

Example 1: Batch submit (auto-create group)

Example 2: Append assets to an existing group

Example 3: Single-asset shorthand

Query Review Result

All Approved

Partial Failure

Using Approved Assets

​Authentication

​Request Parameters

​Response

​Examples

​Example 1: Batch submit (auto-create group)

​Example 2: Append assets to an existing group

​Example 3: Single-asset shorthand

​Query Review Result

​All Approved

​Partial Failure

​Using Approved Assets

Authentication

Request Parameters

Response

Examples

Example 1: Batch submit (auto-create group)

Example 2: Append assets to an existing group

Example 3: Single-asset shorthand

Query Review Result

All Approved

Partial Failure

Using Approved Assets