تغییرات

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

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

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

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