هر کسی که برای محصولش با چند مدل هوش مصنوعی کار کرده، این درد را می‌شناسد. برای هر سازنده یک حساب لازم است، یک کلید، یک روش پرداخت و یک SDK جدا. اگر سرورتان در ایران باشد، اتصال پایدار هم به فهرست اضافه می‌شود. گیسو برای همین مشکل یک وب‌سرویس ساخته است. این وب‌سرویس با کتابخانه‌های رسمی OpenAI کار می‌کند و پشتش ۶۸۰ مدل از ۷۲ سازنده قرار دارد. در این نوشته می‌بینیم از دید یک توسعه‌دهنده چه چیزی عوض می‌شود.

مستندات وب‌سرویس سازگار با OpenAI؛ مشاهده در gisoo.pro/docs

ایده: همان API، نشانی دیگر

وب‌سرویس گیسو سازگار با OpenAI است. اگر کدتان از کتابخانهٔ openai استفاده می‌کند، دو چیز را عوض می‌کنید: `base_url` و کلید. کلید را در اپ گیسو می‌سازید و مثل هر API دیگری با سربرگ `Authorization: Bearer` می‌فرستید. نشانی پایه این است

“` https://gisoo.pro/api/v1 “`

مسیرهای موجود: `/chat/completions`، `/responses`، `/embeddings`، `/images/generations`، `/audio/transcriptions`، `/audio/speech`، `/audio/music`، `/videos` و `/models`. پاسخ جریانی (streaming) هم کار می‌کند. سقف پیش‌فرض هر کلید ۶۰ درخواست در دقیقه است.

یک نمونهٔ کوتاه با Python

“`python from openai import OpenAI

client = OpenAI( base_url=”https://gisoo.pro/api/v1″, api_key=”YOUR_GISOO_KEY”, )

# هر مدل با نام خودش صدا زده می‌شود for model in [“gpt-5-mini”, “deepseek-flash”, “openrouter/anthropic/claude-sonnet-4.5”]: r = client.chat.completions.create( model=model, messages=[{“role”: “user”, “content”: “Write one sentence about Tehran.”}], ) print(model, “->”, r.choices[0].message.content) “`

این حلقه یک پرسش را به سه سازنده می‌فرستد. فقط رشتهٔ `model` فرق می‌کند. بقیهٔ کد یکی است، از ساختار پیام‌ها تا خواندن پاسخ. برای مقایسهٔ کیفیت و هزینه، بیشتر از این لازم ندارید.

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

مدل‌های مستقیم با نام خودشان می‌آیند (مثل `gpt-5-mini` یا `deepseek-flash`) و بقیه با پیشوند `openrouter/` (مثل `openrouter/anthropic/claude-sonnet-4.5`). صفحهٔ هر مدل در سایت این پیشوند را ندارد. اگر `model_not_found` گرفتید، اول همین را بررسی کنید. نکتهٔ دیگر: مدل‌های Pro و Codex اوپن‌ای‌آی که مستقیم وصل‌اند فقط با مسیر `/responses` جواب می‌دهند.

برای دیدن همهٔ مدل‌ها و قیمت دلاری هر کدامفهرست مدل‌های هوش مصنوعیرا باز کنید، یا از خود API بپرسید: درخواست `GET /models` فهرست را برمی‌گرداند.

فهرست ۶۸۱ مدل و قیمت هر کدام؛ مشاهده در gisoo.pro/models

فقط چت نیست

مسیرها همان مسیرهای آشنای OpenAI هستند، پس بقیهٔ کارها هم با همان کلید انجام می‌شود. با `/embeddings` برای جست‌وجوی معنایی بردار می‌سازید. با `/audio/transcriptions` ویس را به متن تبدیل می‌کنید. با `/audio/speech` متن را به صدا برمی‌گردانید و با `/images/generations` تصویر می‌سازید. موسیقی (`/audio/music`) و ویدیو (`/videos`) هم مسیر خودشان را دارند. یعنی ربات پشتیبانی با پاسخ صوتی یا ابزار تولید محتوا را بدون چند حساب و چند SDK می‌شود نوشت.

سرور در ایران؟ نشانی ویژهٔ ایران

اگر برنامه‌تان روی سرورهای دیتاسنترهای ایرانی اجرا می‌شود، به‌جای نشانی اصلی از این نشانی استفاده کنید

