Демо

Лесен за четене текст: Вижте всяка настройка на API в действие.

simple8 преобразува сложно съдържание в структуриран и лесен за четене текст за хора, които се нуждаят от по-силна езикова подкрепа. Сравнете ясен език и лесен за четене текст, пълен и съкратен изход, незадължителни съвети за качество и всичките четири модела на доставка с живи примери за заявки и отговори.

Лесен за четене текст

simple8 преобразува сложно съдържание в структуриран и лесен за четене текст за хора, които се нуждаят от по-силна езикова подкрепа.

Резултати на немски език, съответстващи на DIN

Резултатите на simple8 на ясен немски език съответстват на DIN ISO 24495-1 и DIN 8581-1. Резултатите на лесен за четене немски език съответстват на DIN SPEC 33429.

CMS, API и уиджет за сайт с един ред JavaScript

Интегрирайте simple8 с WordPress, TYPO3, Drupal, Storyblok и много други системи, свържете го чрез API или добавете уиджета към сайта с един ред JavaScript.

Хостинг изцяло в Германия

simple8 се хоства и управлява изцяло в Германия. Хостингът и обработката на данни са в съответствие с ОРЗД (GDPR).

SLA за 99,9% месечна наличност

simple8 предоставя SLA за 99,9% месечна наличност на продукционния API.

Преминете към прегледа на архитектурата интеграция в уебсайтове

Интерактивен пример

Заявката и отговорът се променят с всяка настройка.

Тук можете директно да видите как прост език, лесен език, пълни или съкратени отговори и незадължителна качествена информация работят заедно.

Вход

Изходен текст и настройки

Изходен текст

260 / 1000 знака

Режим

Ниво на детайлност

Бележки за качествотоДобавя допълнителна информация за качеството към отговора на API. Без тази настройка отговорът предоставя само резултата.

API заявка

{
  "text": "За да се ускори обработката, потребителите трябва първо да проверят личната си информация след успешна регистрация, да я актуализират, ако е необходимо, и след това да потвърдят процеса цифрово. След като изпратите, ще получите съобщение със следващите стъпки.",
  "locale": "bg",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  }
}

Изход

Лесен за четене текст

Завършено940 ms

След изпращане тук ще се появи поточно предаваният превод.

API отговор

{
  "requestId": "simple8_case_01",
  "cacheStatus": "hit",
  "durationMs": 940,
  "locale": "bg",
  "mode": "easy-language",
  "settings": {
    "rewriteScope": "complete",
    "qualityHints": false
  },
  "output": {
    "text": "Влезте. Проверете информацията си. Променете невярна информация директно онлайн. Потвърдете процеса цифрово. След това ще получите съобщение. Съобщението съдържа следващите стъпки."
  }
}

Четири API архитектури

И четирите модела решават една и съща техническа задача, но с различна транспортна логика.

Изборът зависи от това дали резултатът е необходим незабавно, дали напредъкът трябва да бъде видим и дали системата за повикване може активно да чака, анкета или да бъде уведомявана чрез събитие.

Синхронна HTTP заявка

Влиза заявка и готовият отговор се връща в същата HTTP връзка.

Подходящ за

Директни действия в интерфейса, кратки текстове и ниска латентност

Една заявка + стрийминг отговор

Заявката започва да се обработва, отговорът се връща стъпка по стъпка като поток.

Подходящ за

По-дълго съдържание, прогресивен потребителски интерфейс, видим прогрес на обработката

Асинхронна работа + запитване

Първата заявка създава задание, след което клиентът пита за състоянието многократно.

Подходящ за

Пакетна обработка, бекенд, по-дълги задачи без постоянна отворена връзка

Асинхронно задание + webhook

Първата заявка създава задание, съобщението за завършване се връща по-късно чрез webhook.

Подходящ за

CMS работни процеси, архитектура на събития, надеждна интеграция от система към система

Четирите модела

Концепция, техническо изпълнение и конкретни примери за всяка архитектура.

Синхронна HTTP заявка

Влиза заявка и готовият отговор се връща в същата HTTP връзка.

Изход API

Системата за повикване изпраща заявка и активно чака резултата. `mode` и `settings` се предават в една и съща заявка и директно определят формата на отговора.

Изпращаме индивидуални текстове на формуляри директно на simple8 и веднага получаваме подходящата езикова версия за избрания режим.

API

Типичен е `POST /api/translate` с текст, езиков режим и настройки.
Ако е успешно, API директно връща `200 OK` с опростения текст.
Ако `qualityHints=false`, отговорът не съдържа допълнителни съвети за качество.

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."
  }
}

Една заявка + стрийминг отговор

Заявката започва да се обработва, отговорът се връща стъпка по стъпка като поток.

Изход API

Клиентът стартира само една заявка, но не остава сляп до края. Вместо единичен окончателен отговор, те получават текущи актуализации на състоянието или съдържанието през една и съща връзка.

Нашият редакционен екип трябва да види коя версия се създава в момента и, ако е необходимо, незабавно да получи качествена информация.

API

Заявката съдържа същите технически опции като в синхронния модел: `mode`, `rewriteScope` и по избор `qualityHints`.
Клиентът обработва събития като `status`, `delta` и `completed`, без да издава нови заявки.
Ако `qualityHints` е активно, крайното съобщение `completed` може да съдържа допълнителни съвети за качество.

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."
    ]
  }
}

Асинхронна работа + запитване

Първата заявка създава задание, след което клиентът пита за състоянието многократно.

Изход API

Действителната обработка е отделена от първото HTTP повикване. Системата за повикване незабавно получава идентификационен номер на задание и по-късно се контролира, когато отново поиска статуса.

Нашият бекенд събира много текстове и по-късно конкретно пита кой вариант на режима е готов.

API

`POST` създава задание и запазва избраната комбинация от режим и настройки.
Клиентът проверява `GET /api/jobs/{id}` през интервали, докато бъде отчетено `queued`, `running`, `completed` или `failed`.
Изпитването е много подходящо, когато съкратените или анализираните версии са класифицирани в по-големи партидни потоци.

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."
    ]
  }
}

Асинхронно задание + webhook

Първата заявка създава задание, съобщението за завършване се връща по-късно чрез webhook.

Изход API

Тук също обработката се стартира асинхронно. За разлика от анкетирането, клиентът не отправя запитвания за състоянието многократно, но се уведомява активно веднага щом има наличен резултат или грешка.

Нашата CMS решава за всяко съдържание дали се използва прост или лесен език и запазва готовата версия само след уебкукичката.

API

В допълнение към техническите данни, заявката за стартиране също предава режим, настройки и `webhookUrl`.
След завършване, API изпраща подписано `POST` събитие към целевата система.
Потоците на Webhook са особено полезни при подаването на различни изходни режими в процеси на публикуване или освобождаване.

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."
  }
}