پاسخ کوتاه به پرسشهایی که توسعهدهندهها بیشتر از همه میپرسند. صفحهٔ کامل هر موضوع را در «صفحههای مرتبط»، پایین همین صفحه، میبینید. اگر پرسشتان اینجا نیست، در تیکت بپرسید.
شروع و سازگاری#
برای وصل شدن به وبسرویس گیسو فیلترشکن لازم است؟
نه. برنامهٔ شما به gisoo.pro وصل میشود و گیسو درخواست را به سرویسدهندهٔ مدل (شرکتی که مدل روی سرورش اجرا میشود) میرساند؛ پس از سرور یا کامپیوتری در ایران هم بدون فیلترشکن کار میکند.
کارت اعتباری خارجی یا حساب OpenAI لازم دارم؟
نه. حساب گیسو را در درگاه بانکی نِت اَرز شارژ میکنید. اعتبار به دلار در حسابتان مینشیند و هزینهٔ هر درخواست از همان کم میشود.
کدی که برای OpenAI نوشتهام با گیسو کار میکند؟
بله. در SDK رسمی OpenAI فقط نشانی پایه (base_url) را https://gisoo.pro/api/v1 بگذارید و کلید گیسو را جای کلید OpenAI بدهید. بقیهٔ کد، از جمله پاسخ جریانی و فراخوانی ابزار، همان میماند.
Claude، Gemini و DeepSeek را هم با همین کلید صدا میزنم؟
بله. همه از همان endpoint گفتوگو و با همان قالب OpenAI صدا زده میشوند؛ فقط شناسهٔ مدل را عوض میکنید. گیسو درخواست را به قالب هر سازنده تبدیل میکند.
هزینه، شارژ و احراز هویت#
حداقل شارژ چقدر است و اشتراک ماهانه دارد؟
شارژ از ۵۰,۰۰۰ سکه شروع میشود و اشتراک ماهانه ندارد: هرچقدر شارژ کنید، همانقدر مصرف میکنید. ماهی که از API استفاده نکنید، چیزی از اعتبارتان کم نمیشود.
درخواستی که خطا بدهد هزینه دارد؟
نه، وقتی سرویسدهندهٔ مدل پیش از تولید پاسخ خطا بدهد: هزینهای کم نمیشود و مبلغی که برای آن درخواست کنار گذاشته شده بود به موجودی برمیگردد. خطاهای کلید، اعتبار و محدودیت هم هزینه ندارند.
احراز هویت لازم است؟
تا ۲ دلار مصرف، بدون احراز هویت میتوانید سرویس را امتحان کنید. پس از آن، تا هویتتان تأیید نشود درخواستها با خطای kyc_required رد میشوند. فرم احراز هویت داخل اپ گیسو پر میشود.
مدل رایگان دارید؟
نه. همهٔ مدلها بر پایهٔ مصرف واقعی قیمت دارند. برای آزمایش ارزان، مدلهای کوچک مثل gpt-4o-mini را انتخاب کنید و max_tokens را کم بگذارید.
رسید و صورتحساب شارژ به نام کیست؟
به نام نِت اَرز، چون فروشنده نِت اَرز است. پرداخت را در درگاه نِت اَرز انجام میدهید و رسید و پیامک پرداخت هم به نام نِت اَرز است. گیسو برند هوش مصنوعی همین مجموعه است.
محدودیتها و رفتار سرویس#
در دقیقه چند درخواست میتوانم بفرستم؟
بهطور پیشفرض ۶۰ درخواست در دقیقه برای هر کلید و ۸ درخواست همزمان برای هر حساب. مقدار واقعی حساب شما را GET /me برمیگرداند؛ اگر بیشتر لازم دارید، تیکت بفرستید.
درخواست طولانی قطع میشود؛ چه کنم؟
هر درخواست، معمولی یا جریانی، حداکثر حدود ۹۰ ثانیه برای پاسخ سرویسدهنده صبر میکند. با stream خروجی همان لحظه که ساخته میشود میرسد و کاربر منتظر نمیماند؛ خروجی خیلی بلند را به چند درخواست کوتاهتر بشکنید. ساخت ویدیو از اول ناهمگام است و این محدودیت را ندارد.
کلید، امنیت و حریم خصوصی#
متن درخواستها و پاسخها ذخیره میشود؟
نه در گیسو. وبسرویس فقط فراداده ثبت میکند: مدل، تعداد توکن، هزینه، زمان پاسخ و IP. متن پرامپت، پاسخ مدل و فایلها ذخیره نمیشود. بدنهٔ درخواست به سرویسدهندهٔ مدل (مثل OpenAI، Google یا OpenRouter) میرسد و از آنجا سیاست نگهداری همان شرکت حاکم است.
کلید نِت اَرز و کلید گیسو چه فرقی دارند؟
هیچ فرقی جز پیشوند. گیسو برند هوش مصنوعی نِت اَرز است و حساب، اعتبار و کلیدها یکی است: کلید sk-gisoo-v1-… و کلید sk-ntz-v1-… هر دو روی هر دو نشانی کار میکنند و از همان اعتبار کم میکنند.
میتوانم کلید را در اپ موبایل یا کد مرورگر بگذارم؟
پیشنهاد نمیکنیم. هر کسی کد سمت کاربر را باز کند کلید را میبیند و با اعتبار شما درخواست میفرستد. کلید را روی سرور خودتان نگه دارید و اپ را به سرورتان وصل کنید؛ اگر ناچارید، برای آن کلید سقف هزینه و فهرست مدل مجاز بگذارید.
صفحههای مرتبط#
پاسخ پرسشتان را پیدا نکردید؟
شناسهٔ درخواست (هدر X-Request-Id) را با پرسشتان در تیکت بفرستید تا دقیق بررسی کنیم.