# Документация для AI-агентов

Эта документация предназначена как для AI-ассистентов, так и для людей. Передайте агенту одну из указанных ниже точек входа,
и он сможет написать корректный код интеграции, не угадывая имена параметров и цены.

## Точки входа

| URL | Описание |
|---|---|
| [https://doitong.com/developers/llms.txt](https://doitong.com/developers/llms.txt) | Индекс в формате [llms.txt](https://llmstxt.org): каждая инструкция и модель с однострочным описанием. |
| [https://doitong.com/developers/llms-full.txt](https://doitong.com/developers/llms-full.txt) | Каждая инструкция полностью, избранные модели полностью и основные сведения обо всех 1 496 моделях (id, разработчик, цена, ссылка на полную страницу) в одном Markdown-файле. |
| `/<lang>/developers/llms.txt` | Тот же индекс с инструкциями на другом языке сайта, например `https://doitong.com/de/developers/llms.txt` (по умолчанию используется английский). |
| `<any page>.md` | Версия страницы в Markdown, например [https://doitong.com/developers/models/flux/schnell.md](https://doitong.com/developers/models/flux/schnell.md) или [https://doitong.com/developers/docs/quickstart.md](https://doitong.com/developers/docs/quickstart.md). |
| `/developers/models/<id>/llms.txt` | То же, что и Markdown-версия страницы модели `.md`. |
| [https://doitong.com/developers/openapi.json](https://doitong.com/developers/openapi.json) | OpenAPI 3.1 для генераторов кода: каждый эндпоинт и типизированные тела запросов избранных моделей; `?model=<id>`, `?category=<id>` или `?models=all` добавляют остальные. |
| `https://api.doitong.com/v1/models` | Каталог в формате JSON (ключ не требуется). |

На Markdown-странице каждой модели указаны её цена в USD и API-кредитах, каждый параметр со всеми допустимыми значениями, пример только с обязательными данными и полный
пример, структура ответа и готовый код для curl, JavaScript, Python и MCP.

## Копирование для AI

На каждой странице модели есть кнопка **Копировать для AI**: скопируйте страницу в формате Markdown или откройте её в ChatGPT или Claude с
промптом, который указывает ассистенту на версию в Markdown.

## Рабочий промпт

Вставьте это в Claude, ChatGPT или Cursor, а затем опишите, что хотите создать:

```text Промпт
I want to generate images/video/audio with the Doitong API.
Read https://doitong.com/developers/llms.txt first, then the .md page of each model you plan to use.
Facts: base URL https://api.doitong.com/v1; auth header "Authorization: Bearer <key>" with the key from the
DOITONG_API_KEY environment variable; run with POST /run/{model_id}?wait=20 and, if the status is
still queued or running, poll GET /requests/{id}?wait=20; outputs[].url are file URLs on Doitong storage
(kept forever by default; add ?storage=temporary for throwaway runs, deleted after 7 days).
Get the price first with POST /quote/{model_id} (same body): exact, or for a model charged by usage the
most the run can cost (the unused part is refunded). Prices are in USD; 1000 API credits = 1 USD.
Use the parameter names from the model page; never invent parameters.
```

## Разрешите агенту самостоятельно вызывать модели

Чтобы агент мог напрямую генерировать медиа, подключите [MCP-сервер](https://doitong.com/developers/docs/mcp) с ключом, у которого есть
бюджет в API-кредитах. Тогда агент получит инструменты для поиска моделей, расчёта стоимости, запуска и получения результатов и не сможет потратить больше
бюджета.