API هوش مصنوعی دیپفا،
سازگار با OpenAI
مدلهای GPT، Claude، Gemini، Grok و DeepSeek پشت یک آدرس و یک کلید. چون API دقیقاً همان استاندارد OpenAI است، کتابخانهها و ابزارهایی که همین حالا دارید — از کتابخانهٔ رسمی پایتون و جاوااسکریپت تا افزونههای VS Code و Cursor — فقط با عوض کردن آدرس پایه به دیپفا وصل میشوند و با اعتبار ریالی کار میکنند.
یک آدرس عوض کنید، همهجا کار میکند
منظور از «سازگار با OpenAI» این است که شکل درخواست و پاسخ API ما دقیقاً همان استاندارد OpenAI است — نه اینکه فقط مدلهای OpenAI را میدهیم. به همین دلیل هر برنامه، کتابخانه یا سرویسی که با OpenAI کار میکند — کد خودتان، سرور، اپ موبایل، اتوماسیون، افزونههای VS Code و Cursor — فقط با عوض کردن آدرس پایه به دیپفا وصل میشود و مدلهای GPT، Claude، Gemini، Grok و DeepSeek را با اعتبار ریالی اجرا میکند.
curl https://deepfa.ir/api/v1/chat/completions \ -H "Authorization: Bearer $DEEPFA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-5.4-mini", "messages": [{"role": "user", "content": "سلام"}] }'
from openai import OpenAI client = OpenAI( api_key="YOUR_DEEPFA_KEY", base_url="https://deepfa.ir/api/v1", ) answer = client.chat.completions.create( model="claude-sonnet-5", messages=[{"role": "user", "content": "سلام"}], ) print(answer.choices[0].message.content)
import OpenAI from "openai"; const client = new OpenAI({ apiKey: "YOUR_DEEPFA_KEY", baseURL: "https://deepfa.ir/api/v1", }); const answer = await client.chat.completions.create({ model: "gemini-3-flash-preview", messages: [{ role: "user", content: "سلام" }], });
مسیرهای در دسترس
| POST | /chat/completions | گفتوگو، با استریم و فراخوانی ابزار |
| GET | /models | مدلهایی که کلید شما اجازه دارد |
| POST | /embeddings | تبدیل متن به بردار، برای جستوجو |
| POST | /images/generations | ساخت تصویر |
| POST | /audio/transcriptions | تبدیل گفتار به متن |
| POST | /audio/speech | تبدیل متن به گفتار |
| POST | /agents/runs | اجرای ایجنت: پژوهش، تحلیل داده یا ساخت سایت |
| GET | /agents/runs/{id} | وضعیت اجرا و فایلهای آن |
همهٔ مسیرها از یک اعتبار API خرج میکنند: گفتوگو و تبدیل متن به بردار بهاندازهٔ توکن، تصویر بهازای هر تصویر، رونوشت بهازای هر دقیقه و تبدیل متن به گفتار بهازای هر کاراکتر. هزینهٔ هر تماس در هدر پاسخ و در صفحهٔ مصرف شما نوشته میشود.
ایجنتها، از کد خودتان
ایجنت یک کار را خودش تا آخر میبرد: وب را جستوجو میکند، در یک محیط ایزوله کد مینویسد و اجرا میکند، و در پایان پاسخ بههمراه فایلهایی که ساخته تحویل میدهد — گزارش، نمودار، اکسل یا یک صفحهٔ وب کامل. هر سه ایجنت پنل با همان کلید از کد شما هم اجرا میشوند.
یک POST به /agents/runs با نام ایجنت و ورودیاش؛ شناسهٔ اجرا برمیگردد.
هر چند ثانیه GET /agents/runs/{id}؛ وضعیت از «در حال اجرا» به «تکمیلشده» میرسد.
پاسخ و فهرست فایلها؛ هر فایل یک آدرس دارد که با همان کلید دانلود میشود.
curl https://deepfa.ir/api/v1/agents/runs \ -H "Authorization: Bearer $DEEPFA_API_KEY" \ -H "Content-Type: application/json" \ -d '{"agent":"research","input":{"topic":"...","depth":"standard","language":"fa"}}'
هزینهٔ اجرا در پایان از اعتبار API کم میشود: مصرف مدل، هر جستوجوی وب و نشست محیط ایزوله. اجرایی که ناموفق بماند، لغو شود یا خروجی ندهد هزینهای ندارد.
قیمت هر مدل
قیمتها بهازای یک میلیون توکن است. همان کار روی مدلهای مختلف تا بیست برابر تفاوت دارد، پس پیش از انتخاب مدل این جدول را ببینید.
| مدل | ورودی | خروجی | یک میلیون ورودی + خروجی |
|---|---|---|---|
| text-embedding-3-small openai | 60 | 0 | 96,000 ریال |
| text-embedding-3-large openai | 390 | 0 | 624,000 ریال |
| gpt-4.1-nano openai | 300 | 1,200 | 2,400,000 ریال |
| gpt-4o-mini openai | 450 | 1,800 | 3,600,000 ریال |
| gpt-4o-mini-search-preview openai | 450 | 1,800 | 3,600,000 ریال |
| gpt-5.6-luna openai | 600 | 3,600 | 6,720,000 ریال |
| gpt-5.4-nano openai | 600 | 3,750 | 6,960,000 ریال |
| deepseek-chat deepseek | 900 | 3,600 | 7,200,000 ریال |
| deepseek-flash deepseek | 900 | 3,600 | 7,200,000 ریال |
| gemini-3.1-flash-lite google | 750 | 4,500 | 8,400,000 ریال |
| sonar perplexity | 3,000 | 3,000 | 9,600,000 ریال |
| deepseek-reasoner deepseek | 1,650 | 6,600 | 13,200,000 ریال |
| gemini-2.5-flash google | 900 | 7,500 | 13,440,000 ریال |
| gemini-3-flash-preview google | 1,500 | 9,000 | 16,800,000 ریال |
| gpt-5.4-mini openai | 2,250 | 13,500 | 25,200,000 ریال |
| deepseek-v4-pro deepseek | 3,900 | 11,850 | 25,200,000 ریال |
| o4-mini openai | 3,300 | 13,200 | 26,400,000 ریال |
| sonar-reasoning perplexity | 3,000 | 15,000 | 28,800,000 ریال |
| claude-haiku-4-5 anthropic | 3,000 | 15,000 | 28,800,000 ریال |
| gemini-3.7-flash google | 4,500 | 22,500 | 43,200,000 ریال |
| gemini-3.8-flash google | 4,500 | 22,500 | 43,200,000 ریال |
| sonar-reasoning-pro perplexity | 6,000 | 24,000 | 48,000,000 ریال |
| o3 openai | 6,000 | 24,000 | 48,000,000 ریال |
| gemini-2.5-pro google | 3,750 | 30,000 | 54,000,000 ریال |
| claude-sonnet-5 anthropic | 6,000 | 30,000 | 57,600,000 ریال |
| gpt-4o-search-preview openai | 7,500 | 30,000 | 60,000,000 ریال |
| gemini-3-pro-preview google | 6,000 | 36,000 | 67,200,000 ریال |
| gemini-3.1-pro-preview google | 6,000 | 36,000 | 67,200,000 ریال |
| gpt-5.6-terra openai | 6,000 | 36,000 | 67,200,000 ریال |
| gpt-5.2 openai | 5,250 | 42,000 | 75,600,000 ریال |
| gpt-5.3-codex openai | 5,250 | 42,000 | 75,600,000 ریال |
| gpt-5.4 openai | 7,500 | 45,000 | 84,000,000 ریال |
| sonar-pro perplexity | 9,000 | 45,000 | 86,400,000 ریال |
| claude-sonnet-4-6 anthropic | 9,000 | 45,000 | 86,400,000 ریال |
| gpt-5.6-sol openai | 12,000 | 60,000 | 115,200,000 ریال |
| claude-opus-4-7 anthropic | 15,000 | 75,000 | 144,000,000 ریال |
| claude-opus-5 anthropic | 15,000 | 75,000 | 144,000,000 ریال |
| claude-opus-4-8 anthropic | 15,000 | 75,000 | 144,000,000 ریال |
| gpt-5.5 openai | 15,000 | 90,000 | 168,000,000 ریال |
| claude-fable-5-1 anthropic | 30,000 | 150,000 | 288,000,000 ریال |
| claude-fable-5 anthropic | 30,000 | 150,000 | 288,000,000 ریال |
| gpt-6-astra openai | 30,000 | 150,000 | 288,000,000 ریال |
| gpt-5.2-pro openai | 63,000 | 504,000 | 907,200,000 ریال |
عددهای ستونهای ورودی و خروجی، اعتبار بهازای یک میلیون توکن هستند. ستون آخر همان مقدار به ریال است، بر اساس قیمت ارزانترین بستهٔ API.
| مدل | واحد | اعتبار | ریال |
|---|---|---|---|
| gpt-image-1 تصویر | هر تصویر | 500 | 800,000 |
| gpt-image-2.5-flare تصویر | هر تصویر | 440 | 704,000 |
| gpt-image-2.5-sunburst تصویر | هر تصویر | 440 | 704,000 |
| tts-1 تبدیل متن به گفتار | هر ۱۰۰۰ کاراکتر | 34 | 54,400 |
| tts-1-hd تبدیل متن به گفتار | هر ۱۰۰۰ کاراکتر | 68 | 108,800 |
| gpt-4o-mini-tts تبدیل متن به گفتار | هر ۱۰۰۰ کاراکتر | 34 | 54,400 |
| whisper-1 رونوشت گفتار | هر دقیقه | 15 | 24,000 |
| gpt-4o-transcribe رونوشت گفتار | هر دقیقه | 15 | 24,000 |
| gpt-4o-mini-transcribe رونوشت گفتار | هر دقیقه | 7.5 | 12,000 |
تصویر، گفتار و رونوشت هم از همان اعتبار API خرج میکنند و ستون ریال از قیمت ارزانترین بستهٔ API حساب شده است.
در ویرایشگر خودتان
{ "models": [{ "title": "DeepFA", "provider": "openai", "model": "claude-sonnet-5", "apiKey": "YOUR_DEEPFA_KEY", "apiBase": "https://deepfa.ir/api/v1" }] }
"github.copilot.chat.customOAIModels": [{ "modelId": "claude-sonnet-5", "displayName": "DeepFA Claude Sonnet 5", "endpoint": "https://deepfa.ir/api/v1", "apiKey": "YOUR_DEEPFA_KEY" }]
# Settings → Models → OpenAI API Base URL: https://deepfa.ir/api/v1 API Key: YOUR_DEEPFA_KEY Model: gpt-5.4 / claude-sonnet-5
Provider: OpenAI Compatible Base URL: https://deepfa.ir/api/v1 API Key: YOUR_DEEPFA_KEY Model ID: claude-sonnet-5
کلیدها را از پیشخوان خودتان میسازید و هر زمان باطل میکنید. برای هر کلید میتوانید سقف مصرف روزانه و ماهانه بگذارید.
یک دروازهٔ سازگار با OpenAI، برای توسعهدهندگان و کسبوکارها
API هوش مصنوعی دیپفا یک دروازهٔ سازگار با استاندارد OpenAI است: همان مسیر /v1/chat/completions، همان بدنهٔ درخواست، همان شکل پاسخ و همان قالب خطا. یعنی هر کتابخانه، افزونه یا سرویسی که امروز با OpenAI کار میکند، تنها با عوض کردن آدرس پایه و کلید به دیپفا وصل میشود — بدون بازنویسی کد، بدون SDK اختصاصی و بدون یاد گرفتن یک قرارداد جدید. پشت این یک آدرس، مدلهای GPT، Claude، Gemini، Grok و DeepSeek قرار دارند و عوض کردن مدل فقط عوض کردن یک رشته در فیلد model است.
علاوه بر گفتوگو، تبدیل متن به بردار برای جستوجوی معنایی و RAG، ساخت تصویر، تبدیل گفتار به متن و تبدیل متن به گفتار هم از همین آدرس در دسترساند. استریم بهصورت SSE، فراخوانی ابزار، خروجی ساختاریافته و ارسال تصویر همگی پشتیبانی میشوند و دقیقاً همانطور رفتار میکنند که در سرویس اصلی انتظار دارید. هزینهٔ هر تماس در هدر پاسخ برمیگردد و در صفحهٔ API پنل کاربری، به تفکیک کلید و مدل ثبت میشود؛ درخواستهای ناموفق هم ثبت میشوند تا هیچوقت ندانید اعتبارتان کجا رفته است.
برای توسعهدهندهٔ ایرانی مهمترین تفاوت، پرداخت است: اعتبار را با درگاه داخلی و به ریال میخرید، کارت بینالمللی لازم نیست و اعتبار خریداریشده تاریخ انقضا ندارد. روی هر کلید میتوانید سقف اعتبار روزانه و ماهانه، سقف تعداد درخواست در دقیقه و فهرست مدلهای مجاز بگذارید، پس کلیدی که به یک اسکریپت یا همکارتان میدهید نمیتواند کل حساب را خالی کند و در صورت لو رفتن با یک کلیک باطل میشود.
چرا API هوش مصنوعی دیپفا؟
طراحیشده با تمرکز بر نیاز توسعهدهندگان — ساده برای شروع، امن در استفاده و مقیاسپذیر برای رشد.
سازگار با OpenAI
همان مسیرها، همان بدنهٔ درخواست، همان شکل پاسخ. کتابخانهٔ رسمی OpenAI و هر ابزاری که با آن کار میکند، فقط با عوض کردن آدرس پایه به دیپفا وصل میشود.
یک کلید برای همهٔ فروشندهها
GPT، Claude، Gemini، Grok و DeepSeek پشت یک کلید و یک آدرس. عوض کردن مدل یعنی عوض کردن یک رشته در درخواست، نه عوض کردن کتابخانه و حساب و صورتحساب.
استریم، ابزار و ورودی تصویری
پاسخ کلمهبهکلمه با SSE، فراخوانی ابزار (function calling)، خروجی ساختاریافته و ارسال تصویر — همه بدون تغییر در کدی که از قبل نوشتهاید.
سقف خرج روی هر کلید
برای هر کلید سقف روزانه و ماهانه، محدودیت تعداد درخواست در دقیقه و فهرست مدلهای مجاز تعیین کنید. کلیدی که به یک اسکریپت میدهید نمیتواند کل حساب را خالی کند.
هزینهٔ هر تماس، جداگانه
هزینهٔ هر درخواست در هدر پاسخ برمیگردد و در صفحهٔ مصرف شما به تفکیک کلید و مدل ثبت میشود — خطاها هم. اعتبار برای شما یک چاه سیاه نیست.
پرداخت ریالی، بدون کارت ارزی
اعتبار را با درگاه داخلی میخرید و اعتبار خریداریشده تاریخ انقضا ندارد. نه کارت بینالمللی لازم است، نه تحریم دور زدن.
مسیرهایی که میتوانید صدا بزنید
همه زیر یک آدرس پایه، همه با همان کلید، همه با همان شکل درخواست و پاسخی که از OpenAI میشناسید.
شروع سریع در ۶ زبان برنامهنویسی
همان درخواست در شش زبان. تنها چیزی که با OpenAI فرق دارد، آدرس پایه و کلید است.
curl https://deepfa.ir/api/v1/chat/completions \
-H "Authorization: Bearer $DEEPFA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"messages": [{"role": "user", "content": "Hello"}]
}'
# pip install openai
from openai import OpenAI
client = OpenAI(
api_key="YOUR_DEEPFA_KEY",
base_url="https://deepfa.ir/api/v1",
)
completion = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "Hello"}],
)
print(completion.choices[0].message.content)
print(completion.usage.total_tokens, "tokens")
// Any fetch, no SDK needed.
const res = await fetch('https://deepfa.ir/api/v1/chat/completions', {
method: 'POST',
headers: {
'Authorization': `Bearer ${DEEPFA_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'gpt-5.4',
messages: [{ role: 'user', content: 'Hello' }],
stream: false
})
});
const data = await res.json();
console.log(data.choices[0].message.content);
// What the call cost, straight off the response header.
console.log(res.headers.get('x-deepfa-credits'), 'credits');
// npm install openai
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: process.env.DEEPFA_API_KEY,
baseURL: 'https://deepfa.ir/api/v1'
});
// Streaming works exactly as it does upstream.
const stream = await client.chat.completions.create({
model: 'gemini-3.8-flash',
messages: [{ role: 'user', content: 'Write a haiku' }],
stream: true
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? '');
}
<?php
$ch = curl_init('https://deepfa.ir/api/v1/chat/completions');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('DEEPFA_API_KEY'),
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'model' => 'deepseek-chat',
'messages' => [['role' => 'user', 'content' => 'Hello']],
]),
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
echo $result['choices'][0]['message']['content'];
package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
"os"
)
func main() {
body, _ := json.Marshal(map[string]any{
"model": "claude-haiku-4-5",
"messages": []map[string]string{
{"role": "user", "content": "Hello"},
},
})
req, _ := http.NewRequest("POST",
"https://deepfa.ir/api/v1/chat/completions",
bytes.NewBuffer(body))
req.Header.Set("Authorization", "Bearer "+os.Getenv("DEEPFA_API_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
var out map[string]any
json.NewDecoder(res.Body).Decode(&out)
fmt.Println(out["choices"])
}
{
"id": "chatcmpl-9f2c1a",
"object": "chat.completion",
"model": "claude-sonnet-5",
"choices": [{
"index": 0,
"message": { "role": "assistant", "content": "Hello!" },
"finish_reason": "stop"
}],
"usage": {
"prompt_tokens": 12,
"completion_tokens": 306,
"total_tokens": 318
}
}
data: {"id":"chatcmpl-9f2c1a","object":"chat.completion.chunk",
"choices":[{"delta":{"content":"Hel"},"index":0}]}
data: [DONE]
{
"object": "list",
"model": "text-embedding-3-small",
"data": [{ "object": "embedding", "index": 0,
"embedding": [0.0021, -0.0134, 0.0075] }],
"usage": { "prompt_tokens": 8, "total_tokens": 8 }
}
{
"created": 1788115200,
"data": [{ "url": "https://.../img_x7k2m.png" }]
}
x-deepfa-request-id: 3f9a1c2e-... x-deepfa-credits: 0.0954 x-deepfa-credit-unit: credits
{
"error": {
"message": "You have run out of credit.",
"type": "insufficient_quota",
"param": null,
"code": "insufficient_quota"
}
}
در چهار گام ساده اولین درخواست را بفرستید
از ساخت کلید تا اولین پاسخ، کمتر از یک دقیقه. هیچ ثبت اپلیکیشن و گردش OAuthای در کار نیست.
ساخت کلید API
وارد حساب خود شوید، به صفحهٔ API بروید و یک کلید بسازید. کلید فقط یک بار نمایش داده میشود، پس همانجا کپیاش کنید.
عوض کردن آدرس پایه
در ابزار یا کتابخانهای که دارید، آدرس پایه را روی https://deepfa.ir/api/v1 بگذارید و کلید را بهعنوان API key وارد کنید.
انتخاب مدل
نام مدل را در همان فیلد model بنویسید — claude-sonnet-5، gpt-5.4، gemini-3.8-flash یا هر مدل دیگری که کلیدتان اجازه دارد.
دیدن هزینه
هزینهٔ هر تماس در هدر x-deepfa-credits برمیگردد و در صفحهٔ API به تفکیک کلید و مدل ثبت میشود.
نگاهی به محیط کاربری API
رابط کاربری ساده و کاربردی — روی هر تصویر کلیک کنید تا بزرگتر ببینید.
پرسشهای پرتکرار درباره API هوش مصنوعی دیپفا
پاسخ سوالات رایج توسعهدهندگان درباره استفاده از API — اگر پاسخ سوال خود را پیدا نکردید، با پشتیبانی تماس بگیرید.
کلید API خود را دریافت کنید و امروز پروژهتان را بسازید
ثبتنام رایگان، ساخت کلید در چند ثانیه، و اعتباری که تاریخ انقضا ندارد