هما، گفت‌وگو

هما مدل گفت‌وگوی فارسی دانا است: مدلی کوچک، با حدود ۲ میلیارد پارامتر، که برای گفت‌وگو به فارسی ساخته شده است. برای کارهای کوتاه و روزمره مناسب است، مثل بازنویسی رسمی یا خودمانی یک متن، خلاصهٔ کوتاه، پیش‌نویس پیام و جواب به پرسش‌های ساده.

مدل کوچکی است و ممکن است با اطمینان جواب نادرست بدهد. برای دانستنی‌هایی که باید درست باشند، محاسبهٔ دقیق، کد و استدلال طولانی به آن تکیه نکنید و خروجی را پیش از استفاده بررسی کنید.

POST https://api.dana.expert/v1/chat/completions
POST https://api.dana.expert/v1/messages

هر دو مسیر با "model": "homa" به هما می‌رسند. اولی سازگار با OpenAI است و دومی سازگار با Anthropic، و هر دو استریم دارند.

نمونه

curl https://api.dana.expert/v1/chat/completions \
  -H "Authorization: Bearer $DANA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "homa",
    "messages": [{"role": "user", "content": "این جمله را رسمی‌تر بنویس: «فردا جلسه رو کنسل کن.»"}],
    "max_tokens": 200
  }'

import os

from openai import OpenAI

client = OpenAI(base_url="https://api.dana.expert/v1", api_key=os.environ["DANA_API_KEY"])

r = client.chat.completions.create(
    model="homa",
    messages=[{"role": "user", "content": "این جمله را رسمی‌تر بنویس: «فردا جلسه رو کنسل کن.»"}],
    max_tokens=200,
)
print(r.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.dana.expert/v1",
  apiKey: process.env.DANA_API_KEY,
});

const r = await client.chat.completions.create({
  model: "homa",
  messages: [{ role: "user", content: "این جمله را رسمی‌تر بنویس: «فردا جلسه رو کنسل کن.»" }],
  max_tokens: 200,
});
console.log(r.choices[0].message.content);

پاسخ، با فیلدهای اصلی:

{
  "object": "chat.completion",
  "model": "homa",
  "choices": [
    {"index": 0, "message": {"role": "assistant", "content": "جلسهٔ فردا لغو شود."}, "finish_reason": "stop"}
  ],
  "usage": {"prompt_tokens": 32, "completion_tokens": 11, "total_tokens": 43}
}

با anthropic SDK هم همین کار را می‌کنید: base_url را https://api.dana.expert بگذارید، بدون /v1، و model="homa" بفرستید. جزئیات دو رابط در Chat Completions و Messages است.

پارامترهای مهم

اعتبار به اندازهٔ ورودی به‌علاوهٔ max_tokens رزرو می‌شود و بعد از پاسخ، باقی‌اش برمی‌گردد. عددی بگذارید که واقعا لازم دارید (قیمت و توکن).

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

• فقط متن: ورودی و خروجی متنی است.
• خروجی هر پاسخ تا ۴٬۰۹۶ توکن است و ورودی و خروجی هر درخواست روی هم تا ۸٬۱۹۲ توکن جا می‌گیرد. گفت‌وگوی بلندتر را کوتاه یا خلاصه کنید.
• هر یک میلیون توکن ورودی ۱۰٬۰۰۰ تومان و هر یک میلیون توکن خروجی ۴۰٬۰۰۰ تومان است (قیمت و توکن).
• سقف درخواست همان سقف کلید است (محدودیت‌ها).
• هما وقتی مدتی استفاده نشود از حافظه خارج می‌شود؛ اولین درخواست بعد از آن چند ثانیه بیشتر طول می‌کشد.

خطاها

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