آموزش / ابزارها در عمل / درس ۵ از ۱۵
اتصال ابزارهای کدنویسی به سرویسهای ایرانی (API سازگار با OpenAI)
با عوض کردن دو مقدار — آدرس پایه و کلید — بیشتر ابزارها و کتابخانهها به درواره، اولایآی، گپجیپیتی یا هر سرویس سازگار دیگر وصل میشوند.
مقدماتی، ۸ دقیقه مطالعه
در این آموزش
بیشتر سرویسهای ایرانی API خود را سازگار با OpenAI ارائه میکنند. یعنی هر ابزار یا کتابخانهای که با OpenAI کار میکند، با تغییر دو مقدار به آنها هم وصل میشود:
- آدرس پایه (Base URL): مثلاً
https://api.darvareh.ir/v1یاhttps://api.avalai.ir/v1یاhttps://api.gapgpt.app/v1 - کلید API: از پنل همان سرویس
شناسهی دقیق مدلها (مثلاً نام مدل Claude یا GPT) در هر سرویس ممکن است کمی فرق کند؛ آن را از فهرست مدلهای پنل بردارید.
پایتون
from openai import OpenAI
client = OpenAI(
base_url="https://api.avalai.ir/v1", # آدرس پایهی سرویس شما
api_key="YOUR_API_KEY",
)
resp = client.chat.completions.create(
model="MODEL_ID", # شناسهی مدل از پنل سرویس
messages=[{"role": "user", "content": "یک تابع پایتون برای اعتبارسنجی کد ملی بنویس."}],
)
print(resp.choices[0].message.content)جاوااسکریپت / Node.js
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.darvareh.ir/v1",
apiKey: process.env.AI_API_KEY,
});
const r = await client.chat.completions.create({
model: "MODEL_ID",
messages: [{ role: "user", content: "این خطا را توضیح بده: ..." }],
});
console.log(r.choices[0].message.content);Cline و Roo Code و Kilo Code
در تنظیمات افزونه، ارائهدهنده را OpenAI Compatible بگذارید، سپس Base URL، کلید و شناسهی مدل را وارد کنید.
Continue
در فایل تنظیمات Continue یک مدل با ارائهدهندهی openai و مقدار apiBase تعریف کنید:
models:
- name: My Coding Model
provider: openai
model: MODEL_ID
apiBase: https://api.gapgpt.app/v1
apiKey: YOUR_API_KEYAider
export OPENAI_API_BASE=https://api.avalai.ir/v1
export OPENAI_API_KEY=YOUR_API_KEY
aider --model openai/MODEL_IDOpenCode
در فایل opencode.json یک ارائهدهنده تعریف کنید:
{
"provider": {
"myprovider": {
"npm": "@ai-sdk/openai-compatible",
"name": "My Provider",
"options": { "baseURL": "https://api.darvareh.ir/v1", "apiKey": "YOUR_API_KEY" },
"models": { "MODEL_ID": {} }
}
}
}Cursor
در تنظیمات مدلها، گزینهی بازنویسی آدرس پایهی OpenAI را فعال کنید و آدرس و کلید سرویس را بدهید. درواره راهنمای تصویری این کار را منتشر کرده است.
Claude Code
Claude Code با API به سبک Anthropic کار میکند. اگر سرویس شما مسیر سازگار با Anthropic دارد (مثلاً درواره راهنمای اتصال Claude Code را منتشر کرده)، کافی است این متغیرها را تنظیم کنید:
export ANTHROPIC_BASE_URL=آدرس-اعلامشده-در-راهنمای-سرویس
export ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY
claudeنکتههای امنیتی
- کلید را هرگز داخل کد یا مخزن گیت نگذارید؛ از متغیر محیطی یا فایل
.env(در.gitignore) استفاده کنید. - برای هر پروژه یک کلید جدا بسازید تا اگر لو رفت، فقط همان را باطل کنید.
- برای کلیدها سقف مصرف تعیین کنید؛ یک ایجنت در حلقهی بیپایان میتواند در چند ساعت اعتبار زیادی مصرف کند.