هدهد، مترجم

POST /v1/translate متن انگلیسی را با مترجم هدهد (نسخهٔ فعلی v2.3) به فارسی روان برمی‌گرداند. بلوک‌های کد اصلا به مدل داده نمی‌شوند و همان‌طور برمی‌گردند. مدل برای دست نزدن به کد اینلاین، عدد، لینک و اصطلاح فنی آموزش دیده و خروجی‌اش برای کد اینلاین بررسی می‌شود، ولی بی‌خطا نیست. بخشی که درست ترجمه نشود انگلیسی می‌ماند و fallback در پاسخ true می‌شود.

در آزمون خود مدل روی ۱۲۰ متن، ۱۶ متن دست‌کم یک خطا داشتند؛ حذف کد هم ثبت شده است. این سنجش با رفتار محافظتی API فرق دارد. خروجی نهایی را پیش از استفاده بررسی کنید.

POST https://api.dana.expert/v1/translate

نمونه

curl https://api.dana.expert/v1/translate \
  -H "Authorization: Bearer $DANA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "The meeting moved to Tuesday.", "register": "auto"}'

پاسخ:

{
  "text": "جلسه به روز سه‌شنبه موکول شد.",
  "register": "formal",
  "model": "dana-translator",
  "model_version": "hodhod-v2.3",
  "fallback": false,
  "usage": {"prompt_tokens": 6, "completion_tokens": 22, "total_tokens": 28}
}

بدنهٔ درخواست

لحن

• formal: رسمی، با «شما».
• informal: خودمانی، با «تو».
• auto: لحن را از خود متن تشخیص می‌دهد و اگر مطمئن نباشد رسمی می‌نویسد.

پاسخ

هزینه و محدودیت

توکن‌های متن ورودی و ترجمه از اعتبار کم می‌شوند: هر یک میلیون توکن ورودی ۱۰٬۰۰۰ تومان و خروجی ۴۰٬۰۰۰ تومان (قیمت و توکن). سقف درخواست همان سقف کلید است (محدودیت‌ها). متن شما و ترجمه‌اش جایی ذخیره نمی‌شوند؛ فقط تعداد توکن‌ها ثبت می‌شود.

خطاها

شرح کامل هر کد در خطاها است. فیلدها و نمونه‌ها به شکل قرارداد در مرجع API هم آمده‌اند.