هر ابزاری که گزینهٔ «OpenAI-compatible» یا تنظیم «Base URL» دارد، با کلید گیسو کار می‌کند؛ ابزارهای Anthropic مثل Claude Code هم با نشانی سازگار با Anthropic وصل می‌شوند. برای ابزارهای رایج یک راهنمای کامل نوشته‌ایم: کجا چه بنویسید، کدام مدل را بگذارید، چه چیزی کار نمی‌کند و هر خطا را چطور رفع کنید. در همه‌شان این سه مقدار را پر می‌کنید:
| Base URL / API Base / Endpoint | https://gisoo.pro/api/v1 |
| API Key | sk-gisoo-v1-… |
| Model | شناسهٔ دقیق مدل از GET /models؛ مثلاً gpt-4o-mini یا openrouter/anthropic/claude-sonnet-4.5 |
| ابزارهای Anthropic | نشانی پایه https://gisoo.pro/api، بدون /v1 (سازگاری با Anthropic) |
برای هر ابزار یک کلید جدا با سقف هزینه بسازید. ابزارهای کدنویسی و ایجنت‌ها در هر کار چندین درخواست می‌فرستند؛ با سقف هزینه، خرجشان از حدی که می‌خواهید بیشتر نمی‌شود و در گزارش مصرف هم جدا دیده می‌شوند.
راهنمای هر ابزار
کدنویسی
خودکارسازی، ایجنت و برنامه‌نویسی
چت داخلی تیم و سایت
هر ابزار با کدام مسیر و کدام مدل‌ها
| ابزار | مسیر API گیسو | مدل‌ها |
|---|---|---|
| Cursor، Cline / Roo Code / Kilo Code، Continue | /chat/completions | همهٔ مدل‌های متنی؛ برای ایجنت، مدل‌هایی که فراخوانی ابزار دارند. |
| Claude Code | /messages (Anthropic) | Claude، و مدل‌های متنی دیگر با دقت کمتر در ابزارها. |
| Codex CLI | /responses | مدل‌های OpenAI. |
| n8n، Dify / Flowise، LangChain، LiteLLM | /chat/completions، /embeddings | همهٔ مدل‌های متنی و امبدینگ. |
| Open WebUI / LibreChat | /chat/completions، /embeddings، /images، /audio | متن، امبدینگ، تصویر و صدا. |
از سرور یا هاست داخل ایران؟ همهٔ این ابزارها فقط به gisoo.pro وصل می‌شوند و فیلترشکن لازم ندارند؛ برای آزمایش اتصال از همان سرور، API هوش مصنوعی بدون فیلترشکن را ببینید.
LlamaIndex
برای مدل‌های گفت‌وگو از OpenAILike استفاده کنید؛ کلاس OpenAI خود LlamaIndex فقط نام مدل‌های OpenAI را می‌شناسد:
برای سرورها و کاربران داخل ایران، در این نمونه نشانی gisoo.pro را با ir.gisoo.pro جایگزین کنید؛ مسیر و کلید همان‌اند.
# pip install llama-index-llms-openai-like llama-index-embeddings-openai
from llama_index.core import Settings, VectorStoreIndex, SimpleDirectoryReader
from llama_index.llms.openai_like import OpenAILike
from llama_index.embeddings.openai import OpenAIEmbedding
Settings.llm = OpenAILike(
model="gpt-4o-mini",
api_base="https://gisoo.pro/api/v1",
api_key="sk-gisoo-v1-...",
is_chat_model=True,
is_function_calling_model=True,
context_window=128000,
)
Settings.embed_model = OpenAIEmbedding(model_name="text-embedding-3-small", api_base="https://gisoo.pro/api/v1", api_key="sk-gisoo-v1-...")
index = VectorStoreIndex.from_documents(SimpleDirectoryReader("./docs").load_data())
print(index.as_query_engine().query("What is our refund policy?"))افزونهٔ هوش مصنوعی وردپرس
افزونهٔ متن‌باز «هوش مصنوعی گیسو» برای وردپرس و ووکامرس: چت پشتیبانی که از مطالب و محصولات همان سایت جواب می‌دهد و هرجا مطمئن نبود گفت‌وگو را به همکار شما می‌سپارد، تیکت و ابزار نوشتن در ویرایشگر.
از اول به https://gisoo.pro/api/v1 وصل است، پس روی هاست و سرور داخل ایران هم کار می‌کند؛ فقط کلید گیسو را در تنظیماتش بگذارید.
همین افزونه با نام «هوش مصنوعی نِت اَرز» هم منتشر می‌شود و از نسخهٔ ۱٫۱٫۰ در تنظیماتش می‌شود نشانی وب‌سرویس را gisoo.pro گذاشت.
- معرفی و دانلود: افزونه هوش مصنوعی وردپرس
- نصب و همهٔ تنظیم‌ها: راهنمای افزونهٔ وردپرس
- کد منبع: github.com/netarz/netarz-ai-wordpress
ماژول هوش مصنوعی WHMCS
ماژول متن‌باز «NetArz AI for WHMCS» برای شرکت‌های هاستینگ: چت آنلاین در ناحیهٔ کاربری، صندوق چت همکاران و پیش‌نویس یا پاسخ خودکار تیکت. کلید گیسو را در تنظیمات ماژول بگذارید؛
در همان تنظیمات، فیلد API address را هم می‌توانید https://gisoo.pro/api/v1 بگذارید.
- معرفی و دانلود: صفحهٔ ماژول
- کد منبع: github.com/netarz/netarz-ai-whmcs
ابزارهای دیگر
AnythingLLM، Vercel AI SDK (نمونه) و بیشتر کتابخانه‌های ایجنت هم گزینهٔ سازگار با OpenAI دارند و با همان سه مقدار بالا وصل می‌شوند. در ابزارهای خودکارسازی مثل Zapier و Make، از ماژول درخواست HTTP استفاده کنید. اگر ابزاری فقط نام مدل‌های OpenAI را می‌پذیرد، از مدل‌های OpenAI گیسو استفاده کنید؛ نام آن‌ها همان نام OpenAI است.
بیشتر اشکال‌ها از یکی از این سه است: نشانی پایه بدون /v1 یا با /chat/completions اضافه، شناسهٔ مدلی که در GET /models نیست، یا ابزاری که کلید را در هدر دیگری می‌فرستد. اگر باز کار نکرد، نام ابزار و X-Request-Id یک درخواست ناموفق را در تیکت بفرستید.
پاسخ پرسشتان را پیدا نکردید؟
شناسهٔ درخواست (هدر X-Request-Id) را با پرسشتان در تیکت بفرستید تا دقیق بررسی کنیم.
