Bronnen en instellingen

Stuur een videolink van YouTube, X, TikTok, Instagram, Facebook of Bluesky, of upload je eigen bestand. Hieronder vind je ook de andere platforms en de links die je daarvoor kunt gebruiken. Met source, diarize en language bepaal je hoe de transcriptie werkt. Je kunt deze velden weglaten of meesturen in de body van POST /v1/transcriptions.

Welke videolinks werken?

Zet de link in url. De API herkent het platform zelf. Stuur je toch platform mee, dan moet die waarde overeenkomen met de link.

Voor de vijf extra platforms moet de link HTTPS gebruiken, zonder inloggegevens of afwijkend poortnummer. Gebruik een link naar één openbare opname. Privéposts, posts waarvoor je moet inloggen, livestreams en streams die nog worden verwerkt werken niet. Dat geldt ook voor profielen, feeds en verzamelingen. We sturen geen accountcookies mee. Een tijdparameter in de URL kort de opname niet in. Bij Twitch-clips en Snapchat Spotlight kan media_id een string zijn die je niet uit de URL kunt afleiden. Bewaar die waarde ongewijzigd.

Op X, TikTok, Instagram, Facebook en Bluesky moet de post openbaar zijn. Staan er meerdere video’s in, dan transcribeert transcript1 alleen de eerste. Gebruik geen profiel, story, livepagina of TikTok-fotopost. Moet je inloggen om de post te bekijken, dan krijg je login_required. Heeft de video geen audiospoor, dan krijg je no_audio. In beide gevallen betaal je niets.

Bij YouTube, X, TikTok, Bluesky, Dailymotion en LinkedIn kun je ondertitels gebruiken als er een bruikbaar spoor in de oorspronkelijke taal is. Dat verschilt per video. Voor Instagram, Facebook, Twitch, Pinterest en Snapchat kies je auto of stt: die platforms gebruiken AI-speech-to-text en accepteren geen captions.

Je betaalt voor elk platform en elke upload hetzelfde tarief per minuut, op basis van de gemeten duur. Alleen de hierboven genoemde korte links werken. Wil je een eerdere transcriptie hergebruiken, stuur dan de volledige postlink. Een deellink zonder post-id kunnen we bij het indienen niet aan een eerdere transcriptie koppelen.

Welke YouTube-URL kun je gebruiken?

Zet de volledige videolink in url. Laat platform weg of geef youtube mee. Deze URL-vormen werken met en zonder www.:

De API negeert extra queryparameters zoals t, list en si. Alle URL-vormen van een video verwijzen dus naar dezelfde video. Alleen de video-id van 11 tekens meesturen is niet genoeg: je hebt een volledige URL nodig. Bij een kanaalpagina, een link naar alleen een afspeellijst of een andere ongeldige link krijg je 422 invalid_url. Geef je een onbekende waarde voor platform mee, dan krijg je 422 unsupported_platform, met de toegestane waarden in supported_platforms.

Je kunt openbare en verborgen YouTube-video’s transcriberen. Een privévideo geeft media_private, een video met leeftijdsbeperking age_restricted en een livestream live_stream. Heb je zelf het bestand, dan kun je het uploaden.

source

Met source kies je of transcript1 ondertitels ophaalt of de audio transcribeert.

Voor bestanden gebruiken we altijd speech-to-text. Bij een upload kun je source dus op auto of stt zetten. Met captions krijg je 422 invalid_request.

Een ondertitelspoor is alleen bruikbaar als de taal past bij je request. Bij language op auto gebruiken we de oorspronkelijke taal van de video. Voor YouTube gebruiken we ondertitels die de maker heeft geüpload of die YouTube in die taal heeft gegenereerd. Automatisch vertaalde ondertitels gebruiken we nooit. Eerst komen door de maker geüploade ondertitels, daarna sporen met onbekende herkomst en tot slot automatisch gegenereerde ondertitels. Een onbekende herkomst betekent niet dat de maker ze heeft aangeleverd.

Voor X halen we de beschikbare VTT-sporen op. Die hebben alleen tijdstempels per segment, ook als de ondertitels automatisch zijn gegenereerd. Bij auto schakelen we over op STT als de ondertitelinhoud ontbreekt of niet te parsen is. Dat gebeurt niet bij fouten in de routering, opslag of programmacode. Met stt slaan we ondertitels altijd over.

diarize

Zet diarize aan voor sprekerherkenning. Standaard staat het op false.

• Sprekerherkenning werkt via speech-to-text. Bij source op auto ga je met diarize: true daarom meteen naar audio, zonder eerst ondertitels te proberen.
• Combineer je source: "captions" met diarize: true, dan krijg je 422 invalid_request.
• Je krijgt labels zoals Speaker 1 en Speaker 2. Die staan in transcript.speakers en in speaker bij elk segment. In text en srt staat Speaker 1: vóór de tekst; vtt gebruikt de voice-tag <v Speaker 1>.

{ "platform": "youtube", "url": "https://youtu.be/dQw4w9WgXcQ", "source": "stt", "diarize": true }

language

Laat language op auto staan of geef een ISO 639-1-code van twee letters mee, zoals en, de of es. auto is de standaardwaarde.

• Voor ondertitels bepaalt dit welk taalspoor je krijgt. Met auto kiest transcript1 de oorspronkelijke taal van de video.
• Voor speech-to-text geven we de code als taalhint mee aan de provider. Met auto werkt taalherkenning automatisch. Elk segment krijgt een eigen language.

In het transcriptieobject staat de meest gesproken taal in language.

Wat staat er in het transcript?

Aan transcript_source zie je waar de tekst vandaan komt: youtube_captions, x_captions, tiktok_captions, bluesky_captions, dailymotion_captions, linkedin_captions of speech_to_text. Bij ondertitels geeft caption_kind meer informatie: manual, auto_generated of null bij onbekende herkomst. Presenteer null niet als door de maker geüploade ondertitels.

De tekst van YouTube-ondertitels nemen we ongewijzigd over, inclusief tags zoals [Music]. Voor speech-to-text mag een opname maximaal 5 uur duren. Bij een langere opname krijg je media_too_long.

Bij X (x_captions), TikTok, Bluesky, Dailymotion en LinkedIn hebben ondertitels alleen tijdstempels per segment. Ook met include=words blijft elk segment words: null houden, ongeacht of het spoor automatisch is gegenereerd. Sprekerherkenning ontbreekt ook. Wil je tijdstempels per woord, kies dan source: "stt". Voor sprekerherkenning gebruik je diarize: true met auto of stt.

Wat kost het?

Voor ondertitels en speech-to-text betaal je evenveel: één credit per minuut van de opname, naar boven afgerond. Met source kies je dus hoe de tekst wordt gemaakt, niet het tarief. Lees meer over minuten, abonnementen en limieten.