Models Reference
All available models, their IDs, parameters, capabilities, and pricing. Use the model ID in your API requests to select which model generates your output.
| 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 IDs are lowercase, hyphenated strings. Use them in the model parameter of any generation request.
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:
curl https://api.fluxpool.ai/v1/models \
-H "Authorization: Bearer fp_your_api_key"
Response:
{
"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.
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 |
Example Request
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
{
"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_scaleabove 12 may produce oversaturated results. - •2048×2048 generations take ~5s (vs. ~3s for 1024×1024).
Excellent Asian aesthetics and character rendering. Strong text-in-image generation. Natively supports Chinese, English, Japanese, Korean, and Malay prompts.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | ✅ Yes | — | Text description. Max 2000 characters. Supports CJK and Latin scripts. |
size | string | No | 1024x1024 | Output dimensions. See supported sizes. |
negative_prompt | string | No | "" | Exclusion prompt. |
steps | integer | No | 30 | Inference steps. Range: 1–50. |
guidance_scale | float | No | 7.0 | Prompt adherence. Range: 1.0–15.0. |
seed | integer | No | Random | Reproducibility seed. |
num_images | integer | No | 1 | Range: 1–4. |
output_format | string | No | "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 resolutionCost
| Resolution | Cost per Image |
|---|---|
| Up to 1024×1024 | $0.02 |
| Up to 1536×1536 | $0.03 |
| 2048×2048 | $0.04 |
Example Request
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).
Open-source workhorse. Largest ecosystem of LoRAs, ControlNets, and community fine-tunes. Fastest and cheapest image model available.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | ✅ Yes | — | Text description. Max 2000 characters. |
size | string | No | 1024x1024 | Output dimensions. |
negative_prompt | string | No | "" | Exclusion prompt. Highly recommended for SDXL. |
steps | integer | No | 25 | Inference steps. Range: 1–50. |
guidance_scale | float | No | 7.5 | Prompt adherence. Range: 1.0–20.0. |
seed | integer | No | Random | Reproducibility seed. |
scheduler | string | No | "euler_a" | Sampling scheduler: euler_a, euler, dpm_2m, dpm_2m_karras, ddim. |
num_images | integer | No | 1 | Range: 1–4. |
output_format | string | No | "png" | png, jpeg, webp. |
Supported Sizes
1024x1024 (1:1) — Default, optimal
768x1024 (3:4) — Portrait
1024x768 (4:3) — Landscape
512x512 (1:1) — Fast / draft qualitySDXL is optimized for 1024×1024. Sizes outside this range may reduce quality.
Cost
| Resolution | Cost per Image |
|---|---|
| Up to 1024×1024 | $0.01 |
| 512×512 | $0.005 |
Example Request
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_promptsignificantly improves output quality with SDXL. Always use it. - •
schedulerparameter 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.
Best-in-class text rendering within images. Ideal for posters, logos, signage, and any generation requiring legible text.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | ✅ Yes | — | Text description. Max 2000 characters. |
size | string | No | 1024x1024 | Output dimensions. |
negative_prompt | string | No | "" | Exclusion prompt. |
style | string | No | "auto" | Style preset: auto, realistic, design, anime, render_3d. |
seed | integer | No | Random | Reproducibility seed. |
num_images | integer | No | 1 | Range: 1–4. |
output_format | string | No | "png" | png, jpeg, webp. |
Cost
| Resolution | Cost per Image |
|---|---|
| Up to 1024×1024 | $0.04 |
| Up to 2048×2048 | $0.06 |
Example Request
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
styleparameter 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.
Design-oriented model. Strong at clean compositions, graphic design styles, and product mockups.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | ✅ Yes | — | Text description. Max 2000 characters. |
size | string | No | 1024x1024 | Output dimensions. |
negative_prompt | string | No | "" | Exclusion prompt. |
guidance_scale | float | No | 7.0 | Prompt adherence. Range: 1.0–15.0. |
seed | integer | No | Random | Reproducibility seed. |
num_images | integer | No | 1 | Range: 1–4. |
output_format | string | No | "png" | png, jpeg, webp. |
Cost
| Resolution | Cost per Image |
|---|---|
| All sizes | $0.02 |
Example Request
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-4xfor upscaling.
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.
High-quality text-to-video and image-to-video. Smooth motion, cinematic output. Strong with Asian aesthetics and character animation.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | ✅ Yes | — | Text description of the video. Max 2000 characters. |
image_url | string | No | — | URL of a source image for image-to-video generation. If omitted, text-to-video is used. |
duration | float | No | 4.0 | Video duration in seconds. Range: 2.0–10.0. |
resolution | string | No | "720p" | Output resolution: 480p, 720p. |
fps | integer | No | 24 | Frames per second: 16, 24. |
seed | integer | No | Random | Reproducibility seed. |
webhook_url | string | No | — | URL to receive completion callback. See Webhooks. |
Cost
| Duration | Resolution | Cost per Video |
|---|---|---|
| ≤4s | 720p | $0.15 |
| 5–8s | 720p | $0.25 |
| 9–10s | 720p | $0.35 |
| Any | 480p | 50% of 720p price |
Example Request
# 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 webhookExample Webhook Payload
{
"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_urlto animate a static image. The prompt then describes the desired motion. - •Supports CJK prompts natively.
- •Average generation time: ~45 seconds for 4s at 720p.
Realistic motion and strong character consistency. Excellent for human movement and facial expressions. Supports up to 1080p.
Cost
| Duration | Resolution | Cost per Video |
|---|---|---|
| ≤5s | 1080p | $0.20 |
| 6–10s | 1080p | $0.40 |
| ≤5s | 720p | $0.12 |
| 6–10s | 720p | $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.
Premium video generation. State-of-the-art motion coherence, camera movement, and scene consistency. The highest-quality video model available.
Cost
| Duration | Resolution | Cost per Video |
|---|---|---|
| ≤4s | 1080p | $0.50 |
| 5–10s | 1080p | $0.90 |
| ≤4s | 720p | $0.35 |
| 5–10s | 720p | $0.60 |
Notes
- •Most expensive video model but highest quality output.
- •The
motionparameter is unique to Runway Gen-3.lowproduces smoother, more controlled camera work.highproduces more dynamic movement. - •Average generation time: ~90 seconds for 4s at 1080p.
Good balance of quality and cost. Strong with nature scenes, abstract visuals, and stylized content.
Cost
| Duration | Resolution | Cost per Video |
|---|---|---|
| ≤4s | 720p | $0.12 |
| 5–8s | 720p | $0.22 |
| Any | 480p | 50% 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.
Fast video generation. Best for quick iterations, prototyping, and social media content.
Cost
| Duration | Resolution | Cost per Video |
|---|---|---|
| ≤4s | 720p | $0.10 |
| 5s | 720p | $0.15 |
| Any | 480p | 50% 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 perform post-processing tasks — upscaling, edge detection, style transfer, etc. They complement the generation models.
4x image upscaling. Enhances resolution while preserving detail. Use after generating at 1024×1024 to produce 4096×4096 output.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
image_url | string | ✅ Yes | — | URL of the image to upscale. |
scale | integer | No | 4 | Upscale factor: 2, 4. |
output_format | string | No | "png" | png, jpeg, webp. |
Cost
| Scale | Cost |
|---|---|
| 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.
Generate images guided by edge-detection maps from a source image. Preserves composition and structure while applying new styles.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | ✅ Yes | — | Text description of the desired output. |
image_url | string | ✅ Yes | — | URL of the source/control image. |
control_strength | float | No | 0.8 | How closely to follow the control image. Range: 0.0–1.5. |
base_model | string | No | "sdxl-1.0" | Underlying generation model: sdxl-1.0, flux-1.1-pro. |
negative_prompt | string | No | "" | Exclusion prompt. |
seed | integer | No | Random | Reproducibility seed. |
output_format | string | No | "png" | png, jpeg, webp. |
Cost
| Base Model | Cost |
|---|---|
| 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_strengthabove 1.0 may produce artifacts. Start at 0.7–0.8. - •The
base_modelparameter selects which underlying model does the generation — cost matches the selected base model plus a $0.01 ControlNet surcharge.
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.
Ready to build?