Overview

Model ID Type Max Resolution Avg. Speed Cost Status
flux-1.1-pro Image 2048×2048 ~3s $0.03/image Active
qwen-image-3-6-plus Image 2048×2048 ~4s $0.02/image Active
sdxl-1.0 Image 1024×1024 ~2s $0.01/image Active
ideogram-2.0 Image 2048×2048 ~5s $0.04/image Active
playground-v3 Image 1024×1024 ~3s $0.02/image Active
wan-video-2.1 Video 1280×720 ~45s $0.15/video Active
kling-v2 Video 1920×1080 ~60s $0.20/video Active
runway-gen3 Video 1920×1080 ~90s $0.50/video Active
hunyuan-video Video 1280×720 ~50s $0.12/video Active
luma-dream Video 1280×720 ~30s $0.10/video Active
real-esrgan-4x Utility 4x input ~5s $0.005/image Active
controlnet-canny Utility Matches input ~4s $0.02/image Active

Click any model ID to jump to its detailed reference below.

Model ID Format

Model IDs are lowercase, hyphenated strings. Use them in the model parameter of any generation request.

python
response = client.images.generate(
    model="flux-1.1-pro",  # ← model ID goes here
    prompt="Your prompt",
    size="1024x1024"
)

Model IDs are stable. We will never change an active model's ID. When a model version is superseded, the old ID enters a deprecation period (see Deprecated Models) and a new ID is created.

To list all available models programmatically:

bash
curl https://api.fluxpool.ai/v1/models \
  -H "Authorization: Bearer fp_your_api_key"

Response:

json
{
  "data": [
    {
      "id": "flux-1.1-pro",
      "type": "image",
      "status": "active",
      "max_resolution": "2048x2048",
      "cost_per_generation": 0.03
    },
    {
      "id": "wan-video-2.1",
      "type": "video",
      "status": "active",
      "max_resolution": "1280x720",
      "cost_per_generation": 0.15
    }
    // ... more models
  ]
}

See the full API Reference → for the complete /v1/models endpoint spec.

Image Generation Models

flux-1.1-pro

Provider: Black Forest Labs Image Generation Active

Best overall image quality. Exceptional prompt adherence, photorealism, and detail. Supports all standard aspect ratios.

Parameters

Parameter Type Required Default Description
prompt string ✅ Yes Text description of the image to generate. Max 2000 characters.
size string No 1024x1024 Output dimensions. See supported sizes below.
negative_prompt string No "" What to exclude from the generation.
steps integer No 28 Inference steps. Range: 1–50. Higher = more detail, slower.
guidance_scale float No 7.5 Prompt adherence strength. Range: 1.0–20.0.
seed integer No Random Reproducibility seed. Same seed + same prompt = same output.
num_images integer No 1 Number of images to generate. Range: 1–4. Each counts as one generation.
output_format string No "png" Output format: png, jpeg, webp.

Supported Sizes

1024x1024  (1:1)     — Default
1024x1536  (2:3)     — Portrait
1536x1024  (3:2)     — Landscape
1024x2048  (1:2)     — Tall portrait
2048x1024  (2:1)     — Wide panoramic
2048x2048  (1:1)     — Maximum resolution (+$0.02 surcharge)

Cost

Resolution Cost per Image
Up to 1024×1024 $0.03
Up to 1536×1536 $0.04
2048×2048 $0.05

View full pricing →

Example Request

python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.fluxpool.ai/v1",
    api_key="fp_your_api_key"
)

response = client.images.generate(
    model="flux-1.1-pro",
    prompt="A bioluminescent deep-sea creature in an underwater cave, hyperrealistic, 8K detail",
    size="1024x1536",
    n=1
)

print(response.data[0].url)

Example Response

json
{
  "created": 1719000000,
  "data": [
    {
      "url": "https://cdn.fluxpool.ai/generations/abc123.png",
      "revised_prompt": null
    }
  ],
  "model": "flux-1.1-pro",
  "usage": {
    "credits_used": 0.03
  }
}

