APIMaster.ai

Verifikasi pemilik dan aset potret

Panduan APIMaster bersama untuk verifikasi, aset, dan pembuatan video Seedance.

Verifikasi pemilik dan aset potret

Gunakan pustaka materi terpadu untuk gambar, video, dan audio biasa. Buat grup hanya dengan model dan nama, tanpa channel_id atau purpose. Server mengelola pemeriksaan dan salinan untuk model tujuan.

Penting: selebritas dan orang biasa menggunakan alur yang berbeda

Hanya selebritas yang perlu menggunakan API verifikasi orang nyata untuk memulai verifikasi keaktifan: POST /v1/seedance2/private-avatar/verifications.

Orang biasa mengirim materi langsung untuk ditinjau melalui POST /v1/seedance2/private-avatar/assets. Jangan gunakan API verifikasi orang nyata dan jangan membuat sesi verifikasi keaktifan. Materi dapat digunakan sebagai referensi setelah berstatus Active.

Keempat model memakai antarmuka APIMaster yang sama. Backend memetakan endpoint, kredensial, ID, dan status penyedia. Verifikasi resmi pemilik, pemeriksaan potret oleh kanal, serta aset biasa atau virtual merupakan alur berbeda. Gunakan hanya foto dengan izin tegas dari pemilik.

1. Kemampuan dan cakupan

Untuk verifikasi H5 resmi yang terpisah, periksa kemampuan dan gunakan channel_id yang tersedia dengan metode official_h5. Pengiriman biasa ke pustaka terpadu tidak memerlukan pemilihan kanal.

model duration Image Video Audio
seedance-2.0 4–15 s ≤9 ≤3 / ≤15 s ≤3 / ≤15 s
seedance-2.0-fast 4–15 s ≤9 ≤3 / ≤15 s ≤3 / ≤15 s
seedance-2.0-mini 4–15 s ≤9 ≤3 / ≤15 s ≤3 / ≤15 s
seedance-2.5 4–30 s / -1 ≤30 ≤10 / ≤30 s ≤10 / ≤30 s

Materi terpadu: buat, simpan, dan gunakan kembali

Gunakan pustaka materi terpadu untuk gambar, video, dan audio biasa. Buat grup hanya dengan model dan nama, tanpa channel_id atau purpose. Server mengelola pemeriksaan dan salinan untuk model tujuan.

export APIMASTER_KEY='<your APIMaster key>'
curl --fail-with-body 'https://apimaster.ai/v1/seedance2/private-avatar/groups' \
  -H "Authorization: Bearer $APIMASTER_KEY" -H 'Content-Type: application/json' \
  -d '{"model":"seedance-2.5","name":"My materials"}'

asset_type: Image / Video / Audio.

curl --fail-with-body 'https://apimaster.ai/v1/seedance2/private-avatar/assets' \
  -H "Authorization: Bearer $APIMASTER_KEY" -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: unified-audio-001' \
  -d '{"model":"seedance-2.5","group_id":"group_PUBLIC_ID","asset_type":"Audio","assets":[{"url":"https://your-storage.example/audio.mp3","name":"Reference audio"}]}'

