{"uid":"cap_It3qVPRXgLjk0RWjmiVda","slug":"halowerk-vocabulary-extractor-from-audio-recording-453736dc","name":"HALOWERK Vocabulary Extractor from Audio Recording","description":"Takes a recording of up to 60 minutes in the language being learned and a learner level, and returns words and phrases worth learning — chosen for the level, skipping the most basic ones — each with the base form, translation into the learner's language, word type, an estimated CEFR level, and the exact example sentence from the recording with its timestamp so it can be listened to in context.","url":"https://medien.halowerk.com/v1/vocabulary?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"level":{"enum":["A1","A2","B1","B2","C1","C2"],"type":"string","default":"B1"},"source":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"description":"Public http(s) URL of the file."},"filename":{"type":"string","maxLength":260},"content_base64":{"type":"string","maxLength":12000000,"description":"The file inline, base64. Larger files by url."}},"description":"The recording. Either url or content_base64.","additionalProperties":false},"language":{"type":"string","maxLength":12,"description":"Spoken language (BCP-47). Omit to detect."},"max_items":{"type":"integer","default":25,"maximum":80,"minimum":5},"output_language":{"enum":["de","en","es","fr","it","nl","pt","pl","tr","sv","da","cs","ru","uk","ja","zh","ko","ar"],"type":"string","description":"Language of labels and explanations. Default: spoken language."},"duration_minutes":{"type":"integer","maximum":60,"minimum":1,"description":"Length in started minutes — this is what you are billed for."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pSPg76rS5ODsWQGC9HLgW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes an audio recording (up to 60 min) and returns level-appropriate vocabulary items with base form, translation, word type, CEFR level, and timestamped example sentences from the recording.","exampleAgentPrompt":"I have a 22-minute German podcast episode at https://example.com/episode42.mp3 — can you pull out up to 30 words and phrases worth learning for a B2 learner, with English translations and the exact timestamps where each one appears?","exampleUseCases":[{"title":"Podcast vocabulary study list","prompt":"I'm learning Spanish at B1 level and found a great 45-minute podcast — here's the URL: https://example.com/spanish-podcast.mp3. Can you extract up to 25 vocabulary items worth studying, skip the super basic ones, and give me the timestamp for each word so I can listen back to it in context? I want the explanations in English."},{"title":"Language tutor lesson prep","prompt":"I recorded a 30-minute French lesson with my tutor. Here's the audio file as base64. I need a list of up to 40 new words and phrases relevant for an A2 learner — with their base forms, word types, translations into English, and where in the recording each one appears so my student can replay the moment."},{"title":"Self-study vocabulary from video lecture","prompt":"I downloaded this Italian lecture — it's about 55 minutes, here's the URL: https://example.com/italian-lecture.mp4. Pull out vocabulary appropriate for a C1 learner with translations in German and the exact sentence from the recording where each word appears, along with its timestamp. Give me up to 50 items."}],"resultDescription":"Returns a list of vocabulary entries, each containing: the base/lemma form of the word or phrase, its translation in the specified output language, the grammatical word type, an estimated CEFR difficulty level, the exact verbatim example sentence from the recording, and the timestamp of that sentence so the learner can navigate directly to it in the audio.","failureModes":["Recording URL is not publicly accessible or returns a non-audio file — returns an error","Audio duration exceeds 60 minutes — rejected by schema validation","Base64 payload too large (>12MB limit) — should use URL instead","Language auto-detection fails on very short or noisy audio","Requested CEFR level filters out all vocabulary (e.g. C2 on a very simple recording) — may return fewer than min_items","Unsupported spoken language for the given BCP-47 tag","Payment insufficient or x402 transaction not confirmed — request blocked"],"whenToPreferThis":"Choose this endpoint when you need to extract level-appropriate vocabulary from an actual audio recording with timestamped context, rather than generating a generic word list from a topic. It is uniquely suited for language learners who want to study vocabulary that appears in a specific piece of authentic audio content they intend to listen to, because the timestamps allow them to replay each word in its natural spoken context. Prefer it over generic vocabulary-generation APIs when the source material is a real recording and learner CEFR level filtering matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:41:48.048Z","isFirstParty":false,"canonicalSlug":"halowerk-vocabulary-extractor-from-audio-recording-453736dc"}