AI Avatars -

Authentication Required

You need to be logged in to run this model.

Don't have an account?
Sign up

Run the model to see results

Generation time: 0s

Run the model to see JSON response

See It In Action

Explore real outputs from this model. Click any example to instantly load its parameters and recreate the result.

No Examples Available

Examples will appear here once users start using this model. Check back later!

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	Required
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"
    }
}

Model Pricing

Usage Cost

$0.05 Cost Per Generation

Cost Per Generation is a pricing model where you’re charged based on each individual output the model generates. Instead of billing for compute time, you pay a fixed cost for every generation request, regardless of how long it takes. This makes costs predictable since each generated result incurs its own set rate.

Features Included:

Full API access
Web UI usage
Output in multiple formats
Commercial usage rights

Add Credits

Note: Pricing is subject to change. For bulk usage or custom packages, please contact us.

AI Avatars