Összehasonlítsa az egyenes válaszokat, a Streaming, a háttérbefektetéseket és a Webhooks. Minden változat szöveget, hangkódot és módot használ.
Válasszon, hogy a rendszered hogyan kapja a hatást.
{
"text": "Összetett forrástartalom a kiválasztott nyelven.",
"locale": "hu",
"mode": "simple-language"
}SDK- és cURL-példák állnak rendelkezésre
Hirtelen
Végpont
POST /api/v2/translate
A legjobb a
Rövid szövegek, amelyek eredményei azonnal szükségesek.
Siker
200 Rendben.
Szenvedés
A válasz a Content-Type: text/event-stream értéket használja.
Végpont
POST /api/v2/translate/stream
A legjobb a
Hosszabb tartalomhoz, melynek eredményét lépésről lépésre kell megjeleníteni.
{
"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}}A stream meta-val kezdődik, és egy vagy több szövegrészt delta-ként követ.
Az első esemény tartalmazza a kérésazonosítót, a nyelvkódot és a módot.
Minden delta tartalmazza az eredmény egy részét, a kész pedig a használati információkat tartalmazza.
Miután elkészült, a kapcsolat megszakad.
A szavazással szinkronizált munka
Munka létrehozásakor küldjön egyedi Idempotency-Key fejlécet. Újrapróbálkozáskor ugyanazt, a kezdő és záró szóközök nélküli, 1-255 karakteres kulcsot használja. Az első létrehozás 202, az ismételt kérés 200 választ ad.
Készítsen végpontot
POST /api/v2/jobs
A helyzet végpontja
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"
}Az állások hét napig állnak rendelkezésre.
A feladat állapota queued, processing, completed vagy failed lehet. A sikertelen feladatok tartalmazzák az error.code mezőt. A létrehozási és állapotválaszok tartalmazzák az expiresAt mezőt.
Először egy másodperc múlva kérdezze meg újra a helyzetet. Hosszú feldolgozás esetén fokozatosan növelje a távolságot.
Asynchronizált munka webhook
Először hozzon létre és ellenőrizze egy webhook-végpontot az Simple8 alkalmazásban. Ezután hivatkozzon a végpont azonosítójára a jobban.
Készítsen végpontot
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"
}
}A Simple8 a Simple8-Signature értéket t=<timestamp>,v1=<signature> formátumban küldi. A <timestamp> egy másodpercben megadott Unix-időbélyeg. Az aláírás a <timestamp>.<raw request body> HMAC SHA-256 kivonatának kisbetűs hexadecimális formája.
Ellenőrizze az aláírást a változatlan kérelemhez képest. A titkos aláíró kulcsot egyszer látni fogja a végpont létrehozásakor.
Amint a rendszer elfogadja az eseményt, adjon vissza HTTP 200 vagy 201 választ.
A megismétlések: Ha hibás, a szállítást 7 napon belül 50 alkalommal próbálják meg újra. Az utolsó kísérletek az alkalmazásban láthatóak.
Dupla események: A megismételt esemény azonosítót csak egyszer kezeljük, mert egy ismétlés ugyanazt a történetet küldheti újra.
Kötegelt feldolgozás
1 és 50 közötti tételt küldhet, összesen legfeljebb 25 000 karakterből.
Készítsen végpontot
POST /api/v2/batches
A helyzet végpontja
GET /api/v2/batches/{id}
Minden elem ugyanazt a szöveg-, terület- és módmezőt használja szinkron kérésként.
Válasszon lekérdezést vagy egy ellenőrzött webhook-végpontot a kézbesítéshez, és küldjön egyedi Idempotency-Key fejlécet.
{
"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"
}
}
]
}A köteg létrehozása első alkalommal HTTP 202, idempotens ismétléskor HTTP 200 választ ad. A webhook-események: job.completed, job.failed, batch.completed és batch.failed. A befejezett webhookok payloadjai csak azonosítókat és állapotot tartalmaznak. A kimenetért kérje le a feladat vagy a köteg állapot-endpointját.