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

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

گفت‌وگو (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: مدل‌ها، ابعاد بردار، ارسال دسته‌ای و یک نمونهٔ کامل جست‌وجوی مشابه‌ترین متن.

API ساخت تصویر API ساخت تصویر با نانو بنانا (Nano Banana) و GPT Image از یک نشانی: ساخت از متن، ویرایش با عکس مرجع، اندازه و کیفیت، پس‌زمینهٔ شفاف و هزینهٔ هر تصویر. API تبدیل متن به صدا و صدا به متن API تبدیل صدا به متن فارسی با زیرنویس SRT و جدا کردن گوینده‌ها، و API تبدیل متن به صدا با صداهای Gemini و دستور لحن؛ نمونه‌کد، حجم مجاز و قالب‌ها. API ساخت ویدیو API ساخت ویدیو با وئو (Veo) و سورا (Sora): ساختن کار، پرسیدن وضعیت و گرفتن MP4، ویدیو از روی عکس با Veo، مدت و ابعاد مجاز و برگشت هزینهٔ رندر ناموفق. ساخت موسیقی ساخت قطعهٔ موسیقی با Lyria از روی توصیف: کلیپ کوتاه یا آهنگ کامل، قطعهٔ بی‌کلام یا با کلام، ذخیرهٔ فایل MP3 و قیمت هر قطعه. اتصال زنده (Realtime) گفت‌وگوی صوتی زنده روی WebSocket، سازگار با OpenAI Realtime API: پاسخ‌گوی تلفنی و Asterisk با A-law و μ-law، فراخوانی ابزار و نمونه‌کد Node.js و Python.

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

SDKها و زبان‌ها اتصال به گیسو با SDK رسمی OpenAI در پایتون، Node.js، Go و .NET و با PHP یا curl؛ تنظیم base_url، زمان انتظار، تلاش دوباره و متغیرهای محیطی. سازگاری با Anthropic (Messages API) SDK رسمی Anthropic و ابزارهایی مثل Claude Code را با نشانی سازگار با Anthropic به گیسو وصل کنید: قالب Messages API، نام مدل‌ها، ابزارها، پاسخ جریانی و خطاها. سرور MCP سرور MCP گیسو: احراز هویت با کلید API، ابزارها و ورودی هر کدام، تنظیم Claude Code، Cursor، VS Code، Cline و Claude Desktop، هزینه، خطاها و محدودیت‌ها. افزونهٔ وردپرس افزونهٔ «هوش مصنوعی گیسو» را روی وردپرس و ووکامرس، حتی روی هاست ایرانی، راه بیندازید: کلید، قیمت مدل‌ها به سکه، همهٔ تنظیم‌ها، جابه‌جایی از نسخهٔ نِت اَرز. افزونهٔ WHMCS افزونهٔ هوش مصنوعی گیسو را روی WHMCS راه بیندازید: نصب، کلید، چت آنلاین، پاسخ تیکت، موجودی محصولات، نشانی ایران برای سرور داخل ایران و به‌روزرسانی. مهاجرت از OpenAI کد فعلی‌تان را با عوض کردن دو مقدار به گیسو ببرید: نشانی پایه و کلید. فهرست تفاوت‌ها، فیلدهایی که فرستاده نمی‌شوند و چک‌لیست مهاجرت بدون توقف.

یکپارچه‌سازی‌ها راهنمای اتصال Cursor، Cline، Continue، Claude Code، Codex CLI، n8n، LangChain، LiteLLM، Open WebUI، Dify، وردپرس و WHMCS به API گیسو، قدم‌به‌قدم. Cursor Cursor را با کلید گیسو و گزینهٔ Override OpenAI Base URL به Claude، GPT و DeepSeek وصل کنید: مدل‌های پیشنهادی، قابلیت‌هایی که عوض نمی‌شوند و رفع خطا. Cline، Roo Code و Kilo Code سه دستیار کدنویسی VS Code را با گزینهٔ OpenAI Compatible به گیسو وصل کنید: نشانی پایه، کلید، شناسهٔ مدل، اندازهٔ ورودی، قیمت توکن، کنترل هزینه و رفع خطا. Continue (VS Code و JetBrains) فایل config.yaml افزونهٔ Continue را برای گیسو بنویسید: مدل گفت‌وگو و ویرایش، حالت ایجنت با tool_use، امبدینگ برای جست‌وجوی کد و چرا تکمیل خودکار جداست. Claude Code مرجع فنی اتصال Claude Code به گیسو: ANTHROPIC_BASE_URL و ANTHROPIC_AUTH_TOKEN، فایل settings.json، نام مدل‌ها، هزینه و خطاهای رایج در ترمینال و VS Code. Codex CLI Codex CLI را با سرویس‌دهندهٔ سفارشی در config.toml به Responses API گیسو وصل کنید: نشانی پایه، متغیر کلید، مدل‌های کدنویسی OpenAI، پروفایل‌ها و رفع خطا. n8n در n8n یک Credential از نوع OpenAI با Base URL گیسو بسازید و در AI Agent و OpenAI Chat Model از Claude، Gemini و GPT استفاده کنید؛ با امبدینگ و HTTP Request. LangChain و LangGraph ChatOpenAI و OpenAIEmbeddings در LangChain پایتون و جاوااسکریپت را به گیسو وصل کنید: پاسخ جریانی، ابزار، خروجی ساختاریافته، ایجنت و ChatAnthropic برای Claude. LiteLLM گیسو را در LiteLLM با پیشوند openai/ و api_base تعریف کنید: SDK پایتون، فایل config.yaml برای LiteLLM Proxy، مسیر پشتیبان، امبدینگ و ثبت درست هزینه. Open WebUI و LibreChat یک چت داخلی برای تیم با مدل‌های گیسو: اتصال OpenAI در Open WebUI با فهرست مدل محدود، امبدینگ، تصویر و صدا، و endpoint سفارشی در فایل librechat.yaml. Dify و Flowise در Dify افزونهٔ OpenAI-API-compatible و در Flowise گره ChatOpenAI Custom را برای گیسو تنظیم کنید: نوع مدل، اندازهٔ ورودی، فراخوانی ابزار، امبدینگ و رفع خطا.

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