APIMaster.ai

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üzey billing.
  • 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.

  1. Her giriş videosunun ölçülen süresini bağımsız olarak yukarı yuvarlayın, sonra toplayın: input_seconds = sum(ceil(each_video_duration)).
  2. Çıktı süresini en yakın tam saniyeye yuvarlayın; pozitif yarım saniyeler yukarı yuvarlanır.
  3. Girdi ve çıktı faturalanabilir saniyelerini ekleyin.
  4. effective_unit_rate ile ç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.

Seedance idempotansı ve gönderim kurtarma