Vad är Azure textöversättning i Microsoft Foundry?

Azure textöversättning är ett molnbaserat REST API för flerspråkig översättning på fler än 100 språk och dialekter som stöds. Du kan integrera den i arbetsflöden för program, tjänster och automatisering för att översätta text i realtid i produktionsskala med hjälp av REST-API:er eller SDK:er.

Den senaste allmänt tillgängliga versionen är 2026-06-06. Den här versionen introducerar ett reviderat schema för begäran och svar, lägger till stöd för modellval mellan NMT (Standard Neural Machine Translation) och stöd för stora språkmodeller (LLM) och utökar översättningskontroller för scenarier som kräver anpassningsbara utdata, ton och könsspecifika variationer.

Translator är utformat för flerspråkiga arbetsbelastningar med stora volymer där konsekvens, skalbarhet och driftskontroll är viktiga. Om du för närvarande använder v3.0, planera migrering och validering före utrullning eftersom 2026-06-06 innehåller icke bakåtkompatibla ändringar.

Nyheter i 2026-06-06 (GA)

API-versionen 2026-06-06 är allmänt tillgänglig och innehåller icke-bakåtkompatibla ändringar jämfört med v3.0.

Den här versionen lägger till nya översättningskontroller och modellalternativ vid uppdatering av begärande- och svarskontrakt. Om du migrerar från v3.0 bör du planera en fullständig valideringsgenomgång av payload-struktur, tolkning av svar och kontroller av produktionskvalitet innan lansering.

Important

  • Azure Translator REST API 2026-06-06 medför icke bakåtkompatibla ändringar.
  • Testa dina program noggrant innan du migrerar produktionsarbetsbelastningar från v3.0.
  • Verifiera kodsökvägar och interna arbetsflöden och begränsa produktionsanvändningen till versioner som du har testat fullständigt.

Viktiga uppdateringar i 2026-06-06 inkluderar:

  • Reviderat JSON-schema för begäran och svar. Begärandematrisen använder inputs, och svarsmatrisen använder value. Ett exempel från slutpunkt till slutpunkt finns i REST API-guide.
  • Modellval (NMT eller LLM). Du kan välja NMT-standard eller en LLM-distribution (till exempel GPT-5.1) baserat på krav på kvalitet, kostnad och scenario. Om du använder LLM-baserad översättning krävs en Microsoft Foundry-resurs. Information om hur du konfigurerar finns i Skapa Translator-resurser.
  • Adaptiv anpassad översättning. Du kan ange upp till fem referensöversättningar eller ett index-ID för anpassningsbar datamängd för att påverka LLM-utdataformat och terminologi. Mer information finns i Adaptiv anpassad översättning.
  • Ton- och könskontroller. LLM-baserad översättning stöder tonvarianter (formella, informella, neutrala) och könsspecifika utdatakontroller.

Kärnåtgärder

2026-06-06 API:et innehåller följande primära åtgärder:

Dessa åtgärder täcker de vanligaste körningsbehoven för pipelines för textlokalisering: identifiera språk som stöds, översätta text i stor skala och transkribera skript för språkpar som kräver skriptkonvertering.

  • Språk: Returnerar språk som stöds för översättningsåtgärder. Den här begäran kräver inte autentisering.

    https://api.cognitive.microsofttranslator.com/languages?api-version=2026-06-06

  • Översätt: Översätter källtext till ett eller flera målspråk i en enda POST begäran.

  • Translitterera: Konverterar skript- eller teckenuppsättningar från ett skrivsystem till ett annat.

En fullständig genomgång av begäran finns i REST API-guiden.

Utvecklingsalternativ

Använd följande alternativ för att skapa och distribuera flerspråkiga textöversättningslösningar i dina program och arbetsflöden:

Välj din integreringssökväg baserat på hur mycket kontroll och automatisering du behöver. De flesta produktionssystem använder direkt REST API- eller SDK-integrering, medan portalarbetsflöden kan vara användbara för konfiguration, testning och driftsfelsökning.

