APIMaster.ai

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}: billing na 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ń.

  1. 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)).
  2. Zaokrąglij czas trwania wyniku do najbliższej pełnej sekundy, z dodatnimi połówkami sekund zaokrąglanymi w górę.
  3. Dodaj rozliczane sekundy wejścia i wyjścia.
  4. Pomnóż przez effective_unit_rate, podziel przez account_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.

Idempotencja Seedance i odzyskiwanie zgłoszeń