مدل‌ها و انتخاب مدل

در هر درخواست، فیلد model می‌گوید کدام مدل جواب بدهد. شناسهٔ مدل‌ها را از فهرست زندهٔ گیسو بردارید، نه از حافظه: مدل تازه اضافه می‌شود، قیمت‌ها با قیمت سرویس‌دهنده عوض می‌شوند و مدلی که پایدار نباشد از فروش برداشته می‌شود. امروز ۴۳۷ مدل از ۵۱ سازنده در فهرست است.

فهرست زندهٔ مدل‌ها#

GET /models کلید نمی‌خواهد و هر مدل را با قیمت و توانایی‌هایش برمی‌گرداند. همین فهرست را صفحهٔ کتابخانهٔ مدل‌ها با جزئیات بیشتر نشان می‌دهد.

# Every model on sale, with prices (no key needed)
curl https://gisoo.pro/api/v1/models

# Only one family: chat | embedding | image | audio_stt | audio_tts | video | music
curl "https://gisoo.pro/api/v1/models?type=embedding"

# One model
curl https://gisoo.pro/api/v1/models/gpt-4o-mini

from openai import OpenAI

client = OpenAI(base_url="https://gisoo.pro/api/v1", api_key="sk-gisoo-v1-...")

for model in client.models.list():
    print(model.id)

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://gisoo.pro/api/v1", apiKey: process.env.GISOO_API_KEY });

for await (const model of client.models.list()) {
  console.log(model.id);
}

هر مدل در فهرست این شکل را دارد:

{
  "id": "gpt-4o-mini",
  "object": "model",
  "owned_by": "openai",
  "name": "GPT-4o mini",
  "type": "chat",
  "context_length": 128000,
  "max_output_tokens": 16384,
  "capabilities": { "streaming": true, "tools": true, "json": true, "vision": true },
  "is_free": false,
  "pricing": {
    "input_per_million": "0.210000",
    "output_per_million": "0.840000",
    "cached_input_per_million": "0.105000"
  },
  "pricing_unit": "USD per 1M tokens unless stated (per_image, per_minute, per_second, per_million_characters, per_request)"
}

• id همان مقداری است که در فیلد model می‌فرستید.
• type خانوادهٔ مدل است و می‌گوید مدل را به کدام endpoint بفرستید (جدول پایین).
• capabilities توانایی‌ها را می‌گوید: vision (خواندن تصویر)، tools (فراخوانی ابزار)، json (خروجی JSON)، reasoning (مدل استدلالی)، streaming.
• pricing قیمت به دلار است؛ برای مدل‌های متنی به‌ازای یک میلیون توکن. نام هر کلید واحدش را می‌گوید، مثل per_second برای ویدیو.
• context_length بیشترین طول ورودی و خروجی با هم، به توکن.

شناسه‌ها: مستقیم و از راه OpenRouter#

مدل‌های گیسو از دو راه می‌آیند و شناسه‌شان این را نشان می‌دهد:

برای مدل‌های OpenRouter، شکل کوتاه‌تر <vendor>/<model> هم پذیرفته می‌شود؛ مثلاً anthropic/claude-sonnet-4.5 همان openrouter/anthropic/claude-sonnet-4.5 است. پاسخ همیشه شناسهٔ کامل را در فیلد model برمی‌گرداند.

هر خانواده، یک endpoint#

اگر مدلی را به endpoint نادرست بفرستید، خطای 400 model_endpoint_mismatch می‌گیرید و متن خطا endpoint درست را نام می‌برد.

برای هر کار کدام مدل#

قیمت‌های این جدول زنده‌اند و از همان فهرستی می‌آیند که صورتحساب با آن حساب می‌شود.

• شروع کار و آزمایش: مدل‌های کوچک مثل gpt-4o-mini ارزان و سریع‌اند و برای بیشتر کارهای روزمره کافی‌اند.
• کدنویسی و متن دقیق: openrouter/anthropic/claude-sonnet-4.5 یا gpt-4.1.
• مسئلهٔ چندمرحله‌ای (ریاضی، برنامه‌ریزی، تحلیل): مدل‌های استدلالی مثل gpt-5-mini. پیش از پاسخ فکر می‌کنند و توکن فکر کردن هم جزو خروجی حساب می‌شود.
• سند بلند یا چندرسانه‌ای: gemini-3.6-flash با پنجرهٔ ورودی بزرگ.
• فارسی: مدل‌های بزرگ فارسی را خوب می‌نویسند؛ بعضی مدل‌های کوچک‌تر در فارسی ضعیف‌ترند. پیش از انتخاب نهایی، چند نمونهٔ واقعی از کار خودتان را با دو سه مدل بسنجید.

عوض کردن مدل در کد#

چون همهٔ مدل‌های متنی یک قالب دارند، مقایسهٔ چند مدل یک حلقهٔ ساده است:

# Same client, same code — only the model id changes.
for model in ["gpt-4o-mini", "openrouter/anthropic/claude-sonnet-4.5", "gemini-3.6-flash", "deepseek-v4-flash"]:
    reply = client.chat.completions.create(
        model=model,
        messages=[{"role": "user", "content": "In one sentence: what is recursion?"}],
        max_tokens=80,
    )
    print(model, "→", reply.choices[0].message.content)