AiFO مستندات AiFO
قیمت
Input: 1 USD · Output: 5 USD · per_1m_tokens
Context
نامشخص
Endpoint
POST /v1/chat/completions

کاربردها

  • تولید پاسخ‌های متنی بر اساس ورودی‌های تصویری و متنی
  • استفاده در برنامه‌های چت‌بات برای تعاملات هوشمند
  • تحلیل و تفسیر تصاویر برای تولید توضیحات متنی
  • پشتیبانی از سیستم‌های آموزشی با تولید محتوای متنی خودکار

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

# Required: model, messages (text + optional image_url)
# Optional gateway parameters:
# temperature: optional, default: 1
# max_tokens: optional, default: 1024
# top_p: optional, default: 1
# frequency_penalty: optional, default: 0
# presence_penalty: optional, default: 0
# image_url in messages: optional (multimodal input)
curl https://api.haftominhonar.ir/v1/chat/completions \
  -H "Authorization: Bearer aifo_sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"anthropic/claude-haiku-4.5","messages":[{"role":"user","content":[{"type":"text","text":"لطفاً تصویری از یک منظره پاییزی ارسال کنید و بپرسید: \"این منظره چه احساسی را در شما ایجاد می‌کند؟\""},{"type":"image_url","image_url":{"url":"https://example.com/image.jpg"}}]}],"temperature":1,"max_tokens":1024,"top_p":1,"frequency_penalty":0,"presence_penalty":0}'
import requests

url = "https://api.haftominhonar.ir/v1/chat/completions"
headers = {
    "Authorization": "Bearer aifo_sk_live_YOUR_API_KEY",
    "Content-Type": "application/json",
}
# Required: model, messages
payload = {
  "model": "anthropic/claude-haiku-4.5",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "لطفاً تصویری از یک منظره پاییزی ارسال کنید و بپرسید: \"این منظره چه احساسی را در شما ایجاد می‌کند؟\""
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/image.jpg"
          }
        }
      ]
    }
  ],
  "temperature": 1,
  "max_tokens": 1024,
  "top_p": 1,
  "frequency_penalty": 0,
  "presence_penalty": 0
}


# Optional gateway parameters:
# temperature: optional, default: 1
# max_tokens: optional, default: 1024
# top_p: optional, default: 1
# frequency_penalty: optional, default: 0
# presence_penalty: optional, default: 0
# image_url in messages: optional (multimodal input)

response = requests.post(url, headers=headers, json=payload)
print(response.json())
// Required: model, messages
const response = await fetch("https://api.haftominhonar.ir/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer aifo_sk_live_YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "anthropic/claude-haiku-4.5",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "لطفاً تصویری از یک منظره پاییزی ارسال کنید و بپرسید: \"این منظره چه احساسی را در شما ایجاد می‌کند؟\""
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/image.jpg"
          }
        }
      ]
    }
  ],
  "temperature": 1,
  "max_tokens": 1024,
  "top_p": 1,
  "frequency_penalty": 0,
  "presence_penalty": 0
}),
});


# Optional gateway parameters:
# temperature: optional, default: 1
# max_tokens: optional, default: 1024
# top_p: optional, default: 1
# frequency_penalty: optional, default: 0
# presence_penalty: optional, default: 0
# image_url in messages: optional (multimodal input)

const data = await response.json();
console.log(data);
import axios from "axios";

// Required: model, messages
const { data } = await axios.post(
  "https://api.haftominhonar.ir/v1/chat/completions",
  {
  "model": "anthropic/claude-haiku-4.5",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "لطفاً تصویری از یک منظره پاییزی ارسال کنید و بپرسید: \"این منظره چه احساسی را در شما ایجاد می‌کند؟\""
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/image.jpg"
          }
        }
      ]
    }
  ],
  "temperature": 1,
  "max_tokens": 1024,
  "top_p": 1,
  "frequency_penalty": 0,
  "presence_penalty": 0
},
  {
    headers: {
      Authorization: "Bearer aifo_sk_live_YOUR_API_KEY",
      "Content-Type": "application/json",
    },
  },
);


# Optional gateway parameters:
# temperature: optional, default: 1
# max_tokens: optional, default: 1024
# top_p: optional, default: 1
# frequency_penalty: optional, default: 0
# presence_penalty: optional, default: 0
# image_url in messages: optional (multimodal input)

console.log(data);

پارامترها

ورودی‌ها — متن/تصویر

پارامترها

نام نوع الزامی/اختیاری پیش‌فرض توضیح
temperature عدد اختیاری 1 کنترل خلاقیت مدل
max_tokens عدد اختیاری 1024 حداکثر تعداد توکن‌های خروجی
top_p عدد اختیاری 1 نمونه‌گیری از توزیع توکن‌ها
frequency_penalty عدد اختیاری 0 کاهش تکرار توکن‌ها
presence_penalty عدد اختیاری 0 تشویق به استفاده از توکن‌های جدید

فیلدهای الزامی در بدنه درخواست

  • model
  • messages

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

  • قیمت‌گذاری بر اساس تعداد توکن‌های ورودی و خروجی
  • پشتیبانی از ورودی‌های صوتی وجود ندارد
  • محدودیت در تعداد توکن‌های خروجی به 1024 توکن

FAQ

چگونه می‌توانم از API استفاده کنم؟

برای استفاده از API، باید درخواست‌های خود را به آدرس https://api.example.com/v1/chat/completions ارسال کنید و فیلدهای الزامی را در بدنه درخواست قرار دهید.

هزینه استفاده از API چگونه محاسبه می‌شود؟

هزینه بر اساس تعداد توکن‌های ورودی و خروجی محاسبه می‌شود؛ 1 دلار برای هر یک میلیون توکن ورودی و 5 دلار برای هر یک میلیون توکن خروجی.

مدل‌های مرتبط