Skip to main content

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.

​
model
string
default:"fal-ai/flux/schnell"
Model ID. Use GET /v1/images/models to see all available models and their parameters.
​
input
object
required
Model-specific parameters — all params supported. Must include prompt.
curl -X POST https://api.usenaive.ai/v1/images/generate \
  -H "Authorization: Bearer nv_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "fal-ai/flux/schnell",
    "input": {
      "prompt": "A minimalist logo for a tech startup",
      "image_size": "square_hd",
      "num_images": 2,
      "seed": 42
    }
  }'

{
  "job_id": "job-uuid",
  "status": "queued",
  "type": "image_generation",
  "model": "fal-ai/flux/schnell",
  "estimated_seconds": 8,
  "estimated_credits": 4,
  "hint": "Poll GET /v1/jobs/job-uuid or GET /v1/images/job-uuid. Credits charged on completion only."
}
Cost: Dynamic — model-dependent. Preview with GET /v1/images/pricing?model=<id>&num_images=<n>. Based on model costs at $0.50/credit. Charged on completion only.

​
Common Input Parameters

Parameters vary by model. Use GET /v1/images/models to see key_params for each model.
ParameterTypeDescription
promptstringText description of the image (required)
image_sizestringsquare_hd, square, landscape_4_3, landscape_16_9, portrait_4_3, portrait_16_9
num_imagesnumberNumber of images (1-4)
seednumberReproducibility seed
guidance_scalenumberCFG guidance (FLUX Schnell/Dev only, default 3.5)
num_inference_stepsnumberQuality steps (FLUX Schnell: 1-12, default 4)
output_formatstring"jpeg" or "png"
enable_safety_checkerbooleanDefault true
guidance_scale and num_inference_steps are NOT supported on FLUX Pro v1.1. They are available on FLUX Schnell and FLUX Dev.

​
Completed Result

When polling the job after completion via GET /v1/jobs/:id or GET /v1/images/:jobId: 
{
  "id": "job-uuid",
  "type": "image_generation",
  "status": "completed",
  "progress": 100,
  "model": "fal-ai/flux/schnell",
  "result": {
    "images": [
      { "url": "https://fal.media/files/...", "width": 1024, "height": 1024, "content_type": "image/png" }
    ],
    "seed": 42,
    "prompt": "A minimalist logo for a tech startup"
  },
  "credits_used": 4,
  "created_at": "2026-05-02T10:30:00Z",
  "completed_at": "2026-05-02T10:30:08Z"
}