رابط برنامه‌نویسی هوش مصنوعی برای توسعه‌دهندگان

API هوش مصنوعی دیپ‌فا،
سازگار با OpenAI

مدل‌های GPT، Claude، Gemini، Grok و DeepSeek پشت یک آدرس و یک کلید. چون API دقیقاً همان استاندارد OpenAI است، کتابخانه‌ها و ابزارهایی که همین حالا دارید — از کتابخانهٔ رسمی پایتون و جاوااسکریپت تا افزونه‌های VS Code و Cursor — فقط با عوض کردن آدرس پایه به دیپ‌فا وصل می‌شوند و با اعتبار ریالی کار می‌کنند.

۵ فروشنده
پشت یک آدرس
OpenAI
سازگار با استاندارد
ریالی
بدون کارت ارزی
🔑 یک کلید
⚡ پاسخ فوری
📄 فرمت JSON
🌐 ۵ فروشنده
POST /api/v1/chat/completions
# Authorization header Authorization: Bearer sk-deepfa-... # Request body { "model": "claude-sonnet-5", "messages": [{ "role": "user", "content": "Hello" }], "stream": true } # Sending request... https://deepfa.ir/api/v1/chat/completions
✓ 200 OK application/json
{ "id": "chatcmpl-9f2...", "model": "claude-sonnet-5", "usage": { "total_tokens": 318 } }
⚡ سازگار با OpenAI

یک آدرس عوض کنید، همه‌جا کار می‌کند

منظور از «سازگار با OpenAI» این است که شکل درخواست و پاسخ API ما دقیقاً همان استاندارد OpenAI است — نه اینکه فقط مدل‌های OpenAI را می‌دهیم. به همین دلیل هر برنامه، کتابخانه یا سرویسی که با OpenAI کار می‌کند — کد خودتان، سرور، اپ موبایل، اتوماسیون، افزونه‌های VS Code و Cursor — فقط با عوض کردن آدرس پایه به دیپ‌فا وصل می‌شود و مدل‌های GPT، Claude، Gemini، Grok و DeepSeek را با اعتبار ریالی اجرا می‌کند.

آدرس پایه
https://deepfa.ir/api/v1
cURL
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": "سلام"}]
  }'
Python
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)
Node.js
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 تبدیل متن به گفتار

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

قیمت هر مدل

قیمت‌ها به‌ازای یک میلیون توکن است. همان کار روی مدل‌های مختلف تا بیست برابر تفاوت دارد، پس پیش از انتخاب مدل این جدول را ببینید.

مدل ورودی خروجی یک میلیون ورودی + خروجی
text-embedding-3-small openai 400,000 0 65,147 ریال
text-embedding-3-large openai 2,600,000 0 423,453 ریال
gpt-5.4-nano openai 1,000,000 8,000,000 1,465,798 ریال
gpt-4.1-nano openai 2,000,000 8,000,000 1,628,664 ریال
gpt-4o-mini openai 3,000,000 12,000,000 2,442,997 ریال
gpt-4o-mini-search-preview openai 3,000,000 12,000,000 2,442,997 ریال
deepseek-chat deepseek 5,000,000 22,000,000 4,397,394 ریال
gpt-5.6-luna openai 4,000,000 24,000,000 4,560,261 ریال
gemini-3.1-flash-lite google 5,000,000 30,000,000 5,700,326 ریال
deepseek-v4-flash deepseek 9,000,000 26,000,000 5,700,326 ریال
sonar perplexity 20,000,000 20,000,000 6,514,658 ریال
gpt-5.4-mini openai 5,000,000 40,000,000 7,328,990 ریال
deepseek-reasoner deepseek 11,000,000 44,000,000 8,957,655 ریال
gemini-2.5-flash google 6,000,000 50,000,000 9,120,521 ریال
gemini-3-flash-preview google 6,000,000 50,000,000 9,120,521 ریال
deepseek-v4-pro deepseek 26,000,000 79,000,000 17,100,977 ریال
o4-mini openai 22,000,000 88,000,000 17,915,309 ریال
sonar-reasoning perplexity 20,000,000 100,000,000 19,543,974 ریال
claude-haiku-4-5 anthropic 20,000,000 100,000,000 19,543,974 ریال
gemini-3.7-flash google 30,000,000 150,000,000 29,315,961 ریال
gemini-3.8-flash google 30,000,000 150,000,000 29,315,961 ریال
sonar-reasoning-pro perplexity 40,000,000 160,000,000 32,573,290 ریال
o3 openai 40,000,000 160,000,000 32,573,290 ریال
gemini-2.5-pro google 25,000,000 200,000,000 36,644,951 ریال
gpt-5.2 openai 25,000,000 200,000,000 36,644,951 ریال
gpt-5.3-codex openai 25,000,000 200,000,000 36,644,951 ریال
gpt-5.4 openai 25,000,000 200,000,000 36,644,951 ریال
gpt-4o-search-preview openai 50,000,000 200,000,000 40,716,612 ریال
gemini-3-pro-preview google 40,000,000 240,000,000 45,602,606 ریال
gemini-3.1-pro-preview google 40,000,000 240,000,000 45,602,606 ریال
gpt-5.6-terra openai 40,000,000 240,000,000 45,602,606 ریال
sonar-pro perplexity 60,000,000 300,000,000 58,631,922 ریال
claude-sonnet-4-6 anthropic 60,000,000 300,000,000 58,631,922 ریال
claude-sonnet-5 anthropic 60,000,000 300,000,000 58,631,922 ریال
gpt-5.6-sol openai 80,000,000 400,000,000 78,175,896 ریال
claude-opus-4-7 anthropic 100,000,000 500,000,000 97,719,870 ریال
claude-opus-5 anthropic 100,000,000 500,000,000 97,719,870 ریال
claude-opus-4-8 anthropic 100,000,000 500,000,000 97,719,870 ریال
gpt-5.5 openai 100,000,000 600,000,000 114,006,515 ریال
claude-fable-5 anthropic 200,000,000 1,000,000,000 195,439,739 ریال
gpt-6-astra openai 200,000,000 1,000,000,000 195,439,739 ریال
gpt-5.2-pro openai 300,000,000 2,400,000,000 439,739,414 ریال

