تغییرات

هر تغییری که روی کد شما اثر بگذارد اینجا ثبت می‌شود، تازه‌ترین در بالا. مدل‌های تازه و تغییر قیمت‌ها اینجا نمی‌آیند؛ آن‌ها را همیشه از GET /models و صفحهٔ مدل‌ها بگیرید.

سیاست تغییرات

• تغییر ناسازگار را از پیش اعلام می‌کنیم. حذف یک endpoint یا فیلد، یا تغییر معنای آن، پیش از اجرا در همین صفحه می‌آید.
• فیلد تازه بی‌اعلام اضافه می‌شود. کدتان را طوری بنویسید که فیلدهای ناشناخته در پاسخ را نادیده بگیرد؛ SDKهای رسمی همین کار را می‌کنند.
• مدلی که از فروش برداشته شود خطای model_discontinued می‌دهد، نه خطای مبهم.
• نسخهٔ API در نشانی (/v1) است و تا وقتی نسخهٔ تازه‌ای منتشر نشده، همین نسخه پایدار می‌ماند.

۱۵ مهر ۱۴۰۵ — نسخهٔ 1.2.0

سرور MCP گیسو

• نشانی تازهٔ https://gisoo.pro/api/mcp: وب‌سرویس به شکل ابزارهای Model Context Protocol برای Claude Code، Cursor، VS Code، Cline و Claude Desktop. راهنما
• ابزارها: list_models، ask_model، generate_image، text_to_speech، generate_music، create_video، get_video و account_balance.
• همان کلید، همان اعتبار و همان محدودیت‌ها؛ هر ابزار پولی یک درخواست عادی وب‌سرویس است و هزینه‌اش در پاسخ می‌آید. هیچ endpoint موجودی تغییر نکرده است.

۱۴ مهر ۱۴۰۵ — نسخهٔ 1.1.0

اتصال زنده (Realtime) روی WebSocket

• نشانی تازهٔ wss://gisoo.pro/api/v1/realtime?model=… برای گفت‌وگوی صوتی زنده، سازگار با OpenAI Realtime API (نام رویدادهای نسخهٔ GA). راهنما
• صدای تلفن بی‌تبدیل: G.711 (A-law و μ-law) با ۸ کیلوهرتز و PCM با ۸، ۱۶ یا ۲۴ کیلوهرتز؛ با ?codec=alaw صدای Asterisk مستقیم جابه‌جا می‌شود.
• تشخیص پایان گفتار در سرور، لغو پاسخ وقتی کاربر وسط حرف می‌آید، فراخوانی ابزار، و انتخاب صدا و مدل گفتار.
• هزینهٔ هر نوبت از همان اعتبار کم می‌شود و با برچسب Realtime (WebSocket) یا Speech در گزارش درخواست‌ها دیده می‌شود. هیچ endpoint موجودی تغییر نکرده است.

۸ مهر ۱۴۰۵ — نسخهٔ 1.0.0

راه‌اندازی وب‌سرویس گیسو

• نشانی پایهٔ https://gisoo.pro/api/v1، سازگار با OpenAI: گفت‌وگو، Responses API، Completions، امبدینگ، ساخت تصویر، گفتار به متن، ترجمهٔ صوت، متن به گفتار، ساخت ویدیو، ساخت موسیقی و پایش محتوا.
• کلیدهای تازه با پیشوند sk-gisoo-v1-. کلیدهای sk-ntz-v1- هم کار می‌کنند و حساب و اعتبار هر دو یکی است.
• endpointهای حساب بدون هزینه: GET /me، GET /usage و GET /requests/{id}.
• endpoint سازگار با Anthropic: POST /messages و POST /messages/count_tokens، برای SDK رسمی Anthropic و Claude Code.
• مشخصات OpenAPI 3.1 در /api/v1/openapi.json و مرجع تعاملی در /docs/reference.
• پاسخ به نشانی ناشناخته یا روش HTTP نادرست در قالب خطای OpenAI (unknown_url، method_not_allowed).
• مستندات فارسی با نمونه‌کد در cURL، Python، Node.js، PHP، Go و C#.