Komma igång

Använd PolyLingo HTTP API för att översätta ren text, Markdown, JSON eller HTML samtidigt som strukturen bevaras. Denna guide täcker produktionsendpoint, autentisering och din första lyckade förfrågan.

Bas-URL

Alla exempel använder produktions-API:

URL
Produktionhttps://api.usepolylingo.com/v1

Varje sökväg nedan är relativ till denna bas (till exempel betyder POST /translate POST https://api.usepolylingo.com/v1/translate).

Om du kör din egna PolyLingo API-instans, byt ut värden till din deploy-URL och behåll /v1 prefixet om du inte konfigurerat annorlunda.

Autentisering

Skyddade endpoints förväntar sig din API-nyckel i Authorization-huvudet:

Authorization: Bearer <your_api_key>

Få en nyckel: Skapa en i PolyLingo-appen under API keys. Du ser hela nyckeln bara en gång—spara den på ett säkert ställe (miljövariabel eller hemlighetshanterare). Nycklar kan återkallas från samma skärm.

Säkerhet: Behandla nyckeln som ett lösenord. Föredra att anropa API från din server, inte från offentlig webbläsarkod, så att nyckeln aldrig exponeras för användare.

Om huvudet saknas, är felaktigt, eller nyckeln är ogiltig eller återkallad, svarar API med 401 och error: "invalid_api_key".

Endpoints och nycklar

Ingen nyckel krävsGET /health — snabb uptime-kontroll
GET /languages — stödda språkkoder
Nyckel krävsPOST /translate — översätt innehåll
POST /translate/batch — översätt flera objekt
POST /jobs — köa en långvarig översättning (returnerar 202 omedelbart)
GET /jobs/:id — poll-jobbstatus; inkluderar queue_position medan du väntar
GET /usage — användning för det autentiserade kontot

Första förfrågan (cURL)

export POLYLINGO_API_KEY="pl_your_key_here"

curl -sS -X POST "https://api.usepolylingo.com/v1/translate" \
  -H "Authorization: Bearer $POLYLINGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "# Hello\n\nThis is **bold**.",
    "format": "markdown",
    "targets": ["es", "fr"],
    "model": "standard"
  }'

Ett lyckat svar inkluderar ett translations-objekt (en post per målspråk du begärt) och ett usage-objekt med tokenräkningar.

Första förfrågan (Node.js)

Node.js 18+ inkluderar fetch:

const API_KEY = process.env.POLYLINGO_API_KEY
const res = await fetch('https://api.usepolylingo.com/v1/translate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Authorization: `Bearer ${API_KEY}`,
  },
  body: JSON.stringify({
    content: '# Hello\n\n**Bold** text.',
    format: 'markdown',
    targets: ['de', 'ja'],
    model: 'standard',
  }),
})
const data = await res.json()
if (!res.ok) throw new Error(`${data.error}: ${data.message}`)
console.log(data.translations)

Kontrollera att API är nåbart

Ingen nyckel behövs för health:

curl -sS "https://api.usepolylingo.com/v1/health"

Du bör se en liten JSON-payload som indikerar att tjänsten är uppe. Använd GET /languages för listan över koder du kan skicka som targets.

CORS och webbläsarappar

API kan begränsa vilka webbläsarorigin som kan anropa det direkt, så att nycklar inte används från opålitliga webbplatser. Server-sidiga anrop (Node, Python, edge-funktioner, din backend) är inte begränsade av CORS.

För en single-page app är det vanliga mönstret: din frontend pratar med din backend, och din backend anropar PolyLingo med API-nyckeln.

Nästa steg

  • API-referens — förfrågnings- och svarsscheman, format, fel och begränsningar.
Kom igång | PolyLingo | PolyLingo