Notes

  • Supports multilingual prompts (English recommended for best results).
  • guidance_scale above 12 may produce oversaturated results.
  • 2048×2048 generations take ~5s (vs. ~3s for 1024×1024).

qwen-image-3-6-plus

Provider: Alibaba Cloud (Qwen) Image Generation Active

Excellent Asian aesthetics and character rendering. Strong text-in-image generation. Natively supports Chinese, English, Japanese, Korean, and Malay prompts.

Parameters

ParameterTypeRequiredDefaultDescription
promptstring✅ YesText description. Max 2000 characters. Supports CJK and Latin scripts.
sizestringNo1024x1024Output dimensions. See supported sizes.
negative_promptstringNo""Exclusion prompt.
stepsintegerNo30Inference steps. Range: 1–50.
guidance_scalefloatNo7.0Prompt adherence. Range: 1.0–15.0.
seedintegerNoRandomReproducibility seed.
num_imagesintegerNo1Range: 1–4.
output_formatstringNo"png"png, jpeg, webp.

Supported Sizes

1024x1024  (1:1)     — Default
768x1024   (3:4)     — Portrait
1024x768   (4:3)     — Landscape
1024x1536  (2:3)     — Tall
1536x1024  (3:2)     — Wide
2048x2048  (1:1)     — Max resolution

Cost

ResolutionCost per Image
Up to 1024×1024$0.02
Up to 1536×1536$0.03
2048×2048$0.04

Example Request

python
response = client.images.generate(
    model="qwen-image-3-6-plus",
    prompt="夕暮れ時の日本庭園、桜と鯉、浮世絵スタイル",  # Japanese prompt
    size="1024x1536"
)

Notes

  • Best-in-class for anime, manga, and East Asian art styles.
  • Text rendering in images (e.g., signs, labels) is significantly better than most models.
  • Multilingual prompts produce style-appropriate outputs (Japanese prompt → Japanese aesthetic defaults).

sdxl-1.0

Provider: Stability AI Image Generation Active

Open-source workhorse. Largest ecosystem of LoRAs, ControlNets, and community fine-tunes. Fastest and cheapest image model available.

Parameters

ParameterTypeRequiredDefaultDescription
promptstring✅ YesText description. Max 2000 characters.
sizestringNo1024x1024Output dimensions.
negative_promptstringNo""Exclusion prompt. Highly recommended for SDXL.
stepsintegerNo25Inference steps. Range: 1–50.
guidance_scalefloatNo7.5Prompt adherence. Range: 1.0–20.0.
seedintegerNoRandomReproducibility seed.
schedulerstringNo"euler_a"Sampling scheduler: euler_a, euler, dpm_2m, dpm_2m_karras, ddim.
num_imagesintegerNo1Range: 1–4.
output_formatstringNo"png"png, jpeg, webp.

Supported Sizes

1024x1024  (1:1)     — Default, optimal
768x1024   (3:4)     — Portrait
1024x768   (4:3)     — Landscape
512x512    (1:1)     — Fast / draft quality

SDXL is optimized for 1024×1024. Sizes outside this range may reduce quality.

Cost

ResolutionCost per Image
Up to 1024×1024$0.01
512×512$0.005

Example Request

python
response = client.images.generate(
    model="sdxl-1.0",
    prompt="Isometric RPG village, pixel art, tavern and blacksmith, warm lighting",
    size="1024x1024",
    negative_prompt="blurry, low quality, watermark"
)

Notes

  • Cheapest model available — ideal for prototyping and batch generation.
  • negative_prompt significantly improves output quality with SDXL. Always use it.
  • scheduler parameter is unique to SDXL; other models do not support it.
  • Max resolution is 1024×1024. For higher resolution, generate at 1024×1024 then upscale with real-esrgan-4x.

ideogram-2.0

Provider: Ideogram Image Generation Active

Best-in-class text rendering within images. Ideal for posters, logos, signage, and any generation requiring legible text.

Parameters

ParameterTypeRequiredDefaultDescription
promptstring✅ YesText description. Max 2000 characters.
sizestringNo1024x1024Output dimensions.
negative_promptstringNo""Exclusion prompt.
stylestringNo"auto"Style preset: auto, realistic, design, anime, render_3d.
seedintegerNoRandomReproducibility seed.
num_imagesintegerNo1Range: 1–4.
output_formatstringNo"png"png, jpeg, webp.

