Image to Image
Image Expand
Bria Expand expands images beyond their borders in high quality. Resizing the image by generating new pixels to expand to the desired aspect ratio.
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' => 'image-expand',
'image' => '',
'aspect_ratio' => '16:9',
'canvas_size' => '',
'original_image_size' => '',
'original_image_location' => '',
'prompt' => '',
'negative_prompt' => '',
];
// 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 (image-expand) |
| api_key | string | Required | Your API key for authentication (sent via Bearer token in the Authorization header) |
| image | string | Required | |
| aspect_ratio | string | Required | Aspect ratio for expansion. Either aspect_ratio or canvas_size with original_image_size/location must be provided. Can be a predefined string like '1:1', '16:9' etc. or a custom float between 0.5 and 3.0 |
| canvas_size | array | Optional | Desired output canvas dimensions [width, height]. Default [1000, 1000]. Max 5000x5000 pixels. |
| original_image_size | array | Optional | Size of original image in canvas [width, height] |
| original_image_location | array | Optional | Position of original image in canvas [x, y] |
| prompt | string | Optional | |
| negative_prompt | string | Optional |
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.
Rate per generation
$
0.045
/ generation
$45.00 per 1,000 generations
Cost Estimator
1,000 generations
Estimated Total
$45.00
Automatic instant refund if any run fails • Credits valid for 1 year