Documentare

Alegeţi cum va primi sistemul rezultatul.

{
  "text": "Conținut sursă complex în limba selectată.",
  "locale": "ro",
  "mode": "simple-language"
}

Sunt disponibile exemple SDK și cURL

HTTP sincronic

Fiecare model folosește aceleași câmpuri de bază: text, local și mod.

Punctul final

POST /api/v2/translate

Cel mai bun pentru

Conținut scurt și acțiuni directe de backend.

Succesul

200 OK

Streaming

Răspunsul folosește Content-Type: text/event-stream.

Punctul final

POST /api/v2/translate/stream

Cel mai bun pentru

Interfețe progressive și conținut mai lung.

{
  "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}}

Fluxul emite un metaeveniment, unul sau mai multe evenimente delta și un eveniment final finalizat.

Metaevenimentul conține identificatorul solicitării, localitatea și modul.

Fiecare deltă conține o parte a rezultatului și done conține informațiile de utilizare.

După terminare, conexiunea se închide.

Lucrarea de sincronizare cu sondajele

Trimiteți un antet unic Idempotency-Key atunci când creați un loc de muncă.

Creează un punct de destinație

POST /api/v2/jobs

Puncte de final de stat

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."
  }
}

Locurile de muncă rămân disponibile timp de șapte zile.

Sondaj la un interval rezonabil până când starea este finalizată sau eșuată.

Lucrarea de sincronizare cu webhook

Creați și verificați mai întâi un punct final webhook în aplicația Simple8. Apoi faceți referire la ID-ul punctului final în job.

Creează un punct de destinație

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 trimite un antet Simple8-Signature cu un marcaj de timp și o semnătură HMAC SHA-256.

Verificați semnătura față de corpul cererii brute cu secretul de semnare afișat o dată când este creat punctul final.

Returnați orice stare 2xx după acceptarea evenimentului.

Livrările eșuate sunt reîncercate de până la 50 de ori în șapte zile, iar încercările recente sunt vizibile în aplicație.

Destinatarii trebuie să tolereze livrarea duplicată, deoarece reîncercările pot livra același eveniment de mai multe ori.

Prelucrare în lot

Trimiteți între 1 și 50 de articole cu un maxim combinat de 500.000 de caractere.

Creează un punct de destinație

POST /api/v2/batches

Puncte de final de stat

GET /api/v2/batches/{id}

Fiecare articol utilizează aceleași câmpuri de text, locale și mod ca o solicitare sincronă.

Alegeți sondajul sau un punct final de webhook verificat pentru livrare și trimiteți un antet unic Idempotency-Key.

Pe această pagină