# Dana API docs (مستندات دانا)

> API فارسی دانا: ترجمهٔ انگلیسی به فارسی با هدهد (`POST /v1/translate`)، تصمیم‌های بسته روی متن فارسی با سنجه (`POST /v1/decide`) و گفت‌وگو به فارسی با هما (`POST /v1/chat/completions` و `POST /v1/messages`، مدل `homa`). آدرس پایه: https://api.dana.expert

همهٔ مستندات در یک فایل: https://dana.expert/llms-full.txt

## راهنما: شروع

- [معرفی](https://dana.expert/docs/index.md): API فارسی دانا برای ترجمه، تصمیم و گفت‌وگو، با یک کلید و یک آدرس
- [شروع سریع](https://dana.expert/docs/quickstart.md): نخستین درخواست به هدهد و سنجه با نمونه‌های curl، Python و Node.js
- [مدل‌ها](https://dana.expert/docs/models.md): مدل‌های API دانا، نسخهٔ فعلی و وضعیت دسترسی هر مدل

## راهنما: هدهد، ترجمه

- [هدهد، مترجم](https://dana.expert/docs/translate.md): ترجمهٔ انگلیسی به فارسی با هدهد: درخواست، لحن، پاسخ و هزینه

## راهنما: سنجه، تصمیم

- [سنجه، مدل‌های تصمیم](https://dana.expert/docs/decide.md): تصمیم‌های بسته روی متن فارسی با سنجه: مدل‌ها، سه نوع پرسش، نمونه و محدودیت‌ها

## راهنما: هما، گفت‌وگو

- [هما، گفت‌وگو](https://dana.expert/docs/homa.md): گفت‌وگوی فارسی با هما: کاربرد، نمونه، پارامترهای مهم و محدودیت‌ها
- [Chat Completions](https://dana.expert/docs/chat-completions.md): رابط سازگار با OpenAI دانا: پارامترها، streaming، هدرها و ساختار پاسخ
- [Messages](https://dana.expert/docs/messages.md): رابط سازگار با Anthropic دانا برای ارسال پیام، tool calling و شمارش توکن

## راهنما: حساب و هزینه

- [حساب و کلید API](https://dana.expert/docs/authentication.md): ساخت حساب، شارژ اعتبار، ساخت کلید و فرستادن آن با هر درخواست
- [قیمت و توکن](https://dana.expert/docs/pricing-and-tokens.md): توکن در دانا چطور شمرده می‌شود، اعتبار کی کسر می‌شود و مصرف را کجا ببینید
- [محدودیت‌ها](https://dana.expert/docs/rate-limits.md): سقف نرخ درخواست API دانا، هدرهای پاسخ و روش درست مدیریت خطای ۴۲۹
- [خطاها](https://dana.expert/docs/errors.md): هر کد خطای API دانا، علتش و کاری که باید بکنید، با نمونهٔ فرمت خطا

## مرجع API

- [مرجع API](https://dana.expert/docs/api-reference.md): همهٔ مسیرهای API دانا با بدنهٔ درخواست، پاسخ و خطاها

## مرجع API: هدهد، ترجمه

- [ترجمه](https://dana.expert/docs/api-reference/translate.md): متن انگلیسی را با هدهد به فارسی برمی‌گرداند. بلوک‌های کد دست نمی‌خورند. اگر بخشی درست ترجمه نشود، انگلیسی می‌ماند و `fallback` برابر `true` می‌شود.

## مرجع API: سنجه، تصمیم

- [تصمیم با سنجه](https://dana.expert/docs/api-reference/decide.md): یک متن یا دادهٔ JSON و چند پرسش بسته می‌گیرد و برای هر پرسش جواب و احتمال گزینه‌ها را برمی‌گرداند. سه نوع پرسش دارد: `choice`، `noul` و `score`.

## مرجع API: مدل‌ها

- [فهرست مدل‌ها](https://dana.expert/docs/api-reference/list-models.md): فهرست مدل‌های فعلی را با نسخه، مسیر و وضعیت هر مدل می‌دهد. شناسه‌هایی که هنوز باز نیستند وضعیت `coming_soon` دارند.

## مرجع API: هما، گفت‌وگو

- [Chat Completions](https://dana.expert/docs/api-reference/chat-completions.md): رابط سازگار با OpenAI برای گفت‌وگو با هما (`"model": "homa"`). خروجی هر پاسخ تا ۴٬۰۹۶ توکن است و ورودی و خروجی روی هم تا ۸٬۱۹۲ توکن.
- [Messages](https://dana.expert/docs/api-reference/messages.md): رابط سازگار با Anthropic برای گفت‌وگو با هما (`"model": "homa"`). خروجی هر پاسخ تا ۴٬۰۹۶ توکن است. خطاهای این مسیر فرمت Anthropic دارند.
- [شمارش توکن](https://dana.expert/docs/api-reference/count-tokens.md): تعداد توکن ورودی یک درخواست Messages را پیش از ارسال می‌شمارد.