جایگزین OpenAI API؛ همان SDK با دو خط تغییر

Q: برای رفتن از OpenAI به گیسو چه چیزی را باید عوض کنم؟

در بیشتر پروژهها فقط base_url و api_key. نشانی گیسو https://gisoo.pro/api/v1 است و کلید را از بخش API اپ میگیرید.

Q: آیا گیسو همان OpenAI است؟

نه. گیسو برند مستقلی است که مدلهای OpenAI و سازندگان دیگر را از راه یک API سازگار میفروشد و نمایندهٔ OpenAI نیست.

Q: با LangChain یا ابزارهای دیگر چه؟

هر ابزاری که نشانی پایه و کلید OpenAI را از شما میگیرد، با نشانی و کلید گیسو هم کار میکند؛ متغیرهای OPENAI_BASE_URL و OPENAI_API_KEY معمولاً کافیاند.

Q: پرداخت چطور است؟

اعتبار را با کارت بانکی ایرانی شارژ میکنید. اشتراک ماهانه نیست و هزینه بهاندازهٔ مصرف از اعتبار کم میشود. حداقل شارژ ۵۰٬۰۰۰ سکه است.

جایگزین OpenAI API با همان SDK

API گیسو فرمت OpenAI را می‌پذیرد، پس برای رفتن از OpenAI به گیسو فقط دو مقدار را عوض می‌کنید: base_url و api_key. بقیهٔ کد، از chat.completions تا embeddings، همان می‌ماند. با همین SDK می‌توانید مدل‌های سازندگان دیگر را هم صدا بزنید و پرداخت را به تومان انجام دهید. گیسو نمایندهٔ OpenAI نیست و بخشی از خدمات آن، مثل batch و fine-tuning، را ندارد.

from openai import OpenAI client = OpenAI( base_url="https://gisoo.pro/api/v1", # was: https://api.openai.com/v1 api_key="sk-gisoo-v1-...", # your Gisoo key ) reply = client.chat.completions.create( model="gpt-4o-mini", messages=[{"role": "user", "content": "سلام"}], ) print(reply.choices[0].message.content)

import OpenAI from "openai"; const client = new OpenAI({ baseURL: "https://gisoo.pro/api/v1", // was: https://api.openai.com/v1 apiKey: process.env.GISOO_API_KEY, }); const reply = await client.chat.completions.create({ model: "gpt-4o-mini", messages: [{ role: "user", content: "سلام" }], }); console.log(reply.choices[0].message.content);

خلاصهٔ مشخصات

نشانی پایه: https://gisoo.pro/api/v1
کلید: کلید گیسو (sk-gisoo-v1-...) از بخش API اپ
کتابخانه‌ها: OpenAI SDK پایتون و Node، LangChain، LlamaIndex و هر ابزاری که OpenAI را می‌شناسد
مدل‌ها: ۶۷۵ مدل از ۷۳ سازنده، با همین SDK
هزینه: اعتبار پیش‌پرداخت به سکه، از ۵۰٬۰۰۰ سکه؛ بدون اشتراک

مهاجرت در چهار قدم

۱

کلید بسازید

در اپ گیسو، بخش API، کلید جدید بسازید و اعتبار را شارژ کنید.
۲

base_url را عوض کنید

به‌جای https://api.openai.com/v1 بنویسید https://gisoo.pro/api/v1.
۳

api_key را عوض کنید

کلید گیسو را بگذارید. ترجیحاً از متغیر محیطی بخوانید.
۴

مدل را بنویسید

نام مدل را از کتابخانهٔ مدل‌ها بردارید؛ مدل‌های GPT و مدل‌های دیگر هر دو با همین فرمت صدا زده می‌شوند.

چه چیزی سازگار است

مسیر	وضعیت
chat/completions و completions	پشتیبانی می‌شود، با پاسخ جریانی (streaming)
responses	پشتیبانی می‌شود
embeddings	پشتیبانی می‌شود
images/generations	پشتیبانی می‌شود
audio: transcriptions، translations، speech	پشتیبانی می‌شود؛ ساخت موسیقی هم مسیر جدا دارد
moderations و videos	پشتیبانی می‌شود
models، me، usage	فهرست مدل‌ها، اطلاعات کلید و گزارش مصرف
messages (فرمت Anthropic)	پشتیبانی می‌شود؛ مسیر Claude Code
batch	ندارد
fine-tuning	ندارد
assistants	ندارد

پیش از مهاجرت بدانید

اگر کدتان به Batch API، fine-tuning یا Assistants وابسته است، آن بخش را باید جدا نگه دارید یا با chat.completions و ابزارهای خودتان بازنویسی کنید.

مدل‌ها دلاری قیمت‌گذاری می‌شوند و از اعتبار به سکه کم می‌شوند؛ قیمت امروز هر مدل در کتابخانهٔ مدل‌ها و تعرفه‌ها آمده است. پیش از جابه‌جایی، یک مدل ارزان را روی کار واقعی خودتان امتحان کنید.

فراتر از مدل‌های OpenAI

چون فرمت یکی است، با عوض کردن فیلد model می‌توانید همان کد را روی مدل‌های سازندگان دیگر اجرا کنید. این برای مقایسهٔ کیفیت و هزینه ساده‌ترین راه است.

راهنمای فنی: مهاجرت از OpenAI · شروع سریع · تعرفه‌ها

پرسش‌های پرتکرار

برای رفتن از OpenAI به گیسو چه چیزی را باید عوض کنم؟

در بیشتر پروژه‌ها فقط base_url و api_key. نشانی گیسو https://gisoo.pro/api/v1 است و کلید را از بخش API اپ می‌گیرید.

آیا گیسو همان OpenAI است؟

نه. گیسو برند مستقلی است که مدل‌های OpenAI و سازندگان دیگر را از راه یک API سازگار می‌فروشد و نمایندهٔ OpenAI نیست.

کدام قابلیت‌های OpenAI را ندارد؟

Batch API، fine-tuning و Assistants در گیسو نیست. چت، responses، بردار، تصویر، گفتار، moderation و ویدیو هست.

streaming کار می‌کند؟

بله. پاسخ جریانی در chat.completions و responses پشتیبانی می‌شود و کتابخانه‌های OpenAI همان‌طور که انتظار دارید آن را می‌خوانند.

با LangChain یا ابزارهای دیگر چه؟

هر ابزاری که نشانی پایه و کلید OpenAI را از شما می‌گیرد، با نشانی و کلید گیسو هم کار می‌کند؛ متغیرهای OPENAI_BASE_URL و OPENAI_API_KEY معمولاً کافی‌اند.

پرداخت چطور است؟

اعتبار را با کارت بانکی ایرانی شارژ می‌کنید. اشتراک ماهانه نیست و هزینه به‌اندازهٔ مصرف از اعتبار کم می‌شود. حداقل شارژ ۵۰٬۰۰۰ سکه است.