APIMaster.ai

Kişi doğrulaması ve portre varlıkları

Seedance doğrulaması, varlıkları ve üretimi için ortak APIMaster kılavuzu.

Kişi doğrulaması ve portre varlıkları

Normal görsel, video ve sesler için birleşik materyal kitaplığını kullanın. Grubu yalnızca model ve ad ile oluşturun; channel_id ve purpose göndermeyin. Sunucu hedef modeller için incelemeyi ve kopyaları yönetir.

Önemli: ünlüler ve ünlü olmayan kişiler farklı süreçler kullanır

Gerçek kişi doğrulama API’siyle canlılık doğrulaması başlatması gerekenler yalnızca ünlülerdir: POST /v1/seedance2/private-avatar/verifications.

Ünlü olmayan kişiler materyallerini POST /v1/seedance2/private-avatar/assets üzerinden doğrudan incelemeye göndermelidir. Gerçek kişi doğrulama API’sini kullanmayın ve canlılık doğrulama oturumu oluşturmayın. Materyal Active durumuna ulaştığında referans olarak kullanılabilir.

Dört model aynı APIMaster arayüzlerini kullanır. Arka uç sağlayıcı uç noktalarını, kimlik bilgilerini, kimlikleri ve durumları eşler. Resmî kişi doğrulaması, kanal portre incelemesi ve sıradan veya sanal varlıklar farklı süreçlerdir. Yalnızca açıkça izin verilen fotoğrafları gönderin.

1. Yetenekler ve kapsam

Ayrı resmî H5 doğrulaması için yetenekleri sorgulayın ve official_h5 yöntemi olan kullanılabilir bir channel_id seçin. Birleşik kitaplığa normal materyal gönderirken kanal seçimi gerekmez.

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

Birleşik materyaller: oluşturma, kaydetme ve yeniden kullanma

Normal görsel, video ve sesler için birleşik materyal kitaplığını kullanın. Grubu yalnızca model ve ad ile oluşturun; channel_id ve purpose göndermeyin. Sunucu hedef modeller için incelemeyi ve kopyaları yönetir.

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

