Cartoon illustration
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' => 'cartoon-illustration',
'prompt' => '-',
'aspect_ratio' => '1:1',
'prompt_strength' => 0.8,
'image' => '',
'num_inference_steps' => 28,
'guidance' => 3,
'seed' => '',
'output_format' => 'webp',
'output_quality' => 80,
'lora_scale' => 1,
'megapixels' => '1',
];
// 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 (cartoon-illustration) |
| api_key | string | Required | Your API key for authentication (sent via Bearer token in the Authorization header) |
| prompt | string | Required | Describe what you want to generate |
| aspect_ratio | string | Required | Aspect ratio for the generated image |
| prompt_strength | number | Optional | Prompt strength when using img2img. 1.0 corresponds to full destruction of information in image |
| image | string | Optional | Input image for image to image mode. The aspect ratio of your output will match this image |
| num_inference_steps | number | Optional | Number of denoising steps. Recommended range is 28-50, and lower number of steps produce lower quality outputs, faster. |
| guidance | number | Optional | Guidance for generated image |
| seed | array | Optional | Random seed. Set for reproducible generation |
| output_format | string | Optional | Format of the output images |
| output_quality | number | Optional | Quality when saving the output images, from 0 to 100. 100 is best quality, 0 is lowest quality. Not relevant for .png outputs |
| lora_scale | number | Optional | Determines how strongly the main LoRA should be applied. Sane results between 0 and 1 for base inference. For go_fast we apply a 1.5x multiplier to this value. |
| megapixels | string | Optional | Approximate number of megapixels for generated image |
Response Format
{
"success": true,
"data": {
"output": "https://lumozai.com/storage/outputs/image_12345.jpg"
}
}
Predictable, Output-Based Pricing
Zero server rental costs, zero cold-start tax, and no monthly lock-in. You only pay for successful inference calls.
Billed in real-time from your prepaid balance per generation. No minimum commitments.
Zero Error Billing
100% automated refund guarantee. If an API request encounters a failure or network timeout, credits are refunded instantly.
Serverless Speed
High-concurrency global inference cluster with ultra-low latency, zero queue bottlenecks, and automated horizontal scaling.
Commercial Ownership
Full commercial ownership for all generated media, assets, and outputs with no attribution or royalties required.
Unified API & Web UI
Single billing balance across both developer cURL / REST API keys and the interactive web studio.