عددهای ستون‌های ورودی و خروجی، اعتبار به‌ازای یک میلیون توکن هستند. ستون آخر همان مقدار به ریال، بر اساس قیمت ارزان‌ترین بستهٔ API.

مدل واحد اعتبار ریال
gpt-image-1 تصویر هر تصویر 25 812,500
dall-e-3 تصویر هر تصویر 4 130,000
dall-e-2 تصویر هر تصویر 2 65,000
tts-1 تبدیل متن به گفتار هر ۱۰۰۰ کاراکتر 1,000 48,750
tts-1-hd تبدیل متن به گفتار هر ۱۰۰۰ کاراکتر 2,000 97,500
gpt-4o-mini-tts تبدیل متن به گفتار هر ۱۰۰۰ کاراکتر 1,000 48,750
whisper-1 رونوشت گفتار هر دقیقه 1 19,500
gpt-4o-transcribe رونوشت گفتار هر دقیقه 1 19,500
gpt-4o-mini-transcribe رونوشت گفتار هر دقیقه 0.5 9,750

تصویر از اعتبار رسانه‌ای کم می‌کند، گفتار از کاراکتر و رونوشت از دقیقه. هر کدام بستهٔ API خودش را دارد و ستون ریال از قیمت ارزان‌ترین بستهٔ همان واحد حساب شده است.

در ویرایشگر خودتان

VS Code — Continue
{
  "models": [{
    "title": "DeepFA",
    "provider": "openai",
    "model": "claude-sonnet-5",
    "apiKey": "YOUR_DEEPFA_KEY",
    "apiBase": "https://deepfa.ir/api/v1"
  }]
}
VS Code — GitHub Copilot
"github.copilot.chat.customOAIModels": [{
  "modelId": "claude-sonnet-5",
  "displayName": "DeepFA Claude Sonnet 5",
  "endpoint": "https://deepfa.ir/api/v1",
  "apiKey": "YOUR_DEEPFA_KEY"
}]
Cursor
# Settings → Models → OpenAI API

Base URL:  https://deepfa.ir/api/v1
API Key:   YOUR_DEEPFA_KEY
Model:     gpt-5.4  /  claude-sonnet-5
Cline / Roo Code / Kilo Code
Provider:  OpenAI Compatible

Base URL:  https://deepfa.ir/api/v1
API Key:   YOUR_DEEPFA_KEY
Model ID:  claude-sonnet-5
کلید API بگیرید

کلیدها را از پیشخوان خودتان می‌سازید و هر زمان باطل می‌کنید. برای هر کلید می‌توانید سقف مصرف روزانه و ماهانه بگذارید.

یک دروازهٔ سازگار با 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)، خروجی ساختاریافته و ارسال تصویر — همه بدون تغییر در کدی که از قبل نوشته‌اید.

🛡️

سقف خرج روی هر کلید

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

📊

هزینهٔ هر تماس، جداگانه

هزینهٔ هر درخواست در هدر پاسخ برمی‌گردد و در صفحهٔ مصرف شما به تفکیک کلید و مدل ثبت می‌شود — خطاها هم. اعتبار برای شما یک چاه سیاه نیست.