Dönen group_id (data.id), asset_id ve asset_url (asset:// referansı) değerlerini kaydedin. Materyalleri incelemeye gönderin, ardından hazır bir hedef modelle üretmeden önce görevi, available_models ve model_readiness alanlarını kontrol edin. Aynı ID kullanılabilir olduğu sürece yeniden kullanılabilir; silme, süre dolması veya yeni kopyalar erişilebilir bir orijinal gerektirebilir. Resmî H5 sahip doğrulaması ayrı bir akıştır ve normal materyal incelemesinin ön koşulu değildir.

3. Telefonda doğrulama

Bu bölüm yalnızca ünlüler içindir. Ünlü olmayan kişiler canlılık doğrulamasını atlayıp doğrudan materyal gönderimi ve incelemesine geçmelidir.

official_h5 için oturum oluşturun; kişi kendi telefonunda h5_link açmalıdır. APIMaster HTTPS callback barındırır; müşterinin kendi sunucusu gerekmez. callback_url göndermeyin. Uzun süreli anahtarlar ve BytedToken sunucuda kalır. Tarayıcı sonucu tek başına yeterli değildir: sunucu sağlayıcıdan doğrular. Yinelenen callback yeni kaynak oluşturmaz.

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. Sonucu doğrulama

completed sonrasında herkese açık group_id kullanın. Aşağıdaki durum ve süreler portrenin kullanım izni süresinden farklıdır. Geçici ağ hataları durumu korur; otomatik yeni oturum açmayın. Konsol: /console/seedance-materials. Oturum, grup, varlık ve video görevi farklı kimliklere sahiptir.

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. Varlık yükleme ve inceleme

Ünlü olmayan kişiler yalnızca bu bölümdeki materyal gönderim API’sini kullanmalıdır; önce gerçek kişi doğrulama API’sini çağırmaları gerekmez.

POST /uploads orijinali saklar; POST /assets materyalleri incelemeye gönderir. Normal gruplar unified_virtual kullanır. Yalnızca hedef model hazır olduğunda üretin. Resmî real_person grubundaki yeni fotoğraflar aynı kişi incelemesini gerektirir. Kısmi başarı kabul edilen materyalleri korur. Gönderim doğrulanmadıysa orijinal görev ve materyal ID’lerini saklayın, durumu sorgulayın ve otomatik olarak yeniden yüklemeyin.

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. Üretme ve indirme

Üretmeden önce /v1/videos/quote çağırın: tahmin azami ücret garantisi değildir. Sunucu uyumlu kanal, hesap ve projeyi korur; uyumsuz birleşimleri reddeder. Model değişikliğinde o modelin sınırları kontrol edilir; yeni fotoğraflar yeni inceleme gerektirir. Başarıdan sonra ücret makbuzunu sorgulayın ve videoyu indirin.

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. Gizlilik ve silme

İmzalı bağlantılar hassastır: bağlantıya sahip olanlar geçerlilik süresinde indirebilir. H5 bağlantılarını, imzalı URL veya callback kimlik bilgilerini kaydetmeyin. Orijinali silmek sağlayıcı varlığını silmez. Varlık silme APIMaster eşlemesini kaldırır ve destekleniyorsa sağlayıcı silmesini kullanır; desteklenmeyen uzak silme vaat edilmez. Önce varlıkları, sonra grubu silin. Üretilmiş videolar otomatik silinmez. Biyometrik şablon saklanmaz; inceleme onayı kullanım izni yerine geçmez.

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. Ücretler ve hatalar

2026-10-07 tarihinde kontrol edildi: resmî belgeler doğrulamayı geçici ücretsiz olarak tanımlar. Oturum, inceleme, yükleme, depolama ve yönetim ücretleri bağlama bağlıdır ve tümü doğrulanmamıştır. Otomatik paket satın alınmaz. Üretim mevcut teklif, ön ayırma, hesaplaşma ve iade mekanizmalarını kullanır; gerçek makbuzu kontrol edin. Hatalar izinleri, desteklenmeyen yeteneği, bekleyen/başarısız incelemeyi, uyumsuz varlığı ve belirsiz sağlayıcı sonucunu ayırır. Başka kullanıcıların kaynaklarına erişilemez.

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

Seedance idempotansı ve gönderim kurtarma

Sanal materyaller ve otomatik kurtarma

channel_id olmadan sanal grup, uyumlu modellerde tek asset:// kimliği kullanır. available_models, model_readiness, all_models_ready hazır olma durumunu belirtir. Her hizmet kopyaları bağımsız inceler. İnceleme görevini sorgulayın; yeni kopyalar erişilebilir özgün kaynak gerektirir. Açık kanal seçimi, mevcut materyal grupları ve resmi H5 materyalleri bağlama kısıtlarını korur.

Üretim Idempotency-Key gerektirir. Kabul öncesi geçiş yalnızca görev kimliği olmadan açık hız sınırı reddinden sonra mümkündür. Kabul edilmiş görev doğrulanmış hesap devre dışı bırakılması, geçersiz kimlik bilgisi veya hizmet arızasıyla biterse uyumlu hizmet mevcutken en fazla bir kez otomatik kurtarılabilir. Genel görev kimliği ve sabitlenmiş kullanıcı tarifesi korunur; ikinci üretim rezervasyonu yapılmaz. İlk görevi ve faturalama makbuzunu sorgulayın.

Hedef hizmetin uyumlu onaylı kopyaları olmalı veya bağımsız materyal incelemesini tamamlamalıdır. Onaylar ve resmi H5 doğrulaması hizmetler veya hesaplar arasında taşınmaz. Parametre, moderasyon, telif hataları, zaman aşımı, bağlantı kopması ve belirsiz kabul kapsam dışıdır. Elle yeniden göndermeden önce makbuzu sorgulayın; yeni anahtar yalnızca new_submission_safe=true olduğunda kullanılabilir.