Cost

ResolutionCost per Image
Up to 1024×1024$0.04
Up to 2048×2048$0.06

Example Request

python
response = client.images.generate(
    model="ideogram-2.0",
    prompt='Movie poster for "NEON DYNASTY" with bold title text, cyberpunk city backdrop, rain-soaked streets',
    size="1024x1536",
    style="design"
)

Notes

  • The style parameter is unique to Ideogram. Other models do not support it.
  • For text in images, include the exact text in quotes within your prompt (e.g., "SALE 50% OFF").
  • Slower than Flux or SDXL but produces the most accurate in-image typography.

playground-v3

Provider: Playground AI Image Generation Active

Design-oriented model. Strong at clean compositions, graphic design styles, and product mockups.

Parameters

ParameterTypeRequiredDefaultDescription
promptstring✅ YesText description. Max 2000 characters.
sizestringNo1024x1024Output dimensions.
negative_promptstringNo""Exclusion prompt.
guidance_scalefloatNo7.0Prompt adherence. Range: 1.0–15.0.
seedintegerNoRandomReproducibility seed.
num_imagesintegerNo1Range: 1–4.
output_formatstringNo"png"png, jpeg, webp.

Cost

ResolutionCost per Image
All sizes$0.02

Example Request

python
response = client.images.generate(
    model="playground-v3",
    prompt="Minimalist product mockup, white sneakers on marble surface, clean studio lighting, editorial style",
    size="1024x1024"
)

Notes

  • Particularly strong at graphic design, editorial, and product photography styles.
  • Limited to 1024×1024 max. Use real-esrgan-4x for upscaling.

Video Generation Models

Video generation is asynchronous. When you submit a video generation request, you receive a generation_id. Poll the status endpoint or use webhooks to receive the completed video URL. See the Video Generation endpoint docs for full request/response details.

wan-video-2.1

Provider: Alibaba Cloud (Wan) Video Generation Active

High-quality text-to-video and image-to-video. Smooth motion, cinematic output. Strong with Asian aesthetics and character animation.

Parameters

ParameterTypeRequiredDefaultDescription
promptstring✅ YesText description of the video. Max 2000 characters.
image_urlstringNoURL of a source image for image-to-video generation. If omitted, text-to-video is used.
durationfloatNo4.0Video duration in seconds. Range: 2.0–10.0.
resolutionstringNo"720p"Output resolution: 480p, 720p.
fpsintegerNo24Frames per second: 16, 24.
seedintegerNoRandomReproducibility seed.
webhook_urlstringNoURL to receive completion callback. See Webhooks.

Cost

DurationResolutionCost per Video
≤4s720p$0.15
5–8s720p$0.25
9–10s720p$0.35
Any480p50% of 720p price

Example Request

python
# Text-to-video
response = client.videos.generate(
    model="wan-video-2.1",
    prompt="A koi fish leaping out of a glowing pond, slow motion, cinematic lighting",
    duration=4.0,
    resolution="720p",
    webhook_url="https://yourapp.com/webhook/fluxpool"
)

print(response.generation_id)  # Use this to poll status or wait for webhook

Example Webhook Payload

json
{
  "event": "generation.completed",
  "generation_id": "gen_abc123",
  "model": "wan-video-2.1",
  "status": "completed",
  "output": {
    "url": "https://cdn.fluxpool.ai/generations/gen_abc123.mp4",
    "duration": 4.0,
    "resolution": "1280x720",
    "fps": 24
  },
  "usage": {
    "credits_used": 0.15
  }
}

Notes

  • Image-to-video: provide image_url to animate a static image. The prompt then describes the desired motion.
  • Supports CJK prompts natively.
  • Average generation time: ~45 seconds for 4s at 720p.

kling-v2

Provider: Kuaishou Video Generation Active

Realistic motion and strong character consistency. Excellent for human movement and facial expressions. Supports up to 1080p.

Cost

