Ö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
Az Idempotency-Key megakadályozza a feladatok megkettőzését, ha időtúllépés vagy kapcsolati hiba után újraküldi a kérést. Minden új feladathoz válasszon új kulcsot, például UUID-t. Ezt a kérésazonosítót Ön hozza létre; ez nem az API-kulcsa.
Készítsen végpontot
POST /api/v2/jobs
A helyzet végpontja
GET /api/v2/jobs/{id}
Használjon 1-255 karaktert: A-Z, a-z, 0-9, pontot (.), aláhúzást (_), kettőspontot (:) vagy kötőjelet (-). Ne használjon szóközt, és ne rövidítse le a kulcsot. Minden újrapróbálkozáskor ugyanazt a kulcsot és ugyanazt a kéréstörzset küldje el.
Az első létrehozás HTTP 202 választ ad. Ugyanazon kérés ismétlése HTTP 200 választ ad a meglévő feladat azonosítójával. Ugyanaz a kulcs eltérő kéréssel HTTP 409 választ ad. Ugyanezek a szabályok vonatkoznak a kötegekre is. Az alábbi példák tartalmazzák a fejlécet; minden új feladathoz vagy köteghez egyszer cserélje le a példakulcsot.
curl https://api.simple8.de/api/v2/jobs \
-H "Authorization: Bearer $SIMPLE8_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: article-4711-v1" \
-d '{
"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
curl https://api.simple8.de/api/v2/jobs \
-H "Authorization: Bearer $SIMPLE8_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: article-4711-webhook-v1" \
-d '{
"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.
curl https://api.simple8.de/api/v2/batches \
-H "Authorization: Bearer $SIMPLE8_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: release-4711-v1" \
-d '{
"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.