مستندات API هوش مصنوعی
دیپفا برای توسعهدهندگان
قابلیتهای هوش مصنوعی دیپفا را در اپلیکیشن، وبسایت یا سرویس خود یکپارچه کنید. تولید متن با مدلهای پیشرفته، ساخت تصویر، ایجاد چتبات هوشمند، رونویسی فایلهای صوتی و بیشتر — همه از طریق یک رابط استاندارد REST با خروجی JSON. مستندات کامل شامل نمونهکد در ۶ زبان برنامهنویسی.
رابط برنامهنویسی هوش مصنوعی دیپفا برای توسعهدهندگان و کسبوکارها
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 آماده در ۸ دستهبندی — مستندات کامل هر مسیر در 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"])
}
{
"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 قرار دهید و اولین درخواست خود را ارسال کنید.
نگاهی به محیط کاربری API
رابط کاربری ساده و کاربردی — روی هر تصویر کلیک کنید تا بزرگتر ببینید.
پرسشهای پرتکرار درباره API هوش مصنوعی دیپفا
پاسخ سوالات رایج توسعهدهندگان درباره استفاده از API — اگر پاسخ سوال خود را پیدا نکردید، با پشتیبانی تماس بگیرید.
کلید API خود را دریافت کنید و امروز پروژهتان را بسازید
ثبتنام رایگان، دریافت فوری توکن دسترسی و دسترسی کامل به مستندات تعاملی Swagger