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

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

قابلیت‌های هوش مصنوعی دیپ‌فا را در اپلیکیشن، وب‌سایت یا سرویس خود یکپارچه کنید. تولید متن با مدل‌های پیشرفته، ساخت تصویر، ایجاد چت‌بات هوشمند، رونویسی فایل‌های صوتی و بیشتر — همه از طریق یک رابط استاندارد REST با خروجی JSON. مستندات کامل شامل نمونه‌کد در ۶ زبان برنامه‌نویسی.

30+
مسیر API آماده
OAuth2
احراز هویت امن
JSON
خروجی استاندارد
🔑 توکن دسترسی
⚡ پاسخ فوری
📄 فرمت JSON
🌐 رابط REST
POST /api/v1/image/generate
# Authorization header Authorization: Bearer eyJhbGci... # Request body { "vendor": "openai", "prompt": "city sunset", "resolution": "1024x1024" } # Sending request... https://deepfa.ir/api/v1/...
✓ 200 OK application/json
{ "image_id": 1842, "image_url": "https://deepfa.ir/...", "status": true }

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

API هوش مصنوعی دیپ‌فا یک رابط برنامه‌نویسی جامع و استاندارد REST است که به توسعه‌دهندگان امکان می‌دهد قابلیت‌های پیشرفته هوش مصنوعی را بدون نیاز به دانش تخصصی یادگیری ماشین، مستقیماً در اپلیکیشن‌ها، وب‌سایت‌ها و سرویس‌های خود یکپارچه کنند. از تولید متن خلاقانه و حرفه‌ای با مدل‌های ChatGPT، Claude و Gemini گرفته تا ساخت تصاویر هنری و واقع‌گرایانه، ایجاد چت‌بات‌های هوشمند با قابلیت مکالمه طبیعی، رونویسی دقیق فایل‌های صوتی، مدیریت سیستم تیکت پشتیبانی و برنامه همکاری فروش — تمام این قابلیت‌ها از طریق بیش از ۳۰ مسیر API استاندارد با خروجی JSON قابل دسترسی هستند.

سیستم احراز هویت API دیپ‌فا بر پایه OAuth2 با Laravel Passport پیاده‌سازی شده است که یکی از امن‌ترین و پرکاربردترین استانداردهای احراز هویت در صنعت نرم‌افزار محسوب می‌شود. مستندات کامل و تعاملی Swagger در آدرس /api/v1/documentation در دسترس است و به شما امکان می‌دهد بدون نوشتن حتی یک خط کد، تمام مسیرهای API را مستقیماً از مرورگر تست کنید، پارامترهای درخواست را تغییر دهید و پاسخ‌های واقعی را مشاهده نمایید.

API دیپ‌فا با تمام زبان‌های برنامه‌نویسی رایج از جمله پایتون، جاوااسکریپت، پی‌اچ‌پی، گو، روبی و جاوا سازگار است. نمونه‌کدهای آماده در ۶ زبان مختلف در بخش مستندات ارائه شده تا بتوانید در کمتر از ۵ دقیقه اولین درخواست API خود را ارسال کنید. پاسخ‌های API و پیام‌های خطا به هر دو زبان فارسی و انگلیسی قابل دریافت هستند که این ویژگی، API دیپ‌فا را برای پروژه‌های داخلی و بین‌المللی مناسب می‌سازد.

ویژگی‌های کلیدی

چرا API هوش مصنوعی دیپ‌فا؟

طراحی‌شده با تمرکز بر نیاز توسعه‌دهندگان — ساده برای شروع، امن در استفاده و مقیاس‌پذیر برای رشد.

🔐

احراز هویت امن OAuth2

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

خروجی JSON استاندارد

تمام مسیرهای API خروجی JSON استاندارد برمی‌گردانند و با هر زبان برنامه‌نویسی و فریمورکی سازگار هستند.

📄

مستندات تعاملی Swagger

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

🌐

پشتیبانی از زبان فارسی و انگلیسی

پاسخ‌ها، پیام‌های خطا و مستندات به هر دو زبان فارسی و انگلیسی — مناسب برای پروژه‌های داخلی و بین‌المللی.

🔄

صفحه‌بندی خودکار لیست‌ها

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

🛡️

مدیریت دسترسی بر اساس نقش

مسیرهای مدیریتی با لایه‌های محافظتی جداگانه ایمن شده‌اند. دسترسی کاربران عادی و مدیران کاملاً تفکیک شده است.

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

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

بیش از ۳۰ مسیر API آماده در ۸ دسته‌بندی — مستندات کامل هر مسیر در Swagger موجود است.

🔒 مسیرهایی با برچسب «نیاز به احراز هویت» نیازمند ارسال توکن دسترسی در هدر درخواست هستند
نمونه‌کدها

شروع سریع در ۶ زبان برنامه‌نویسی

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

# Login and get access token
curl -X POST https://deepfa.ir/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "password": "your_password"
  }'

