Messages

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

هدرها

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

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

modelstringالزامی
شناسهٔ مدل: homa
max_tokensintegerالزامی
سقف توکن خروجی؛ پیش‌فرض و حداکثر ۴٬۰۹۶. عدد بزرگ‌تر به ۴٬۰۹۶ کم می‌شود
حداکثر ۴٬۰۹۶
messagesobject[]الزامی
فیلدهای هر عضو messages
- rolestringالزامی
  مقدارها: "system""user""assistant""tool"
- contentstring | object[]الزامی
  متن پیام یا فهرست بخش‌ها
systemstring | object[]
دستور سیستمی
temperaturenumber
۰ تا ۱
streamboolean
پیش‌فرض: false
stop_sequencesstring[]
toolsobject[]
ابزارها با ساختار Anthropic

پاسخ `200`

پاسخ هما، با ساختار Anthropic

idstring
typestring
مقدار: "message"
rolestring
مقدار: "assistant"
modelstring
contentobject[]
stop_reasonstring
usageobject
فیلدهای usage
- input_tokensinteger
- output_tokensinteger

هدرهای پاسخ

x-dana-cold-startstring
1 وقتی هما پیش از این جواب در حافظه بارگذاری شد؛ چنین پاسخی چند ثانیه بیشتر طول کشیده است. در بقیهٔ پاسخ‌ها نمی‌آید.

خطاها

کد	یعنی
`400`	خطا با فرمت Anthropic؛ `type` و پیام، علت را می‌گویند
`401`	خطا با فرمت Anthropic؛ `type` و پیام، علت را می‌گویند
`429`	خطا با فرمت Anthropic؛ `type` و پیام، علت را می‌گویند
`503`	هما همین حالا در دسترس نیست؛ چند دقیقه بعد دوباره بفرستید

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

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

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

import os

import requests

r = requests.post(
    "https://api.dana.expert/v1/messages",
    headers={"Authorization": f"Bearer {os.environ['DANA_API_KEY']}"},
    json={
        "model": "homa",
        "max_tokens": 200,
        "messages": [
            {
                "role": "user",
                "content": "این جمله را رسمی‌تر بنویس: «فردا جلسه رو کنسل کن.»",
            },
        ],
    },
    timeout=60,
)
print(r.json())

const r = await fetch("https://api.dana.expert/v1/messages", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.DANA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "homa",
    "max_tokens": 200,
    "messages": [
      {
        "role": "user",
        "content": "این جمله را رسمی‌تر بنویس: «فردا جلسه رو کنسل کن.»"
      }
    ]
  }),
});
console.log(await r.json());

نمونهٔ پاسخ 200

{
  "id": "msg_123",
  "type": "message",
  "role": "assistant",
  "model": "homa",
  "content": [
    {
      "type": "text",
      "text": "جلسهٔ فردا لغو شود."
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 32,
    "output_tokens": 11
  }
}

نمونهٔ خطا 401

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

Messages

هدرها

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

پاسخ 200

هدرهای پاسخ

خطاها

پاسخ `200`