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

سازگار با OpenAI · پرداخت تومانی

API هوش مصنوعی برای برنامه‌نویسان

API چت جی پی تی، API کلاد، جمنای، گروک و ۸۰+ مدل دیگر با یک کلید. همان SDK رسمی OpenAI یا Anthropic؛ فقط base_url را عوض کن. OpenAI API در ایران، بدون فیلترشکن و کارت ارزی.

ساخت کلید API مستندات
مدل
۸۰+
مدل
پروایدر
۱۸
پروایدر
تغییر کد
۱ خط
تغییر کد
from openai import OpenAI

client = OpenAI(base_url="https://api.hooshi.ai/v1", api_key="hk-...")

# یک API، هر مدلی
for model in ["openai/gpt-5.5", "anthropic/claude-opus-5-5",
              "gemini/gemini-3.1-pro-preview", "xai/grok-4.7"]:
    r = client.chat.completions.create(
        model=model,
        messages=[{"role": "user", "content": "در یک جمله خودت را معرفی کن"}],
    )
    print(model, "→", r.choices[0].message.content)
    print("   هزینه:", r.model_extra["hooshi"]["cost"], "تومان")

چرا API هوشی

همهٔ هوش‌های دنیا، پشت یک endpoint

به‌جای چند حساب خارجی، چند صورتحساب دلاری و چند SDK، با یک کلید و یک کیف پول تومانی کار کن.

یک API، ۸۰+ مدل

GPT-5.5، Claude Opus 5.5، Gemini 3.1 Pro، Grok 4.7، DeepSeek V4، Kimi، Qwen و… فقط با عوض کردن model.

SDKهای رسمی بدون تغییر

OpenAI، Anthropic، Google GenAI و ElevenLabs؛ فقط base_url و کلید عوض می‌شود.

از ایران، بدون فیلترشکن

سرورهای پایدار با failover خودکار بین چند مسیر بالادستی.

پرداخت تومانی

کیف پول API با درگاه بانکی ایرانی؛ بدون کارت ارزی و حداقل ماهانه.

هزینهٔ شفاف هر درخواست

قیمت هر ۱ میلیون توکن به تومان و هزینهٔ دقیق در فیلد hooshi.cost پاسخ.

کنترل کامل کلیدها

سقف نرخ، سقف هزینه، IP مجاز، مدل مجاز و تاریخ انقضا برای هر کلید.

دو سبک، یک کلید

API یکپارچه یا API بومی؟

هر دو با همان کلید hk و همان کیف پول کار می‌کنند. هر جا لازم بود، ترکیبشان کن.

API یکپارچه

پیشنهادی

یک API سازگار با OpenAI روی https://api.hooshi.ai/v1. مدل را با provider/model انتخاب کن؛ هوشی Tool Calling، تصویر و استریم را برای هر پروایدر ترجمه می‌کند و هزینهٔ هر درخواست را در پاسخ برمی‌گرداند.

مرجع API یکپارچه 
# pip install openai
from openai import OpenAI

client = OpenAI(
    base_url="https://api.hooshi.ai/v1",
    api_key="hk-...",  # کلید هوشی از /console
)

resp = client.chat.completions.create(
    model="anthropic/claude-sonnet-5-5",  # یا openai/gpt-5.5 ، xai/grok-4.7 ، ...
    messages=[
        {"role": "system", "content": "تو یک دستیار برنامه‌نویسی دقیق هستی."},
        {"role": "user", "content": "یک تابع پایتون برای تبدیل اعداد به حروف فارسی بنویس."},
    ],
)

print(resp.choices[0].message.content)
print("هزینه:", resp.model_extra["hooshi"]["cost"], "تومان")

API بومی پروایدرها

مسیرهای اصلی هر پروایدر، ۱:۱: /openai/v1، /anthropic، /gemini، /elevenlabs و… . برای Claude Code، Responses API، قابلیت‌های beta و هر ابزاری که SDK بومی می‌خواهد.

راهنمای API بومی 
# pip install anthropic
import anthropic

client = anthropic.Anthropic(
    base_url="https://api.hooshi.ai/anthropic",
    api_key="hk-...",  # همان کلید هوشی؛ در هدر x-api-key ارسال می‌شود
)

message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "مفهوم Big-O را با یک مثال ساده توضیح بده."}],
)
print(message.content[0].text)

شروع سریع

در سه قدم، اولین درخواست

  1. ۱

    کلید بساز

    در کنسول توسعه‌دهندگان یک کلید hk- بساز و محدودیت‌هایش را تنظیم کن.

    رفتن به کنسول
  2. ۲

    کیف پول را شارژ کن

    کیف پول API را با کارت بانکی شارژ کن؛ فقط به اندازهٔ مصرف کسر می‌شود.

    نحوهٔ محاسبه
  3. ۳

    base_url را عوض کن

    در SDK فعلی‌ات base_url را https://api.hooshi.ai/v1 بگذار و model را انتخاب کن.

    شروع سریع

قیمت API

پرداخت به ازای مصرف، به تومان

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

مثال: ۲٬۰۰۰ توکن ورودی و ۵۰۰ توکن خروجی با مدلی به قیمت ۳۰۰ هزار / ۱.۵ میلیون تومان ≈ ۱٬۳۵۰ تومان.

شفاف: هزینهٔ دقیق هر درخواست در فیلد hooshi.cost پاسخ برمی‌گردد.

قابل کنترل: سقف هزینهٔ ماهانه برای هر کلید و گزارش روزانهٔ مصرف.

