Documentation

Basic Generation

Basic Generation

Standard text-to-image and image-to-image generation using the same parameters as Flux.1 Dev.

Advanced Features
For advanced features like LoRA, ControlNet, and editing tools, see the dedicated sections
Text-to-Image Generation
Generate images from text prompts using standard parameters

Request Example

POST https://api.qubico.ai/v1/inference
Content-Type: application/json
x-api-key: YOUR_API_KEY

{
  "model": "Qubico/flux1-dev-advanced",
  "task_type": "txt2img",
  "input": {
    "prompt": "A serene mountain landscape at sunset, highly detailed, cinematic lighting",
    "negative_prompt": "low quality, blurry, distorted, artifacts",
    "width": 1024,
    "height": 1024,
    "guidance_scale": 4.0,
    "num_inference_steps": 28,
    "seed": 42
  }
}
Parameter Reference
Complete parameter documentation for basic generation

Required Parameters

model
string
required

Model identifier. Must be "Qubico/flux1-dev-advanced"

task_type
string
required

Task type. Must be "txt2img" for text-to-image generation.

input.prompt
string
required

Text description of the desired image. Maximum 1000 characters. Be specific and descriptive for best results.

Optional Parameters

input.negative_prompt
string
optional

Text description of what to avoid in the image. Maximum 500 characters.

input.width
integer
txt2img only

Output image width. Range: 256-2048, Default: 1024. Must be divisible by 8. width×height cannot exceed 4,194,304.

input.height
integer
txt2img only

Output image height. Range: 256-2048, Default: 1024. Must be divisible by 8. width×height cannot exceed 4,194,304.

input.guidance_scale
float
optional

Controls how closely the image follows the prompt. Range: 1.0-20.0, Default: 4.0

input.num_inference_steps
integer
optional

Number of denoising steps. Range: 1-50, Default: 28. More steps = higher quality but slower generation.

input.seed
integer
optional

Random seed for reproducible results. Range: 0-2147483647. Use same seed for consistent outputs.

Response Format
Standard response structure for all generation types
{
  "id": "req_abc123def456",
  "status": "completed",
  "output": {
    "images": [
      {
        "url": "https://cdn.qubico.ai/generated/image_123.png",
        "width": 1024,
        "height": 1024,
        "seed": 42
      }
    ]
  },
  "meta": {
    "model": "Qubico/flux1-dev-advanced",
    "task_type": "txt2img",
    "credits_used": 3.0,
    "generation_time": 2.8
  }
}
Best Practices
Tips for optimal results with basic generation

Prompt Writing

  • • Be specific and descriptive
  • • Include style keywords (e.g., "cinematic", "detailed")
  • • Use negative prompts to avoid unwanted elements
  • • Experiment with different prompt structures

Parameter Tuning

  • • Start with default values and adjust gradually
  • • Higher guidance_scale = stronger prompt adherence
  • • More steps = higher quality but slower generation
  • • Use seeds for reproducible results
Pricing & Credits
Credit costs for basic generation features

Text-to-Image

3.0
credits per image

Image-to-Image

3.5
credits per image
* Prices may vary based on output resolution and generation parameters