“` https://ir.gisoo.pro/api/v1 “`

فقط `base_url` عوض می‌شود؛ کلید، اعتبار، مدل‌ها و مسیرها همان‌اند. streaming پشتیبانی می‌شود و برای Realtime نشانی `wss://ir.gisoo.pro/api/v1/realtime` هست. نشانی اصلی gisoo.pro هم سر جایش می‌ماند. اگر از SDK خود Anthropic استفاده می‌کنید، نشانی پایهٔ آن `https://ir.gisoo.pro/api` است.

MCP برای Claude Code، Cursor و VS Code

گیسو یک سرور MCP هم دارد: `https://gisoo.pro/api/mcp` و برای ایران `https://ir.gisoo.pro/api/mcp`. با همان کلید API، ابزارهایی مثل Claude Code، Cursor، VS Code و Cline از مدل‌های دیگر سؤال می‌پرسند. تصویر، گفتار، موسیقی و ویدیو هم می‌سازند. مثلاً اگر در Claude Code روی مسئله‌ای گیر کرده‌اید، نظر مدل دیگری را هم می‌گیرید. هزینهٔ هر ابزار MCP مثل وب‌سرویس به اندازهٔ مصرف حساب می‌شود.

افزونهٔ وردپرس

اگر سایت وردپرسی یا ووکامرسی دارید، افزونهٔ متن‌باز (GPL) هوش مصنوعی گیسو یک چت پشتیبانی می‌دهد که از مطالب خود سایت جواب می‌دهد و در صورت نیاز به همکار انسانی می‌سپارد؛ تیکت و تولید محتوا در ویرایشگر هم دارد. افزونه به `gisoo.pro/api/v1` یا نشانی ایران وصل می‌شود و روی هاست ایرانی هم کار می‌کند. هزینه به اندازهٔ مصرف از اعتبار گیسو کم می‌شود.

قیمت‌گذاری: هر مدل قیمت خودش

مدل مالی ساده است. اعتبار به دلار نگه داشته می‌شود. هر مدل قیمت دلاری خودش را دارد: مدل سبک ارزان‌تر است و مدل قوی گران‌تر. اشتراک ماهانه ندارد. شارژ با کارت بانکی ایرانی انجام می‌شود و حداقل ۵۰٬۰۰۰ سکه است. ۹٪ مالیات بر ارزش افزوده هنگام شارژ جدا حساب می‌شود. کارت ارزی و فیلترشکن لازم نیست.

دو نکتهٔ عملی برای هزینه

• برای کارهای ساده (طبقه‌بندی، استخراج، پاسخ کوتاه) از مدل سبک شروع کنید و فقط برای کارهای سنگین مدل قوی‌تر را فعال کنید.
• پیش از انتشار محصول، یک مجموعهٔ آزمون کوچک بسازید و با چند مدل اجرا کنید؛ گاهی مدل ارزان‌تر برای کار شما کافی است و فقط با آزمون معلوم می‌شود.

یک کلید، یک base_url، چند سازنده؛ شروع از gisoo.pro/docs

حریم خصوصی و محدودیت‌ها

• در وب‌سرویس، متن درخواست و پاسخ و فایل‌های ضمیمه ذخیره نمی‌شود؛ فقط فراداده مثل مدل، توکن، هزینه، زمان و آی‌پی ثبت می‌شود. اما بدنهٔ درخواست به سرویس‌دهندهٔ همان مدل می‌رود و سیاست آن شرکت دربارهٔ داده‌ها حاکم است. اگر داده‌ای حساس دارید، این را در انتخاب مدل بسنجید.
• گیسو رایگان نیست و بخش رایگان ندارد.
• تا ۲ دلار مصرف بدون احراز هویت (KYC) ممکن است؛ بعد از آن یک بار احراز هویت داخل اپ لازم است.
• سقف و رفتار هر مدل همان است که سازنده‌اش تعیین کرده، و سقف پیش‌فرض ۶۰ درخواست در دقیقه برای هر کلید هم اعمال می‌شود.

از کجا شروع کنیم؟

سه قدم کافی است: در اپ گیسو حساب بسازید و کلید بگیرید، `base_url` را در کدتان عوض کنید، و با یک مبلغ کم چند مدل را روی کار واقعی خودتان امتحان کنید. جزئیات مسیرها و نمونه‌ها درمستندات API گیسوآمده است.