قابلیت‌ها

هر چیزی که برای محصول واقعی لازم داری

استریم SSE

قالب استاندارد chunkهای OpenAI با stream_options.include_usage.

Tool / Function Calling

یک تعریف ابزار برای GPT، Claude، Gemini و Grok.

Vision

ارسال تصویر با image_url یا base64 و PDF برای مدل‌های پشتیبان.

JSON Schema

خروجی ساختاریافته با response_format، حتی برای Claude.

reasoning_effort

کنترل عمق تفکر مدل‌های استدلالی با یک پارامتر یکسان.

Embeddings

OpenAI text-embedding-3 و Gemini Embedding برای RAG و جستجو.

ساخت تصویر

GPT Image 2، FLUX، Stable Image، Gemini Image و Grok Imagine.

متن به صدا و صدا به متن

OpenAI TTS، ElevenLabs v4، Whisper و Scribe با فارسی عالی.

محدودیت نرخ هر کلید

هدرهای X-RateLimit و Retry-After استاندارد.

سقف هزینهٔ ماهانه

هیچ‌وقت بیشتر از بودجه‌ای که تعیین کرده‌ای خرج نمی‌شود.

IP مجاز و مدل مجاز

کلید لورفته بیرون از سرورهای تو بی‌استفاده است.

داشبورد مصرف

گزارش روزانه به تفکیک مدل در کنسول و /v1/usage.

تضمین هویت مدل

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

Failover خودکار

تلاش مجدد بی‌صدا روی مسیر بعدی در خطاهای موقت پروایدر.

مشخصات کامل در مستندات API و فایل openapi.json.

سوالات متداول

سوالات رایج دربارهٔ API هوش مصنوعی هوشی

API هوشی چیست و چه فرقی با OpenAI API دارد؟

+

API هوشی یک درگاه واحد به بیش از ۸۰ مدل هوش مصنوعی از OpenAI، Anthropic، Google، xAI، DeepSeek و… است. قرارداد آن کاملاً سازگار با OpenAI API است؛ یعنی همان SDK و همان کد کار می‌کند، با این تفاوت که از ایران بدون فیلترشکن در دسترس است، پرداخت تومانی دارد و با تغییر فیلد model به همهٔ مدل‌ها دسترسی داری.

آیا می‌توانم از OpenAI API در ایران استفاده کنم؟

+

بله. با API هوشی کافی است در SDK رسمی OpenAI مقدار base_url را https://api.hooshi.ai/v1 (یا برای API بومی https://api.hooshi.ai/openai/v1) بگذاری و کلید hk هوشی را وارد کنی. نیازی به کارت ارزی، شماره مجازی یا فیلترشکن نیست و هزینه از کیف پول تومانی کسر می‌شود.

API کلاد (Claude) را چطور با SDK رسمی Anthropic استفاده کنم؟

+

در SDK پایتون یا TypeScript شرکت Anthropic مقدار base_url را https://api.hooshi.ai/anthropic بگذار و کلید هوشی را به‌عنوان api_key بده. همهٔ قابلیت‌ها از جمله استریم، ابزارها و تفکر تطبیقی کار می‌کنند. Claude Code هم با متغیر ANTHROPIC_BASE_URL به هوشی وصل می‌شود.

قیمت API هوش مصنوعی هوشی چطور محاسبه می‌شود؟

+

پرداخت به ازای مصرف است: برای مدل‌های متنی قیمت هر یک میلیون توکن ورودی و خروجی به تومان مشخص است و فقط توکن‌های واقعاً مصرف‌شده از کیف پول API کسر می‌شود. هزینهٔ هر درخواست در فیلد hooshi.cost پاسخ برمی‌گردد و گزارش کامل در کنسول و endpoint مصرف در دسترس است.

آیا اشتراک ماهانهٔ چت هوشی شامل API هم می‌شود؟

+

خیر. API یک کیف پول جداگانه دارد که مستقل از پلن‌های ماهانهٔ پنل چت شارژ می‌شود. این جداسازی باعث می‌شود هزینهٔ محصول نرم‌افزاری تو شفاف و قابل‌کنترل باشد و مصرف API هیچ‌وقت اعتبار چت شخصی‌ات را کم نکند.

امنیت کلیدها و کنترل هزینه چطور است؟

+

برای هر کلید می‌توانی محدودیت نرخ (تا ۳۰۰۰ درخواست در دقیقه)، سقف هزینهٔ ماهانه به تومان، فهرست IPهای مجاز، فهرست مدل‌های مجاز و تاریخ انقضا تعیین کنی. کلیدها فقط به‌صورت هش ذخیره می‌شوند و هر زمان می‌توانی آن‌ها را غیرفعال یا حذف کنی.

آیا Function Calling، Vision و استریم برای همهٔ مدل‌ها کار می‌کند؟

+

بله، برای هر مدلی که آن قابلیت را دارد. هوشی پیام‌ها، ابزارها و تصاویر را از قالب OpenAI به قالب هر پروایدر ترجمه می‌کند؛ مثلاً Tool Calling و ورودی تصویر برای Claude هم با همان کد OpenAI کار می‌کند. استریم SSE هم با قالب استاندارد OpenAI برای همهٔ مدل‌ها ارسال می‌شود.

همین حالا اولین کلید API را بساز

چند دقیقه تا اولین پاسخ از GPT-5.5، Claude Opus 5.5 یا Gemini فاصله داری؛ بدون فیلترشکن، با پرداخت تومانی.

ورود به کنسولمستندات