یکپارچه‌سازی‌ها

هر ابزاری که گزینهٔ «OpenAI-compatible» یا تنظیم «Base URL» دارد، با کلید گیسو کار می‌کند. در همه‌شان سه چیز را پر می‌کنید:

Cursor#

1. تنظیمات مدل‌ها را باز کنید

   در Cursor به Settings → Models بروید.

2. کلید و نشانی را بدهید

   در بخش OpenAI API Key کلید گیسو را بگذارید، گزینهٔ Override OpenAI Base URL را روشن کنید و https://gisoo.pro/api/v1 را وارد کنید.

3. مدل را اضافه کنید

   با Add model شناسهٔ مدل گیسو را اضافه کنید (مثلاً openrouter/anthropic/claude-sonnet-4.5) و فقط همان را برای چت روشن نگه دارید.

Cursor درخواست‌ها را از سرورهای خودش به نشانی شما می‌فرستد و بعضی قابلیت‌هایش (مثل تکمیل خودکار Tab) همیشه با مدل‌های خود Cursor کار می‌کنند؛ کلید گیسو برای چت و ویرایش با مدلی که انتخاب کرده‌اید به کار می‌رود.

Continue (VS Code و JetBrains)#

Continue یک افزونهٔ متن‌باز دستیار کدنویسی است. در فایل تنظیمش برای هر مدل provider: openai و apiBase گیسو را بگذارید؛ می‌توانید برای چت، تکمیل خودکار و امبدینگ مدل جدا انتخاب کنید:

# ~/.continue/config.yaml
name: Gisoo
version: 1.0.0
schema: v1
models:
  - name: Gisoo · Claude
    provider: openai
    model: openrouter/anthropic/claude-sonnet-4.5
    apiBase: https://gisoo.pro/api/v1
    apiKey: sk-gisoo-v1-...
    roles: [chat, edit, apply]
  - name: Gisoo · autocomplete
    provider: openai
    model: gpt-4o-mini
    apiBase: https://gisoo.pro/api/v1
    apiKey: sk-gisoo-v1-...
    roles: [autocomplete]
  - name: Gisoo · embeddings
    provider: openai
    model: text-embedding-3-small
    apiBase: https://gisoo.pro/api/v1
    apiKey: sk-gisoo-v1-...
    roles: [embed]

Cline#

1. نوع اتصال را انتخاب کنید

   در تنظیمات Cline، API Provider را OpenAI Compatible بگذارید.

2. سه فیلد را پر کنید

   Base URL: https://gisoo.pro/api/v1، API Key: کلید گیسو، Model ID: مثلاً openrouter/anthropic/claude-sonnet-4.5.

3. اندازهٔ ورودی مدل را درست بگذارید

   در Model Configuration، پنجرهٔ ورودی (Context Window) و پشتیبانی تصویر را مطابق GET /models همان مدل تنظیم کنید.

Cline برای هر کار چندین درخواست با ورودی بلند می‌فرستد؛ مدلی انتخاب کنید که فراخوانی ابزار را خوب انجام می‌دهد (Claude یا GPT-4.1 به بالا) و حتماً روی کلیدش سقف هزینه بگذارید.

n8n#

1. یک Credential از نوع OpenAI بسازید

   در Credentials → New → OpenAI کلید گیسو را در API Key و https://gisoo.pro/api/v1 را در Base URL بگذارید.

2. در گره‌های OpenAI از همین Credential استفاده کنید

   در گره OpenAI Chat Model یا OpenAI، مدل را با گزینهٔ By ID بنویسید تا هر مدل گیسو، از جمله Claude و Gemini، قابل انتخاب باشد.

اگر نسخهٔ n8n شما فیلد Base URL ندارد، از گره HTTP Request استفاده کنید:

{
  "method": "POST",
  "url": "https://gisoo.pro/api/v1/chat/completions",
  "headers": { "Authorization": "Bearer {{$credentials.gisooKey}}" },
  "body": {
    "model": "gpt-4o-mini",
    "messages": [{ "role": "user", "content": "={{$json.question}}" }]
  }
}

LangChain#

# pip install langchain-openai
from langchain_openai import ChatOpenAI, OpenAIEmbeddings

llm = ChatOpenAI(model="gpt-4o-mini", base_url="https://gisoo.pro/api/v1", api_key="sk-gisoo-v1-...", temperature=0.3)
print(llm.invoke("Summarise the plot of Shahnameh in two lines.").content)

embeddings = OpenAIEmbeddings(model="text-embedding-3-small", base_url="https://gisoo.pro/api/v1", api_key="sk-gisoo-v1-...")
vector = embeddings.embed_query("hello")

