Dokumentacja

Wybierz, jak twój system otrzymuje wynik.

{
  "text": "Kompleksowa treść źródłowa w wybranym języku.",
  "locale": "pl",
  "mode": "simple-language"
}

Dostępne przykłady SDK i cURL

Synchroniczne HTTP

Każdy wzorzec wykorzystuje te same podstawowe pola: tekst, ustawienia regionalne i tryb.

Wynik końcowy

POST /api/v2/translate

Najlepsze dla

Krótkie treści i bezpośrednie działania w tyłach.

Sukces

200 OK

Streaming

Odpowiedź używa typu treści: tekst/strumień zdarzenia.

Wynik końcowy

POST /api/v2/translate/stream

Najlepsze dla

Interfejsy progresywne i dłuższy treść.

{
  "text": "Source content in the selected language.",
  "locale": "en",
  "mode": "easy-language"
}

event: meta
data: {"requestId":"req_stream_001","locale":"en","mode":"easy-language"}

event: delta
data: {"delta":"Complete result."}

event: done
data: {"usage":{"inputCharacters":42,"cacheHit":false}}

Strumień emituje jedno zdarzenie meta, jedno lub więcej zdarzeń delta i końcowe zdarzenie.

Zdarzenie meta zawiera identyfikator żądania, ustawienia regionalne i tryb.

Każda delta zawiera część wyniku, a gotowe zawiera informacje o użyciu.

Po zakończeniu połączenie zostaje zamknięte.

Praca w nieprzyrzeczalnym czasie z sondażami

Wyślij unikalny nagłówek Idempotency-Key podczas tworzenia zadania.

Utworzenie punktu końcowego

POST /api/v2/jobs

Punkt końcowy stanu

GET /api/v2/jobs/{id}

{
  "text": "Source content in the selected language.",
  "locale": "fr",
  "mode": "simple-language",
  "delivery": {
    "type": "polling"
  }
}

{
  "jobId": "job_poll_001",
  "status": "queued"
}

{
  "jobId": "job_poll_001",
  "status": "completed",
  "locale": "fr",
  "mode": "simple-language",
  "output": {
    "text": "Simplified content in French."
  }
}

Oferty pracy są dostępne przez siedem dni.

Odpytuj w rozsądnych odstępach czasu, aż status zostanie ukończony lub zakończony niepowodzeniem.

Praca asynchronizacja z webhook

Najpierw utwórz i zweryfikuj punkt końcowy webhooka w aplikacji Simple8. Następnie odwołaj się do jego identyfikatora punktu końcowego w zadaniu.

Utworzenie punktu końcowego

POST /api/v2/jobs

{
  "text": "Source content in the selected language.",
  "locale": "de",
  "mode": "easy-language",
  "delivery": {
    "type": "webhook",
    "endpointId": "00000000-0000-4000-8000-000000000000"
  }
}

{
  "id": "evt_01",
  "type": "job.completed",
  "createdAt": "2026-08-06T12:00:00.000Z",
  "data": {
    "jobId": "job_hook_001",
    "status": "completed"
  }
}

Simple8 wysyła nagłówek Simple8-Signature ze znacznikiem czasu i podpisem HMAC SHA-256.

Zweryfikuj podpis w stosunku do nieprzetworzonej treści żądania z kluczem podpisującym pokazanym raz podczas tworzenia punktu końcowego.

Zwróć dowolny status 2xx po zaakceptowaniu wydarzenia.

Nieudane dostawy są ponawiane nawet 50 razy w ciągu siedmiu dni, a ostatnie próby są widoczne w aplikacji.

Odbiorcy muszą tolerować podwójne dostarczanie, ponieważ ponowne próby mogą dostarczyć to samo zdarzenie więcej niż raz.

Przetwarzanie wsadowe

Wyślij od 1 do 50 elementów o łącznej maksymalnej długości 500 000 znaków.

Utworzenie punktu końcowego

POST /api/v2/batches

Punkt końcowy stanu

GET /api/v2/batches/{id}

Każdy element używa tych samych pól tekstu, ustawień regionalnych i trybu, co żądanie synchroniczne.

Wybierz odpytywanie lub zweryfikowany punkt końcowy webhooka do dostarczenia i wyślij unikalny nagłówek Idempotency-Key.

Na tej stronie