مستندات برای عامل‌های هوش مصنوعی
این مستندات طوری تهیه شده‌اند که هم دستیارهای هوش مصنوعی و هم افراد بتوانند آن‌ها را بخوانند. یکی از نقاط ورود زیر را به عامل خود بدهید تا بتواند بدون حدس‌زدن نام پارامترها یا قیمت‌ها، کد یکپارچه‌سازی صحیح بنویسد.
نقاط ورود
| URL | چیست |
|---|---|
| https://doitong.com/developers/llms.txt | نمایه در قالب llms.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/docs/quickstart.md. |
/developers/models/<id>/llms.txt |
همان نسخه .md مدل. |
| 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 جای‌گذاری کنید، سپس آنچه را می‌خواهید بسازید توضیح دهید:
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 را با کلیدی متصل کنید که بودجه‌ای بر اساس اعتبار API دارد. سپس عامل ابزارهایی برای جست‌وجوی مدل‌ها، دریافت قیمت، اجرا و دریافت نتایج خواهد داشت و نمی‌تواند بیشتر از بودجه هزینه کند.