메인 콘텐츠로 건너뛰기
POST
/
v1
/
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"
      }
    ]
  }'

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

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

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

​
인증

​
Authorization
string
필수
모든 요청에 Bearer Token 인증이 필요합니다API Key 발급:API Key 관리 페이지에서 API Key를 발급받으세요각 요청에 다음 헤더를 추가하세요:
Authorization: Bearer YOUR_API_KEY

​
요청 파라미터

​
group
object
에셋 그룹 정보group_id를 지정하지 않으면 서버가 이 필드를 기반으로 AIGC 타입 에셋 그룹을 자동 생성합니다예시:
{
  "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
에셋 목록, 1회 요청으로 여러 에셋 제출 가능
1회 제출 최대 20개
예시:
{
  "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 배열과 둘 중 하나만 사용 가능. 에셋 1개 제출 시 적합합니다
​
name
string
단일 에셋 단축 표기: 에셋 이름
assets 배열과 둘 중 하나만 사용 가능. 에셋 1개 제출 시 적합합니다

​
응답

​
code
integer
응답 상태 코드, 성공 시 200
​
data
object
태스크 정보

​
사용 예시

​
예시 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: 단일 에셋 단축 표기

에셋이 1개인 경우 최상위 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": []
    }
  }
}

​
일부 실패

배치 제출 시 1개라도 심사에 실패하면 태스크 상태가 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": "일부 에셋 심사 실패"
    }
  }
}
  • result.usable_assets[].asset_url은 Seedance 2.0 동영상 생성에 직접 사용할 수 있습니다
  • result.failed_assets 내 에셋은 소스 파일을 교체하거나 재제출해야 합니다
  • 단일 에셋 태스크도 호환을 위해 result.asset_url을 반환합니다

​
심사 통과 에셋 사용

asset://... URL을 Seedance 2.0 동영상 생성 엔드포인트에 직접 전달하세요: 
{
  "model": "doubao-seedance-2.0",
  "prompt": "캐릭터가 도시 거리를 자연스럽게 걷는다",
  "image_urls": ["asset://asset_a"],
  "duration": 5,
  "resolution": "720p"
}
서버가 asset:// 접두사를 감지하면 에셋 심사를 다시 트리거하지 않고 직접 생성 태스크를 제출합니다.