# Embeddings, Rerank & Speech-to-Text (Tanod)

> Speech denoise, transcripts (SRT/VTT), embeddings, reranking, entities and translation. A focused part of Tanod (https://tanod.dev/llms.txt covers every family), over HTTP and MCP.
>
> Pay per call in USDC on Base or Polygon or Solana or BNB Chain or Arbitrum with x402, or on Tempo with MPP; no account or API key. Free tier: a small daily per-IP
> pool per family; over HTTP add the header `X-Tanod-Free: 1` to an unpaid call (without it every unpaid call gets the 402); over MCP
> the free tier is automatic.
> Every result is automated and heuristic, not an audit: findings can be false positives, and a clean result is not proof that code or a package is free of risk.
> Tanod is operated by an autonomous AI agent on behalf of its owner. Scans run automatically; no person reviews individual results.

## API

- [OpenAPI spec](https://ml.tanod.dev/openapi.json): machine-readable description of this family's 19 routes.
- [x402 resources](https://ml.tanod.dev/.well-known/x402)
- MCP: `https://tanod.dev/mcp/ml` (server `tanod-ml`); also at `https://ml.tanod.dev/mcp` on this host

## Routes

- `POST https://ml.tanod.dev/v1/text/language` (detect_text_language): Use when an agent must identify which language a piece of text is written in.
- `POST https://ml.tanod.dev/v1/audio/podcast-transcript` (transcribe_podcast_episode): Use when an agent must transcribe up to 10 minutes of a podcast episode picked from its RSS feed.
- `POST https://ml.tanod.dev/v1/text/keywords` (extract_keywords_from_text): Use when an agent needs the key phrases of a text without calling a language model.
- `POST https://ml.tanod.dev/v1/text/summarize` (summarize_text): Use when an agent needs the most central sentences of a long text, quoted verbatim.
- `POST https://ml.tanod.dev/v1/text/sentiment` (analyze_text_sentiment): Use when an agent must score an English text as positive, negative or neutral.
- `POST https://ml.tanod.dev/v1/embed` (create_text_embeddings): Use when an agent needs vector embeddings of texts for semantic search or clustering.
- `POST https://ml.tanod.dev/v1/embed/multimodal` (create_multimodal_embeddings): Use when an agent needs images and texts embedded in one vector space, for text-to-image search or duplicate photos.
- `POST https://ml.tanod.dev/v1/rerank` (rerank_documents): Use when an agent has candidate documents for a query and must order them by relevance.
- `POST https://ml.tanod.dev/v1/similarity` (semantic_text_similarity): Use when an agent must score how close in meaning pairs of texts are.
- `POST https://ml.tanod.dev/v1/ner` (extract_named_entities): Use when an agent must find people, organizations, places, dates and amounts in English text.
- `POST https://ml.tanod.dev/v1/classify/zero-shot` (zero_shot_text_classification): Use when an agent must sort an English text into labels it supplies, without training a model.
- `POST https://ml.tanod.dev/v1/text/translate` (translate_text): Use when an agent must translate up to 5,000 characters between English and 14 languages such as Spanish, German or Japanese.
- `POST https://ml.tanod.dev/v1/text/injection` (check_text_for_prompt_injection): Use when an agent will act on a web page, email or tool result it did not write and needs a prompt-injection check first.
- `POST https://ml.tanod.dev/v1/audio/speak` (text_to_speech): Use when an agent must turn text into spoken audio in English, Spanish, French, Hindi, Italian or Portuguese.
- `POST https://ml.tanod.dev/v1/text/llm-extract` (extract_json_from_text_with_schema): Use when an agent must turn text, such as an invoice or job post, into JSON that matches its own schema.
- `POST https://ml.tanod.dev/v1/audio/transcribe` (transcribe_audio): Use when an agent must turn a spoken-audio file of up to 10 minutes into text, captions or a speaker-labelled transcript.
- `POST https://ml.tanod.dev/v1/audio/denoise` (denoise_audio): Use when an agent must reduce steady background noise in a short speech recording.
- `POST https://ml.tanod.dev/v1/audio/translate-speech` (translate_speech_audio_to_text_voice): Use when an agent must turn speech in another language into translated text or spoken audio, from a 2-minute clip.
- `POST https://ml.tanod.dev/v1/docs/translate` (translate_pdf_document_scanned_to_english): Use when an agent must read a PDF or scanned document in another language, translated to English as Markdown.