Wyceny Seedance i rachunki rozliczeniowe
Oszacuj koszty generowania Seedance i zweryfikuj finalne obciążenie dzięki trwałym, autoryzowanym rachunkom rozliczeniowym.
Wyceny Seedance i rachunki rozliczeniowe
Dotyczy modeli seedance-2.0, seedance-2.5, seedance-2.0-fast oraz seedance-2.0-mini we wszystkich kanałach generowania. Adres bazowy: https://apimaster.ai/v1 (https://apimaster.ai/v1). Autoryzuj wszystkie żądania nagłówkiem Authorization: Bearer YOUR_API_KEY.
Uzyskaj szacunkową wycenę
POST https://apimaster.ai/v1/videos/quote przyjmuje te same parametry JSON co standardowe żądanie generowania wideo, w tym model, prompt, duration, resolution, video_urls oraz inne obsługiwane ustawienia generowania. Wyceny dla wersji roboczych, ulepszeń wersji roboczych i remiksów nie są obecnie obsługiwane.
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}'
Odpowiedź zawiera object: "video.quote", quote_id, expires_at (sekundy Unix), binding: false, funds_reserved: false oraz obiekt billing opisany poniżej. Wycena ma pięciominutowy doradczy okres ważności. Nie obciąża środków, nie tworzy zadania ani nie uruchamia generowania u dostawcy. Dlatego billing.reserved_amount ma wartość "0.000000". Identyfikator wyceny ma charakter informacyjny; nie jest tokenem autoryzacji ani gwarancji ceny i nie trzeba go dołączać do generowania.
Cena jest przeliczana przy faktycznym zgłoszeniu i zamrażana dla tego zadania. Szacunek nie jest gwarancją maksymalnej opłaty. Ukończone zadanie może kosztować więcej lub mniej niż wycena. Żądania z automatycznym czasem trwania używają oszacowania 30-sekundowego wyniku; requested_output_seconds ma wartość -1.
Generowanie pozostaje zależne od walidacji dostawcy. W przypadku żądań rozszerzenia wideo Seedance 2.5 należy jawnie ustawić aspect_ratio: "adaptive"; odrzucenie przez dostawcę jest obsługiwane w standardowym cyklu zwrotów.
Pobierz rachunek zadania
curl "https://apimaster.ai/v1/videos/task_xxx/billing" \
-H "Authorization: Bearer YOUR_API_KEY"
GET /v1/videos/{task_id}/billing zwraca object: "video.billing_receipt", billing i customer_billing. Użyj klucza API konta właściciela zadania. Z pierwotnym kluczem wywołanie GET /v1/video-submissions/by-key udostępnia rozliczenie w data.customer_billing. Gdy final: true, net_amount to ostateczne obciążenie netto zapisane jako ciąg dziesiętny w USD. Dla starszego zadania z potwierdzonym zwrotem może ono wynieść zero, nawet jeśli rozliczenie dostawcy pozostaje niezweryfikowane. Zapytanie według identyfikatora zadania zwraca HTTP 404, jeśli zadanie jest na innym koncie albo brakuje zarówno potwierdzenia rozliczenia, jak i dowodu zwrotu. O możliwości ponownego wysłania informują pola dotyczące ponawiania.
Ten sam obiekt billing jest dołączany do odpowiedzi zapytań o zadanie:
GET /v1/videos/{task_id}:billingna najwyższym poziomie.GET /v1/video/generations/{task_id}:data.billing.
settlement_status ma wartość pending, settled lub refunded; odpowiedzi wyceny używają estimate. Zakończenie zadania i rozliczenie finansowe to osobne zdarzenia: traktuj kwoty jako ostateczne dopiero, gdy rachunek ma status settled lub refunded. Powtarzane żądania rachunku nie uruchamiają generowania, rozliczenia ani zwrotów. Sfinalizowane rachunki zachowują ten sam identyfikator i zawartość, także po zwrocie.
Kompletne przykłady żądań i odpowiedzi
Oba przykłady używają Seedance 2.0 w jakości 480P, żądanego 4-sekundowego wyniku, jednego materiału referencyjnego zmierzonego na 4,042 sekundy, mnożnika kanału 1 oraz mnożnika konta 1,05. Czasy trwania i kwoty po zakończeniu pochodzą z testu na żywo; wycena jest przykładem poglądowym przygotowanym dla pasujących danych wejściowych. Identyfikatory i adresy URL multimediów są placeholderami. Rzeczywiste stawki pochodzą z odpowiedzi API.
1. Uzyskaj wycenę
POST https://apimaster.ai/v1/videos/quote, JSON żądania:
{
"model": "seedance-2.0",
"prompt": "A paper boat moves gently on a pond.",
"duration": 4,
"resolution": "480p",
"video_urls": [
"https://example.com/reference.mp4"
]
}
| Pole | Typ | Znaczenie |
|---|---|---|
model |
string | Identyfikator modelu, tutaj seedance-2.0. |
prompt |
string | Prompt generowania. |
duration |
integer | Żądana liczba sekund wyniku, nie czas trwania wideo referencyjnego. |
resolution |
string | Rozdzielczość wyniku, tutaj 480p. |
video_urls |
array |
Adresy URL wideo referencyjnego. Zastąp placeholder dostępnym multimedia; serwer mierzy każdy plik. |
Odpowiedź wyceny:
{
"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
}
}
Wejście o długości 4,042 sekundy jest zaokrąglane w górę do 5 sekund. Przy 4 szacowanych sekundach wyniku szacunek obejmuje 9 sekund i kosztuje 0,408146 USD. Wycena nie obciąża środków; kwoty końcowe pozostają puste.
2. Zgłoś generowanie i sprawdź zakończenie
Po zgłoszeniu do POST https://apimaster.ai/v1/videos/generations odpowiedź początkowa zawiera identyfikator zadania:
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_example"
}
]
}
Następnie zapytaj GET https://apimaster.ai/v1/videos/task_example używając klucza API z tego samego konta. Po zakończeniu generowania i rozliczenia:
{
"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
}
}
Początkowe obciążenie jest tutaj równe kosztowi końcowemu, bez dodatkowego obciążenia ani zwrotu. billing.output.actual_seconds to czas trwania wyniku; actual_time to czas przetwarzania. usage.completion_tokens nie określa opłaty. Pola opcjonalne mogą się różnić w zależności od kanału.
GET https://apimaster.ai/v1/videos/task_example/billing zwraca { "object": "video.billing_receipt", "billing": ... } z tym samym obiektem billing. Zapytanie kompatybilności GET https://apimaster.ai/v1/video/generations/task_example umieszcza go pod data.billing.
Pola odpowiedzi zewnętrznej
| Pole | Typ | Znaczenie |
|---|---|---|
object |
string | Typ odpowiedzi: video.quote, video lub video.billing_receipt. |
quote_id |
string | Informacyjny identyfikator wyceny; nie jest blokadą ceny ani autoryzacją generowania. |
expires_at |
integer | Doradczy czas wygaśnięcia wyceny w sekundach Unix, zwykle utworzenie plus 300 sekund. |
binding |
boolean | Obecnie false; wycena nie gwarantuje kwoty końcowej. |
funds_reserved |
boolean | Obecnie false; wycena nie obciąża ani nie rezerwuje środków. |
billing |
object | Szczegóły rozliczeniowe udokumentowane osobno poniżej. |
code |
integer | Kod odpowiedzi zgłoszenia; 200 oznacza zgłoszenie, nie zakończenie. |
data |
array | Lista zgłoszonych zadań; zapytanie kompatybilności używa zamiast tego obiektu dla danych. |
data[].status |
string | Status zgłoszenia, w tym przykładzie submitted. |
data[].task_id |
string | Publiczny identyfikator zadania używany w kolejnych zapytaniach. |
id |
string | Publiczny identyfikator zadania w zapytaniu o zakończenie. |
task_id |
string | Identyfikator zadania, w tym przykładzie równy id. |
model |
string | Publiczna nazwa modelu generowania. |
status |
string | Status zadania; completed oznacza zakończenie generowania. Sprawdź billing.settlement_status w celu ustalenia finalnego rozliczenia. |
progress |
number | Procent postępu; w tym przykładzie 100 po zakończeniu. |
actual_time |
number | Sekundy przetwarzania zadania, nie czas trwania wideo wynikowego. |
created_at |
integer | Znacznik czasu utworzenia zadania w sekundach Unix. |
completed_at |
integer | Znacznik czasu zakończenia zadania w sekundach Unix. |
metadata |
object | Metadane wyniku generowania. |
metadata.url |
string | Adres URL pobierania wideo. |
usage |
object | Informacje o użyciu od dostawcy; może być nieobecne w zależności od kanału. |
usage.completion_tokens |
integer | Liczba tokenów od dostawcy; nie jest używana do rozliczania za sekundę dla tych czterech modeli. |
Schemat rozliczeń
Wszystkie kwoty pieniężne i stawki jednostkowe są dziesiętnymi ciągami znaków. Czasy trwania są w sekundach. Pola dopuszczające wartość null są JSON null do momentu ich dostępności.
| Pole | Typ | Znaczenie |
|---|---|---|
schema_version |
string | Wersja schematu rozliczeń, w tym przykładzie "1". |
receipt_id |
string | Stały identyfikator rachunku; nieobecny w wycenach. |
task_id |
string | Publiczny identyfikator zadania powiązany z rachunkiem; nieobecny w wycenach. |
settlement_status |
string | estimate, pending, settled, refunded |
model |
string | Zastosowany publiczny identyfikator modelu. |
resolution |
string | Znormalizowana rozdzielczość używana do rozliczeń. |
tariff_variant |
string | Poziom taryfy; -input oznacza materiały wideo referencyjne, a stawka ta dotyczy zarówno wejścia, jak i wyjścia. |
tariff_revision |
string | Odcisk palca modelu, poziomu taryfy, skonfigurowanej stawki bazowej i wersji reguł rozliczeniowych |
currency |
string | Waluta opłaty, obecnie USD. |
unit |
string | Jednostka stawki; second oznacza za sekundę. |
base_unit_rate |
decimal string | Skonfigurowana cena bazowa za sekundę dla tego modelu i poziomu. |
channel_multiplier |
number | Zastosowany zagregowany mnożnik cen kanału. |
account_multiplier |
number | Zastosowany mnożnik konta/grupy, w tym przykładzie 1,05. |
effective_unit_rate |
decimal string | Zastosowana stawka za sekundę, zamrożona przy zgłoszeniu i zaokrąglona do 12 miejsc po przecinku. |
requested_output_seconds |
integer | Żądany czas trwania wyniku; -1 dla automatycznego czasu trwania |
estimated_output_seconds |
integer | Szacowana liczba sekund wyniku; automatyczny czas trwania jest szacowany na 30 sekund. |
estimated_billable_seconds |
integer | Początkowa szacowana łączna liczba rozliczanych sekund, w tym wideo referencyjne i szacowany wynik. |
input_videos |
array | Pomiary serwera dla poszczególnych materiałów referencyjnych, w kolejności żądania |
input_videos[].index |
integer | Pozycja wideo referencyjnego w żądaniu, zaczynając od zera. |
input_videos[].media_id |
string | Hash multimediów w zakresie konta lub identyfikator zasobu; adres URL wideo referencyjnego nie jest zwracany. |
input_videos[].measured_seconds |
number lub null | Zmierzony przez serwer czas trwania przed zaokrągleniem; może być null dla starszych zasobów z pamięci podręcznej |
input_videos[].billable_seconds |
integer | Zaokrąglony rozliczany czas trwania tego materiału referencyjnego |
input_videos[].duration_source |
string | apimaster_probe lub apimaster_asset_cache |
billable_input_video_seconds |
integer | Suma rozliczanych sekund dla poszczególnych materiałów referencyjnych |
output |
object lub null | Informacje o końcowym czasie trwania wyniku, dostępne po pomyślnym rozliczeniu |
output.actual_seconds |
number lub null | Rzeczywisty zgłoszony/zbadany czas trwania wyniku; null, jeśli niedostępny |
output.billable_seconds |
integer | Liczba sekund wyniku faktycznie użyta w rozliczeniu |
output.duration_source |
string | provider_reported, apimaster_probe, provider_billable_seconds, requested_duration_fallback lub reservation_fallback |
billable_seconds |
integer lub null | Finalna łączna liczba rozliczanych sekund wejścia/wyjścia |
rounding |
object | Zasady zaokrąglania wejścia, wyjścia i pieniędzy oraz wzór kwoty |
estimated_amount |
decimal string | Początkowy szacowany koszt; nie jest kwotą końcową ani gwarancją maksymalnej opłaty. |
reserved_amount |
decimal string | Początkowe obciążenie konta przy zgłoszeniu, zero dla wycen; nie jest blokadą autoryzacji bankowej. |
additional_debit_amount |
decimal string | Dodatkowe obciążenie, gdy koszt końcowy przekracza obciążenie początkowe. |
final_debit_amount |
decimal string lub null | Finalny koszt netto zadania po korektach; zero po pełnym zwrocie |
net_amount |
decimal string lub null | Finalny koszt netto zadania po korektach; zero po pełnym zwrocie |
refunded_amount |
decimal string | Kwota zwrócona z obciążenia początkowego; przy pełnym zwrocie równa obciążeniu początkowemu. |
initial_quota_units |
integer | Dokładna liczba jednostek konta obciążona początkowo; zero dla wycen. |
final_quota_units |
integer lub null | Dokładna liczba jednostek konta finalnego kosztu netto; null w stanie oczekiwania, zero po pełnym zwrocie. |
account_unit_usd |
decimal string | "0.000002" na jednostkę konta |
media_charges |
object | image, audio, other_reference są zerowe w obecnej taryfie; input_video_unrounded i output_video_unrounded rozdzielają składniki wideo przed końcowym zaokrągleniem pieniężnym |
final_debit_may_exceed_estimate |
boolean | true; szacunek nie jest twardym limitem wydatków |
created_at |
integer | Znacznik czasu utworzenia szczegółów rozliczeniowych w sekundach Unix. |
settled_at |
integer lub null | Znacznik czasu finalnego rozliczenia lub zwrotu w sekundach Unix; null do czasu sfinalizowania. |
| Pole | Typ | Znaczenie |
|---|---|---|
rounding.input_video |
string | ceil_each_file_then_sum: zaokrąglij każdy plik wejściowy w górę, potem zsumuj. |
rounding.output_video |
string | nearest_integer_half_up: najbliższa sekunda wyniku, połówki sekund zaokrąglane w górę. |
rounding.effective_unit_rate |
string | nearest_decimal_12_places_half_up: zaokrąglij efektywną stawkę do 12 miejsc po przecinku. |
rounding.money |
string | nearest_account_unit_half_up: zaokrąglij łączną kwotę do jednostek konta. |
rounding.amount_formula |
string | Wzór końcowej łącznej kwoty; kwoty wejścia i wyjścia nie są zaokrąglane osobno. |
media_charges.input_video_unrounded |
decimal string | Składnik wideo wejściowego przed zaokrągleniem pieniężnym. |
media_charges.output_video_unrounded |
decimal string | Składnik wideo wyjściowego przed zaokrągleniem pieniężnym. |
media_charges.image |
decimal string | Osobna dopłata za obraz, obecnie zero. |
media_charges.audio |
decimal string | Osobna dopłata za audio, obecnie zero. |
media_charges.other_reference |
decimal string | Osobna dopłata za inne materiały referencyjne, obecnie zero. |
Przeliczanie kosztu końcowego
Przy wideo referencyjnym poziom taryfy wideo-wejście dotyczy zarówno sekund wyniku, jak i sekund wideo referencyjnego. Obrazy i audio nie mają osobnej dopłaty w obecnej taryfie Seedance. Liczby tokenów i koszty dostawcy nie są danymi wejściowymi rozliczeń.
- Zaokrąglij zmierzony czas trwania każdego wideo wejściowego niezależnie w górę, a następnie zsumuj:
input_seconds = sum(ceil(each_video_duration)). - Zaokrąglij czas trwania wyniku do najbliższej pełnej sekundy, z dodatnimi połówkami sekund zaokrąglanymi w górę.
- Dodaj rozliczane sekundy wejścia i wyjścia.
- Pomnóż przez
effective_unit_rate, podziel przezaccount_unit_usd, a następnie zaokrąglij całość jednokrotnie do najbliższej całkowitej jednostki konta, z dodatnimi połówkami jednostek zaokrąglanymi w gó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
Używaj arytmetyki dziesiętnej. Nie zaokrąglaj osobno składników pieniężnych wejścia i wyjścia. Na przykład 4-sekundowe zadanie Seedance 2.0 w jakości 480P, bez wideo referencyjnego, ze stawką bazową 0.07031, mnożnikiem kanału 1 i mnożnikiem konta 1.05, ma efektywną stawkę 0.0738255 i koszt netto 0.295302 USD (147651 jednostek konta).
APIMaster mierzy czas trwania wideo referencyjnego, zamiast ufać polom klienta takim jak input_seconds czy reference_seconds. Żądane duration/seconds kontroluje czas trwania wyniku. Dla wyników rozliczenie preferuje czas trwania zgłoszony przez dostawcę i w razie potrzeby bada wynik; niedostępne pomiary mogą zostać zastąpione rozliczanymi sekundami dostawcy lub żądanym/zarezerwowanym czasem trwania. Rachunek jednoznacznie oznacza źródło. Zastępcze źródło nigdy nie jest oznaczone jako niezależnie zmierzony rzeczywisty czas trwania. Istniejące zasoby z pamięci podręcznej lub odziedziczone starsze wersje robocze mogą nie mieć kompletnych szczegółów pomiarów dla poszczególnych plików.
actual_time w odpowiedzi wideo to czas przetwarzania zadania, nie czas trwania wideo wynikowego. usage.completion_tokens, jeśli występuje, ma charakter informacyjny.
Błędy i zwroty
Błędy zadań dostawcy oraz skonfigurowany 24-godzinny limit czasu dla niezakończonych zadań uruchamiają automatyczny pełny zwrot. Ich rachunki pozostają dostępne i po udanym zwrocie pokazują refunded z zerową kwotą netto. Tymczasowe błędy sieci/pollingu nie powodują natychmiastowego zwrotu ani anulowania zadania; przetwarzanie jest ponawiane.
Potwierdzone nieobciążone niepowodzenie zgłoszenia jest zwracane. Niejednoznaczny wynik zgłoszenia jest wstrzymywany do automatycznej reconciliacji (pierwsza asynchroniczna reconciliacja po około 20 minutach; wyniki wciąż nieznane po 24 godzinach są zwracane podczas reconciliacji). Jeśli zgłoszenie nie utworzyło publicznego zadania, nie ma rachunku powiązanego z zadaniem dla tej próby. Wycena nie jest rezerwacją i nie wymaga zwolnienia.
Nie ma publicznego endpointu anulowania Seedance. Rozłączenie lub zatrzymanie pollingu nie anuluje zadania. Kontrole stanu zadania zapobiegają ponownemu zastosowaniu tego samego rozliczenia/zwrotu przez powtarzane pollingu, a sam endpoint rachunku jest tylko do odczytu. Nie są to jednak absolutna gwarancja exactly-once dla każdego błędu infrastruktury; oczekujące operacje finansowe nie powinny być traktowane jako sfinalizowane.
