Seedance teklifleri ve fatura makbuzları
Seedance üretim maliyetlerini tahmin edin ve nihai tahsilatı kimliği doğrulanmış, kalıcı fatura makbuzlarıyla doğrulayın.
Seedance teklifleri ve fatura makbuzları
seedance-2.0, seedance-2.5, seedance-2.0-fast ve seedance-2.0-mini modelleri için tüm üretim kanallarında geçerlidir. Temel URL: https://apimaster.ai/v1 (https://apimaster.ai/v1). Tüm istekleri Authorization: Bearer YOUR_API_KEY ile kimlik doğrulayarak gönderin.
Tahmin alın
POST https://apimaster.ai/v1/videos/quote, standart bir video üretim isteğiyle aynı JSON parametrelerini kabul eder; bunlar model, prompt, duration, resolution, video_urls ve diğer desteklenen üretim ayarlarını içerir. Taslak üretim, taslak yükseltmeleri ve remix teklifleri şu anda desteklenmemektedir.
curl "https://apimaster.ai/v1/videos/quote" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"seedance-2.0","prompt":"A paper boat on a pond","duration":4,"resolution":"480p","generate_audio":false}'
Yanıt, object: "video.quote", quote_id, expires_at (Unix saniye), binding: false, funds_reserved: false ve aşağıda açıklanan bir billing nesnesi içerir. Teklifin beş dakikalık tavsiye niteliğinde bir geçerlilik süresi vardır. Bu işlem fon düşürmez, görev oluşturmaz veya sağlayıcı üretimini başlatmaz. Bu nedenle billing.reserved_amount değeri "0.000000"dır. Teklif kimliği bilgilendirme amaçlıdır; bir yetkilendirme veya fiyat kilidi belirteci değildir ve üretimle birlikte gönderilmesi gerekmez.
Fiyat, gerçek gönderimde yeniden hesaplanır ve o görev için sabitlenir. Bir tahmin, azami ücret garantisi değildir. Tamamlanan görev, tahminden daha pahalıya veya daha ucuza mal olabilir. Otomatik süre istekleri 30 saniyelik çıktı tahmini kullanır; requested_output_seconds değeri -1dir.
Üretim sağlayıcı doğrulamasına tabidir. Seedance 2.5 video uzatma isteklerinde aspect_ratio: "adaptive" değerini açıkça ayarlayın; sağlayıcı reddi normal iade yaşam döngüsü kapsamında ele alınır.
Görev makbuzunu alın
curl "https://apimaster.ai/v1/videos/task_xxx/billing" \
-H "Authorization: Bearer YOUR_API_KEY"
GET /v1/videos/{task_id}/billing, object: "video.billing_receipt", billing ve customer_billing döndürür. Görev sahibinin hesabına ait API anahtarını kullanın. Özgün anahtarla GET /v1/video-submissions/by-key sorgusunda müşteri ücretini data.customer_billing altında görebilirsiniz. final: true iken net_amount, USD cinsinden ondalık metin olarak kesin net tutardır. İadesi kesinleşen eski görevlerde sağlayıcı ücreti henüz doğrulanmasa da müşterinin net tutarı sıfır olabilir. Başka bir hesaba ait görevlerde veya makbuz ile iade kanıtı bulunmadığında görev kimliğiyle sorgu HTTP 404 döndürür. Yeni gönderimin güvenli olup olmadığını mevcut yeniden deneme alanlarından kontrol edin.
Aynı billing nesnesi her iki görev sorgu yanıtında da yer alır:
GET /v1/videos/{task_id}: üst düzeybilling.GET /v1/video/generations/{task_id}:data.billing.
settlement_status değeri pending, settled veya refunded olur; teklif yanıtları estimate kullanır. Görev tamamlaması ve finansal mutabakat birbirinden ayrıdır: tutarları yalnızca makbuz settled veya refunded olduğunda kesin kabul edin. Tekrarlanan makbuz istekleri üretim, mutabakat veya iade işlemi gerçekleştirmez. Kesinleşen makbuzlar, iade sonrasında dahil olmak üzere aynı makbuz kimliğini ve içeriğini korur.
Tam istek ve yanıt örnekleri
Her iki örnek de 480P'de Seedance 2.0, istenen 4 saniyelik çıktı, 4.042 saniye ölçülen bir referans, kanal çarpanı 1 ve hesap çarpanı 1.05 kullanır. Tamamlanma süreleri ve tutarlar canlı bir testten gelir; teklif, eşleşen girdiler için oluşturulmuş örnekleyici bir örnektir. Kimlikler ve medya URL'leri yer tutucudur. Gerçek oranlar API yanıtınızdan gelir.
1. Teklif alın
POST https://apimaster.ai/v1/videos/quote, istek JSON'u:
{
"model": "seedance-2.0",
"prompt": "A paper boat moves gently on a pond.",
"duration": 4,
"resolution": "480p",
"video_urls": [
"https://example.com/reference.mp4"
]
}
| Alan | Tür | Anlam |
|---|---|---|
model |
string | Model kimliği, burada seedance-2.0. |
prompt |
string | Üretim istemi. |
duration |
integer | İstenen çıktı saniyesi, referans video süresi değil. |
resolution |
string | Çıktı çözünürlüğü, burada 480p. |
video_urls |
array |
Referans video URL'leri. Yer tutucuyu erişilebilir medyayla değiştirin; sunucu her dosyayı ölçer. |
Teklif yanıtı:
{
"object": "video.quote",
"quote_id": "quote_example",
"expires_at": 1790949324,
"binding": false,
"funds_reserved": false,
"billing": {
"schema_version": "1",
"settlement_status": "estimate",
"model": "seedance-2.0",
"resolution": "480P",
"tariff_variant": "480P-input",
"tariff_revision": "sd-v1-b79a35d3a29af9af",
"currency": "USD",
"unit": "second",
"base_unit_rate": "0.04319",
"channel_multiplier": 1,
"account_multiplier": 1.05,
"effective_unit_rate": "0.0453495",
"requested_output_seconds": 4,
"estimated_output_seconds": 4,
"estimated_billable_seconds": 9,
"input_videos": [
{
"index": 0,
"media_id": "media_example_hash",
"measured_seconds": 4.042,
"billable_seconds": 5,
"duration_source": "apimaster_probe"
}
],
"billable_input_video_seconds": 5,
"output": null,
"billable_seconds": null,
"rounding": {
"amount_formula": "round(total_billable_seconds * effective_unit_rate / account_unit_usd) * account_unit_usd",
"effective_unit_rate": "nearest_decimal_12_places_half_up",
"input_video": "ceil_each_file_then_sum",
"money": "nearest_account_unit_half_up",
"output_video": "nearest_integer_half_up"
},
"estimated_amount": "0.408146",
"reserved_amount": "0.000000",
"additional_debit_amount": "0.000000",
"final_debit_amount": null,
"refunded_amount": "0.000000",
"net_amount": null,
"initial_quota_units": 0,
"final_quota_units": null,
"account_unit_usd": "0.000002",
"media_charges": {
"audio": "0.000000",
"image": "0.000000",
"input_video_unrounded": "0.2267475",
"other_reference": "0.000000",
"output_video_unrounded": "0.181398"
},
"final_debit_may_exceed_estimate": true,
"created_at": 1790949024,
"settled_at": null
}
}
4.042 saniyelik girdi yukarı yuvarlanarak 5 saniye olur. 4 tahmini çıktı saniyesiyle teklif 9 saniyeyi kapsar ve 0.408146 USD tutarındadır. Teklif fon düşürmez; nihai tutarlar null kalır.
2. Üretimi gönderin ve tamamlamayı sorgulayın
POST https://apimaster.ai/v1/videos/generations adresine gönderdikten sonra ilk yanıt görev kimliğini içerir:
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_example"
}
]
}
Ardından aynı hesaptan bir API anahtarıyla GET https://apimaster.ai/v1/videos/task_example adresini sorgulayın. Üretim ve mutabakat tamamlandıktan sonra:
{
"actual_time": 189,
"billing": {
"schema_version": "1",
"receipt_id": "bill_task_example",
"task_id": "task_example",
"settlement_status": "settled",
"model": "seedance-2.0",
"resolution": "480P",
"tariff_variant": "480P-input",
"tariff_revision": "sd-v1-b79a35d3a29af9af",
"currency": "USD",
"unit": "second",
"base_unit_rate": "0.04319",
"channel_multiplier": 1,
"account_multiplier": 1.05,
"effective_unit_rate": "0.0453495",
"requested_output_seconds": 4,
"estimated_output_seconds": 4,
"estimated_billable_seconds": 9,
"input_videos": [
{
"index": 0,
"media_id": "media_example_hash",
"measured_seconds": 4.042,
"billable_seconds": 5,
"duration_source": "apimaster_probe"
}
],
"billable_input_video_seconds": 5,
"output": {
"actual_seconds": 4,
"billable_seconds": 4,
"duration_source": "provider_reported"
},
"billable_seconds": 9,
"rounding": {
"amount_formula": "round(total_billable_seconds * effective_unit_rate / account_unit_usd) * account_unit_usd",
"effective_unit_rate": "nearest_decimal_12_places_half_up",
"input_video": "ceil_each_file_then_sum",
"money": "nearest_account_unit_half_up",
"output_video": "nearest_integer_half_up"
},
"estimated_amount": "0.408146",
"reserved_amount": "0.408146",
"additional_debit_amount": "0.000000",
"final_debit_amount": "0.408146",
"refunded_amount": "0.000000",
"net_amount": "0.408146",
"initial_quota_units": 204073,
"final_quota_units": 204073,
"account_unit_usd": "0.000002",
"media_charges": {
"audio": "0.000000",
"image": "0.000000",
"input_video_unrounded": "0.2267475",
"other_reference": "0.000000",
"output_video_unrounded": "0.181398"
},
"final_debit_may_exceed_estimate": true,
"created_at": 1790949024,
"settled_at": 1790949213
},
"completed_at": 1790949213,
"created_at": 1790949024,
"id": "task_example",
"metadata": {
"url": "https://apimaster.ai/v1/videos/task_example/content"
},
"model": "seedance-2.0",
"object": "video",
"progress": 100,
"status": "completed",
"task_id": "task_example",
"usage": {
"completion_tokens": 80770
}
}
Burada ilk tahsilat nihai maliyete eşittir; ek tahsilat veya iade yoktur. billing.output.actual_seconds çıktı süresidir; actual_time işleme süresidir. usage.completion_tokens tahsilatı belirlemez. İsteğe bağlı alanlar kanala göre değişebilir.
GET https://apimaster.ai/v1/videos/task_example/billing, aynı fatura nesnesiyle { "object": "video.billing_receipt", "billing": ... } döndürür. Uyumluluk sorgusu GET https://apimaster.ai/v1/video/generations/task_example bunu data.billing altında yerleştirir.
Dış yanıt alanları
| Alan | Tür | Anlam |
|---|---|---|
object |
string | Yanıt türü: video.quote, video veya video.billing_receipt. |
quote_id |
string | Bilgilendirme amaçlı teklif tanımlayıcısı; fiyat kilidi veya üretim yetkilendirmesi değildir. |
expires_at |
integer | Unix saniye cinsinden tavsiye niteliğinde teklif bitişi, normalde oluşturma zamanı artı 300 saniye. |
binding |
boolean | Şu anda false; teklif nihai bir tutarı garanti etmez. |
funds_reserved |
boolean | Şu anda false; teklif almak fon düşürmez veya rezerve etmez. |
billing |
object | Aşağıda ayrı ayrı belgelenen fatura ayrıntıları. |
code |
integer | Gönderim yanıt kodu; 200 gönderildi anlamına gelir, tamamlandı değil. |
data |
array | Gönderilen görev listesi; uyumluluk sorgusu bunun yerine data için bir nesne kullanır. |
data[].status |
string | Gönderim durumu, bu örnekte submitted. |
data[].task_id |
string | Sonraki sorgularda kullanılan genel görev tanımlayıcısı. |
id |
string | Tamamlama sorgusundaki genel görev kimliği. |
task_id |
string | Görev tanımlayıcısı, bu örnekte id ile eşittir. |
model |
string | Genel üretim modeli adı. |
status |
string | Görev durumu; completed üretimin bittiği anlamına gelir. Nihai mutabakat için billing.settlement_status değerine bakın. |
progress |
number | Yüzde ilerleme; bu örnekte tamamlandığında 100. |
actual_time |
number | Görev işleme saniyeleri, çıktı video süresi değil. |
created_at |
integer | Unix saniye cinsinden görev oluşturma zaman damgası. |
completed_at |
integer | Unix saniye cinsinden görev tamamlama zaman damgası. |
metadata |
object | Üretim sonucu üst verileri. |
metadata.url |
string | Video içerik indirme URL'si. |
usage |
object | Sağlayıcı kullanım bilgisi; kanala göre bulunmayabilir. |
usage.completion_tokens |
integer | Sağlayıcı belirteç sayısı; bu dört modelin saniye başına faturalandırmasında kullanılmaz. |
Fatura şeması
Tüm parasal tutarlar ve birim oranlar ondalık dizgelerdir. Süreler saniye cinsindendir. Kullanılabilir olana kadar boş alanlar JSON null değerindedir.
| Alan | Tür | Anlam |
|---|---|---|
schema_version |
string | Fatura şema sürümü, bu örnekte "1". |
receipt_id |
string | Kararlı makbuz tanımlayıcısı; tekliflerde bulunmaz. |
task_id |
string | Makbuza bağlı genel görev kimliği; tekliflerde bulunmaz. |
settlement_status |
string | estimate, pending, settled, refunded |
model |
string | Uygulanan genel model kimliği. |
resolution |
string | Faturalandırma için kullanılan normalize edilmiş çözünürlük. |
tariff_variant |
string | Tarife kademesi; -input video referanslarını belirtir ve bu oran hem girdi hem çıktı için geçerlidir. |
tariff_revision |
string | Model, tarife kademesi, yapılandırılmış temel oran ve faturalandırma kuralı sürümünün parmak izi |
currency |
string | Tahsilat para birimi, şu anda USD. |
unit |
string | Oranın birimi; second saniye başına demektir. |
base_unit_rate |
decimal string | Bu model ve kademe için yapılandırılmış saniye başına temel fiyat. |
channel_multiplier |
number | Uygulanan toplu kanal fiyatlandırma çarpanı. |
account_multiplier |
number | Uygulanan hesap/grup çarpanı, bu örnekte 1.05. |
effective_unit_rate |
decimal string | Uygulanan saniye başına oran, gönderimde sabitlenir ve 12 ondalık basamağa yuvarlanır. |
requested_output_seconds |
integer | İstenen çıktı süresi; otomatik süre için -1 |
estimated_output_seconds |
integer | Tahmini çıktı saniyeleri; otomatik süre 30 saniye olarak tahmin edilir. |
estimated_billable_seconds |
integer | Referans videoları ve tahmini çıktı dahil olmak üzere ilk tahmini toplam faturalanabilir saniyeler. |
input_videos |
array | Referans başına sunucu ölçümleri, istek sırasıyla |
input_videos[].index |
integer | İstekteki referans video konumu, sıfırdan başlar. |
input_videos[].media_id |
string | Hesap kapsamındaki medya özeti veya sahip olunan varlık kimliği; referans video URL'si geri gönderilmez. |
input_videos[].measured_seconds |
number or null | Yuvarlama öncesi sunucu tarafından ölçülen süre; daha eski önbellekli varlıklar için null olabilir |
input_videos[].billable_seconds |
integer | Bu referansın yuvarlanmış faturalanabilir süresi |
input_videos[].duration_source |
string | apimaster_probe veya apimaster_asset_cache |
billable_input_video_seconds |
integer | Referans başına faturalanabilir saniyelerin toplamı |
output |
object or null | Nihai çıktı süresi bilgisi, başarılı mutabakattan sonra kullanılabilir |
output.actual_seconds |
number or null | Gerçek bildirilen/ölçülen çıktı süresi; kullanılamıyorsa null |
output.billable_seconds |
integer | Mutabakatta fiilen kullanılan çıktı saniyeleri |
output.duration_source |
string | provider_reported, apimaster_probe, provider_billable_seconds, requested_duration_fallback veya reservation_fallback |
billable_seconds |
integer or null | Nihai birleşik girdi/çıktı faturalanabilir saniyeleri |
rounding |
object | Girdi, çıktı ve para yuvarlama kuralları ile tutar formülü |
estimated_amount |
decimal string | İlk tahmini maliyet; nihai tutar veya azami ücret garantisi değildir. |
reserved_amount |
decimal string | Gönderimdeki ilk hesap tahsilatı, tekliflerde sıfırdır; banka yetkilendirme tutaması değildir. |
additional_debit_amount |
decimal string | Nihai maliyet ilk tahsilatı aştığında ek tahsilat. |
final_debit_amount |
decimal string or null | Düzeltilmelerden sonraki nihai net görev maliyeti; tam iade sonrası sıfır |
net_amount |
decimal string or null | Düzeltilmelerden sonraki nihai net görev maliyeti; tam iade sonrası sıfır |
refunded_amount |
decimal string | İlk tahsilattan iade edilen tutar; tam iade durumunda ilk tahsilata eşittir. |
initial_quota_units |
integer | Başlangıçta tahsil edilen tam hesap birimleri; tekliflerde sıfır. |
final_quota_units |
integer or null | Nihai net maliyetin tam hesap birimleri; beklerken null, tam iade sonrası sıfır. |
account_unit_usd |
decimal string | Hesap birimi başına "0.000002" |
media_charges |
object | image, audio, other_reference mevcut tarife altında sıfırdır; input_video_unrounded ve output_video_unrounded, nihai parasal yuvarlama öncesi video bileşenlerini ayırır |
final_debit_may_exceed_estimate |
boolean | true; tahmin katı bir harcama sınırı değildir |
created_at |
integer | Fatura ayrıntısı oluşturma zaman damgası, Unix saniye. |
settled_at |
integer or null | Nihai mutabakat veya iade zaman damgası, Unix saniye; kesinleşene kadar null. |
| Alan | Tür | Anlam |
|---|---|---|
rounding.input_video |
string | ceil_each_file_then_sum: her girdi dosyasını yukarı yuvarla, sonra topla. |
rounding.output_video |
string | nearest_integer_half_up: en yakın çıktı saniyesi, yarım saniyeler yukarı yuvarlanır. |
rounding.effective_unit_rate |
string | nearest_decimal_12_places_half_up: etkin oranı 12 ondalık basamağa yuvarla. |
rounding.money |
string | nearest_account_unit_half_up: birleşik tutarı hesap birimlerine yuvarla. |
rounding.amount_formula |
string | Nihai birleşik tutar formülü; girdi ve çıktı tutarları ayrı ayrı yuvarlanmaz. |
media_charges.input_video_unrounded |
decimal string | Parasal yuvarlama öncesi video girdi bileşeni. |
media_charges.output_video_unrounded |
decimal string | Parasal yuvarlama öncesi video çıktı bileşeni. |
media_charges.image |
decimal string | Ayrı görsel ek ücreti, şu anda sıfır. |
media_charges.audio |
decimal string | Ayrı ses ek ücreti, şu anda sıfır. |
media_charges.other_reference |
decimal string | Diğer referans ek ücreti, şu anda sıfır. |
Nihai maliyeti yeniden hesaplayın
Referans video varken video girdi kademesi hem çıktı hem referans video saniyeleri için geçerlidir. Görseller ve ses, mevcut Seedance tarifesinde ayrı bir ek ücrete tabi değildir. Belirteç sayıları ve sağlayıcı maliyeti faturalandırma girdisi değildir.
- Her giriş videosunun ölçülen süresini bağımsız olarak yukarı yuvarlayın, sonra toplayın:
input_seconds = sum(ceil(each_video_duration)). - Çıktı süresini en yakın tam saniyeye yuvarlayın; pozitif yarım saniyeler yukarı yuvarlanır.
- Girdi ve çıktı faturalanabilir saniyelerini ekleyin.
effective_unit_rateile çarpın,account_unit_usd'ye bölün, sonra toplamı bir kez en yakın tam hesap birimine yuvarlayın; pozitif yarım birimler yukarı yuvarlanır.
final_quota_units = round_half_up(billable_seconds × effective_unit_rate / 0.000002)
net_amount = final_quota_units × 0.000002
net_amount = reserved_amount + additional_debit_amount - refunded_amount
Ondalık aritmetik kullanın. Girdi ve çıktı parasal bileşenlerini ayrı ayrı yuvarlamayın. Örneğin, referans video olmadan 480P'de 4 saniyelik bir Seedance 2.0 görevi, 0.07031 temel oran, 1 kanal çarpanı ve 1.05 hesap çarpanıyla 0.0738255 etkin orana ve 0.295302 USD (147651 hesap birimi) net maliyete sahiptir.
APIMaster, input_seconds veya reference_seconds gibi istemci alanlarına güvenmek yerine referans video süresini ölçer. İstenen duration/seconds çıktı süresini kontrol eder. Çıktılar için mutabakat, sağlayıcı tarafından bildirilen süreyi tercih eder ve gerektiğinde çıktıyı ölçer; kullanılamayan ölçümler sağlayıcı faturalanabilir saniyelerine veya istenen/rezerve edilen süreye geri dönebilir. Makbuz kaynağı açıkça etiketler. Geri dönüş asla bağımsız olarak ölçülmüş gerçek süre olarak etiketlenmez. Mevcut önbellekli varlıklar veya devralınan daha eski taslaklar, eksik dosya başına ölçüm ayrıntılarına sahip olabilir.
Video yanıtındaki actual_time, görev işleme süresidir, çıktı video süresi değil. Bulunduğunda usage.completion_tokens bilgilendirme amaçlıdır.
Hatalar ve iadeler
Salayıcı görev hataları ve yapılandırılmış 24 saatlik tamamlanmamış görev zaman aşımı otomatik tam iadeyi tetikler. Bunların makbuzları alınabilir kalır ve iade başarılı olduğunda sıfır net tutarla refunded gösterir. Geçici yoklama/ağ hataları bir görevi hemen iade etmez veya iptal etmez; işleme yeniden denenir.
Ücretlendirilmediği doğrulanmış bir gönderim hatası iade edilir. Belirsiz bir gönderim sonucu otomatik mutabakat için bekletilir (ilk asenkron mutabakat yaklaşık 20 dakika sonra; 24 saat sonra hâlâ bilinmeyen sonuçlar mutabakat sırasında iade edilir). Gönderim genel bir görev oluşturmadıysa, o deneme için görev bağlantılı bir makbuz yoktur. Bir teklif bir rezervasyon değildir ve bırakılması gerekmez.
Genel bir Seedance iptal uç noktası yoktur. Bağlantıyı kesmek veya yoklamayı durdurmak bir görevi iptal etmez. Görev durumu kontrolleri, tekrarlanan yoklamanın aynı tamamlama mutabakatını/İadesini yeniden uygulanmasını önlerken, makbuz uç noktası kendisi salt okunurdur. Bunlar her altyapı hatası için genel anlamda tam olarak bir kez garantisi değildir; bekleyen finansal işlemler kesinleşmiş olarak değerlendirilmemelidir.