# Generate an AI image (use token from login)
curl -X POST https://deepfa.ir/api/v1/image/generate \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "vendor=openai" \
  -F "prompt=A futuristic city at sunset, photorealistic" \
  -F "resolution=1024x1024"
// Login and get access token
const loginRes = await fetch('https://deepfa.ir/api/auth/login', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    email: 'user@example.com',
    password: 'your_password'
  })
});
const { access_token } = await loginRes.json();

// Generate an AI image
const formData = new FormData();
formData.append('vendor', 'openai');
formData.append('prompt', 'A futuristic city at sunset, photorealistic');
formData.append('resolution', '1024x1024');

const imgRes = await fetch('https://deepfa.ir/api/v1/image/generate', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${access_token}` },
  body: formData
});
const { image_url, image_id } = await imgRes.json();
console.log('Generated image:', image_url);
import requests

BASE_URL = "https://deepfa.ir"

# Login
login = requests.post(f"{BASE_URL}/api/auth/login", json={
    "email": "user@example.com",
    "password": "your_password"
})
token = login.json()["access_token"]
headers = {"Authorization": f"Bearer {token}"}

# Generate AI image
response = requests.post(
    f"{BASE_URL}/api/v1/image/generate",
    headers=headers,
    data={
        "vendor": "openai",
        "prompt": "A futuristic city at sunset, photorealistic",
        "resolution": "1024x1024"
    }
)
result = response.json()
print(f"Image URL: {result['image_url']}")
print(f"Image ID:  {result['image_id']}")
<?php

$baseUrl = 'https://deepfa.ir';

// Login
$ch = curl_init("$baseUrl/api/auth/login");
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'email'    => 'user@example.com',
        'password' => 'your_password',
    ]),
]);
$login = json_decode(curl_exec($ch), true);
$token = $login['access_token'];
curl_close($ch);

// Generate AI image
$ch = curl_init("$baseUrl/api/v1/image/generate");
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ["Authorization: Bearer $token"],
    CURLOPT_POSTFIELDS     => [
        'vendor'     => 'openai',
        'prompt'     => 'A futuristic city at sunset, photorealistic',
        'resolution' => '1024x1024',
    ],
]);
$result = json_decode(curl_exec($ch), true);
echo "Image URL: " . $result['image_url'];
curl_close($ch);
const axios = require('axios');
const FormData = require('form-data');

const BASE = 'https://deepfa.ir';

async function main() {
  // Login
  const { data: auth } = await axios.post(`${BASE}/api/auth/login`, {
    email: 'user@example.com',
    password: 'your_password'
  });

  const headers = { Authorization: `Bearer ${auth.access_token}` };

  // Generate AI image
  const form = new FormData();
  form.append('vendor', 'openai');
  form.append('prompt', 'A futuristic city at sunset, photorealistic');
  form.append('resolution', '1024x1024');

  const { data: img } = await axios.post(
    `${BASE}/api/v1/image/generate`,
    form,
    { headers: { ...headers, ...form.getHeaders() } }
  );

  console.log('Image URL:', img.image_url);
  console.log('Image ID: ', img.image_id);
}

main().catch(console.error);
package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "mime/multipart"
    "net/http"
)

const base = "https://deepfa.ir"

func main() {
    // Login
    body, _ := json.Marshal(map[string]string{
        "email":    "user@example.com",
        "password": "your_password",
    })
    res, _ := http.Post(base+"/api/auth/login",
        "application/json", bytes.NewBuffer(body))
    var auth map[string]interface{}
    json.NewDecoder(res.Body).Decode(&auth)
    token := auth["access_token"].(string)

    // Generate AI image
    var buf bytes.Buffer
    w := multipart.NewWriter(&buf)
    w.WriteField("vendor",     "openai")
    w.WriteField("prompt",     "A futuristic city at sunset, photorealistic")
    w.WriteField("resolution", "1024x1024")
    w.Close()

    req, _ := http.NewRequest("POST",
        base+"/api/v1/image/generate", &buf)
    req.Header.Set("Authorization", "Bearer "+token)
    req.Header.Set("Content-Type", w.FormDataContentType())

    client := &http.Client{}
    resp, _ := client.Do(req)
    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Println("Image URL:", result["image_url"])
}
نمونه پاسخ‌های JSON
پاسخ ورود موفق
{
  "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9...",
  "token_type": "Bearer",
  "expires_at": "2026-06-08 14:30:00"
}
پاسخ تولید تصویر
{
  "image_id": 1842,
  "image_url": "https://deepfa.ir/storage/images/ai/img_x7k2m.png",
  "status": true
}
پاسخ آمار مصرف کاربر
{
  "words": 145280,
  "images": 342,
  "contents": 891,
  "synthesized": 56,
  "transcribed": 23,
  "codes": 178
}
پاسخ رونویسی فایل صوتی
{
  "status": true,
  "text": "This is the transcribed text from the audio file..."
}
پاسخ اطلاعات ارجاع و درآمد
{
  "total_commission": 142.50,
  "total_referred": 18,
  "total_withdrawal": 80.00,
  "referral_code": "DEEPFA_XK92M",
  "currency": "$"
}
پاسخ خطای اعتبارسنجی
{
  "error": {
    "email": ["The email field is required."],
    "password": ["The password field is required."]
  }
}
راهنمای شروع

در چهار گام ساده اولین درخواست API را ارسال کنید

از ثبت‌نام تا دریافت اولین پاسخ API در کمتر از ۵ دقیقه — بدون نیاز به تنظیمات پیچیده.

۱

ثبت‌نام رایگان در دیپ‌فا

یک حساب کاربری رایگان بسازید. برای استفاده از API به یک حساب فعال و تأیید شده نیاز دارید.

۲

دریافت توکن دسترسی

با ارسال درخواست به آدرس /api/auth/login وارد شوید. توکن دسترسی از پاسخ دریافتی قابل استخراج است.

۳

مشاهده مستندات تعاملی

مستندات تعاملی API در آدرس /api/v1/documentation قابل دسترسی است. تمام مسیرها را مرور و مستقیماً تست کنید.

۴

ارسال اولین درخواست

توکن دسترسی را در هدر Authorization با پیشوند Bearer قرار دهید و اولین درخواست خود را ارسال کنید.

شروع سریع — راهنمای گام به گام
# Step 1: Login and get token curl -X POST https://deepfa.ir/api/auth/login \ -H "Content-Type: application/json" \ -d '{"email":"you@example.com","password":"pass"}' # Response — save the access_token value { "access_token": "eyJhbGci...", "token_type": "Bearer", "expires_at": "2026-06-02 14:00:00" } # Step 2: Use token in any API request curl -X GET https://deepfa.ir/api/v1/user/profile \ -H "Authorization: Bearer eyJhbGci..." # Step 3: View your profile data { "name": "John Doe", "email": "you@example.com", "plan": "Premium" }
اسکرین‌شات ابزار

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

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

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

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

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

برای شروع کار با API دیپ‌فا فقط به یک حساب کاربری رایگان و یک توکن دسترسی نیاز دارید. توکن دسترسی را از طریق سیستم احراز هویت OAuth2 و با ارسال درخواست به آدرس /api/auth/login دریافت می‌کنید. پس از دریافت، این توکن را در هدر Authorization تمام درخواست‌های بعدی خود قرار دهید. برای امنیت بیشتر، توکن‌ها دارای تاریخ انقضا هستند و قابلیت تمدید دارند.
بله، محدودیت تعداد درخواست بر اساس پلن اشتراک فعال شما اعمال می‌شود. کاربران پلن رایگان، پلن حرفه‌ای و پلن سازمانی هر کدام سقف متفاوتی دارند. پلن‌های حرفه‌ای و سازمانی محدودیت بسیار بالاتری دارند. جزئیات دقیق سقف درخواست‌ها در مستندات تعاملی Swagger قابل مشاهده است. در صورت عبور از حد مجاز، خطای ۴۲۹ (Too Many Requests) دریافت خواهید کرد.
بله، API دیپ‌فا از استاندارد REST با فرمت خروجی JSON پشتیبانی می‌کند و با تمام زبان‌های برنامه‌نویسی رایج سازگار است. نمونه‌کدهای آماده در ۶ زبان پایتون، جاوااسکریپت، پی‌اچ‌پی، گو، نودجی‌اس و cURL در صفحه مستندات موجود است. هر زبانی که قابلیت ارسال درخواست HTTP را داشته باشد می‌تواند از API دیپ‌فا استفاده کند.
توکن دسترسی پیش‌فرض ۱ روز (۲۴ ساعت) اعتبار دارد. اگر در هنگام ورود، گزینه «مرا به خاطر بسپار» (remember_me) را فعال کنید، اعتبار توکن به ۱ هفته افزایش می‌یابد. پس از پایان اعتبار، کافی است دوباره با آدرس /api/auth/login درخواست ورود ارسال کنید تا توکن جدیدی دریافت کنید. توصیه می‌شود توکن منقضی‌شده را نگه ندارید و همیشه از آخرین توکن فعال استفاده کنید.
برای تست API از طریق Swagger، ابتدا به آدرس /api/v1/documentation بروید. در بالای صفحه روی دکمه «Authorize» کلیک کنید و توکن دسترسی خود را وارد نمایید. پس از احراز هویت، می‌توانید هر مسیر API را انتخاب کنید، پارامترهای درخواست را پر کنید و دکمه «Try it out» را بزنید تا پاسخ واقعی API را مستقیماً در مرورگر خود مشاهده کنید. این ابزار برای توسعه و دیباگ بسیار مفید است.

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

ثبت‌نام رایگان، دریافت فوری توکن دسترسی و دسترسی کامل به مستندات تعاملی Swagger