مستندات وب‌سرویس سازگار با 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

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

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

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