DurationResolutionCost per Video
≤5s1080p$0.20
6–10s1080p$0.40
≤5s720p$0.12
6–10s720p$0.24

Notes

  • Best model for realistic human motion and facial expressions.
  • 1080p output is this model's differentiator — most video models max at 720p.
  • Average generation time: ~60 seconds for 5s at 1080p.

runway-gen3

Provider: Runway Video Generation Active

Premium video generation. State-of-the-art motion coherence, camera movement, and scene consistency. The highest-quality video model available.

Cost

DurationResolutionCost per Video
≤4s1080p$0.50
5–10s1080p$0.90
≤4s720p$0.35
5–10s720p$0.60

Notes

  • Most expensive video model but highest quality output.
  • The motion parameter is unique to Runway Gen-3. low produces smoother, more controlled camera work. high produces more dynamic movement.
  • Average generation time: ~90 seconds for 4s at 1080p.

hunyuan-video

Provider: Tencent Video Generation Active

Good balance of quality and cost. Strong with nature scenes, abstract visuals, and stylized content.

Cost

DurationResolutionCost per Video
≤4s720p$0.12
5–8s720p$0.22
Any480p50% of 720p price

Notes

  • Best value video model — cheapest option for 720p video.
  • Max duration is 8s (shorter than other video models).
  • Supports CJK prompts.

luma-dream

Provider: Luma AI Video Generation Active

Fast video generation. Best for quick iterations, prototyping, and social media content.

Cost

DurationResolutionCost per Video
≤4s720p$0.10
5s720p$0.15
Any480p50% of 720p price

Notes

  • Fastest video model — ~30s for 4s at 720p. Ideal for rapid iteration.
  • Max duration is 5s (shortest of all video models).
  • Good enough quality for social media; use Runway or Kling for production-grade output.

Utility Models

Utility models perform post-processing tasks — upscaling, edge detection, style transfer, etc. They complement the generation models.

real-esrgan-4x

Provider: Community (Open Source) Upscaling Active

4x image upscaling. Enhances resolution while preserving detail. Use after generating at 1024×1024 to produce 4096×4096 output.

Parameters

ParameterTypeRequiredDefaultDescription
image_urlstring✅ YesURL of the image to upscale.
scaleintegerNo4Upscale factor: 2, 4.
output_formatstringNo"png"png, jpeg, webp.

Cost

ScaleCost
2x$0.003
4x$0.005

Notes

  • Input image must be ≤ 2048×2048.
  • 4x upscale of a 1024×1024 image produces a 4096×4096 output.
  • Works with any image URL, not just Fluxpool-generated images.
  • Processing time: ~5 seconds regardless of scale.

controlnet-canny

Provider: Community (Open Source) Guided Image Generation Active

Generate images guided by edge-detection maps from a source image. Preserves composition and structure while applying new styles.

Parameters

ParameterTypeRequiredDefaultDescription
promptstring✅ YesText description of the desired output.
image_urlstring✅ YesURL of the source/control image.
control_strengthfloatNo0.8How closely to follow the control image. Range: 0.0–1.5.
base_modelstringNo"sdxl-1.0"Underlying generation model: sdxl-1.0, flux-1.1-pro.
negative_promptstringNo""Exclusion prompt.
seedintegerNoRandomReproducibility seed.
output_formatstringNo"png"png, jpeg, webp.

Cost

Base ModelCost
sdxl-1.0$0.02
flux-1.1-pro$0.04

Notes

  • Useful for maintaining composition from a sketch, wireframe, or existing image while generating in a new style.
  • control_strength above 1.0 may produce artifacts. Start at 0.7–0.8.
  • The base_model parameter selects which underlying model does the generation — cost matches the selected base model plus a $0.01 ControlNet surcharge.

Deprecated Models

Deprecated models remain available for a transition period but will be removed on the listed sunset date. Migrate to the recommended replacement.

Model ID Sunset Date Replacement Notes
No models are currently deprecated.

When a model is deprecated, we announce it in the Changelog, via email to all users who have called the model in the last 90 days, and with a X-Fluxpool-Deprecation response header on API calls to the model.