Loading source

Preparing the source view

Pulling the file list, source metadata, and syntax-aware rendering for this listing.

Source from repo

Azure AI Services

Guidance for building and deploying AI solutions on Azure using Azure AI services and Copilot for Azure

microsoftGitHub microsoftOfficialSource repo Original GitHub link Publisher page

Files

17

Skill

n/a

Size

28.2 KB

Entrypoint

SKILL.md

Format

git-repo

Open file

references/sdk/azure-ai-translation-ts.md

Syntax-highlighted preview of this file as included in the skill package.

Rendered Source

markdown30 linesFree

Azure Translation — TypeScript SDK Quick Reference

Condensed from azure-ai-translation-ts. Full patterns (document translation, batch SAS, transliterate) in the azure-ai-translation-ts plugin skill if installed.

Install

npm install @azure-rest/ai-translation-text @azure/identity

Quick Start

import TextTranslationClient, { TranslatorCredential, isUnexpected } from "@azure-rest/ai-translation-text";
const credential: TranslatorCredential = { key: process.env.TRANSLATOR_SUBSCRIPTION_KEY!, region: process.env.TRANSLATOR_REGION! };
const client = TextTranslationClient(process.env.TRANSLATOR_ENDPOINT!, credential);

Non-Obvious Patterns

REST client — TextTranslationClient is a function, not a class
Translate via client.path("/translate").post({ body: { inputs: [...] } })
Document translation: separate package @azure-rest/ai-translation-document
Batch docs require SAS URLs for source/target blob containers

Best Practices

Auto-detect source — omit language parameter to auto-detect
Batch requests — translate multiple texts in one call for efficiency
Use SAS tokens — for document translation, use time-limited SAS URLs
Handle errors — always check isUnexpected(response) before accessing body
Regional endpoints — use regional endpoints for lower latency