Документация

Пълен преглед на API и панела за управление.

Pricing

1 кредит = 1 изричане = до 1500 символа входен текст.

1) Създай API ключ

В клиентския панел създаваш ключ с име и `webhook_url` (по избор). При създаване копирай и запази ключа - това е последния път, в който ще го видиш.

2) Пусни изричане

POST /api/convert
{
  "api_key": "izr_xxx",
  "text": "Вашият текст тук"
}

Отговор:

{
  "job_id": "uuid",
  "status": "accepted",
  "credits_to_charge": 1
}

3) Резултат с и без webhook

Ако има зададен webhook URL, системата изпраща:

{
  "job_id": "uuid",
  "status": "completed",
  "output_html": "https://izrechi.eu/embed/{job_id}"
}

Ако webhook липсва, няма външно известяване, но резултатът е достъпен в клиентския панел и можеш да копираш embed кода от страницата на изричането.

Пълна интеграция

При отметка Пълна интеграция в API ключа, webhook payload-ът включва и готови данни за директно поставяне в сайт без embed:

{
  "job_id": "uuid",
  "status": "completed",
  "output_html": "https://izrechi.eu/embed/{job_id}",
  "output_text": "...",
  "output_audio": "https://izrechi.eu/storage/conversions/.../speech.mp3"
}

Така можеш да рендираш текста и аудиото директно в HTML кода си (без iframe), което е по-подходящо за SEO.

4) Подновяване

Подновява валидността на изричането за 1 кредит:

POST /api/renew
{
  "api_key": "izr_xxx",
  "job_id": "uuid"
}