# مستندات عامل‌های هوش مصنوعی

این مستندات طوری تهیه شده‌اند که هم دستیارهای هوش مصنوعی و هم افراد بتوانند آن‌ها را بخوانند. یکی از نقاط ورود زیر را به عامل خود بدهید تا بتواند بدون حدس‌زدن نام پارامترها یا قیمت‌ها، کد یکپارچه‌سازی صحیح بنویسد.

## نقاط ورود

| 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) | همه راهنماها به‌صورت کامل، مدل‌های منتخب به‌صورت کامل و اطلاعات ضروری همه ۱٬۴۹۶ مدل (شناسه، سازنده، قیمت، پیوند به صفحه کامل) در یک فایل 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.com/v1/models` | کاتالوگ به‌صورت JSON (نیازی به کلید نیست). |

صفحه Markdown هر مدل، قیمت آن را به USD و اعتبار API، هر پارامتر را همراه با همه مقادیر مجاز، یک نمونه فقط شامل موارد الزامی و یک نمونه کامل، شکل پاسخ و کد آماده برای curl، JavaScript، Python و MCP دارد.

## کپی برای هوش مصنوعی

هر صفحه مدل یک دکمه **Copy for AI** دارد: صفحه را به‌صورت Markdown کپی کنید یا آن را در ChatGPT یا Claude باز کنید و در یک پرامپت، دستیار را به نسخه Markdown هدایت کنید.

## پرامپتی که کار می‌کند

این متن را در Claude، ChatGPT یا Cursor جای‌گذاری کنید، سپس آنچه را می‌خواهید بسازید توضیح دهید:

```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 ۷ 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 دارد. سپس عامل ابزارهایی برای جست‌وجوی مدل‌ها، دریافت قیمت، اجرا و دریافت نتایج خواهد داشت و نمی‌تواند بیشتر از بودجه هزینه کند.