Skip to main content
POST
Impor satu URL sumber yang dapat diakses publik ke dalam grup material Seedance. TokenLab menyimpan material tersebut untuk digunakan nanti; gunakan id aset material yang dikembalikan untuk pembuatan, bukan URL sumbernya. Untuk library_type: "aigc_avatar", group_id bersifat opsional; TokenLab menggunakan atau membuat grup virtual-avatar default organisasi. Untuk library_type: "liveness_face", group_id wajib diisi dan harus berupa grup TokenLab yang dikembalikan oleh Mendapatkan hasil validasi visual. TokenLab memeriksa URL sumber, jenis media, ukuran file, dan dimensi gambar yang dapat dibaca. Impor yang diterima belum berarti aset siap: tunggu ACTIVE dan periksa error_message jika pemrosesan gagal. Persyaratan media dan wajah lainnya diperiksa selama pemrosesan. Pembuatan bersifat asinkron. Lakukan polling pada Mendapatkan Material Asset hingga status menjadi ACTIVE. Untuk grup orang asli (real-person), satu grup dipetakan ke satu orang yang terverifikasi; unggahan dengan banyak wajah atau wajah yang tidak cocok dengan orang yang terverifikasi dapat gagal. project_name memisahkan sumber daya dalam organisasi yang terautentikasi. Nilai default adalah default; gunakan nilai yang sama dan peka huruf besar-kecil untuk grup dan aset terkait. Kirim di body JSON untuk POST/PUT dan parameter kueri untuk GET/DELETE.

Contoh Permintaan

Contoh Respons

Otorisasi

Authorization
string
header
wajib

Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.

Body

application/json
asset_url
string<uri>
wajib

URL sumber yang dapat dijangkau publik untuk diimpor. TokenLab menyimpan materi untuk penggunaan nanti; jangan mengandalkan URL ini sebagai alamat materi jangka panjang.

asset_name
string

Nama tampilan opsional yang disimpan bersama aset materi.

Required string length: 1 - 128
asset_type
enum<string>
default:Image
Opsi yang tersedia:
Image,
Video,
Audio
library_type
enum<string>
default:aigc_avatar

Kelas pustaka materi. aigc_avatar untuk materi avatar virtual. liveness_face untuk materi orang asli yang terverifikasi.

Opsi yang tersedia:
aigc_avatar,
liveness_face
group_id
string

ID grup materi TokenLab. Diperlukan untuk materi liveness_face; opsional untuk aigc_avatar.

project_name
string
default:default

Cakupan proyek untuk aset materi. Aset dan grup diisolasi berdasarkan proyek di dalam organisasi yang terautentikasi.

Required string length: 1 - 128
metadata
object | null

Metadata klien opsional yang disimpan bersama aset materi.

Respons

Aset materi berhasil dibuat

id
string
wajib

ID aset materi TokenLab. Gunakan ini sebagai material_asset_id setelah aset menjadi ACTIVE.

object
enum<string>
wajib
Opsi yang tersedia:
seedance.material_asset
library_type
enum<string>
wajib
Opsi yang tersedia:
aigc_avatar,
liveness_face
asset_type
enum<string>
wajib
Opsi yang tersedia:
Image,
Video,
Audio
status
enum<string>
wajib
Opsi yang tersedia:
PROCESSING,
ACTIVE,
FAILED,
DELETED
ready
boolean
wajib

True saat aset aktif dan tidak dihapus.

group_id
string | null

ID grup materi TokenLab yang memiliki aset materi ini.

project_name
string

Cakupan proyek untuk aset materi ini.

asset_name
string | null
error_message
string | null

Kesalahan pemrosesan terminal yang aman untuk publik. Kegagalan validasi sumber permanen mencakup batasan dimensi yang ditolak.

metadata
object | null
created_at
integer

Stempel waktu Unix saat catatan aset materi dibuat.

updated_at
integer

Stempel waktu Unix saat catatan aset materi terakhir diperbarui.