Sign In Get Started
AI Avatars

AI Avatars

Image to Image

Use one or two face images to create AI avatars

Authentication Required

You need to be logged in to run this model.

Log In

Don't have an account? Sign up

Output

Run the model to see results

API Endpoint

POST https://lumozai.com/api/v4/run

Use this endpoint to run the model with your parameters. Authentication is required using your API key.

Sample Code (PHP cURL)

<?php
// API endpoint URL
$apiUrl = 'https://lumozai.com/api/v4/run';

// Your API key
$apiKey = 'YOUR_API_KEY';

// Model parameters
$params = [
    'model_id' => ai-avatars,
    'face_image' => '',
    'user_gender' => '',
    'face_image_b' => '',
    'user_b_gender' => '',
    'prompt' => 'a guy riding a motorbike',
    'workflow_type' => '',
];

// Initialize cURL session
$curl = curl_init();

// Set cURL options
curl_setopt_array($curl, [
    CURLOPT_URL => $apiUrl,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $params,
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'Authorization: Bearer ' . $apiKey
    ]
]);

// Execute the request
$response = curl_exec($curl);
$httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);

// Check for errors
if (curl_errno($curl)) {
    echo 'cURL Error: ' . curl_error($curl);
} else {
    // Process the response
    $result = json_decode($response, true);
    
    if ($httpCode == 200 && isset($result['success']) && $result['success']) {
        // Handle successful response
        echo "Model output: ";
        print_r($result['data']['output']);
    } else {
        // Handle error response
        echo "Error: " . ($result['message'] ?? 'Unknown error');
    }
}

// Close cURL session
curl_close($curl);

Request Parameters

Parameter Type Required Description
model_id string Required The ID of the model to run (ai-avatars)
api_key string Required Your API key for authentication (sent via Bearer token in the Authorization header)
face_image string Optional
user_gender string Optional
face_image_b string Optional Optional second face image for multi-person avatars
user_b_gender string Optional
prompt string Optional A prompt describing the scene to put the user(s) in
workflow_type string Optional

Response Format

{
    "success": true,
    "data": {
        "output": "https://lumozai.com/storage/outputs/image_12345.jpg"
    }
}