💳

پرداخت ریالی، بدون کارت ارزی

اعتبار را با درگاه داخلی می‌خرید و اعتبار خریداری‌شده تاریخ انقضا ندارد. نه کارت بین‌المللی لازم است، نه تحریم دور زدن.

فهرست مسیرهای API

مسیرهایی که می‌توانید صدا بزنید

همه زیر یک آدرس پایه، همه با همان کلید، همه با همان شکل درخواست و پاسخی که از OpenAI می‌شناسید.

🔒 هر مسیر کلید API شما را در هدر Authorization می‌خواهد — دقیقاً همان طور که برای 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"])
}
نمونه پاسخ‌های JSON
پاسخ گفت‌وگو
{
  "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: 318
x-deepfa-credit-unit: tokens
پاسخ خطا، به شکل استاندارد OpenAI
{
  "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 به تفکیک کلید و مدل ثبت می‌شود.

شروع سریع
# 1 — the key you made on the API page export DEEPFA_API_KEY="sk-deepfa-..." # 2 — the only two things that differ from 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"}]}' # 3 — the answer, in the shape you already parse { "choices": [{ "message": { "content": "Hello!" } }], "usage": { "total_tokens": 318 } } # 4 — what it cost, on the response itself x-deepfa-credits: 318 x-deepfa-credit-unit: tokens
اسکرین‌شات ابزار

نگاهی به محیط کاربری API

رابط کاربری ساده و کاربردی — روی هر تصویر کلیک کنید تا بزرگ‌تر ببینید.

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

پرسش‌های پرتکرار درباره API هوش مصنوعی دیپ‌فا

پاسخ سوالات رایج توسعه‌دهندگان درباره استفاده از API — اگر پاسخ سوال خود را پیدا نکردید، با پشتیبانی تماس بگیرید.

یک حساب کاربری و یک کلید API. کلید را از صفحهٔ API در پنل کاربری خودتان می‌سازید و بلافاصله در دسترس است؛ خبری از ثبت اپلیکیشن، گردش OAuth یا انتظار برای تأیید نیست. بعد کافی است آدرس پایه را روی https://deepfa.ir/api/v1 بگذارید و کلید را به‌عنوان API key به هر ابزاری که با OpenAI کار می‌کند بدهید. اولین درخواست معمولاً کمتر از یک دقیقه طول می‌کشد.
بله. مسیر /v1/chat/completions، بدنهٔ درخواست، شکل پاسخ، استریم SSE، فراخوانی ابزار و شکل خطاها همگی مطابق استاندارد OpenAI هستند. تنها دو چیز عوض می‌شود: آدرس پایه و کلید. همین باعث می‌شود کتابخانهٔ رسمی OpenAI در پایتون و جاوااسکریپت، افزونه‌های VS Code مانند Continue و Cline، Cursor و ابزارهای مشابه بدون یک خط تغییر به دیپ‌فا وصل شوند.
مدل‌های GPT، Claude، Gemini، Grok و DeepSeek از یک آدرس در دسترس‌اند. هزینه بر اساس توکن ورودی و خروجی همان مدل حساب می‌شود و نرخ هر مدل روی همین صفحه در جدول قیمت‌ها آمده است. تصویر به‌ازای هر تصویر، رونوشت به‌ازای هر دقیقه و تبدیل متن به گفتار به‌ازای هر کاراکتر محاسبه می‌شوند. هزینهٔ دقیق هر تماس در هدر x-deepfa-credits پاسخ برمی‌گردد.
بله. روی هر کلید می‌توانید سقف اعتبار روزانه و ماهانه، سقف تعداد درخواست در دقیقه و فهرست مدل‌های مجاز تعیین کنید. کلیدی که به یک اسکریپت یا به همکارتان می‌دهید فقط تا همان سقف خرج می‌کند و در صورت لو رفتن با یک کلیک باطل می‌شود. مصرف هر کلید به‌صورت جداگانه در صفحهٔ API گزارش می‌شود.
نه. بسته‌های اعتبار API با حاشیهٔ سود بسیار کمتری فروخته می‌شوند و به همین دلیل فقط از طریق کلید API خرج می‌شوند و در ابزارهای داخل پنل در دسترس نیستند. عکسش اما درست است: اگر اعتبار API تمام شود، درخواست‌ها از اعتبار طرح و پیش‌پرداخت شما ادامه پیدا می‌کنند. اعتبار خریداری‌شده هم تاریخ انقضا ندارد.

کلید API خود را دریافت کنید و امروز پروژه‌تان را بسازید

ثبت‌نام رایگان، ساخت کلید در چند ثانیه، و اعتباری که تاریخ انقضا ندارد