Lietuvių kalbos taisymas jūsų programoje

Ką galima daryti

Pavyzdžiui, el. parduotuvė patikrina prekių aprašymus prieš juos skelbdama, klientų aptarnavimo sistema – atsakymus klientams, o redakcija – straipsnius.

• Taisymas

  POST /fix

  Ištaiso rašybos, gramatikos ir skyrybos klaidas ir atkuria lietuviškas raides. Grąžina ištaisytą tekstą ir pakeitimų sąrašą.

• Perfrazavimas

  POST /rephrase

  Perrašo tekstą formaliau, neformaliau, trumpiau, ilgiau arba paprasčiau, nekeisdamas prasmės.

• Tono keitimas

  POST /tone

  Pakeičia teksto toną į oficialų, laisvą, draugišką, dalykišką arba neutralų.

• DI detektorius

  POST /ai-detection

  Įvertina, ar tekstą parašė žmogus, ar jį sukūrė DI. Rezultatas – tikimybė, ne įrodymas.

• Naudojimas

  GET /usage

  Parodo, kiek šio mėnesio simbolių ir šios dienos DI analizių liko.

• MCP serveris

  MCP /mcp/check

  Tekstą taisykite tiesiai „ChatGPT“, „Claude.ai“ ir kitose programose, palaikančiose MCP.

Greita pradžia

API gali naudoti „Max“ plano naudotojai. Planus palyginsite kainų puslapyje.

1. 1

   Sukurkite raktą

   Paskyroje atidarykite skiltį „API raktai“, įrašykite rakto pavadinimą ir paspauskite „Sukurti raktą“. Raktas parodomas vieną kartą: išsaugokite jį aplinkos kintamajame ZODLY_API_KEY.

   Raktą laikykite serveryje. Įdėtą į svetainės ar programėlės kodą jį pamatytų bet kas.

2. 2

   Išsiųskite tekstą

   Raktą siųskite antraštėje Authorization: Bearer, o tekstą – JSON lauke text.

   Terminalas

   curl https://zodly.lt/api/v1/fix \
     -H "Authorization: Bearer $ZODLY_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"text":"Labas, siandien."}'

3. 3

   Pritaikykite pakeitimus

   Atsakymas:

   JSON

   {
     "corrected_text": "Labas, šiandien.",
     "changed": true,
     "changes": [
       {
         "offset": 7,
         "length": 9,
         "original": "siandien.",
         "suggestion": "šiandien."
       }
     ],
     "usage": {
       "chars_used": 16,
       "chars_limit": 1000000,
       "chars_left": 999984,
       "resets_at": "2026-12-01T00:00:00Z"
     }
   }

   corrected_text –

   Visas ištaisytas tekstas. Tarpai ir eilučių lūžiai pradžioje ir pabaigoje lieka tokie, kokius siuntėte.

   changed –

   true, jei tekstas pakeistas.

   changes –

   Pakeitimai pagal vietą tekste. offset – kur fragmentas prasideda siųstame tekste (skaičiuojama nuo 0), length – jo ilgis, original – pats fragmentas, suggestion – kuo jį pakeisti. Kai length lygus 0, tekstas įterpiamas, o kai suggestion tuščias, fragmentas išbraukiamas.

   usage –

   Kiek šio mėnesio simbolių sunaudota, kiek liko ir kada limitas atsinaujins.

   Pozicijos ir ilgiai skaičiuojami kodo taškais (angl. Unicode code points), kaip Python len() ir PHP mb_strlen(). JavaScript text.length jaustuką gali laikyti dviem simboliais, todėl ten naudokite Array.from(text). Kelis pakeitimus taikykite nuo sąrašo galo – tada ankstesnių pakeitimų pozicijos nepasislenka.

Kodo pavyzdžiai

Visi pavyzdžiai siunčia tą patį tekstą į /fix ir raktą ima iš aplinkos kintamojo ZODLY_API_KEY. JavaScript pavyzdžiui reikia „Node.js“ 18 ar naujesnės versijos, Python – paketo requests.

curl https://zodly.lt/api/v1/fix \
  -H "Authorization: Bearer $ZODLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Labas, siandien."}'

const response = await fetch("https://zodly.lt/api/v1/fix", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ZODLY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ text: "Labas, siandien." }),
});
const result = await response.json();

if (!response.ok) {
  throw new Error(`${result.error}: ${result.message}`);
}

console.log(result.corrected_text);
console.log(result.changes);

<?php

$curl = curl_init('https://zodly.lt/api/v1/fix');
curl_setopt_array($curl, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('ZODLY_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode(['text' => 'Labas, siandien.']),
]);
$result = json_decode(curl_exec($curl), true);

if (curl_getinfo($curl, CURLINFO_RESPONSE_CODE) !== 200) {
    throw new RuntimeException($result['error'] . ': ' . $result['message']);
}

