Translate text using Nativ's AI localization engine.

Uses the team's translation memory, style guides, and brand voice automatically. Returns the translation along with TM match info and rationale.

Args: text: The text to translate. target_language: Full target language name (e.g. "French", "German", "Japanese"). target_language_code: Optional ISO language code (e.g. "fr", "de", "ja"). source_language: Source language name. Defaults to English. source_language_code: Source language code. Defaults to "en". context: Optional context to guide the translation (e.g. "marketing headline for Gen Z audience"). glossary: Optional inline glossary as CSV (e.g. "term,translation\nbrand,marque"). formality: Tone override — one of: very_informal, informal, neutral, formal, very_formal. max_characters: Optional strict character limit for the translation output. backtranslate: If true, also returns a back-translation to verify intent.

Translate multiple texts to a single target language.

Useful for localizing lists of strings, UI labels, or i18n files. Each text is translated individually using the team's TM and style guides.

Args: texts: List of texts to translate. target_language: Full target language name (e.g. "French"). target_language_code: Optional ISO language code. source_language: Source language name. Defaults to English. source_language_code: Source language code. Defaults to "en". context: Optional context to guide all translations. formality: Tone override for all translations.

Search the translation memory for existing translations.

Use this to check if translations already exist before creating new ones, or to find reference translations for consistency.

Args: query: Text to search for in the translation memory. source_language_code: Source language code (default: "en"). target_language_code: Optional target language code to filter results. min_score: Minimum fuzzy match score (0-100). Default 0 returns all. limit: Maximum number of results (default 10).

Add a new entry to the translation memory.

Use this to store approved translations so they are reused in future localizations.

Args: source_text: The original text. target_text: The approved translation. source_language_code: Source language code (e.g. "en"). target_language_code: Target language code (e.g. "fr-FR"). name: Optional label for this entry (e.g. "homepage hero copy").

Get all languages configured for the Nativ workspace.

Returns language names, codes, formality settings, and custom style directives for each language.

Get statistics about the translation memory.

Shows total entries, enabled/disabled counts, and breakdown by source type.

Get all style guides configured for the workspace.

Returns the titles, content, and enabled status of each style guide.

Get the brand voice prompt — the core localization personality.

This is the master prompt that shapes all translations. It captures the brand's tone, personality, terminology, and localization guidelines.

Extract text segments from an image, in reading order (OCR).

Use this as the first step when localizing an image: pull out the on-image source strings, translate each with translate (so TM, style guides, and brand voice apply), then re-render with localize_image.

Args: image_path: Path to a local PNG, JPEG, or WebP image file.

Localize an image in place by replacing its on-image text with translations.

Keeps every non-text element (layout, colours, graphics) intact and re-renders the original text with the provided translations. Pair with extract_image_text (to get the source strings) and translate (to translate them with TM and brand voice) for a full image localization flow.

The localized image is saved to disk and the file path is returned — the raw image bytes are not sent back to the model.

Args: image_path: Path to a local PNG, JPEG, or WebP image to localize. replacements: JSON array of {"original": "...", "translated": "..."} pairs, e.g. '[{"original": "Buy now", "translated": "Achetez maintenant"}]'. target_language_code: Target language code (e.g. "fr-FR"), used for labelling output. output_path: Optional path to write the localized image to. Defaults to ".." next to the source image. num_images: Number of variants to generate (1-5, default 1). output_format: Output format — png, jpeg, or webp (default png).

Analyze an image for cultural-sensitivity issues across markets before launch.

Returns a SAFE / NOT SAFE verdict and, where relevant, the specific countries affected with the issue and a concrete fix.

Args: image_path: Path to a local PNG, JPEG, or WebP image. countries: Optional comma-separated list of countries to check against (e.g. "Saudi Arabia, Japan, France"). Defaults to the top markets by GDP.

Transcribe speech from a local audio or video file (unbilled draft).

Use the returned segments with translate (origin via text) then synthesize_audio to produce a dubbed track. Video uploads also return a video_id for muxing.

Args: file_path: Path to audio (mp3, wav, m4a, …) or video (mp4, mov, …). source_language_code: Optional source language hint (e.g. "en"). keep_background_music: If true, split a music bed for later remix.

Parse a script file (.txt, .docx, .pdf, .srt, .itt) instead of STT.

List TTS voices available for dubbing.

Args: language_code: Optional filter (e.g. "fr", "ja-JP").

Generate a short TTS preview and save it to disk.

Args: voice_id: Voice id from list_voices. output_path: Where to write the WAV file. language_code: Optional locale. text: Optional preview line (max 200 chars).

Get the spoken consent script required for voice cloning.

Generate billed localized TTS (and optional dubbed video).

Args: language: Target language name (e.g. "French"). language_code: Target language code (e.g. "fr"). voice_id: Voice id from list_voices. segments: JSON array of {text, start_ms, end_ms, original?} objects. output_path: Path to write the WAV audio. keep_same_length: Stretch/compress speech to source timings. keep_background_music: Mix transcribed music bed when stem_id is set. stem_id: Optional bed stem from transcribe_audio. source_duration_ms: Original duration. source_transcript: Optional original transcript. video_id: Optional id from transcribe/register to mux MP4. video_output_path: Optional path for dubbed MP4 when video_id is set.

Upload a source video for later remuxing. Returns video_id.

Mux a WAV file onto a previously registered video.

Args: video_id: Id from register_video or transcribe_audio. audio_path: Local WAV (or other) file to encode as base64. output_path: Where to write the MP4.

Parse a local SRT/ITT file into timed cues (no storage).

Localize subtitles in-memory. Provide an SRT/ITT and/or a video (STT).

Args: target_language_codes: Comma-separated codes (e.g. "fr,de,ja"). subtitle_path: Optional local subtitle file. video_path: Optional video used when no subtitle file is given. glossary_path: Optional glossary text file. source_language_code: Source language code. context: Optional localization context. formality: Optional formality override. output_dir: If set, write one .srt per language there.