# SmartBee AI API

> Text-to-speech (natural Azerbaijani voices) and AI tools for news websites. Submit article text, it is queued, voiced once and returned as an immutable audio URL; billing is per synthesized character, listening is free.

AI agents: read https://ai.smartbee.az/llms-full.txt, then load tool definitions from https://ai.smartbee.az/api/agent/tools.json and call them against https://ai.smartbee.az/api.

## Docs

- [Agent guide](https://ai.smartbee.az/llms-full.txt): authentication, workflow, errors and a ready prompt for every endpoint
- [Tool definitions](https://ai.smartbee.az/api/agent/tools.json): Anthropic format, `?format=openai` for OpenAI
- [OpenAPI](https://ai.smartbee.az/openapi.json): Swagger 2.0 with x-agent-tool / x-agent-prompt extensions
- [Swagger UI](https://ai.smartbee.az/swagger/index.html): interactive docs
- [Player](https://ai.smartbee.az/v1/player.js): drop-in browser player (`<script async src=… data-key="pk_live_…">`)

## Endpoints

- [GET /health](https://ai.smartbee.az/llms-full.txt#get_health): Sağlamlıq yoxlaması
- [GET /health/services](https://ai.smartbee.az/llms-full.txt#get_health_services): Asılılıqların vəziyyəti
- [POST /v1/articles](https://ai.smartbee.az/llms-full.txt#post_v1_articles): Məqaləni səsləndirməyə göndər
- [GET /v1/articles/{external_id}/audio](https://ai.smartbee.az/llms-full.txt#get_v1_articles_external_id_audio): Məqalənin audio vəziyyəti
- [POST /v1/articles/{external_id}/invalidate](https://ai.smartbee.az/llms-full.txt#post_v1_articles_external_id_invalidate): Məqalənin audiosunu köhnəlmiş say (məzmun dəyişib)
- [POST /v1/articles/{external_id}/translate](https://ai.smartbee.az/llms-full.txt#post_v1_articles_external_id_translate): Məqaləni tərcümə et
- [GET /v1/audio/{file}](https://ai.smartbee.az/llms-full.txt#get_v1_audio_file): Hazır audio faylı
- [POST /v1/translations](https://ai.smartbee.az/llms-full.txt#post_v1_translations): Mətni tərcümə et
- [GET /v1/translations/{id}](https://ai.smartbee.az/llms-full.txt#get_v1_translations_id): Tərcümə işinin vəziyyəti / nəticəsi
- [GET /v1/webhook](https://ai.smartbee.az/llms-full.txt#get_v1_webhook): Webhook ayarları və imza sirri
- [PUT /v1/webhook](https://ai.smartbee.az/llms-full.txt#put_v1_webhook): Webhook URL-ini dəyiş / sirri yenilə