Documentation Index
Fetch the complete documentation index at: https://usenaive.ai/docs/llms.txt
Use this file to discover all available pages before exploring further.
Overview
| Command | Description | Cost |
|---|
naive images generate <prompt> | AI image generation | ~2 credits/image |
naive images stock <query> | Search stock photos | Free |
naive images status <job_id> | Check generation job status | Free |
naive images models | List available models | Free |
Generate Images
Submits an image generation job. Returns a job ID (async processing).
Simple (prompt)
naive images generate "a futuristic city at sunset"
naive images generate "minimalist logo" --model fal-ai/flux-pro/v1.1 --size square_hd --num 4 --wait
Advanced (full parameter passthrough)
naive images generate --model fal-ai/flux/schnell \
--input '{"prompt":"A minimalist tech logo","image_size":"landscape_16_9","num_images":2,"guidance_scale":3.5}'
Options
| Flag | Required | Description |
|---|
prompt | No* | Text description (positional argument) |
--model <model> | No | Model ID (default: fal-ai/flux/schnell) |
--input <json> | No* | Full model parameters as JSON (overrides prompt) |
--size <size> | No | square_hd, square, landscape_4_3, landscape_16_9, portrait_4_3, portrait_16_9 |
--num <n> | No | Number of images (default: 1, max: 4) |
--wait | No | Block until generation completes |
prompt or --input is required.
| Parameter | Type | Models | Description |
|---|
prompt | string | All | Text description (required) |
image_size | string | All | Output size (see above) |
num_images | number | All | 1–4 |
seed | number | All | Reproducibility seed |
guidance_scale | number | Schnell, Dev | CFG guidance (default 3.5, range 1-20) |
num_inference_steps | number | Schnell | Quality steps (1-12, default 4) |
output_format | string | All | "jpeg" or "png" |
enable_safety_checker | boolean | Schnell, Dev | Content filter (default: true) |
guidance_scale and num_inference_steps are NOT supported on FLUX Pro v1.1. Use FLUX Schnell or FLUX Dev if you need these controls.
Output (submitted)
{
"success": true,
"action": "images.generate.submitted",
"result": { "job_id": "job-uuid-123", "status": "queued", "model": "fal-ai/flux/schnell" },
"next_steps": [
{ "command": "naive images status job-uuid-123", "description": "Check generation progress" },
{ "command": "naive jobs get job-uuid-123", "description": "Get full job details" }
],
"hints": [
"Image generation submitted (model: fal-ai/flux/schnell)",
"Credits deducted only on successful completion",
"Typical time: 5-15 seconds depending on model"
]
}
Output (completed — with --wait)
{
"success": true,
"action": "images.generate.completed",
"result": {
"id": "job-uuid-123",
"status": "completed",
"result": {
"images": [
{ "url": "https://fal.media/files/.../image.png", "width": 1024, "height": 1024 }
]
},
"credits_used": 2
},
"next_steps": [
{ "command": "# Download: curl -o image.png \"https://fal.media/files/.../image.png\"", "description": "Download the generated image" },
{ "command": "naive images generate \"another prompt\" --model <model>", "description": "Generate another image" }
],
"hints": ["Generation complete — 1 image(s) ready"]
}
Available Models
| Model | Speed | Notes |
|---|
fal-ai/flux/schnell | Fast (~5s) | Default. Full parameter control. |
fal-ai/flux/dev | Medium (~10s) | Good quality, full parameter control. |
fal-ai/flux-pro/v1.1 | High quality (~15s) | Best quality. No guidance_scale/steps. |
fal-ai/flux-realism | Medium (~10s) | Photorealistic results. |
fal-ai/recraft-v3 | Medium (~10s) | Design-focused (logos, illustrations). |
naive images models for the full list with parameters.
Stock Photos
Search for stock photos:
naive images stock "team collaboration"
naive images stock "nature mountain" --count 5 --orientation landscape
naive images stock "abstract background" --color blue --size large
Options
| Flag | Required | Description |
|---|
query | Yes | Search terms |
--count <n> | No | Number of results (1–80, default: 10) |
--orientation <type> | No | landscape, portrait, or square |
--color <color> | No | Filter by dominant color (red, orange, yellow, green, turquoise, blue, violet, pink, brown, black, gray, white) |
--size <size> | No | Minimum photo size: large (24MP+), medium (12MP+), small |
Output
{
"success": true,
"action": "images.stock",
"result": {
"photos": [
{
"id": "stock-123456",
"url": "https://stock.example.com/photo/...",
"photographer": "John Doe",
"alt": "Modern office workspace",
"width": 1920,
"height": 1080,
"src": {
"original": "https://images.example.com/photos/.../original.jpeg",
"large": "https://images.example.com/photos/.../large.jpeg",
"medium": "https://images.example.com/photos/.../medium.jpeg",
"small": "https://images.example.com/photos/.../small.jpeg"
}
}
],
"total": 500
},
"next_steps": [
{ "command": "naive images stock \"team collaboration\" --count 20", "description": "Get more results" },
{ "command": "naive images generate \"custom version of this concept\"", "description": "Generate a custom AI image" }
],
"hints": ["Found 10 stock photos", "Cost: 0 credits (free)"]
}
Check Status
naive images status <job-id>
List Models
Returns all supported image models with IDs, key parameters, and mode (text-to-image vs image-to-image).
