DeepFA AI API Documentation
for developers

// 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"])
}