Demonstrācija

Vieglā valoda: Skatiet katru API iestatījumu darbībā.

simple8 pārveido sarežģītu saturu strukturētā vieglajā valodā cilvēkiem, kuriem nepieciešams lielāks valodas atbalsts. Salīdziniet skaidra valoda un vieglā valoda, pilnīgu un saīsinātu izvadi, izvēles kvalitātes ieteikumus un visus četrus piegādes modeļus ar reāllaika pieprasījumu un atbilžu piemēriem.

Vieglā valoda

simple8 pārveido sarežģītu saturu strukturētā vieglajā valodā cilvēkiem, kuriem nepieciešams lielāks valodas atbalsts.

DIN standartiem atbilstoša vācu valodas izvade

simple8 izvade skaidrā vācu valodā atbilst DIN ISO 24495-1 un DIN 8581-1. Izvade vieglajā vācu valodā atbilst DIN SPEC 33429.

CMS, API un vietnes logrīks ar vienu JavaScript rindu

Integrējiet simple8 ar WordPress, TYPO3, Drupal, Storyblok un daudzām citām sistēmām, pieslēdziet to ar API vai pievienojiet vietnes logrīku ar vienu JavaScript rindu.

Hostings pilnībā Vācijā

simple8 tiek pilnībā mitināts un pārvaldīts Vācijā. Hostings un datu apstrāde atbilst VDAR (GDPR).

99,9 % mēneša pieejamības SLA

simple8 nodrošina 99,9 % mēneša pieejamības SLA produkcijas API.

Pāriet uz arhitektūras pārskatu tīmekļa vietnes integrācija

Interaktīvs piemērs

Pieprasījuma un atbildes maiņa ar katru iestatījumu.

Šeit varat tieši redzēt, kā vienkārša valoda, vienkārša valoda, pilnīgas vai saīsinātas atbildes un izvēles kvalitātes informācija darbojas kopā.

Ievade

Avota teksts un iestatījumi

Avota teksts

263 / 1000 rakstzīmes

Režīms

Detalizācijas līmenis

Kvalitātes piezīmesAPI atbildei pievieno papildu kvalitātes informāciju. Bez šī iestatījuma atbilde sniedz tikai rezultātu.

API pieprasījums

{
  "text": "Lai paātrinātu apstrādi, lietotājiem pēc veiksmīgas reģistrācijas vispirms ir jāpārbauda sava personiskā informācija, nepieciešamības gadījumā tā jāatjaunina un pēc tam process jāapstiprina digitāli. Pēc iesniegšanas jūs saņemsit ziņojumu ar turpmākajām darbībām.",
  "locale": "lv",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  }
}

Izvade

Vieglā valoda

Pabeigts940 ms

Pēc nosūtīšanas šeit parādīsies straumētais tulkojums.

API atbilde

{
  "requestId": "simple8_case_01",
  "cacheStatus": "hit",
  "durationMs": 940,
  "locale": "lv",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  },
  "output": {
    "text": "Piesakieties. Pārbaudiet savu informāciju. Mainiet nepatiesu informāciju tieši tiešsaistē. Apstipriniet procesu digitāli. Pēc tam jūs saņemsit ziņojumu. Ziņojumā ir ietvertas nākamās darbības."
  }
}

Četras API arhitektūras

Visi četri modeļi atrisina vienu un to pašu tehnisko uzdevumu, bet ar atšķirīgu transporta loģiku.

Izvēle ir atkarīga no tā, vai rezultāts ir nepieciešams nekavējoties, vai progresam jābūt redzamam un vai zvanīšanas sistēma var aktīvi gaidīt, aptaujāt vai saņemt paziņojumu ar notikumu.

Sinhrons HTTP pieprasījums

Tiek saņemts pieprasījums, un gatavā atbilde tiek atgriezta tajā pašā HTTP savienojumā.

Piemērots

Tiešas darbības lietotāja saskarnē, īsi teksti un zems latentums

Viens pieprasījums + straumēšanas atbilde

