Sign In Get Started
dreamina-3.1

dreamina-3.1

Text to Image

4MP text-to-image generation with enhanced cinematic-quality image generation with precise style control, improved text rendering, and commercial design optimization.

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.

Example output

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' => dreamina-31,
    'prompt' => '',
    'aspect_ratio' => '',
    'width' => '',
    'height' => '',
    'seed' => '',
];

// 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 (dreamina-31)
api_key string Required Your API key for authentication (sent via Bearer token in the Authorization header)
prompt string Required
aspect_ratio string Optional
width array Optional Image width (only used when aspect_ratio is 'custom')
height array Optional Image height (only used when aspect_ratio is 'custom')
seed array Optional Random seed. Set for reproducible generation

Response Format

{
    "success": true,
    "data": {
        "output": "https://lumozai.com/storage/outputs/image_12345.jpg"
    }
}

Model Pricing

Usage Cost

$0.04 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

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