مستندات وب‌سرویس گیسو

شروع سریع از ساخت حساب تا اولین پاسخ مدل: شارژ اعتبار، ساخت کلید دسترسی (API Key) و فرستادن اولین درخواست با curl، پایتون یا Node.js به نشانی gisoo.pro/api/v1. احراز هویت و کلیدها کلید دسترسی گیسو (sk-gisoo-v1-…) را چطور بسازید، در هدر بفرستید و امن نگه دارید؛ پروژه‌ها، سقف هزینهٔ هر کلید، فهرست IP مجاز و چرخش کلید. مدل‌ها و انتخاب مدل شناسهٔ مدل‌ها در وب‌سرویس گیسو، گرفتن فهرست زنده با GET /models، مدل‌هایی که از OpenRouter می‌آیند و این‌که برای هر کار کدام مدل را انتخاب کنید.

گفت‌وگو (Chat Completions) اصلی‌ترین endpoint وب‌سرویس گیسو: ساختار پیام‌ها، نقش system و user، پارامترهای دما و طول پاسخ، مدل‌های استدلالی و نمونه‌کد در شش زبان. پاسخ جریانی (Streaming) پاسخ را تکه‌تکه و همان لحظه که ساخته می‌شود بگیرید: stream: true، قالب رویدادهای SSE، مصرف پایانی، قطع اتصال از سمت شما و خطایی که وسط پاسخ جریانی می‌رسد. ورودی تصویر (Vision) فرستادن عکس به مدل‌های بینا با نشانی اینترنتی یا base64، چند تصویر در یک پیام، هزینهٔ ورودی تصویری و مدل‌هایی که تصویر می‌خوانند. فراخوانی ابزار (Function Calling) به مدل ابزار بدهید تا تابع‌های برنامهٔ شما را صدا بزند: تعریف ابزار با JSON Schema، چرخهٔ کامل درخواست و پاسخ، چند فراخوانی همزمان و نکته‌های Gemini و Claude. خروجی ساختاریافته (JSON) پاسخ مدل را به شکل JSON بگیرید تا کدتان آن را بخواند: حالت json_object، طرح‌وارهٔ دقیق با json_schema، اعتبارسنجی در کد و مدل‌هایی که هر حالت را پشتیبانی می‌کنند. Responses API endpoint تازه‌تر OpenAI روی گیسو: ورودی ساده، ابزار جست‌وجوی وب داخلی و هزینهٔ هر فراخوانی آن، پاسخ جریانی و مدل‌هایی که این مسیر را می‌پذیرند. امبدینگ (Embeddings) تبدیل متن فارسی و انگلیسی به بردار برای جست‌وجوی معنایی و RAG: مدل‌ها، ابعاد بردار، ارسال دسته‌ای و یک نمونهٔ کامل جست‌وجوی مشابه‌ترین متن.

ساخت تصویر ساخت تصویر از توصیف متنی با مدل‌های GPT Image: اندازه‌ها و کیفیت‌های مجاز، تأثیرشان بر قیمت، ذخیرهٔ خروجی base64 و نوشتن پرامپت خوب. صدا: گفتار و متن تبدیل فایل صوتی به متن فارسی، زیرنویس SRT، ترجمهٔ صوت به انگلیسی و ساخت فایل گفتار از متن؛ حجم مجاز فایل، قالب‌ها، صداها و قیمت هر دقیقه یا هر نویسه. ساخت ویدیو ساخت ویدیو با Sora از روی متن: چرا پاسخ یک «کار» است، پرسیدن وضعیت، گرفتن فایل MP4، مدت و ابعاد مجاز، قیمت ثانیه‌ای و برگشت هزینهٔ رندر ناموفق. ساخت موسیقی ساخت قطعهٔ موسیقی با Lyria از روی توصیف: کلیپ کوتاه یا آهنگ کامل، قطعهٔ بی‌کلام یا با کلام، ذخیرهٔ فایل MP3 و قیمت هر قطعه.

قیمت‌گذاری و صورتحساب اعتبار دلاری حساب و شارژ آن از ۵۰ هزار سکه، نرخ روز هر دلار اعتبار، مالیات بر ارزش افزوده، این‌که هزینهٔ هر درخواست چطور حساب می‌شود و چرا درخواست ناموفق هزینه ندارد. مدیریت هزینه و محدودیت‌ها سقف درخواست در دقیقه، درخواست‌های همزمان، اندازهٔ درخواست، سقف هزینهٔ کلید و بودجهٔ پروژه، سقف مصرف پیش از احراز هویت و رفتار درست در برابر خطای ۴۲۹. موجودی و گزارش مصرف با GET /me موجودی و محدودیت‌های کلید را بخوانید، با GET /usage گزارش مصرف روزانه یا به تفکیک مدل بگیرید و با GET /requests/{id} وضعیت یک درخواست را ببینید. خطاها همهٔ کدهای خطای وب‌سرویس گیسو با وضعیت HTTP، معنا و راه رفع؛ قالب خطا که همان قالب OpenAI است، و این‌که کدام خطاها را دوباره بفرستید.

SDKها و زبان‌ها اتصال به گیسو با SDK رسمی OpenAI در پایتون، Node.js، Go و .NET و با PHP یا curl؛ تنظیم base_url، زمان انتظار، تلاش دوباره و متغیرهای محیطی. سازگاری با Anthropic و Claude Code گیسو Messages API شرکت Anthropic را هم می‌پذیرد: Claude Code و SDK رسمی Anthropic را با تنظیم ANTHROPIC_BASE_URL به گیسو وصل کنید؛ نام مدل‌ها، ابزارها، پاسخ جریانی و محدودیت‌ها. یکپارچه‌سازی‌ها گیسو را به Cursor، Continue، Cline، n8n، LangChain، LlamaIndex، Dify، Open WebUI، وردپرس و WHMCS وصل کنید؛ برای هر کدام دقیقاً کدام فیلد را پر کنید. مهاجرت از OpenAI کد فعلی‌تان را با عوض کردن دو مقدار به گیسو ببرید: نشانی پایه و کلید. فهرست تفاوت‌ها، فیلدهایی که فرستاده نمی‌شوند و چک‌لیست مهاجرت بدون توقف.

مرجع API مرجع تعاملی همهٔ endpointهای گیسو بر پایهٔ OpenAPI 3.1: پارامترها، پاسخ‌ها و نمونه‌کد هر endpoint؛ هر کدام را از همین صفحه آزمایش می‌کنید. تغییرات تاریخچهٔ تغییرات وب‌سرویس گیسو: endpointها و قابلیت‌های تازه، تغییر رفتار و هر چیزی که روی کد شما اثر بگذارد، از تازه‌ترین به قدیمی‌ترین. پرسش‌های پرتکرار پاسخ کوتاه به پرسش‌های رایج توسعه‌دهندگان: فیلترشکن، کارت خارجی، حداقل شارژ، هزینهٔ درخواست ناموفق، نگهداری پیام‌ها، رسید پرداخت و تفاوت گیسو با نِت اَرز.