Ga naar inhoud

Audio, video en stemmen

Een mediataak wordt uitgevoerd zodra deze is aangemaakt en wordt in rekening gebracht tegen creditprijzen op basis van het gebruik dat de server meet. Lees eerst de catalogus; alleen producten die als open zijn gemarkeerd, kunnen worden uitgevoerd.

Prijzen worden rechtstreeks in credits weergegeven:

ProductproductPrijs
Spraakherkenningasr20 credits/minuut; het fun-asr real-time model 30 credits/minuut (in rekening gebracht per milliseconde)
Ondertitelvertalingsubtitle_translation60 credits/minuut
Basale videobewerking (vertaalde ondertitels, originele audio)basic_video80 credits/minuut
Volledige videobewerking (vertaalde ondertitels en nasynchronisatie)full_video300 credits/minuut
Spraak合成tts1.500 credits per 10.000 gefactureerde tekens
Eerste succesvolle toepassing van een stem—300 credits per stem, eenmalig in rekening gebracht
  • De prijs van spraakherkenning wordt bepaald door het gebruikte herkenningsmodel; de prijzen van beide modellen worden afzonderlijk vermeld in prices van credit-catalog (het veld model).
  • De duur wordt gemeten in milliseconden: spraakherkenning en ondertiteling worden berekend op basis van de oorspronkelijke duur, video op basis van de duur van de geleverde video.
  • Gebriefeerde tekens voor spraaksynthese: elk Chinees karakter telt als 2, elk ander teken (inclusief spaties en leestekens) als 1.
  • Herkennen, vertalen, nasynchroniseren en andere stappen die een product vereist, zijn bij de prijs inbegrepen. Als het verzoek een resultaat van een lagere kwaliteit (allowed_fallback_products) toelaat en er wordt zo’n resultaat geleverd, is de prijs van het geleverde product van toepassing.
  • Kosten = eenheidsprijs × verbruik, afgerond op 0,001 credit (1 millicredit).
GET /api/v1/billing/media/credit-catalog
POST /api/v1/billing/media/credit-estimates

credit-catalog retourneert de prijzen van elk product (prices, in millicredits) en geeft aan of het openstaat; credit-estimates berekent de benodigde credits (rounded_millicredits) voor een opgegeven duur, tekst of aantal stemmen. Dit is uitsluitend bedoeld voor weergave: er wordt geen taak aangemaakt en er worden geen kosten in rekening gebracht.

POST /api/v1/media-jobs
Idempotency-Key: unique-request-id

Producten:

productDoel
asrSpraakherkenning
ttsSpraak合成
subtitle_translationOndertitelvertaling voor audio en video
basic_videoBasis videobewerking
full_videoVolledige videobewerking

Voorbeeld van spraakherkenning:

{
"product": "asr",
"document_id": "4q8mx2q9z1k7p6ra",
"source_language": "auto",
"max_duration_ms": 600000
}

Elk product, behalve spraaksynthese (tts), vereist max_duration_ms (milliseconden, maximaal 21600000, wat 6 uur is).

Nadat het aanmaakverzoek 202 heeft geretourneerd, controleert de server het bestand en start de verwerking:

  1. Alleen het saldo wordt gecontroleerd voordat het begint : het saldo (na schuld) moet hoger zijn dan de kosten die zijn berekend op basis van de door de server gemeten duur (voor spraaksynthese, op basis van de gefactureerde tekens, inclusief eventuele eerstekansspraakvergoeding die nog niet in rekening is gebracht); bij een API-sleutel met een budget moet het resterende budget van de sleutel ook hoger zijn dan die kosten. Het starten verandert het saldo niet.
  2. Het werkelijke gebruik wordt in rekening gebracht zodra het is voltooid : geprijsd en gefactureerd op basis van het geleverde product en het gebruik. Wat de balans niet dekt, wordt als schuld geregistreerd en de balans wordt negatief weergegeven; later binnengekomen tegoeden worden eerst gebruikt om de schuld af te lossen. Nieuwe taken kunnen niet starten zolang de balans negatief is.
  3. Mislukte of geannuleerde taken worden niet in rekening gebracht.

Wanneer het saldo te laag is of de duur niet past, start er niets en wordt er niets in rekening gebracht: spraaksynthese wordt bij aanmaak gecontroleerd en geeft 402 terug wanneer het saldo te laag is; andere producten worden gecontroleerd nadat de server de duur heeft gemeten, en de taak eindigt als mislukt met error_code insufficient_credits (saldo te laag) of media_duration_exceeds_confirmed_cap (de werkelijke duur overschrijdt max_duration_ms).

GET /api/v1/media-jobs/{operation_id}
GET /api/v1/media-jobs?limit=25
POST /api/v1/media-jobs/{operation_id}/cancel

Het queryantwoord bevat de taakstatus, de geleverde bestanden en de afrekeningsreferentie.

GET /api/v1/media-voices
POST /api/v1/media-voices
GET /api/v1/media-voices/{asset_id}
POST /api/v1/media-voices/{asset_id}/confirm
POST /api/v1/media-voices/{asset_id}/reconcile
POST /api/v1/media-voices/{asset_id}/revoke

reconcile herstelt een onzeker extern resultaat; het controleert alleen de oorspronkelijke bewerking en maakt nooit een tweede stem aan.

Het aanmaken van een voice vereist het bevestigen van uw rechten op de opname:

{
"document_id": "authorized_recording_document_id",
"consent": true,
"consent_version": "voice-source-rights-v1"
}

De beller is verantwoordelijk om ervoor te zorgen dat de opname van hemzelf is of met geldige toestemming wordt gebruikt.