API dokumentace | Galenio API

Overview

Medical Translation API

Služba překládá jeden text nebo dávku textů a před vrácením výsledku kontroluje klinicky významné hodnoty, negace a vysoce rizikové termíny.

Base URLhttps://api.galenio.app

Klinická kontrolaSlužba podporuje klinickou komunikaci, nejde o podporu klinického rozhodování. Výstup musí před použitím pro péči o pacienta zkontrolovat kvalifikovaný člověk.

Quickstart

První request

curl --request POST "https://api.galenio.app/v1/translate" \
  --header "X-API-Key: <CLIENT_API_KEY>" \
  --header "Content-Type: application/json" \
  --data '{
    "source_language": "en",
    "target_language": "th",
    "text": "Take 500 mg by mouth twice daily. Do not stop the medicine.",
    "response_mode": "translation"
  }'

Authentication

Galenio API klíč

Překlady vyžadují pouze X-API-Key vydaný Galenio. Integrujte výhradně přes https://api.galenio.app.

Endpoints

Provozní endpointy

Method	Path	Purpose
POST	`/v1/translate`	Překlad jednoho nebo více textů.
POST	`/v1/translate/pdf`	Překlad nativního PDF.
POST	`/v1/translate/image`	OCR a překlad JPEG, PNG nebo WebP.
GET	`/health/live`	Kontrola běhu procesu.
GET	`/health/ready`	Kontrola připravenosti závislostí.
GET	`/metrics`	Prometheus metriky; v produkci pro správce.
GET	`/docs`	Interaktivní OpenAPI dokumentace.
GET	`/openapi.json`	OpenAPI dokument.

Translate

`POST /v1/translate`

Pošlete právě jedno z polí text nebo items. Režim report obsahuje provozní diagnostiku a patří pouze do důvěryhodných serverových systémů.

{
  "request_id": "7bda6d94-95bd-43ef-9458-d3547cb5ed6a",
  "response_mode": "translation",
  "results": [{"status": "ok", "text": "..."}]
}

Schemas

Vstup a výstup

source_language a target_language jsou povinné; legacy aliasy source_lang a target_lang zůstávají podporované. Překladový kontext spravuje Galenio automaticky.

Statuses

Stavy položek

ok

Překlad prošel kontrolami.

blocked

Při nevyřešené kritické podmínce se text standardně nevrátí.

item error

Dávková položka může vrátit vlastní chybový stav.

Limits

Jazyky a limity

ar, bg, cs, da, de, el, en, es, et, fi, fr, ga, hr, hu, id, it, km, lo, lt, lv, ms, mt, nl, pl, pt, ro, ru, sk, sl, sv, th, uk, vi; alias cz je přijímán pro cs.

Limit	Value
Text	1–3 000 znaků
Batch	1–20 položek
Celkem za request	20 000 znaků

Errors

Chyby a tracing

Standardní chyby vracejí request_id také v hlavičce X-Request-Id. Běžné statusy jsou 400, 401, 403, 422, 429 a 503.

Safety

Deterministické bezpečnostní kontroly

Kontroly chrání dávky, frekvence, trvání, jednotky, data, časy, měření, vitální hodnoty, negace a rizikové termíny. Pro thajštinu, khmerštinu a laoštinu normalizují nativní číslice a pracují i se skripty bez mezer mezi slovy.

Každý překlad prochází kontrolou významově důležitých údajů. Dlouhé dokumenty používají robustní kontroly přizpůsobené jejich rozsahu. Obsah dokumentů se neukládá do auditních stop.

Podpora

Přístup a integrace

Pro API klíč nebo integrační dotazy napište na

tomaskroupa@galenio.app

Dokumentace REST API.