Simpan group_id (data.id), asset_id, dan asset_url (referensi asset://). Kirim materi untuk diperiksa, lalu periksa tugas, available_models, dan model_readiness sebelum membuat video dengan model yang siap. ID yang sama dapat digunakan lagi selama materi tersedia; penghapusan, kedaluwarsa, atau salinan baru mungkin memerlukan sumber asli yang dapat diakses. Verifikasi pemilik H5 resmi merupakan alur terpisah, bukan syarat pemeriksaan materi biasa.

3. Verifikasi melalui ponsel

Bagian ini hanya berlaku untuk selebritas. Orang biasa melewati verifikasi keaktifan dan langsung mengirim materi untuk ditinjau.

Untuk official_h5, buat sesi lalu pemilik membuka h5_link melalui ponselnya. APIMaster menyediakan callback HTTPS, sehingga pelanggan tidak memerlukan server callback sendiri. Jangan kirim callback_url. Kunci jangka panjang dan BytedToken tetap di server. Hasil browser saja tidak cukup: server mengonfirmasi ke penyedia. Callback berulang tidak membuat sumber daya tambahan.

export APIMASTER_KEY='<your APIMaster key>'
export APIMASTER_CHANNEL_ID='<available channel ID from the capability API>'
curl --fail-with-body 'https://apimaster.ai/v1/seedance2/private-avatar/capabilities?model=seedance-2.5' -H "Authorization: Bearer $APIMASTER_KEY"
curl --fail-with-body 'https://apimaster.ai/v1/seedance2/private-avatar/verifications' \
 -H "Authorization: Bearer $APIMASTER_KEY" -H 'Content-Type: application/json' \
 -H 'Idempotency-Key: portrait-session-001' \
 -d "{\"model\":\"seedance-2.5\",\"channel_id\":${APIMASTER_CHANNEL_ID},\"name\":\"My portrait\"}"

4. Mengonfirmasi hasil

Setelah completed gunakan group_id publik. Status dan batas waktu berikut berbeda dari masa izin penggunaan potret. Kesalahan jaringan sementara mempertahankan status; jangan membuat sesi baru otomatis. Konsol: /console/seedance-materials. Sesi, grup, aset, dan tugas video mempunyai ID berbeda.

curl --fail-with-body 'https://apimaster.ai/v1/seedance2/private-avatar/verifications/verification_PUBLIC_ID' -H "Authorization: Bearer $APIMASTER_KEY"
API fields / values
capabilities model, channel_id, method, configured, reason, hosted_callback, real_person_verified
verification session_id (id), method, status, h5_link (verification_url), created_at, expires_at, group_id
verification.status creating, pending, completed, failed, expired, failed_unconfirmed, submission_unknown
Idempotency-Key 8–128; same request → original receipt; changed request → 409
verification rate ≤3 / user / minute; upstream limits also apply
H5 / BytedToken single-use H5; query credential ≤30 min; expires_at ≠ portrait authorization expiry

5. Mengunggah dan memeriksa aset

Orang biasa cukup menggunakan API pengiriman materi dalam bagian ini; tidak perlu memanggil API verifikasi orang nyata terlebih dahulu.

POST /uploads menyimpan sumber asli; POST /assets mengirim materi untuk diperiksa. Grup biasa memakai unified_virtual. Buat video hanya saat model tujuan siap. Foto baru dalam grup resmi real_person tetap memerlukan pemeriksaan orang yang sama. Keberhasilan sebagian mempertahankan materi yang diterima. Jika pengiriman belum terkonfirmasi, simpan ID tugas dan materi asli, periksa statusnya, dan jangan mengunggah ulang secara otomatis.

curl --fail-with-body 'https://apimaster.ai/v1/seedance2/private-avatar/uploads' \
 -H "Authorization: Bearer $APIMASTER_KEY" -F 'file=@authorized-owner.png'
curl --fail-with-body 'https://apimaster.ai/v1/seedance2/private-avatar/assets' \
 -H "Authorization: Bearer $APIMASTER_KEY" -H 'Content-Type: application/json' \
 -H 'Idempotency-Key: portrait-asset-001' \
 -d '{"model":"seedance-2.5","group_id":"group_PUBLIC_ID","asset_type":"Image","assets":[{"url":"<signed upload URL>","name":"Owner"}]}'
curl --fail-with-body 'https://apimaster.ai/v1/tasks/asset_task_PUBLIC_ID' -H "Authorization: Bearer $APIMASTER_KEY"
curl --fail-with-body 'https://apimaster.ai/v1/seedance2/private-avatar/assets?group_id=group_PUBLIC_ID' -H "Authorization: Bearer $APIMASTER_KEY"
curl --fail-with-body 'https://apimaster.ai/v1/seedance2/private-avatar/assets/asset_PUBLIC_ID' -H "Authorization: Bearer $APIMASTER_KEY"
API fields / values
uploads JPEG / PNG ≤10 MB; upload_id, url, url_expires_at, delete_after
groups public id; group_type=unified_virtual / real_person
assets public asset_id; status=Pending / Processing / Active / Failed / SubmissionUnknown
review task asset_task_*; GET /v1/tasks/{id}

6. Membuat dan mengunduh

Sebelum membuat video, panggil /v1/videos/quote: perkiraan bukan jaminan biaya maksimum. Server mempertahankan kanal, akun, dan proyek yang kompatibel dengan aset. Kombinasi tidak kompatibel ditolak. Pergantian model tetap harus memeriksa batas inputnya; foto baru perlu pemeriksaan baru. Setelah sukses, periksa tagihan dan unduh video.

curl --fail-with-body 'https://apimaster.ai/v1/videos' \
 -H "Authorization: Bearer $APIMASTER_KEY" -H 'Content-Type: application/json' \
 -H 'Idempotency-Key: portrait-video-001' \
 -d '{"model":"seedance-2.5","prompt":"The person smiles naturally","image_urls":["asset://asset_PUBLIC_ID"],"resolution":"480p","duration":4,"generate_audio":false}'
curl --fail-with-body 'https://apimaster.ai/v1/seedance2/private-avatar/video-requests/video_request_PUBLIC_ID' -H "Authorization: Bearer $APIMASTER_KEY"
curl --fail-with-body 'https://apimaster.ai/v1/videos/task_PUBLIC_ID' -H "Authorization: Bearer $APIMASTER_KEY"
curl --fail-with-body 'https://apimaster.ai/v1/videos/task_PUBLIC_ID/billing' -H "Authorization: Bearer $APIMASTER_KEY"
curl --fail-with-body 'https://apimaster.ai/v1/videos/task_PUBLIC_ID/content' -H "Authorization: Bearer $APIMASTER_KEY" -o owner.mp4
API fields / values
generation Idempotency-Key required; no automatic POST retry
receipt video_request_*; X-Seedance-Request-Id; replay → 202 + original receipt
video task task_*; separate from receipt, verification and asset IDs

7. Privasi dan penghapusan

Tautan bertanda tangan bersifat sensitif: pemegangnya dapat mengunduh selama masa berlaku. Jangan mencatat tautan H5, URL bertanda tangan, atau kredensial callback. Menghapus berkas asli tidak menghapus aset penyedia. Penghapusan aset menghapus pemetaan APIMaster dan memanggil penghapusan penyedia jika didukung; operasi jarak jauh yang tidak tersedia tidak dijanjikan. Hapus aset sebelum grup. Video yang sudah dibuat tidak otomatis terhapus. Tidak menyimpan templat biometrik; persetujuan pemeriksaan bukan pengganti izin penggunaan.

API / storage values
signed original URL 1 h
hosted original access ≤24 h; deletion ≤25 h
DELETE /uploads/{upload_id} hosted original
DELETE /assets/{asset_id} APIMaster mapping; upstream deletion if supported
DELETE /groups/{group_id} empty group

8. Biaya dan kesalahan

Diperiksa pada 2026-10-07: dokumentasi resmi menyebut verifikasi gratis sementara. Biaya nyata sesi, pemeriksaan, unggahan, penyimpanan, dan pengelolaan bergantung pada konteks dan belum seluruhnya dikonfirmasi. Tidak ada pembelian paket otomatis. Pembuatan video memakai penawaran, pencadangan biaya, penyelesaian, dan pengembalian dana yang ada; periksa bukti tagihan nyata. Kesalahan membedakan izin, kemampuan tidak tersedia, pemeriksaan tertunda atau gagal, aset tidak kompatibel, serta hasil penyedia yang belum pasti. Aset pengguna lain tidak dapat diakses.

HTTP context
400 input / callback
403 permissions
404 resource
409 pending / failed review / incompatible context
429 rate limit
502 / 503 uncertain upstream result / unavailable

Idempotensi Seedance dan pemulihan pengiriman

Materi virtual dan pemulihan otomatis

Grup virtual tanpa channel_id memungkinkan satu ID asset:// untuk model kompatibel. available_models, model_readiness, dan all_models_ready menunjukkan kesiapan. Setiap layanan meninjau salinannya secara mandiri. Periksa tugas peninjauan; salinan baru memerlukan sumber asli yang dapat diakses. Kanal eksplisit, grup materi yang sudah ada, dan materi H5 resmi tetap mengikuti batas pengikatannya.

Pembuatan memerlukan Idempotency-Key. Peralihan sebelum penerimaan hanya mungkin setelah penolakan batas laju yang tegas tanpa ID tugas. Tugas diterima yang berakhir karena akun dinonaktifkan, kredensial tidak valid, atau gangguan layanan terkonfirmasi dapat dipulihkan otomatis paling banyak sekali jika layanan kompatibel tersedia. ID tugas publik dan tarif pengguna yang dibekukan tetap sama, tanpa reservasi pembuatan kedua. Periksa tugas asli dan tanda terima tagihan.

Layanan tujuan memerlukan salinan kompatibel yang disetujui atau peninjauan materi mandiri. Persetujuan dan verifikasi H5 resmi tidak dipindahkan antar layanan atau akun. Kesalahan parameter, moderasi, hak cipta, waktu habis, putus koneksi, dan penerimaan tidak pasti dikecualikan. Sebelum mengirim ulang manual, periksa tanda terima; kunci baru hanya jika new_submission_safe=true.