Utvecklingsalternativ Beskrivning
Microsoft Foundry-portalen Använd Microsoft Foundry för att hantera projekt, modeller och relaterade AI-resurser.
REST API Integrera direkt med REST API:er för textöversättning.
Klientbibliotek (SDK:er) Skapa med SDK:er som stöds med hjälp av snabbstarter för klientbibliotek.
Docker-container Använd Translator-containern för frånkopplade eller kontrollerade scenarier som stöds. Börja med Container: översätta text.

Autentisering

Alla textöversättningsbegäranden kräver autentiseringshuvuden. För produktionsdistributioner väljer du en metod som matchar din säkerhets- och driftsmodell. Resursnycklar är enkla att börja med, medan Microsoft Entra ID vanligtvis föredras för företagsmiljöer som kräver centraliserad identitet och nyckellös åtkomst.

Metod Beskrivning
Resursnyckel Ange Ocp-Apim-Subscription-Key från resursen Translator.
Bearer-token Hämta en tidsbegränsad token och skicka den i Authorization rubriken.
Microsoft Entra-ID Använd hanterade identiteter eller tjänstens huvudnamn för nyckellös autentisering.

Nödvändiga rubriker och slutpunktsspecifika exempel finns i Autentisering och auktorisering.

Slutpunkter och datalokalisering

Textöversättning stöder globala slutpunkter, geografiska platser och resursspecifika slutpunkter. Val av slutpunkt avgör var Translator bearbetar NMT-begäranden. Information om slutpunkts-URL:er, bearbetningsplatser och skillnader i foundry LLM-distribution finns i Regionstöd för Azure Translator.

LLM-bearbetning, gränser och priser

För blandade NMT- och LLM-driftsättningar bör du se modellstyrning, begränsningar och kostnader som en del av utformningen av körtidsmiljön. Genomströmning och dimensionering av nyttolast skiljer sig mellan NMT- och LLM-flöden, så fastställ ett basvärde för både svarstid och kostnad innan ni skalar upp trafiken.

Servicens begränsningar

Operation Maximalt antal matriselement Maximal storlek på matriselement LLM maximalt antal matriselement Största storlek för LLM-arrayelement
Översätta 1,000 50,000 50 5,000

Mer information om bredare kvoter och gränser finns i Tjänstgränser – Translator.

Pricing

  • NMT-översättning debiteras per tecken i källtexten. Se priser för Azure Translator.
  • LLM-översättning debiteras utifrån antalet bearbetade indata- och utdatatoken. Se priser för Azure OpenAI.

Om du har stöd för flera trafiknivåer definierar du routningsregler som reserverar LLM för scenarier som kräver anpassningsbart beteende, tonkontroll eller mer omfattande kontextbaserad hantering och behåller högvolymsbaslinjetrafik på NMT där det är lämpligt.

Felsökning

Om en begäran misslyckas börjar du med HTTP-statusen och tjänstens felkod.

I produktionssystem är det snabbaste sättet att isolera problem att logga begärande-ID:n, slutpunkten, regionen, API-versionen och nyckelhuvudena med varje misslyckat anrop. Den här kontexten hjälper till att skilja autentiserings-, kvot-, nyttolast- och funktionstillgänglighetsfel åt.

Symptom Sannolik orsak Upplösning
401 Unauthorized Saknar eller ogiltig prenumerationsnyckel. Kontrollera Ocp-Apim-Subscription-Key och resurskoppling.
403 Forbidden Giltiga autentiseringsuppgifter, men åtgärden eller konfigurationen stöds inte. Bekräfta region, resurstyp och funktionstillgänglighet.
429 Too Many Requests Gränsen eller kvoten har överskridits. Minska begärandefrekvensen och granska tjänstbegränsningarna.
400 Bad Request Ogiltig nyttolast eller språkvärde som inte stöds. Verifiera JSON-begäran och språk som stöds.

Detaljerade koder finns i Svarskoder och meddelanden.

Get started

Använd den här sekvensen för att gå från etablering till ditt första verifierade översättningsarbetsflöde. Håll testnyttolaster små först och skala sedan begärandens storlek och samtidighet när du har verifierat autentisering, slutpunktsroutning och svarshantering.

  1. Skapa en Translator-resurs.
  2. Hämta åtkomstnycklar och slutpunkts-URL.
  3. Kör snabbstarten för textöversättning på önskat språk:

Relaterat innehåll

  • Uppdaterades senast