Zvuk, video a hlasy
Úloha média se spustí ihned po vytvoření a bude účtována dle cen za kreditní hodnoty podle měřeného využití serveru. Nejprve si přečtěte katalog; spouštět lze pouze produkty označené jako otevřené.
Ceny jsou uvedeny přímo v kreditech:
| Produkt | product | Cena |
|---|---|---|
| Rozpoznávání řeči | asr | 20 kreditů/minuta; model v reálném čase fun-asr 30 kreditů/minuta (účtováno po milisekundách) |
| Překlad podtitulů | subtitle_translation | 60 kreditů/minuta |
| Základní zpracování videa (přeložené titulky, původní zvuk) | basic_video | 80 kreditů/minuta |
| Kompletní zpracování videa (přeložené titulky a dabing) | full_video | 300 kreditů/minuta |
| Synthetizace řeči | tts | 1 500 kreditů za 10 000 fakturovaných znaků |
| První úspěšné použití hlasu | — | 300 kreditů za hlas, účtováno jednorázově |
- Cena rozpoznávání řeči se odvíjí od použitého rozpoznávacího modelu; ceny obou modelů jsou uvedeny odděleně v
pricesspolečně scredit-catalog(polemodel). - Doba trvání se počítá v milisekundách: rozpoznávání řeči a překlad titulků podle doby trvání zdroje, video podle doby trvání doručeného videa.
- Zaúčtované znaky pro syntézu řeči: každý čínský znak se počítá jako 2, každý ostatní znak (včetně mezer a interpunkce) jako 1.
- Rozpoznání, překlad, dabing a další kroky potřebné pro produkt jsou zahrnuty v jeho ceně. Pokud požadavek umožňuje nižší úroveň výsledku (
allowed_fallback_products) a takový výsledek je dodán, platí cena za dodaný produkt. - Náklady = jednotková cena × spotřeba, zaokrouhleno na 0,001 kreditu (1 milikredit).
GET /api/v1/billing/media/credit-catalogPOST /api/v1/billing/media/credit-estimatescredit-catalog vrátí ceny každého produktu (prices, v milicredech) a informaci o tom, zda je produkt dostupný; credit-estimates vypočítá potřebné kredity (rounded_millicredits) pro danou dobu, text nebo počet hlasů. Slouží pouze k zobrazení: nevytváří žádný úkol ani nic neúčtuje.
Vytvořte úlohu
Section titled “Vytvořte úlohu”POST /api/v1/media-jobsIdempotency-Key: unique-request-idProdukty:
product | Účel |
|---|---|
asr | Rozpoznávání řeči |
tts | Synthetizace řeči |
subtitle_translation | Překlad titulků pro audio a video |
basic_video | Základní zpracování videa |
full_video | Plné zpracování videa |
Příklad rozpoznávání řeči:
{ "product": "asr", "document_id": "4q8mx2q9z1k7p6ra", "source_language": "auto", "max_duration_ms": 600000}Každý produkt kromě syntézy řeči (tts) vyžaduje max_duration_ms (milisekundy, maximálně 21600000, což je 6 hodin).
Poté, co požadavek na vytvoření vrátí 202, server zkontroluje soubor a zahájí zpracování:
- Před spuštěním se kontroluje pouze zůstatek : zůstatek (po dluhu) musí být vyšší než náklady vypočítané na základě doby, kterou server naměřil (pro syntézu řeči pak na základě fakturovaných znaků, včetně případné poplatky za první použití hlasu, který ještě nebyl účtován); pokud je k dispozici API klíč s rozpočtem, zbývající rozpočet tohoto klíče také musí být vyšší než tyto náklady. Spuštění nemění stav zůstatku.
- Skutečné využití je zpoplatněno po jeho dokončení : cenově stanovené a zpoplatněné podle dodaného produktu a spotřeby. Cokoliv, co zůstatek nepokryje, je evidováno jako dluh a zůstatek se zobrazuje jako záporný; kreditní platby přicházející později nejprve splatí tento dluh. Nové úlohy nelze spustit, pokud je zůstatek záporný.
- Za neúspěšně provedené nebo zrušené úlohy se neplatí.
Pokud je zůstatek příliš nízký nebo délka trvání neodpovídá, nic se nespustí a nic se neúčtuje: syntéza řeči je ověřena při vytvoření a vrátí 402, pokud je zůstatek příliš nízký; ostatní produkty jsou ověřeny poté, co server změřil délku trvání, a úloha končí jako neúspěšná s error_code insufficient_credits (zůstatek příliš nízký) nebo media_duration_exceeds_confirmed_cap (skutečná délka trvání překračuje max_duration_ms).
Dotazovat a zrušit
Section titled “Dotazovat a zrušit”GET /api/v1/media-jobs/{operation_id}GET /api/v1/media-jobs?limit=25POST /api/v1/media-jobs/{operation_id}/cancelOdpověď dotazu obsahuje stav úlohy, doručené soubory a referenci k vyúčtování.
GET /api/v1/media-voicesPOST /api/v1/media-voicesGET /api/v1/media-voices/{asset_id}POST /api/v1/media-voices/{asset_id}/confirmPOST /api/v1/media-voices/{asset_id}/reconcilePOST /api/v1/media-voices/{asset_id}/revokereconcile obnovuje nejistý vzdálený výsledek; pouze kontroluje původní operaci a nikdy nevytváří druhý hlas.
Vytvoření hlasu vyžaduje potvrzení vašich práv k nahrávce:
{ "document_id": "authorized_recording_document_id", "consent": true, "consent_version": "voice-source-rights-v1"}Volající je zodpovědný za to, aby se ujistil, že nahrávka je jeho vlastní nebo používána s platným povolením.