Text to Image
Realify 2.0
Realify 2.0 is the flagship ultra-photorealistic visual synthesis model on Lumoz, delivering hyper-realistic human anatomy, rich cinematic lighting, reference-guided editing with up to 10 images, research grounding, and multi-ratio outputs.
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' => 'realify-2',
'prompt' => '',
'images[]' => 'https://example.com/image.jpg', // Example image URL
'aspect_ratio' => 'auto',
'resolution' => '1k',
'grounding' => 'true',
'output_format' => 'webp',
'output_quality' => 80,
'safety_tolerance' => 2,
];
// 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 (realify-2) |
| api_key | string | Required | Your API key for authentication (sent via Bearer token in the Authorization header) |
| prompt | string | Required | Detailed text description of the image to synthesize or edit. |
| images | array | Required | Required reference image(s) for character consistency, style matching, photorealistic transformation, or reference-based editing (up to 10 images). |
| aspect_ratio | string | Optional | Aspect ratio of the generated image. 'auto' matches the prompt or first reference image. |
| resolution | string | Optional | Output resolution budget. |
| grounding | string | Optional | Enable live web and visual research to enhance realism and accuracy. |
| output_format | string | Optional | Format of the generated image file. |
| output_quality | number | Optional | Quality when saving output images (0 to 100). |
| safety_tolerance | number | Optional | Moderation tolerance for inputs and outputs (0 strictest, 4 most permissive). |
Response Format
{
"success": true,
"data": {
"output": "https://lumozai.com/storage/outputs/image_12345.jpg"
}
}
Model Pricing
Pay only for what you run. Charges are deducted directly from your account balance with zero recurring commitments.
Resolution Rates
Select a tier to estimate volume costs
768sq
$0.03 / run
$30.00 / 1k
1k
Default
$0.05 / run
$50.00 / 1k
1.5k
$0.07 / run
$70.00 / 1k
2k
$0.09 / run
$90.00 / 1k
4k
$0.15 / run
$150.00 / 1k
Cost Estimator
1k ($0.05/run)
1,000 generations
Estimated Total
$50.00
Automatic instant refund if any run fails • Credits never expire