# Claude through the same class:
claude = ChatOpenAI(model="openrouter/anthropic/claude-sonnet-4.5", base_url="https://gisoo.pro/api/v1", api_key="sk-gisoo-v1-...")

// npm install @langchain/openai
import { ChatOpenAI, OpenAIEmbeddings } from "@langchain/openai";

const llm = new ChatOpenAI({
  model: "gpt-4o-mini",
  apiKey: process.env.GISOO_API_KEY,
  configuration: { baseURL: "https://gisoo.pro/api/v1" },
});
const res = await llm.invoke("Summarise the plot of Shahnameh in two lines.");

const embeddings = new OpenAIEmbeddings({
  model: "text-embedding-3-small",
  apiKey: process.env.GISOO_API_KEY,
  configuration: { baseURL: "https://gisoo.pro/api/v1" },
});

ایجنت‌ها، ابزارها (bind_tools) و خروجی ساختاریافته (with_structured_output) در LangChain همان‌طور کار می‌کنند، به شرط آن‌که مدل انتخابی آن قابلیت را داشته باشد.

LlamaIndex#

برای مدل‌های گفت‌وگو از OpenAILike استفاده کنید؛ کلاس OpenAI خود LlamaIndex فقط نام مدل‌های OpenAI را می‌شناسد:

# 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?"))

Dify#

1. اتصال سازگار با OpenAI را اضافه کنید

   در Settings → Model Provider، گزینهٔ OpenAI-API-compatible را اضافه کنید.

2. مدل را تعریف کنید

   برای هر مدل: Model Name شناسهٔ گیسو، API Key کلید گیسو، API endpoint URL برابر https://gisoo.pro/api/v1، و نوع مدل (LLM یا Text Embedding).

3. توانایی‌های مدل را درست تنظیم کنید

   اندازهٔ ورودی (Context size)، پشتیبانی Function Calling و Vision را مطابق GET /models همان مدل تنظیم کنید تا ایجنت‌ها و پایگاه دانش Dify درست کار کنند.

Open WebUI#

یک رابط چت متن‌باز که روی سرور خودتان نصب می‌شود؛ برای تیمی که یک چت داخلی با مدل‌های گیسو می‌خواهد. هنگام اجرا نشانی و کلید را بدهید:

docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://gisoo.pro/api/v1 \
  -e OPENAI_API_KEY=sk-gisoo-v1-... \
  -v open-webui:/app/backend/data \
  --name open-webui ghcr.io/open-webui/open-webui:main

یا بعد از نصب، در Admin Panel → Settings → Connections یک اتصال OpenAI با همین نشانی و کلید بسازید. Open WebUI فهرست مدل‌ها را از /models می‌خواند که صدها مدل دارد؛ در تنظیم همان اتصال، در Model IDs فقط مدل‌هایی را که تیمتان لازم دارد نگه دارید.

افزونهٔ هوش مصنوعی وردپرس#

افزونهٔ متن‌باز «NetArz AI» برای وردپرس و ووکامرس: چت پشتیبانی که از مطالب و محصولات همان سایت جواب می‌دهد و هرجا مطمئن نبود گفت‌وگو را به همکار شما می‌سپارد، تیکت و ابزار نوشتن در ویرایشگر. این افزونه را تیم نِت اَرز ساخته و چون حساب و کلیدها یکی است، کلید گیسو را هم در تنظیماتش می‌پذیرد و هزینهٔ هر پاسخ از همان اعتبار کم می‌شود.

• معرفی و دانلود: صفحهٔ افزونه
• کد منبع: github.com/netarz/netarz-ai-wordpress

ماژول هوش مصنوعی WHMCS#

ماژول متن‌باز «NetArz AI for WHMCS» برای شرکت‌های هاستینگ: چت آنلاین در ناحیهٔ کاربری، صندوق چت همکاران و پیش‌نویس یا پاسخ خودکار تیکت. کلید گیسو را در تنظیمات ماژول بگذارید؛ در همان تنظیمات، فیلد API address را هم می‌توانید https://gisoo.pro/api/v1 بگذارید.

• معرفی و دانلود: صفحهٔ ماژول
• کد منبع: github.com/netarz/netarz-ai-whmcs

ابزارهای دیگر#

LibreChat، Flowise، AnythingLLM و بیشتر کتابخانه‌های ایجنت هم گزینهٔ سازگار با OpenAI دارند و با همان سه مقدار بالا وصل می‌شوند. در ابزارهای خودکارسازی مثل Zapier و Make، از ماژول درخواست HTTP استفاده کنید. اگر ابزاری فقط نام مدل‌های OpenAI را می‌پذیرد، از مدل‌های OpenAI گیسو استفاده کنید؛ نام آن‌ها همان نام OpenAI است.