echo $result['corrected_text'], PHP_EOL;
print_r($result['changes']);

import os

import requests

response = requests.post(
    "https://zodly.lt/api/v1/fix",
    headers={"Authorization": f"Bearer {os.environ['ZODLY_API_KEY']}"},
    json={"text": "Labas, siandien."},
    timeout=300,
)
result = response.json()

if not response.ok:
    raise RuntimeError(f"{result['error']}: {result['message']}")

print(result["corrected_text"])
print(result["changes"])

Adresai

Visi adresai prasideda https://zodly.lt/api/v1. Užklausos turinį siųskite JSON formatu su antrašte Content-Type: application/json. Atsakymas visada yra JSON.

curl https://zodly.lt/api/v1/rephrase \
  -H "Authorization: Bearer $ZODLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Nu, gal susitiksim rytoj","style":"formal"}'

{
  "text": "Galbūt susitiksime rytoj.",
  "usage": {
    "chars_used": 24,
    "chars_limit": 1000000,
    "chars_left": 999976,
    "resets_at": "2026-12-01T00:00:00Z"
  }
}

curl https://zodly.lt/api/v1/tone \
  -H "Authorization: Bearer $ZODLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Nu, gal susitiksim rytoj","tone":"formal"}'

{
  "text": "Galbūt susitiksime rytoj.",
  "usage": {
    "chars_used": 24,
    "chars_limit": 1000000,
    "chars_left": 999976,
    "resets_at": "2026-12-01T00:00:00Z"
  }
}

curl https://zodly.lt/api/v1/ai-detection \
  -H "Authorization: Bearer $ZODLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Šiandien yra puiki diena mokytis lietuvių kalbos taisyklių ir rašybos. Kiekviena nauja taisyklė padeda rašyti aiškiau."}'

{
  "score": 9.5,
  "confidence": "high",
  "classification": "human",
  "probabilities": {
    "human": 0.88,
    "ai": 0.07,
    "mixed": 0.05
  },
  "summary": "Tekstas greičiausiai parašytas žmogaus. Nerasta ryškių AI požymių.",
  "warnings": [],
  "detected_language": "lt",
  "usage": {
    "detections_used_today": 1,
    "detections_limit_today": 20,
    "detections_left_today": 19
  }
}

curl https://zodly.lt/api/v1/usage \
  -H "Authorization: Bearer $ZODLY_API_KEY"

{
  "chars_used": 300,
  "chars_limit": 1000000,
  "chars_left": 999700,
  "resets_at": "2026-12-01T00:00:00Z",
  "detections_used_today": 2,
  "detections_limit_today": 20,
  "detections_left_today": 18
}

Kiekvieno adreso laukus, atsakymus ir klaidas rasite interaktyviame žinyne ir OpenAPI apraše.

Limitai

Limitai taikomi paskyrai, ne programai: visi raktai ir MCP naudoja tą patį likutį.

Klaidos

Klaidos atsakyme yra laukai error (nekintamas kodas) ir message (paaiškinimas lietuvių kalba). Programoje tikrinkite error, o message galite rodyti žmonėms.

MCP: taisymas pokalbių ir kodo programose

MCP serveris https://zodly.lt/mcp/check leidžia taisyti tekstą tiesiai programose, palaikančiose MCP. Įrankis fix-text grąžina ištaisytą tekstą, pakeitimus ir mėnesio limito likutį. Tekstas įskaičiuojamas į tą patį limitą kaip API.

claude mcp add --transport http zodly https://zodly.lt/mcp/check --header "Authorization: Bearer $ZODLY_API_KEY"

Raktai, nustatymai ir privatumas

Rakto galiojimas –

Raktas galioja, kol jį atšauksite skiltyje „API raktai“. Pakeitus slaptažodį ar ištrynus paskyrą, atšaukiami visi raktai ir atjungiamos visos prijungtos programos.

Nustatymai –

Jei redaktoriaus nustatymuose įjungėte „Taisyti anglicizmus“, API ir MCP taiso ir anglicizmus.

Siunčiamas tekstas –

Tik užklausoje pateiktas tekstas, šifruotu ryšiu (HTTPS). Viso taisomo teksto duomenų bazėje nesaugome. DI detektoriui pateikto teksto pradžią saugome kaip ir svetainėje.

Saugomi duomenys –

Rakto pavadinimas, maišos reikšmė (pats raktas nesaugomas), sukūrimo ir paskutinio naudojimo laikas, o apie kiekvieną užklausą – jos laikas, adresas ir simbolių skaičius, bet ne tekstas. Prijungtai programai – jos pavadinimas ir nukreipimo adresas, kuriuos ji nurodė registruodamasi, suteikta prieiga ir prisijungimo žymų galiojimo laikas. Plačiau – privatumo politikoje.