تغییرات

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

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

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

۱۴ آبان ۱۴۰۵ — نسخهٔ 1.4.0

ElevenLabs: گفتار فارسی، Scribe، موسیقی و جلوه صوتی

• مدل‌های ElevenLabs روی همان endpointها و با همان کلید در دسترس‌اند و هیچ endpoint موجودی تغییر نکرده است. راهنما
• متن به گفتار: eleven-v4، eleven-v4-turbo، eleven-v3 و eleven-v3-conversational فارسی می‌خوانند و صداهای فارسی mitra، arash، arash-clear، mr-o، arman، mahdi، mammo و danesh را دارند؛ قالب‌های mp3، wav، opus، aac، flac و pcm.
• گفتار به متن: scribe-v2 و scribe-v2-medical با srt، vtt، verbose_json، diarized_json و diarize=true.
• موسیقی و جلوه صوتی: eleven-music-v1 و eleven-sound-effects-v2 و -v3 در POST /audio/music، با فیلد تازهٔ seconds. هزینه به‌ازای طول قطعه است.
• اگر ElevenLabs در دسترس نباشد، گفتار و Scribe خودکار به مدل همتا می‌روند؛ صداهای فارسی، موسیقی و جلوه صوتی جایگزین ندارند.
• تبدیل صدا (Voice Changer): POST /audio/voice-change با مدل‌های eleven-multilingual-sts-v2 و eleven-english-sts-v2؛ فایل صوتی را می‌دهید و همان گفتار را با صدای دیگر پس می‌گیرید. هزینه به‌ازای مدت صوتِ ورودی است. راهنما

۱۳ آبان ۱۴۰۵ — نسخهٔ 1.3.0

API مدیریت پروژه‌ها و کلیدها

• نشانی تازهٔ https://gisoo.pro/api/v1/manage/…: برای هر کاربر محصول خودتان با کد یک پروژه و یک کلید با سقف اعتبار و انقضای مشخص بسازید. راهنما
• با کلید مدیریت جدا (sk-gisoo-mgmt-v1-…) که در اپ گیسو، بخش API، ساخته می‌شود. این کلید نمی‌تواند مدل صدا بزند و کلید مدل هم این API را نمی‌شناسد.
• ساخت پروژه و کلید اول در یک درخواست، تغییر سقف (مقدار مطلق یا افزودن اتمی) و انقضا، مکث، چرخش و ابطال کلید، بایگانی پروژه و گزارش مصرف.
• هدر Idempotency-Key روی درخواست‌های POST: تکرار همان درخواست تا ۲۴ ساعت همان پاسخ را می‌دهد. هیچ endpoint موجودی تغییر نکرده است.

۱۵ مهر ۱۴۰۵ — نسخهٔ 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#.