Tiek sākta pieprasījuma apstrāde, atbilde soli pa solim tiek atgriezta kā straume.

Piemērots

Garāks saturs, progresīvs lietotāja interfeiss, redzams apstrādes progress

Asinhronais darbs + aptauja

Ar pirmo pieprasījumu tiek izveidots darbs, pēc tam klients atkārtoti vaicā statusu.

Piemērots

Pakešu apstrāde, aizmugursistēmas, ilgāki darbi bez pastāvīga atvērta savienojuma

Asinhronais darbs + tīmekļa aizķere

Ar pirmo pieprasījumu tiek izveidots darbs, un vēlāk tiek parādīts pabeigšanas ziņojums, izmantojot tīmekļa aizķeri.

Piemērots

SPS darbplūsmas, notikumu arhitektūra, uzticama sistēmu integrācija

Četri modeļi

Katras arhitektūras koncepcija, tehniskā realizācija un konkrēti piemēri.

Sinhrons HTTP pieprasījums

Tiek saņemts pieprasījums, un gatavā atbilde tiek atgriezta tajā pašā HTTP savienojumā.

Izvade API

Izsaucošā sistēma nosūta pieprasījumu un aktīvi gaida rezultātu. `mode` un `settings` tiek nodoti tajā pašā pieprasījumā un tieši nosaka atbildes formu.

Mēs nosūtām atsevišķus veidlapu tekstus tieši uz simple8 un uzreiz saņemam atbilstošās valodas versiju izvēlētajam režīmam.

API

Tipisks ir “POST /api/translate” ar tekstu, valodas režīmu un iestatījumiem.
Ja tas ir veiksmīgi, API tieši atgriež “200 OK” ar vienkāršotu tekstu.
Ja “qualityHints=false”, atbilde nesatur papildu kvalitātes ieteikumus.

POST /api/translate
{
  "text": "Für die Beantragung des Personalausweises bringen Sie bitte Ihren alten Ausweis oder Reisepass sowie ein aktuelles Lichtbild mit.",
  "mode": "simple-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  }
}

200 OK
{
  "requestId": "req_sync_001",
  "cacheStatus": "miss",
  "durationMs": 980,
  "mode": "simple-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  },
  "output": {
    "text": "Wenn Sie einen Personalausweis beantragen, bringen Sie bitte Ihren alten Ausweis oder Reisepass und ein aktuelles Foto mit."
  }
}

Viens pieprasījums + straumēšanas atbilde

Tiek sākta pieprasījuma apstrāde, atbilde soli pa solim tiek atgriezta kā straume.

Izvade API

Klients sāk tikai vienu pieprasījumu, bet nepaliek akls līdz beigām. Vienas galīgās atbildes vietā viņi saņem pastāvīgu statusa vai satura atjauninājumus, izmantojot to pašu savienojumu.

Mūsu redakcijai vajadzētu redzēt, kura versija pašlaik tiek veidota, un, ja nepieciešams, nekavējoties saņemt kvalitatīvu informāciju.

API

Pieprasījumā ir iekļautas tās pašas funkcionālās opcijas kā sinhronajā modelī: `mode`, `rewriteScope` un pēc izvēles `qualityHints`.
Klients apstrādā tādus notikumus kā `status`, `delta` un `completed`, nesūtot jaunus pieprasījumus.
Ja `qualityHints` ir aktīvs, noslēguma ziņojumā `completed` var būt iekļautas papildu kvalitātes norādes.

POST /api/translate/stream
{
  "text": "Nach der Beantragung des Personalausweises erhalten Sie ein Schreiben, sobald das Dokument in der Behörde zur Abholung bereitliegt.",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": true
  }
}

event: status
data: {"state":"processing","mode":"easy-language"}

event: delta
data: {"chunk":"Nach dem Antrag bekommen Sie ein Schreiben.\n"}

event: delta
data: {"chunk":"Dann wissen Sie: Ihr Ausweis liegt bereit.\n"}

