Video Generation
Lumoz Video
Flagship cinematic video synthesis engine. Generates fluid, high-fidelity neural video sequences from text prompts or still images with dynamic camera control.
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' => 'lumoz-video',
'prompt' => '',
'image' => '',
'last_frame_image' => '',
'duration' => 5,
'aspect_ratio' => '16:9',
'resolution' => '720p',
'fps' => 24,
'draft' => false,
'prompt_upsampling' => true,
'save_audio' => true,
];
// 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 (lumoz-video) |
| api_key | string | Required | Your API key for authentication (sent via Bearer token in the Authorization header) |
| prompt | string | Required | Text prompt describing the video scene, camera direction, and dynamic motion. |
| image | string | Optional | Optional starting image for image-to-video animation. Leave empty for direct text-to-video generation. |
| last_frame_image | string | Optional | Optional ending image for frame-to-frame interpolation between start and end image. |
| duration | array | Optional | Output duration in seconds (billed at $0.033/sec for 720p or $0.066/sec for 1080p). |
| aspect_ratio | string | Optional | Aspect ratio of the generated video. |
| resolution | string | Optional | Output video resolution ($0.033/sec for 720p, $0.066/sec for 1080p). |
| fps | string | Optional | Video frame rate. |
| draft | boolean | Optional | Fast generation mode at half the standard price ($0.0165/sec for 720p, $0.033/sec for 1080p). |
| prompt_upsampling | boolean | Optional | Automatically enrich prompt with cinematic descriptors. |
| save_audio | boolean | Optional | Synthesize atmospheric audio and environmental sound effects. |
Response Format
{
"success": true,
"data": {
"output": "https://lumozai.com/storage/outputs/video_12345.mp4"
}
}
Model Pricing
Pay only for what you run. Charges are deducted directly from your account balance with zero recurring commitments.
Video Duration Rates
Billed strictly per second of generated video • 1 to 20 seconds
720p HD Base
Standard
$0.033 / sec
$0.165 for 5s • $0.33 for 10s
1080p Full HD
Crisp Master
$0.066 / sec
$0.33 for 5s • $0.66 for 10s
720p Draft Mode
50% Off
$0.0165 / sec
$0.0825 for 5s • $0.165 for 10s
1080p Draft Mode
50% Off
$0.033 / sec
$0.165 for 5s • $0.33 for 10s
Cost Estimator
720p HD Base ($0.033/sec)
300 seconds of video
Estimated Total
$9.90
Automatic instant refund if any run fails • Credits valid for 1 year