Déan comparáid idir freagraí díreach, Streaming, comhaltaí tuairisceana agus Webhooks. Úsáidtear téacs, codáil teanga agus modh ag gach rogha.
Roghnaigh conas a fhaigheann do chóras an toradh.
{
"text": "Ábhar foinse casta sa teanga roghnaithe.",
"locale": "ga",
"mode": "simple-language"
}Samplaí SDK agus cURL ar fáil
HTTP comhtháthraithe
Críoch-aiste
POST /api/v2/translate
Is fearr le haghaidh
Teachtaireachtaí gairid a bhfuil an toradh acu ag teastáil láithreach.
Is é an rath
200 OK
Streaming
Úsáideann an freagra Ábhar-Cineál: téacs/sruth imeachtaí.
Críoch-aiste
POST /api/v2/translate/stream
Is fearr le haghaidh
Le haghaidh ábhar níos faide, ba chóir an toradh a thaispeáint céim ar chéim.
{
"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}}Tosaíonn an sruth le meta. Ansin leanann codanna téacs amháin nó níos mó mar delta.
Sa chéad imeacht tá aitheantas an iarratais, cód teanga agus mód.
Tá cuid den toradh i ngach deilt, agus tá an fhaisnéis úsáide ann.
Tar éis é a dhéanamh, dúnann an nasc.
Oibriú async le vótaíocht
Seol ceanntásc uathúil Idempotency-Key agus post á chruthú agat. Úsáid an eochair chéanna, agus na spásanna tosaigh agus deiridh bainte di, idir 1 agus 255 carachtar le haghaidh atrialacha. Tugann an chéad chruthú 202 ar ais agus tugann athsheoladh 200 ar ais.
Cruthaigh ceannpoint
POST /api/v2/jobs
Staidéal deiridh
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",
"expiresAt": "2026-09-03T12:00:00.000Z"
}{
"jobId": "job_poll_001",
"status": "completed",
"locale": "fr",
"mode": "simple-language",
"output": "Simplified content in French.",
"expiresAt": "2026-09-03T12:00:00.000Z"
}Fanann poist ar fáil ar feadh seacht lá.
Téann jab trí queued, processing, completed nó failed. Bíonn error.code i jabanna ar theip orthu. Bíonn expiresAt i bhfreagraí cruthaithe agus stádais.
Déan an t-athbhreithniú ar an stádas arís tar éis sec. Le haghaidh próiseáil níos faide, méadú céimnithe ar an scáth.
D' oibríonn async le webhook
Cruthaigh agus fíoraigh críochphointe crúca gréasáin san fheidhmchlár Simple8 ar dtús. Ansin déan tagairt dá ID críochphointe sa phost.
Cruthaigh ceannpoint
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"
}
}Seolann Simple8 Simple8-Signature mar t=<timestamp>,v1=<signature>. Is stampa ama Unix i soicindí é <timestamp>. Is é an síniú aschur heicsidheachúlach litreacha beaga HMAC SHA-256 thar <timestamp>.<raw request body>.
Seiceáil an síniú i gcoinne an iarratais gan athrú. Feicfidh tú an eochair sínithe rúnda uair amháin agus an críochphointe á chruthú.
Tabhair HTTP 200 nó 201 ar ais a luaithe a ghlacann do chóras leis an teagmhas.
Athsamh: Má bhíonn mícheart ann, déan iarracht an seachadadh a dhéanamh arís laistigh de seacht lá agus suas le 50 uair.
Tuairiscí dáileoghte: Déan gach aitheantas ócáide ach uair amháin, mar is féidir le athbhreithniú an t-earráid céanna a sheoladh arís.
Próiseáil bhaisc
Seol idir 1 agus 50 mír le huasmhéid comhcheangailte de 25,000 carachtar.
Cruthaigh ceannpoint
POST /api/v2/batches
Staidéal deiridh
GET /api/v2/batches/{id}
Úsáideann gach mír an téacs céanna, locale, agus réimsí mód mar iarratas sioncrónach.
Roghnaigh an vótaíocht nó críochphointe fíoraithe cluaisín gréasáin le seachadadh agus seol ceanntásc uathúil Idempotency-Key.
{
"items": [
{
"text": "First source text.",
"locale": "en",
"mode": "simple-language"
},
{
"text": "Second source text.",
"locale": "de",
"mode": "easy-language"
}
],
"delivery": {
"type": "polling"
}
}{
"batchId": "batch_001",
"status": "queued",
"itemCount": 2
}{
"batchId": "batch_001",
"status": "completed",
"itemCount": 2,
"items": [
{
"jobId": "job_001",
"status": "completed",
"locale": "en",
"mode": "simple-language",
"output": "First result."
},
{
"jobId": "job_002",
"status": "failed",
"locale": "de",
"mode": "easy-language",
"error": {
"code": "processing_failed"
}
}
]
}Tugann cruthú baisce HTTP 202 ar ais an chéad uair agus HTTP 200 le haghaidh athsheinm idémpotantach. Is iad na teagmhais webhook job.completed, job.failed, batch.completed agus batch.failed. Ní bhíonn ach aitheantóirí agus stádas i payloadanna webhook críochnaithe. Faigh endpoint stádais an jab nó na baisce chun an t-aschur a léamh.