# Documentação para agentes de IA

Esta documentação foi criada para ser lida tanto por assistentes de IA quanto por pessoas. Forneça ao seu agente um dos pontos de entrada abaixo, e
ele poderá escrever um código de integração correto sem precisar adivinhar nomes de parâmetros ou preços.

## Pontos de entrada

| URL | O que é |
|---|---|
| [https://doitong.com/developers/llms.txt](https://doitong.com/developers/llms.txt) | Índice no formato [llms.txt](https://llmstxt.org): todos os guias e modelos com uma descrição de uma linha. |
| [https://doitong.com/developers/llms-full.txt](https://doitong.com/developers/llms-full.txt) | Todos os guias completos, os modelos em destaque completos e o essencial de todos os 1.496 modelos (id, fabricante, preço, link para a página completa) em um único arquivo Markdown. |
| `/<lang>/developers/llms.txt` | O mesmo índice com os guias em outro idioma do site, por exemplo `https://doitong.com/de/developers/llms.txt` (inglês é o padrão). |
| `<any page>.md` | A versão Markdown de uma página, por exemplo [https://doitong.com/developers/models/flux/schnell.md](https://doitong.com/developers/models/flux/schnell.md) ou [https://doitong.com/developers/docs/quickstart.md](https://doitong.com/developers/docs/quickstart.md). |
| `/developers/models/<id>/llms.txt` | Igual à versão `.md` do modelo. |
| [https://doitong.com/developers/openapi.json](https://doitong.com/developers/openapi.json) | OpenAPI 3.1 para geradores de código: todos os endpoints e corpos de solicitação tipados dos modelos em destaque; `?model=<id>`, `?category=<id>` ou `?models=all` adicionam outros. |
| `https://api.doitong.ru/v1/models` | O catálogo em JSON (não requer chave). |

A página Markdown de cada modelo contém seu preço em USD e créditos de API, todos os parâmetros com todos os valores permitidos, um exemplo somente com os campos obrigatórios e um
exemplo completo, o formato da resposta e código pronto para curl, JavaScript, Python e MCP.

## Copiar para IA

Toda página de modelo tem um botão **Copiar para IA**: copie a página como Markdown ou abra-a no ChatGPT ou Claude com um
prompt que direcione o assistente para a versão em Markdown.

## Um prompt que funciona

Cole isto no Claude, ChatGPT ou Cursor e depois descreva o que você quer criar:

```text Prompt
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.
```

## Permitir que o agente chame modelos por conta própria

Para permitir que um agente gere mídia diretamente, conecte o [servidor MCP](https://doitong.com/developers/docs/mcp) com uma chave que tenha um
orçamento em créditos de API. O agente terá ferramentas para pesquisar modelos, consultar preços, executá-los e buscar resultados, e não poderá gastar mais do que
o orçamento.