event: completed
data: {
  "requestId": "req_stream_001",
  "cacheStatus": "miss",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": true
  },
  "output": {
    "text": "Nach dem Antrag bekommen Sie ein Schreiben.\nDann wissen Sie: Ihr Ausweis liegt bereit.",
    "qualityHints": [
      "Die Ausgabe nutzt sehr kurze Sätze mit klarer Reihenfolge."
    ]
  }
}

Asinhronais darbs + aptauja

Ar pirmo pieprasījumu tiek izveidots darbs, pēc tam klients atkārtoti vaicā statusu.

Izvade API

Faktiskā apstrāde tiek atsaistīta no pirmā HTTP zvana. Izsaucošā sistēma nekavējoties saņem darba ID un vēlāk kontrolē sevi, kad tā vēlreiz pieprasa statusu.

Mūsu aizmugure savāc daudz tekstu un vēlāk īpaši jautā, kurš režīma variants ir gatavs.

API

“POST” izveido darbu un saglabā atlasīto režīma un iestatījumu kombināciju.
Klients regulāri pieprasa `GET /api/jobs/{id}`, līdz tiek ziņots statuss `queued`, `running`, `completed` vai `failed`.
Aptauja ir labi piemērota, ja saīsinātās vai analizētās versijas tiek klasificētas lielākās partijas plūsmās.

POST /api/jobs
{
  "text": "Für die Beantragung des Personalausweises müssen Sie persönlich im Bürgeramt vorsprechen. Minderjährige brauchen die Zustimmung der Sorgeberechtigten.",
  "mode": "simple-language",
  "settings": {
    "rewriteScope": "condensed",
    "qualityHints": true
  }
}

202 Accepted
{
  "jobId": "job_poll_001",
  "status": "queued"
}

GET /api/jobs/job_poll_001
{
  "jobId": "job_poll_001",
  "status": "completed",
  "mode": "simple-language",
  "settings": {
    "rewriteScope": "condensed",
    "qualityHints": true
  },
  "output": {
    "text": "Für den Personalausweis müssen Sie persönlich ins Bürgeramt gehen.",
    "qualityHints": [
      "Die Ausgabe konzentriert sich auf die wichtigsten Aussagen und lässt Nebendetails weg."
    ]
  }
}

Asinhronais darbs + tīmekļa aizķere

Ar pirmo pieprasījumu tiek izveidots darbs, un vēlāk tiek parādīts pabeigšanas ziņojums, izmantojot tīmekļa aizķeri.

Izvade API

Arī šeit apstrāde tiek sākta asinhroni. Atšķirībā no aptaujas, klients atkārtoti nejautā par statusu, bet tiek aktīvi informēts, tiklīdz ir pieejams rezultāts vai kļūda.

Mūsu SPS katram saturam izlemj, vai tiek izmantota vienkārša valoda vai vienkārša valoda, un saglabā gatavo versiju tikai pēc tīmekļa aizķeres.

API

Papildus tehniskajiem datiem starta pieprasījums pārsūta arī režīmu, iestatījumus un `webhookUrl`.
Pēc pabeigšanas API mērķa sistēmai nosūta parakstītu POST notikumu.
Tīmekļa aizķeres plūsmas ir īpaši noderīgas, ievadot dažādus izvades režīmus publicēšanas vai izlaišanas procesos.

POST /api/jobs
{
  "text": "Wenn Sie Ihren Personalausweis beantragen, können Gebühren anfallen. Bitte bringen Sie die erforderlichen Unterlagen vollständig zum Termin mit.",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "condensed",
    "qualityHints": false
  },
  "webhookUrl": "https://cms.example.com/webhooks/simple8"
}

202 Accepted
{
  "jobId": "job_hook_001",
  "status": "queued"
}

POST https://cms.example.com/webhooks/simple8
simple8-signature: sha256=...

{
  "event": "job.completed",
  "jobId": "job_hook_001",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "condensed",
    "qualityHints": false
  },
  "output": {
    "text": "Für den Personalausweis können Gebühren anfallen.\nBringen Sie bitte alle nötigen Unterlagen mit."
  }
}