# Documentazione per agenti AI

Questa documentazione è pensata per essere letta sia dagli assistenti AI sia dalle persone. Fornisci al tuo agente uno degli ingressi qui sotto e
potrà scrivere codice di integrazione corretto senza dover indovinare i nomi dei parametri o i prezzi.

## Punti di accesso

| URL | Descrizione |
|---|---|
| [https://doitong.com/developers/llms.txt](https://doitong.com/developers/llms.txt) | Indice nel formato [llms.txt](https://llmstxt.org): ogni guida e modello con una descrizione di una riga. |
| [https://doitong.com/developers/llms-full.txt](https://doitong.com/developers/llms-full.txt) | Ogni guida completa, i modelli in evidenza completi e gli elementi essenziali di tutti i 1496 modelli (id, produttore, prezzo, link alla pagina completa) in un unico file Markdown. |
| `/<lang>/developers/llms.txt` | Lo stesso indice con le guide in un'altra lingua del sito, ad esempio `https://doitong.com/de/developers/llms.txt` (l'inglese è la lingua predefinita). |
| `<any page>.md` | La versione Markdown di una pagina, ad esempio [https://doitong.com/developers/models/flux/schnell.md](https://doitong.com/developers/models/flux/schnell.md) o [https://doitong.com/developers/docs/quickstart.md](https://doitong.com/developers/docs/quickstart.md). |
| `/developers/models/<id>/llms.txt` | Uguale alla versione `.md` del modello. |
| [https://doitong.com/developers/openapi.json](https://doitong.com/developers/openapi.json) | OpenAPI 3.1 per i generatori di codice: ogni endpoint e i body delle richieste tipizzati dei modelli in evidenza; `?model=<id>`, `?category=<id>` o `?models=all` aggiungono gli altri. |
| `https://api.doitong.com/v1/models` | Il catalogo in formato JSON (non serve alcuna chiave). |

La pagina Markdown di ogni modello riporta il prezzo in USD e crediti API, ogni parametro con tutti i valori consentiti, un esempio con i soli parametri obbligatori e uno
completo, la struttura della risposta e codice pronto per cURL, JavaScript, Python e MCP.

## Copia per l'AI

Ogni pagina del modello ha un pulsante **Copia per l'AI**: copia la pagina come Markdown oppure aprila in ChatGPT o Claude con un
prompt che indirizza l'assistente alla versione Markdown.

## Un prompt efficace

Incollalo in Claude, ChatGPT o Cursor, quindi descrivi ciò che vuoi creare:

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

## Lasciare che l'agente chiami direttamente i modelli

Per consentire a un agente di generare direttamente contenuti multimediali, connetti il [server MCP](https://doitong.com/developers/docs/mcp) con una chiave che abbia un
budget in crediti API. L'agente avrà quindi strumenti per cercare modelli, ottenere preventivi, eseguirli e recuperare i risultati, senza poter spendere più del
budget.