ترجمه

POSThttps://api.dana.expert/v1/translate

هدرها

Authorizationstringالزامی
کلید API از کنسول دانا: Authorization: Bearer dn-live-...
x-api-keystring
همان کلید، به‌جای هدر Authorization
Content-Typestringالزامی
مقدار: "application/json"

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

textstringالزامی
متن انگلیسی
۱ تا ۲۰٬۰۰۰ کاراکتر
directionstring
جهت ترجمه؛ فعلا فقط en-fa
مقدار: "en-fa"پیش‌فرض: "en-fa"
registerstring
لحن ترجمه: formal با «شما»، informal با «تو»، auto از روی خود متن
مقدارها: "auto""formal""informal"پیش‌فرض: "auto"

پاسخ `200`

ترجمهٔ فارسی

textstringالزامی
ترجمهٔ فارسی
registerstringالزامی
لحنی که به کار رفت
مقدارها: "auto""formal""informal"
modelstringالزامی
همیشه dana-translator
مقدار: "dana-translator"
model_versionstringالزامی
نسخهٔ مترجمی که جواب داد، مثل hodhod-v2.3
fallbackbooleanالزامی
true یعنی بخشی از متن انگلیسی ماند
usageobjectالزامی
توکن‌های همین درخواست
فیلدهای usage
- prompt_tokensintegerالزامی
  توکن‌های ورودی
- completion_tokensintegerالزامی
  توکن‌های خروجی
- total_tokensintegerالزامی
  جمع دو عدد بالا

خطاها

کد	یعنی
`400`	بدنهٔ درخواست درست نیست؛ پیام می‌گوید کدام فیلد
`401`	کلید نرسید یا شناخته نشد
`429`	سقف درخواست، ظرفیت یا اعتبار؛ `type` و `code` علت را می‌گویند
`503`	مدل همین حالا در دسترس نیست (`model_unavailable`)؛ چند دقیقه بعد دوباره بفرستید

همهٔ کدها، علت و راه‌حل هرکدام در خطاها آمده است.

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

curl -X POST 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"
  }'

import os

import requests

r = requests.post(
    "https://api.dana.expert/v1/translate",
    headers={"Authorization": f"Bearer {os.environ['DANA_API_KEY']}"},
    json={
        "text": "The meeting moved to Tuesday.",
        "register": "auto",
    },
    timeout=60,
)
print(r.json())

const r = await fetch("https://api.dana.expert/v1/translate", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.DANA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "text": "The meeting moved to Tuesday.",
    "register": "auto"
  }),
});
console.log(await r.json());

نمونهٔ پاسخ 200

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

نمونهٔ خطا 401

{
  "error": {
    "message": "Invalid API key.",
    "type": "authentication_error",
    "param": null,
    "code": null
  }
}

ترجمه

هدرها

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

پاسخ 200

خطاها

پاسخ `200`