Documentare

Referință la API

Simplificați și traduceți conținutul în 24 de limbi de ieșire.

Punctul final sincron acceptă textul sursă, un local de ieșire și unul dintre cele două moduri. Detectează automat limba sursă și returnează un rezultat gata de utilizare în limba de ieșire selectată.

{
  "text": "Conținut sursă complex în limba selectată.",
  "locale": "ro",
  "mode": "simple-language"
}

Sunt disponibile exemple SDK și cURL

Punctul final

POST /api/v2/translate

Creați un rezultat în limbaj simplu sau în limbaj ușor și returnați-l în același răspuns HTTP.

Titluri necesare

ÎncheieturaValoriScopul
AuthorizationBearer <API_KEY>Autentifică proiectul cu schema curentă HTTP Bearer
Content-Typecerere/jsonDeclarează formatul corpului de cerere
Acceptcerere/jsonRequire un răspuns JSON
Idempotency-KeyNecesar numai pentru lucrări și loturiÎmpiedică trimiterile asincrone repetate să creeze lucrări duplicate

Organism de cerere

Nicio altă setare de conținut nu face parte din schema de solicitare publică.

CâmpăTipulRequiredValor permisDescriere
textstringDa, nu.1 până la 10.000 de caractere UnicodeConținutul sursă în localitatea selectată
localestringDa, nu.Unul dintre cele 24 de coduri de două litere suportateLimba de ieșire. Limba sursă este detectată automat.
modestringDa, nu.limbajul simplu, limbajul simpluModul de simplificare
json
{
  "text": "Applicants must provide the required documentation before the deadline.",
  "locale": "en",
  "mode": "easy-language"
}

Organism de răspuns

Răspunsul nu trebuie să conțină setări de solicitare retrase sau o matrice separată de informații despre calitate.

CâmpăTipulDescriere
requestIdstringIdentificator unic pentru suport și jurnaluri
localestringLocalizare de ieșire selectată
modestringModul de simplificare selectat
outputstringRezultatul final în localitatea de ieșire selectată
usage.inputCharactersnumăr întregCaracterele numărate pentru această solicitare sau 0 pentru o accesare în cache
usage.cacheHitbooleanDacă rezultatul a venit din memoria cache de 30 de zile
json
{
  "requestId": "req_sync_002",
  "locale": "en",
  "mode": "easy-language",
  "output": "You need to send documents.\nSend the documents before the deadline.",
  "usage": {
    "inputCharacters": 78,
    "cacheHit": false
  }
}

Comportamentul de validare

  • Text lipsit: respingere cu o eroare de câmp documentată.
  • Text gol: respinge cu o eroare de câmp documentată.
  • Locul nesuportat: respinge; niciodată nu înlocuiește în tăcere alt loc.
  • Modul nesuportat: respinge; nu alegeți niciodată un mod automat.
  • Câmpul retras necunoscut: respinge cu o eroare axată pe migrație sau gestionează numai printr-un strat de compatibilitate cu versiuni explicite.
  • Textul sursă poate folosi o limbă diferită de cea locală. Simple8 detectează automat limba sursă și scrie rezultatul în localitatea de ieșire selectată.