سازگار با OpenAI
کدتان را دوباره ننویسید؛ دو مقدار را عوض کنید
اگر برنامه‌تان با OpenAI کار میکند، به گیسو هم وصل میشود: نشانی پایه (base_url) را https://gisoo.pro/api/v1 بگذارید و کلید گیسو را جای کلید OpenAI بدهید.
برای Claude یا Gemini هم لازم نیست SDK سازنده‌اش را نصب کنید؛ همین درخواست با شناسهٔ مدل دیگری به آن‌ها میرسد.
- پایتون، Node.js، PHP، Go، .NET و هر زبانی که HTTP بفرستد
- قالب خطاها هم همان OpenAI است؛ منطق تلاش دوباره‌تان سر جایش می‌ماند
- فایل مشخصات OpenAPI برای ساختن خودکار کلاینت
برای سرورها و کاربران داخل ایران، در این نمونه نشانی gisoo.pro را با ir.gisoo.pro جایگزین کنید؛ مسیر و کلید همان‌اند.
from openai import OpenAI
client = OpenAI(base_url="https://gisoo.pro/api/v1", api_key="sk-gisoo-v1-...")
print(client.chat.completions.create(model="gpt-4o-mini", messages=[{"role": "user", "content": "سلام"}]).choices[0].message.content)import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://gisoo.pro/api/v1", apiKey: process.env.GISOO_API_KEY });
const r = await client.chat.completions.create({ model: "gpt-4o-mini", messages: [{ role: "user", content: "سلام" }] });
console.log(r.choices[0].message.content);curl https://gisoo.pro/api/v1/chat/completions \
-H "Authorization: Bearer $GISOO_API_KEY" -H "Content-Type: application/json" \
-d '{"model": "gpt-4o-mini", "messages": [{"role": "user", "content": "سلام"}]}'$client = OpenAI::factory()->withBaseUri('https://gisoo.pro/api/v1')->withApiKey(getenv('GISOO_API_KEY'))->make();
$r = $client->chat()->create(['model' => 'gpt-4o-mini', 'messages' => [['role' => 'user', 'content' => 'سلام']]]);
echo $r->choices[0]->message->content;امکانات وبسرویس
از اولین درخواست تا سقف هزینهٔ هر کلید
همان SDK که می‌شناسید
قالب درخواست و پاسخ همان OpenAI است. کتابخانه‌ها، ابزارها و ایجنت‌هایی که برای OpenAI ساخته شده‌اند، با عوض کردن نشانی پایه به گیسو وصل میشوند.
یک کلید برای چند سازنده
GPT، Claude، Gemini، DeepSeek، Grok، Qwen و Llama با یک کلید و یک صورتحساب. برای عوض کردن مدل، فقط شناسهٔ آن را در درخواست عوض کنید.
پاسخ جریانی، ابزار، JSON
پاسخ تکه‌تکه و همان لحظه که ساخته میشود (SSE)، فراخوانی تابع (Function Calling)، خروجی ساختاریافته با JSON Schema و ورودی تصویر؛ هر جا مدل پشتیبانی کند.
تصویر، صدا، ویدیو
ساخت تصویر، گفتار به متن و متن به گفتار، تبدیل متن به عدد برای جست‌وجوی معنایی (امبدینگ)، ساخت ویدیو و ساخت موسیقی؛ همه از همین نشانی پایه.
از ایران، با کارت بانکی
سرورتان بدون فیلترشکن به gisoo.pro وصل میشود. حساب را با کارت بانکی در صفحهٔ پرداخت نِت اَرز شارژ میکنید و اعتبار دلاری در حسابتان مینشیند؛ کارت خارجی لازم نیست.
بهاندازهٔ مصرف، از ۵۰٬۰۰۰ سکه
اشتراک ماهانه ندارد. هزینهٔ هر درخواست از مصرف واقعی حساب میشود و درخواستی که پیش از تولید پاسخ با خطای سرویس‌دهنده تمام شود، هزینه‌ای ندارد.
سقف هزینه برای هر کلید
برای هر کلید سقف هزینه، فهرست مدل مجاز، فهرست IP مجاز و تاریخ انقضا بگذارید و برای هر پروژه بودجهٔ ماهانه تعیین کنید.
گزارش مصرف در اپ
مصرف هر روز و هر مدل را در اپ گیسو ببینید یا با GET /usage به داشبورد خودتان ببرید. هر پاسخ هم شناسهٔ درخواست دارد.
قیمت به دلار
قیمت هر مدل را پیش از درخواست می‌بینید
قیمت برای هر یک میلیون توکن (واحد شمارش متن) است. ستون آخر هزینهٔ تقریبی یک پیام معمولی را به سکه و با نرخ امروز نشان می‌دهد: حدود ۱٬۵۰۰ توکن ورودی و ۵۰۰ توکن خروجی.
| مدل | شناسه (model) | ورودی / ۱M | خروجی / ۱M | یک پیام معمولی |
|---|---|---|---|---|
| GPT-4o mini | gpt-4o-mini |
$0.21 | $0.84 | ≈ ۱۹۸ سکه |
| GPT-5 mini | gpt-5-mini |
$0.35 | $2.80 | ≈ ۵۱۸ سکه |
| Anthropic: Claude Sonnet 4.5 | openrouter/anthropic/claude-sonnet-4.5 |
$4.5892 | $22.9462 | ≈ ۴٬۹۳۷ سکه |
| Gemini 3.6 Flash | gemini-3.6-flash |
$1.05 | $5.25 | ≈ ۱٬۱۳۰ سکه |
| DeepSeek V4 Flash (نام قدیمی) | deepseek-v4-flash |
$0.42 | $1.68 | ≈ ۳۹۶ سکه |
| GPT-4.1 | gpt-4.1 |
$2.80 | $11.20 | ≈ ۲٬۶۳۶ سکه |
هزینهٔ واقعی هر درخواست از مصرف گزارش‌شدهٔ همان درخواست حساب میشود. صورتحساب چطور حساب میشود؟
فارسی، از مستندات تا پشتیبانی
API هوش مصنوعی فارسی، از یک سرویس ایرانی
گیسو برند هوش مصنوعی نِت اَرز است و همه‌چیزش برای برنامه‌نویس ایرانی نوشته شده: راهنما، پیام خطا، پرداخت و پشتیبانی. مدلها اما ساخت ما نیستند؛ GPT، Claude، Gemini و بقیه را سازندههایشان ساختهاند و روی سرورهای همان شرکتها اجرا میشوند. گیسو آن‌ها را با یک کلید و یک نشانی به برنامهٔ شما می‌رساند.
مستندات فارسی
از شروع سریع تا خطاها، هر راهنما فارسی است و نمونه‌کدش با نشانی و کلید گیسو آمادهٔ اجراست.
پیام خطای فارسی
خطاها همان قالب OpenAI را دارند و متنشان فارسی است؛ مثلاً «کلید API نامعتبر است.» کنار کد invalid_api_key.
متن و صدای فارسی
بیشتر مدلهای گفت‌وگو فارسی میخوانند و مینویسند، صداهای Gemini متن فارسی را میخوانند و گفتار به متن با language=fa صدای فارسی را پیاده میکند.
پشتیبانی و پرداخت
تیکت فارسی در اپ گیسو، و شارژ با کارت بانکی در درگاه نِت اَرز؛ رسید هم به نام نِت اَرز است.
هنوز تصمیم نگرفته‌اید کلید را از خود OpenAI، گوگل یا DeepSeek بگیرید یا از گیسو؟ گرفتن کلید API هوش مصنوعی از ایران شرط هر سازنده را کنار کلید گیسو گذاشته است.
یک نشانی پایه
متن، تصویر، صدا، ویدیو و موسیقی
هر کار endpoint خودش را دارد، با همان کلید و همان اعتبار. جزئیات هر کدام را در مستندات می‌بینید.
مرجع کامل API| گفت‌وگو و متن | POST /chat/completions |
GPT، Claude، Gemini، DeepSeek و… |
| Responses API | POST /responses |
مدلهای OpenAI و جست‌وجوی وب |
| امبدینگ | POST /embeddings |
text-embedding-3، Gemini Embedding |
| ساخت تصویر | POST /images/generations |
GPT Image |
| گفتار به متن | POST /audio/transcriptions |
Whisper و GPT Transcribe |
| متن به گفتار | POST /audio/speech |
OpenAI TTS |
| ساخت ویدیو | POST /videos |
Sora |
| ساخت موسیقی | POST /audio/music |
Lyria |
یکپارچه‌سازی‌ها
ابزارهایی که با کلید گیسو کار می‌کنند
هر ابزاری که «OpenAI-compatible» یا تنظیم Base URL دارد، با کلید گیسو کار میکند. برای هر کدام گفته‌ایم کدام فیلد را پر کنید.
سه قدم
از ورود تا اولین پاسخ
-
۱
وارد گیسو شوید
با شمارهٔ موبایل و کد پیامکی، یا اگر در نِت اَرز حساب دارید، با همان. حساب و اعتبار در هر دو یکی است.
-
۲
حساب را شارژ کنید
از ۵۰٬۰۰۰ سکه، در صفحهٔ پرداخت نِت اَرز. تا ۲ دلار مصرف احراز هویت نمی‌خواهد؛ بعد از آن یک بار لازم است.
-
۳
کلید بسازید و وصل شوید
در اپ، بخش API، کلید sk-gisoo-v1-… بسازید و در کدتان نشانی پایه را https://gisoo.pro/api/v1 بگذارید.
وبسرویس گیسو برای برنامه‌نویس‌ها: یک کلید، مدلهای چند شرکت
فقط نشانی پایه (base URL) و کلید را در کدتان عوض میکنید و هزینهٔ هر درخواست از اعتبار حسابتان کم میشود. کلید با sk-gisoo- شروع میشود و فقط یک بار، هنگام ساخت، نشان داده میشود؛ همان موقع کپی‌اش کنید.
پرسش‌های پرتکرار
API هوش مصنوعی گیسو به چه کارم میآید؟
برنامه یا سایت شما با یک نشانی و یک کلید از مدلهای GPT، Claude، Gemini، DeepSeek و دهها سازندهٔ دیگر جواب میگیرد. قالب درخواست و پاسخ همان OpenAI است، پس SDK رسمی OpenAI بدون تغییر کار میکند.
برای گرفتن API ChatGPT در ایران چه لازم دارم؟
یک حساب گیسو و شارژ اعتبار؛ با همین دو، مدلهای GPT (همان خانوادهای که ChatGPT با آن کار میکند) را از API صدا میزنید. کارت اعتباری خارجی، حساب OpenAI و فیلترشکن لازم نیست؛ در درگاه بانکی نِت اَرز پرداخت میکنید و اعتبار به دلار در حسابتان مینشیند. کلید را در بخش API اپ گیسو میسازید. راهنمای «گرفتن کلید API هوش مصنوعی از ایران» در مستندات، راه خود سازندهها را هم کنارش گفته است.
API هوش مصنوعی ایرانی و فارسی است؟
سرویس ایرانی است و فارسی کار میکند: گیسو برند هوش مصنوعی نِت اَرز است، مستندات و پیامهای خطا فارسیاند و پشتیبانی با تیکت فارسی در اپ است. ولی مدلها ساخت ما نیستند؛ GPT، Claude، Gemini و بقیه را سازندههایشان ساختهاند و روی سرورهای همان شرکتها اجرا میشوند. بیشتر مدلهای بزرگ فارسی را خوب میخوانند و مینویسند؛ برای کار مهم، دو سه مدل را با متن واقعی خودتان مقایسه کنید.
هزینه چطور حساب میشود؟
بهاندازهٔ مصرف. قیمت هر مدل به دلار و برای هر یک میلیون توکن (واحد شمارش متن) منتشر شده است و پس از هر درخواست، هزینهٔ همان مصرف از اعتبارتان کم میشود. شارژ از ۵۰٬۰۰۰ سکه شروع میشود و اشتراک ماهانه ندارد.
کد فعلی‌ام را باید از نو بنویسم؟
نه. در SDK رسمی OpenAI (پایتون، Node.js، Go، .NET و…) فقط نشانی پایه را https://gisoo.pro/api/v1 بگذارید و کلید گیسو را جای کلید OpenAI بدهید. پاسخ جریانی، فراخوانی ابزار و خروجی JSON همان‌طور کار می‌کنند.
اگر درخواستی خطا بدهد، پولش کم میشود؟
نه. درخواستی که پیش از تولید پاسخ با خطای سرویسدهندهٔ مدل تمام شود هزینه ندارد و مبلغی که برایش کنار گذاشته شده بود به موجودی برمیگردد.
متن درخواستهای ما جایی ذخیره میشود؟
نه در گیسو. وبسرویس فقط فراداده ثبت میکند (مدل، تعداد توکن، هزینه، زمان و IP) و متن پرامپت و پاسخ مدل را ذخیره نمیکند. بدنهٔ درخواست به سرویسدهندهٔ مدل (مثل OpenAI، Google یا OpenRouter) میرسد و از آنجا سیاست همان شرکت حاکم است.
محدودیت تعداد درخواست دارد؟
بهطور پیشفرض ۶۰ درخواست در دقیقه برای هر کلید و ۸ درخواست همزمان برای هر حساب. برای هر کلید هم میتوانید سقف هزینه، فهرست مدل مجاز و فهرست IP مجاز بگذارید. تا ۲ دلار مصرف بدون احراز هویت آزاد است؛ پس از آن احراز هویت داخل اپ گیسو لازم است.
گیسو با نِت اَرز چه نسبتی دارد؟
گیسو برند هوش مصنوعی نِت اَرز است. حساب، اعتبار و کلیدها در هر دو یکی است؛ کلیدی که در یکی بسازید روی نشانی دیگری هم کار میکند و از همان اعتبار کم میکند.
پرسش فنی‌تری دارید؟ پرسش‌های پرتکرار توسعه‌دهندگان
کلید بسازید، نشانی را عوض کنید، درخواست بفرستید
شارژ از ۵۰٬۰۰۰ سکه، بدون اشتراک ماهانه. هر کلید بهطور پیشفرض ۶۰ درخواست در دقیقه می‌پذیرد.
