# Dokumentacja dla agentów AI

Ta dokumentacja jest przeznaczona zarówno dla asystentów AI, jak i ludzi. Przekaż agentowi jeden z poniższych punktów wejścia,
a będzie mógł napisać poprawny kod integracji bez zgadywania nazw parametrów ani cen.

## Punkty wejścia

| URL | Opis |
|---|---|
| [https://doitong.com/developers/llms.txt](https://doitong.com/developers/llms.txt) | Indeks w formacie [llms.txt](https://llmstxt.org): każdy przewodnik i model z jednozdaniowym opisem. |
| [https://doitong.com/developers/llms-full.txt](https://doitong.com/developers/llms-full.txt) | Wszystkie przewodniki w całości, wyróżnione modele w całości oraz najważniejsze informacje o wszystkich 1496 modelach (id, twórca, cena, link do pełnej strony) w jednym pliku Markdown. |
| `/<lang>/developers/llms.txt` | Ten sam indeks z przewodnikami w innym języku witryny, na przykład `https://doitong.com/de/developers/llms.txt` (domyślnie angielski). |
| `<any page>.md` | Wersja strony w Markdown, na przykład [https://doitong.com/developers/models/flux/schnell.md](https://doitong.com/developers/models/flux/schnell.md) lub [https://doitong.com/developers/docs/quickstart.md](https://doitong.com/developers/docs/quickstart.md). |
| `/developers/models/<id>/llms.txt` | To samo co wersja modelu w pliku `.md`. |
| [https://doitong.com/developers/openapi.json](https://doitong.com/developers/openapi.json) | OpenAPI 3.1 dla generatorów kodu: każdy endpoint i typowane treści żądań wyróżnionych modeli; `?model=<id>`, `?category=<id>` lub `?models=all` dodają pozostałe. |
| `https://api.doitong.com/v1/models` | Katalog w formacie JSON (klucz nie jest potrzebny). |

Strona Markdown każdego modelu zawiera cenę w USD i kredytach API, każdy parametr ze wszystkimi dozwolonymi wartościami, przykład tylko z wymaganymi polami oraz
pełny przykład, strukturę odpowiedzi i gotowy kod dla curl, JavaScript, Python i MCP.

## Kopiowanie dla AI

Każda strona modelu ma przycisk **Kopiuj dla AI**: skopiuj stronę jako Markdown lub otwórz ją w ChatGPT albo Claude,
używając promptu wskazującego asystentowi wersję Markdown.

## Prompt, który działa

Wklej to do Claude, ChatGPT lub Cursor, a następnie opisz, co chcesz zbudować:

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

## Pozwól agentowi samodzielnie wywoływać modele

Aby agent mógł bezpośrednio generować multimedia, połącz [serwer MCP](https://doitong.com/developers/docs/mcp) z kluczem mającym
limit w kredytach API. Agent otrzyma wtedy narzędzia do wyszukiwania modeli, sprawdzania cen, uruchamiania ich i pobierania wyników, a także nie będzie mógł wydać więcej niż
wynosi limit.