# 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` | Модельдің `.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.ru/v1/models` | JSON форматындағы каталог (кілт қажет емес). |

Әр модельдің Markdown бетінде оның USD және API кредиттеріндегі бағасы, барлық рұқсат етілген мәндерімен бірге әрбір параметрі, тек міндетті өрістері бар және толық мысал, жауап пішімі және curl, JavaScript, Python әрі MCP үшін дайын код бар.

## AI үшін көшіру

Әр модель бетінде **AI үшін көшіру** түймесі бар: бетті Markdown ретінде көшіріңіз немесе көмекшіге Markdown нұсқасына сілтеме беретін нұсқаумен оны ChatGPT не Claude ішінде ашыңыз.

## Жұмыс істейтін нұсқау

Мынаны 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.ru/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 кредиттеріндегі бюджеті бар кілтпен қосыңыз. Сонда агентте модельдерді іздеуге, бағаны есептеуге, іске қосуға және нәтижелерді алуға арналған құралдар болады, әрі ол бюджеттен артық жұмсай алмайды.