Vertaile suoria vastauksia, Streaming, taustatarjouksia ja Webhooks. Kaikki vaihtoehdot käyttävät tekstiä, kieleen koodia ja mallia.
Valitse, miten järjestelmäsi saa tuloksen.
{
"text": "Monimutkainen lähdesisältö valitulla kielellä.",
"locale": "fi",
"mode": "simple-language"
}SDK- ja cURL-esimerkkejä saatavilla
Synkroniinen HTTP
Lopputulos
POST /api/v2/translate
Parasta
Lyhyet tekstit, joiden tulokset ovat välittömästi tarpeen.
Menestys
200 Hyvä on.
Lähetys
Vastaus käyttää Content-Type: text/event-stream.
Lopputulos
POST /api/v2/translate/stream
Parasta
Pidemmälle sisällölle, jonka tulos tulee näyttää askel askeleelta.
{
"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}}Aalto alkaa meta-aineella, ja sen jälkeen yksi tai useampi tekstiosa seuraa delta-ainea.
Ensimmäinen tapahtuma sisältää pyyntötunnuksen, kielikoodin ja tilan.
Jokainen delta sisältää osan tuloksesta ja done sisältää käyttötiedot.
Kun olet valmis, yhteys sulkeutuu.
Asynkisointi työllä äänestys
Idempotency-Key estää päällekkäiset työt, kun lähetät pyynnön uudelleen aikakatkaisun tai yhteysvirheen jälkeen. Valitse jokaiselle uudelle työlle uusi avain, esimerkiksi UUID. Luot tämän pyynnön tunnisteen itse; se ei ole API-avaimesi.
Luoda loppupiste
POST /api/v2/jobs
Tilanne päämäärä
GET /api/v2/jobs/{id}
Käytä 1-255 merkkiä: A-Z, a-z, 0-9, pisteitä (.), alaviivoja (_), kaksoispisteitä (:) tai yhdysmerkkejä (-). Älä käytä välilyöntejä tai lyhennä avainta. Lähetä jokaisella uudella yrityksellä sama avain ja sama pyynnön sisältö.
Ensimmäinen luonti palauttaa HTTP 202. Sama pyyntö uudelleen palauttaa HTTP 200 ja olemassa olevan työn tunnisteen. Sama avain eri pyynnöllä palauttaa HTTP 409. Samat säännöt koskevat eriä. Alla olevat esimerkit sisältävät otsakkeen; vaihda kukin esimerkkiavain kerran jokaista uutta työtä tai erää varten.
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"
}Työpaikkoja on tarjolla seitsemän päivää.
Työ etenee tilojen queued, processing, completed tai failed kautta. Epäonnistuneet työt sisältävät kentän error.code. Luonti- ja tilavastaukset sisältävät kentän expiresAt.
Kysy tila uudelleen sekunnin kuluttua. Lisäytä etäisyys asteittain pidempään käsittelyyn.
Asynkisointi työ webhookin kanssa
Luo ja vahvista ensin webhook-päätepiste Simple8-sovelluksessa. Viittaa sitten sen päätepisteen tunnukseen työssä.
Luoda loppupiste
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"
}
}Simple8 lähettää Simple8-Signature-arvon muodossa t=<timestamp>,v1=<signature>. <timestamp> on Unix-aikaleima sekunteina. Allekirjoitus on pienillä kirjaimilla kirjoitettu heksadesimaalinen HMAC SHA-256 -tulos arvosta <timestamp>.<raw request body>.
Tarkista allekirjoitus muuttumattomana pyyntöä vastaan. Näet salaisen allekirjoitusavaimen kerran päätepistettä luotaessa.
Palauta HTTP 200 tai 201 heti, kun järjestelmäsi on hyväksynyt tapahtuman.
Toistot: Jos virhe tapahtuu, Simple8 yrittää toimittaa se seitsemän päivän kuluessa jopa 50 kertaa uudelleen.
Kaksi tapahtumaa: Käsittele jokainen tapahtuma-ID vain kerran, koska toisto voi lähettää saman tapahtuman uudelleen.
Eräkäsittely
Lähetä 1–50 kohdetta, joissa on yhteensä enintään 25 000 merkkiä.
Luoda loppupiste
POST /api/v2/batches
Tilanne päämäärä
GET /api/v2/batches/{id}
Jokainen kohde käyttää samoja teksti-, alue- ja tilakenttiä synkronisena pyyntönä.
Valitse kysely tai vahvistettu webhook-päätepiste toimitettavaksi ja lähetä yksilöllinen Idempotency-Key-otsikko.
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"
}
}
]
}Erän luonti palauttaa ensimmäisellä kerralla HTTP 202:n ja idempotentissa uusinnassa HTTP 200:n. Webhook-tapahtumat ovat job.completed, job.failed, batch.completed ja batch.failed. Valmiiden webhookien payloadit sisältävät vain tunnisteet ja tilan. Nouda tulos työn tai erän tila-endpointista.