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
Section titled “Prijzen”Prijzen worden rechtstreeks in credits weergegeven:
| Product | product | Prijs |
|---|---|---|
| Spraakherkenning | asr | 20 credits/minuut; het fun-asr real-time model 30 credits/minuut (in rekening gebracht per milliseconde) |
| Ondertitelvertaling | subtitle_translation | 60 credits/minuut |
| Basale videobewerking (vertaalde ondertitels, originele audio) | basic_video | 80 credits/minuut |
| Volledige videobewerking (vertaalde ondertitels en nasynchronisatie) | full_video | 300 credits/minuut |
| Spraak合成 | tts | 1.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
pricesvancredit-catalog(het veldmodel). - 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-catalogPOST /api/v1/billing/media/credit-estimatescredit-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.
Maak een taak aan
Section titled “Maak een taak aan”POST /api/v1/media-jobsIdempotency-Key: unique-request-idProducten:
product | Doel |
|---|---|
asr | Spraakherkenning |
tts | Spraak合成 |
subtitle_translation | Ondertitelvertaling voor audio en video |
basic_video | Basis videobewerking |
full_video | Volledige 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:
- 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.
- 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.
- 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).
Query en annuleren
Section titled “Query en annuleren”GET /api/v1/media-jobs/{operation_id}GET /api/v1/media-jobs?limit=25POST /api/v1/media-jobs/{operation_id}/cancelHet queryantwoord bevat de taakstatus, de geleverde bestanden en de afrekeningsreferentie.
Stemmen
Section titled “Stemmen”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 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.