Začínáme

Použijte PolyLingo HTTP API k překladu prostého textu, Markdownu, JSONu nebo HTML při zachování struktury. Tento průvodce pokrývá produkční endpoint, autentizaci a váš první úspěšný požadavek.

Základní URL

Všechny příklady používají produkční API:

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

Každá cesta níže je relativní k této základně (například POST /translate znamená POST https://api.usepolylingo.com/v1/translate).

Pokud provozujete vlastní instanci PolyLingo API, nahraďte hostitele URL vaší nasazené instance a ponechte prefix /v1, pokud jste nenakonfigurovali jinak.

Autentizace

Chráněné endpointy očekávají váš API klíč v hlavičce Authorization:

Authorization: Bearer <your_api_key>

Získání klíče: Vytvořte si ho v aplikaci PolyLingo pod API keys. Celý klíč vidíte pouze jednou—uložte si ho na bezpečné místo (proměnná prostředí nebo správce tajemství). Klíče lze zrušit ze stejné obrazovky.

Bezpečnost: Zacházejte s klíčem jako s heslem. Preferujte volání API ze svého serveru, ne z veřejného kódu v prohlížeči, aby klíč nebyl nikdy vystaven uživatelům.

Pokud hlavička chybí, je nesprávná, nebo je klíč neplatný či zrušený, API odpoví 401 a error: "invalid_api_key".

Endpointy a klíče

Klíč není potřebaGET /health — rychlá kontrola dostupnosti
GET /languages — podporované jazykové kódy
Klíč je potřebaPOST /translate — překlad obsahu
POST /translate/batch — překlad více položek
POST /jobs — zařazení dlouhotrvajícího překladu (okamžitě vrací 202)
GET /jobs/:id — dotaz na stav úlohy; obsahuje queue_position během čekání
GET /usage — využití pro autentizovaný účet

První požadavek (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"
  }'

Úspěšná odpověď obsahuje objekt translations (jedna položka na cílový jazyk, který jste požadovali) a objekt usage s počty tokenů.

První požadavek (Node.js)

Node.js 18+ obsahuje 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)

Zkontrolujte, zda je API dostupné

Pro kontrolu stavu není potřeba klíč:

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

Měli byste vidět malou JSON odpověď, která indikuje, že služba běží. Použijte GET /languages pro seznam kódů, které můžete předat jako targets.

CORS a prohlížečové aplikace

API může omezit, které původy prohlížeče mohou volat přímo, aby se klíče nepoužívaly z nedůvěryhodných stránek. Volání na straně serveru (Node, Python, edge funkce, váš backend) nejsou CORS omezeny.

Pro jednostránkovou aplikaci je obvyklý vzor: váš frontend komunikuje s vaším backendem a váš backend volá PolyLingo s API klíčem.

Další kroky

  • API reference — tvary požadavků a odpovědí, formáty, chyby a limity.
Začínáme | PolyLingo | PolyLingo