پرش به محتوا
هوشی

مستندات API

مدل‌ها و شناسه‌ها

هر مدل در API هوشی یک شناسهٔ provider/model دارد. فهرست زیر مستقیم از کاتالوگ زندهٔ هوشی خوانده می‌شود و قیمت هر مدل را به تومان نشان می‌دهد.

ساختار شناسهٔ مدل

شناسهٔ هوشی از دو بخش تشکیل شده است: provider (نام پروایدر در هوشی) و model (شناسهٔ اصلی مدل نزد همان پروایدر). مثال‌ها:

شناسهٔ هوشیپروایدرشناسهٔ بالادستی (native_id)
openai/gpt-5.5OpenAIgpt-5.5
anthropic/claude-opus-5-5Anthropicclaude-opus-5-5
gemini/gemini-3.1-pro-previewGooglegemini-3.1-pro-preview
xai/grok-4.7xAIgrok-4.7
deepseek/deepseek-v4-proDeepSeekdeepseek-v4-pro
groq/openai/gpt-oss-120bGroqopenai/gpt-oss-120b

گوگل = gemini

اسلاگ پروایدر گوگل در هوشی gemini است، نه google؛ پس شناسه‌ها به شکل gemini/gemini-3.8-flash هستند و API بومی آن هم روی /gemini قرار دارد.

ترتیب تطبیق شناسه

  1. تطبیق دقیق با شناسهٔ هوشی (provider/model)؛
  2. تطبیق با شناسهٔ بالادستی (مثلاً gpt-5.5)؛ اگر چند پروایدر مدلی با همین نام داشته باشند، اولین مورد در ترتیب کاتالوگ انتخاب می‌شود؛
  3. تطبیق با نام‌های مستعار (alias) تعریف‌شده برای مدل.

تطبیق همیشه با نوع endpoint محدود می‌شود: در /v1/chat/completions فقط مدل‌های گفتگو، در /v1/embeddings فقط مدل‌های embedding و… . در API بومی از شناسهٔ بالادستی (بدون پیشوند) استفاده کن، چون SDK رسمی همان را می‌فرستد.

فهرست زندهٔ مدل‌ها و قیمت‌ها

قیمت‌ها به تومان هستند. برای مدل‌های متنی، قیمت هر ۱ میلیون توکن ورودی و خروجی آمده است؛ مدل‌های صوتی و تصویری بر اساس واحد خودشان (هر ۱۰۰۰ کاراکتر، هر دقیقه، هر ثانیه یا هر تصویر) محاسبه می‌شوند. نحوهٔ محاسبه در صورتحساب.

دریافت فهرست با API

GEThttps://api.hooshi.ai/v1/models
بدون نیاز به کلید
from openai import OpenAI

client = OpenAI(base_url="https://api.hooshi.ai/v1", api_key="hk-...")
for m in client.models.list():
    print(m.id, m.model_extra.get("type"), m.model_extra.get("pricing"))

هر آیتم فیلدهای استاندارد OpenAI را به‌علاوهٔ اطلاعات اضافهٔ هوشی دارد:

JSON
{
  "object": "list",
  "data": [
    {
      "id": "anthropic/claude-opus-5-5",
      "object": "model",
      "created": 1789000000,
      "owned_by": "anthropic",
      "name": "Claude Opus 5.5",
      "type": "chat",
      "context_window": 1000000,
      "max_output_tokens": 128000,
      "capabilities": ["vision", "tools", "reasoning", "web_search", "file_input", "flagship"],
      "pricing": { "currency": "IRT", "unit": "1M_tokens", "input": 621000, "output": 3105000, "cached_input": 31050 },
      "native_id": "claude-opus-5-5"
    }
  ]
}
فیلدتوضیح
typeیکی از chat، embedding، image، tts، stt، video، sound.
capabilitiesvision (ورودی تصویر)، tools، reasoning، web_search، file_input (PDF)، flagship (پرچم‌دار).
pricing.unit1M_tokens، 1K_chars، minute، second یا image.
pricing.input / outputقیمت تومانی هر واحد؛ برای مدل‌های غیرتوکنی output برابر null است.
pricing.cached_inputقیمت توکن‌های ورودی که از کش پرامپت پروایدر خوانده می‌شوند (معمولاً خیلی ارزان‌تر).
native_idشناسهٔ بالادستی برای استفاده در API بومی.

برای یک مدل خاص هم GET /v1/models/{id} را صدا بزن (مثلاً /v1/models/openai/gpt-5.5)؛ پاسخ شامل id، object، created و owned_by است.

کدام مدل را انتخاب کنم؟

کاربردپیشنهاد
کدنویسی، ایجنت و متن‌های طولانیanthropic/claude-opus-5-5 یا anthropic/claude-sonnet-5-5
دستیار عمومی و چندزبانهopenai/gpt-5.5
حجم بالا با هزینهٔ کمopenai/gpt-6-luna، anthropic/claude-haiku-5-5، gemini/gemini-3.5-flash-lite
اسناد حجیم و چندرسانه‌ایgemini/gemini-3.1-pro-preview
اقتصادی با استدلال خوبdeepseek/deepseek-v4-pro
جستجوی وب با منبعperplexity/sonar-pro یا Claude با web_search: true

برای مقایسهٔ عملی، همین مدل‌ها را در پنل چت هوشی کنار هم امتحان کن یا صفحهٔ همهٔ مدل‌ها را ببین.