پرش به محتوا

مستندات توسعه‌دهندگان

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

API گیسو با SDK رسمی OpenAI کار می‌کند. نشانی پایه و کلید را عوض کنید؛ همان کد به ۴۳۷ مدل از ۵۱ سازنده می‌رسد. نمونه‌کدها بدون تغییر، با کلید خودتان اجرا می‌شوند.

نشانی پایه (base URL)
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": "Hello!"}]
  }'

کارهای رایج

همهٔ راهنماها

شروع

متن و گفت‌وگو

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

تصویر، صدا، ویدیو و موسیقی

هزینه، محدودیت و خطا

ابزارها و مهاجرت

مرجع و تغییرات

نشانی پایه

https://gisoo.pro/api/v1

احراز هویت درخواست

Authorization: Bearer sk-gisoo-v1-…

مشخصات OpenAPI

/api/v1/openapi.json