# معرفی

> API فارسی دانا برای ترجمه، تصمیم و گفت‌وگو، با یک کلید و یک آدرس

URL: https://dana.expert/docs

دانا API هوش مصنوعی فارسی است. سه کار را از راه API انجام می‌دهد: ترجمهٔ انگلیسی به فارسی با **هدهد**، تصمیم‌های بسته روی متن فارسی با **سنجه** و گفت‌وگو به فارسی با **هما**.

- **هدهد** (مترجم انگلیسی به فارسی): متن عادی، فنی یا Markdown؛ لحن رسمی یا خودمانی. [راهنما](https://dana.expert/docs/translate)، [مرجع API](https://dana.expert/docs/api-reference/translate)
- **سنجه** (مدل‌های تصمیم، سیستم ۱): قناری، کبوتر، شاهین (به‌زودی). [راهنما](https://dana.expert/docs/decide)، [مرجع API](https://dana.expert/docs/api-reference/decide)
- **هما** (مدل‌های زبانی فارسی): برای گفت‌وگو و پاسخ به پرسش، با رابط‌های سازگار با OpenAI و Anthropic. [راهنما](https://dana.expert/docs/homa)، [مرجع API](https://dana.expert/docs/api-reference/chat-completions)

برای نخستین درخواست، [شروع سریع](https://dana.expert/docs/quickstart) را ببینید: کلید بسازید و در سه قدم نخستین ترجمه را بگیرید.

## آدرس پایه

```
https://api.dana.expert/v1
```

یک کلید برای همهٔ مسیرها کافی است. کلید را از [کنسول دانا](https://console.dana.expert/keys) بسازید و در هدر `Authorization: Bearer ...` بفرستید ([حساب و کلید API](https://dana.expert/docs/authentication)).

## امروز چه در دسترس است

| سرویس | مسیر | شناسهٔ مدل | وضعیت |
|---|---|---|---|
| هدهد، مترجم | `POST /v1/translate` | `dana-translator` (نسخهٔ `hodhod-v2.3`) | در دسترس |
| سنجه: قناری و کبوتر | `POST /v1/decide` | `ghanari` و `kabootar` | در دسترس |
| هما، گفت‌وگو | `POST /v1/chat/completions` و `POST /v1/messages` | `homa` | در دسترس |

نسخهٔ مدلی که جواب داده در فیلد `model_version` هر پاسخ می‌آید؛ جدول کامل در [مدل‌ها](https://dana.expert/docs/models) است.

## از کجا شروع کنم

- تازه‌کارید؟ [شروع سریع](https://dana.expert/docs/quickstart) در سه قدم به نخستین ترجمه می‌رساندتان.
- دنبال فیلدهای دقیق یک مسیرید؟ [مرجع API](https://dana.expert/docs/api-reference) هر مسیر را با بدنهٔ درخواست، پاسخ و خطاها دارد.
- خطا گرفته‌اید؟ [خطاها](https://dana.expert/docs/errors) هر کد را با علت و راه‌حلش دارد.
- `429` می‌گیرید؟ [محدودیت‌ها](https://dana.expert/docs/rate-limits) علت‌ها را از هم جدا می‌کند.

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

هر صفحه نسخهٔ Markdown دارد. دکمهٔ «کپی صفحه» بالای هر صفحه متن آن را کپی می‌کند و از منوی کنارش می‌شود همان صفحه یا همهٔ مستندات را در یک فایل `.md` گرفت. فهرست صفحه‌ها در [`/llms.txt`](https://dana.expert/llms.txt) و متن کامل در [`/llms-full.txt`](https://dana.expert/llms-full.txt) است.