فهرست مدل‌ها

هوشوانا به بیش از ۸۰ مدل از سازنده‌های مختلف دسترسی می‌دهد. فهرست مدل‌ها به‌مرور تغییر می‌کند: مدل‌های جدید اضافه می‌شوند و مدل‌های قدیمی ممکن است کنار گذاشته شوند. برای همین، به جای این‌که فهرست را در کد ثابت کنید، آن را از API بگیرید.

GET https://hooshvana.ir/api/v1/models

درخواست

curl https://hooshvana.ir/api/v1/models \
  -H "Authorization: Bearer $HOOSHVANA_API_KEY"

نمونه‌ی پاسخ

قالب پاسخ همان قالب فهرست مدل‌های OpenAI است:

{
  "object": "list",
  "data": [
    { "id": "openai/gpt-4o-mini", "object": "model", "owned_by": "openai" },
    { "id": "anthropic/claude-sonnet-4.6", "object": "model", "owned_by": "anthropic" },
    { "id": "google/gemini-2.5-flash", "object": "model", "owned_by": "google" },
    { "id": "deepseek/deepseek-v4-flash", "object": "model", "owned_by": "deepseek" },
    { "id": "openai/text-embedding-3-small", "object": "model", "owned_by": "openai" }
  ]
}

با SDK

import os
from openai import OpenAI

client = OpenAI(base_url="https://hooshvana.ir/api/v1", api_key=os.environ["HOOSHVANA_API_KEY"])

models = [m.id for m in client.models.list()]
print(len(models), "models")

anthropic_models = [m for m in models if m.startswith("anthropic/")]
print(anthropic_models)

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://hooshvana.ir/api/v1", apiKey: process.env.HOOSHVANA_API_KEY });

for await (const model of client.models.list()) {
  console.log(model.id);
}

شناسه‌ی مدل

شناسه‌ها به شکل vendor/model هستند. بخش اول نام سازنده و بخش دوم نام مدل است:

این شناسه‌ها فقط برای نمونه آمده‌اند. همیشه شناسه‌ی دقیق را از GET /models یا کاتالوگ مدل‌ها بردارید.

کاتالوگ مدل‌ها در سایت

کاتالوگ مدل‌ها اطلاعاتی بیشتر از API نشان می‌دهد: قیمت ورودی و خروجی به تومان، طول پنجره‌ی زمینه (context)، قابلیت‌ها (بینایی، فراخوانی ابزار، خروجی JSON، استدلال) و دسته‌بندی. می‌توانید مدل‌ها را بر اساس این دسته‌ها فیلتر کنید:

• محبوب: مدل‌های پراستفاده و همه‌منظوره
• کدنویسی: مناسب تولید و بازبینی کد و عامل‌های کدنویسی
• تولید محتوا: نوشتن، ترجمه و خلاصه‌سازی
• اقتصادی: کم‌هزینه برای حجم بالا
• بینایی: پذیرش تصویر به عنوان ورودی
• صدا: تبدیل متن به گفتار و گفتار به متن
• استدلال: مسائل چندمرحله‌ای، ریاضی و تحلیل

همین دسته‌ها به صورت گروه مدل هم در دسترس‌اند و می‌توانید کلید را به یک گروه محدود کنید.

چطور مدل انتخاب کنیم؟

یک روش عملی:

1. از یک مدل ارزان و سریع شروع کنید، مثلاً openai/gpt-4o-mini یا google/gemini-2.5-flash. برای بسیاری از کارها (دسته‌بندی، خلاصه، پاسخ به سوالات ساده، استخراج اطلاعات) کافی‌اند.
2. یک مجموعه‌ی آزمون کوچک بسازید: ۲۰ تا ۵۰ ورودی واقعی با پاسخ مطلوب. هر مدل را روی همین مجموعه بسنجید.
3. فقط اگر کیفیت کافی نبود، مدل قوی‌تر را امتحان کنید، مثل anthropic/claude-sonnet-4.6، openai/gpt-4.1 یا google/gemini-2.5-pro.
4. برای مسائل استدلالی سنگین (ریاضی، برنامه‌ریزی چندمرحله‌ای) مدل‌های استدلالی مثل deepseek/deepseek-r1-0528 را بسنجید. این مدل‌ها توکن خروجی بیشتری مصرف می‌کنند.
5. هزینه را برآورد کنید. راهنمای برآورد هزینه‌ی ماهانه در قیمت‌گذاری و صورتحساب آمده است.

چند معیار دیگر:

تغییر مدل بدون تغییر کد

دو راه برای تعویض مدل بدون استقرار دوباره‌ی کد:

• مدل پیش‌فرض کلید: فیلد model را در درخواست نفرستید و مدل را در قوانین کلید تعیین کنید.
• گروه مدل: در درخواست "model": "group:..." بفرستید تا مدل پیش‌فرض گروه استفاده شود.

خطاهای مرتبط

• model_not_found (HTTP ۴۰۴): شناسه اشتباه است یا مدل دیگر در دسترس نیست. املای شناسه را با GET /models مقایسه کنید.
• model_not_allowed (HTTP ۴۰۳): مدل وجود دارد ولی قوانین کلید یا حساب اجازه‌ی استفاده از آن را نمی‌دهد.

جزئیات بیشتر در خطاها و کدها.