Dokumentācija

Izvēli, kā jūsu sistēma saņem rezultātu.

{
  "text": "Sarežģīts avota saturs atlasītajā valodā.",
  "locale": "lv",
  "mode": "simple-language"
}

Pieejami SDK un cURL piemēri

Sinkrons HTTP

Katrā modelī tiek izmantoti tie paši pamatlauki: teksts, lokalizācija un režīms.

Galvenā punkta

POST /api/v2/translate

Labākais

Īss saturs un tiešā aizmugurējā darbība.

Atbalsts

200 OK

Streaming

Atbildē tiek izmantots satura veids: teksts/notikuma straume.

Galvenā punkta

POST /api/v2/translate/stream

Labākais

Progressivi saskarni un ilgāks saturs.

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

Straume izstaro vienu meta notikumu, vienu vai vairākus delta notikumus un pēdējo pabeigto notikumu.

Meta notikums satur pieprasījuma identifikatoru, lokalizāciju un režīmu.

Katrs delta satur daļu no rezultāta, un veikts satur lietošanas informāciju.

Pēc pabeigšanas savienojums tiek aizvērts.

Asinkronizēts darbs ar aptaujas

Veidojot darbu, nosūtiet unikālu Idempotency-Key galveni.

Jautājums:

POST /api/v2/jobs

Statusa beigšanas punkts

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

Darbs ir pieejams septiņas dienas.

Aptauja ar saprātīgu intervālu, līdz statuss ir pabeigts vai neizdevās.

Asinkronizācijas darbs ar webhook

Vispirms lietojumprogrammā Simple8 izveidojiet un pārbaudiet tīmekļa aizķeres galapunktu. Pēc tam darbā atsaucieties uz tā galapunkta ID.

Jautājums:

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 nosūta Simple8-Signature galveni ar laikspiedolu un HMAC SHA-256 parakstu.

Pārbaudiet parakstu pret neapstrādātā pieprasījuma pamattekstu ar parakstīšanas noslēpumu, kas tiek parādīts vienreiz, kad tiek izveidots galapunkts.

Atgrieziet jebkuru 2xx statusu pēc pasākuma pieņemšanas.

Neveiksmīgas piegādes tiek atkārtoti mēģinātas līdz 50 reizēm septiņu dienu laikā, un jaunākie mēģinājumi ir redzami lietojumprogrammā.

Saņēmējiem ir jāpieļauj piegādes dublikāti, jo atkārtoti mēģinājumi var piegādāt vienu un to pašu notikumu vairāk nekā vienu reizi.

Partijas apstrāde

Nosūtiet no 1 līdz 50 vienumiem ar ne vairāk kā 500 000 rakstzīmēm.

Jautājums:

POST /api/v2/batches

Statusa beigšanas punkts

GET /api/v2/batches/{id}

Katrs vienums izmanto tos pašus teksta, lokalizācijas un režīma laukus kā sinhronu pieprasījumu.

Izvēlieties aptauju vai verificētu tīmekļa aizķeres galapunktu piegādei un nosūtiet unikālu Idempotency-Key galveni.

Šajā lapā