Windpaint
Generation

Models

Which capabilities have a live model, what each model supports and costs, and how to read the current catalog from the API.

Windpaint is capability-first: you ask for image.generate or video.generate, and a model implements it. Today image.generate has two live models. video.generate is coming soon: its first model, wan-2.2-i2v, is in the catalog with status: "coming-soon" and its planned price, but can’t be submitted yet. The other capabilities are part of the API’s schema and return 422 if you submit to them.

The catalog endpoint is the source of truth for what’s live and what it costs. Read prices from it rather than hard-coding the numbers on this page. windpaint.ai/models lists the live models and the ones coming next, with their licences.

curl https://api.windpaint.ai/v1/generation/capabilities \
  -H "Authorization: Bearer $WINDPAINT_API_KEY"

Capabilities

CapabilityInputs (slot: count, kind)OutputPromptModel
image.generatenoneimageRequiredz-image-turbo (default), flux-2-klein-4b
video.generatestart_frame: 0–1 image, end_frame: 0–1 imagevideoRequiredComing soon: wan-2.2-i2v (needs exactly one start_frame, no end_frame)
image.editimages: 1–3 image, mask: 0–1 maskimageRequiredComing
mask.segmentimages: 1 imagemaskRequired (what to segment)Coming
media.upscalemedia: 1 image or videosame as inputOptionalComing
audio.speechvoice: 0–1 audioaudioRequired (the text to speak)Coming
video.lipsyncmedia: 1 image or video, audio: 1 audiovideoOptionalComing
text.llmimages: 0–8 imagetextRequiredComing

“Coming” capabilities appear in GET /v1/generation/capabilities with no live model. Some list models with status: "coming-soon" and available: false; submitting to those returns 503. A capability with no models at all returns 422 with the message No model implements <capability> yet. They’re listed so you can see the shape of the API; there’s no date attached to any of them.

Live models

z-image-turbo

Fast text-to-image, implementing image.generate.

Capabilityimage.generate
Resolutions1k
Aspect ratiosAll ten (see below), default 1:1
OutputUp to 4 images per request (num_outputs)
LicenceApache-2.0
Price1k: 0.08 credits

See Images for pixel sizes and examples, and the z-image-turbo model page on windpaint.ai for an overview.

flux-2-klein-4b

FLUX.2 [klein] 4B from Black Forest Labs, a 4-step distilled text-to-image model, implementing image.generate. Name it with "model": "flux-2-klein-4b".

Capabilityimage.generate
Resolutions1k
Aspect ratiosAll ten (see below), default 1:1
OutputUp to 4 images per request (num_outputs), PNG, JPEG or WebP
LicenceApache-2.0
Price1k: 0.10 credits

It takes the same request fields as z-image-turbo. Reference images and editing aren’t available yet. See the flux-2-klein-4b model page on windpaint.ai for an overview.

Coming soon

wan-2.2-i2v

Coming soon. wan-2.2-i2v is listed in the catalog with status: "coming-soon" and available: false, so video.generate can’t be submitted yet. The details and price below are what it will launch with.

Image-to-video, implementing video.generate. It animates a start frame you supply.

Capabilityvideo.generate
Inputsstart_frame: exactly 1 image (PNG, JPEG or WebP). No end_frame.
Resolutions480p only
Durations5 seconds only
Aspect ratiosAll ten, default 16:9
OutputOne MP4 clip, no audio
LicenceApache-2.0
Price (coming soon)480p, 5 s: 4 credits per clip

See Video for the full workflow, and the wan-2.2-i2v model page on windpaint.ai for an overview.

Prices are in credits per output (per image, per clip) at a tier, and can change. The price you pay is the credits_estimate returned when you submit; it’s fixed for that job even if the list price changes while it runs. See Pricing for what a credit costs.

Resolution tiers

A resolution tier sets one edge of the output, and the aspect ratio sets the other.

  • Image tiers set the long edge: 1k = 1024 px.
  • Video tiers set the short edge: 480p = 480 px, 720p = 720 px, 1080p = 1080 px.

Both edges are rounded to the nearest multiple of 16. A model only accepts the tiers it has a price for; today that’s 1k for both image models, and 480p for wan-2.2-i2v once it’s live. Asking for any other tier returns 422.

RequestOutput size
image.generate, 1k, 1:11024 × 1024
image.generate, 1k, 16:91024 × 576
image.generate, 1k, 9:16576 × 1024
video.generate, 480p, 16:9 (coming soon)848 × 480
video.generate, 480p, 9:16 (coming soon)480 × 848

To see the exact size for any combination before you pay, call POST /v1/generation/estimate; it returns width and height. Images has the full table for image tiers.

Aspect ratios

Every capability with an image or video output accepts the same ten ratios:

1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, 4:5, 5:4

The default is 16:9 for video.generate and 1:1 for everything else. Anything outside the list returns 422.

Quality and duration

quality is reserved for models with quality tiers. No live model has any, so sending quality at all returns 422.

duration is in whole seconds. For a model with durations, leaving it out uses the model’s first duration (5 for wan-2.2-i2v), and any value outside its list returns 422. Image models don’t take a duration.

Default model selection

When you leave model out of a request, Windpaint uses the capability’s first available model in catalog order. Today that means image.generate runs z-image-turbo; send "model": "flux-2-klein-4b" for the other image model. video.generate has no available model yet.

If you need a specific model, name it. When more models ship for a capability, the default may change, and a request without model would follow it. The status object always reports which model ran.

No version pinning

Model ids such as z-image-turbo are stable slugs. There’s no way to pin a version of a model; if Windpaint updates what’s behind a slug, requests that name it get the update. The price is fixed per job at submit time, so a price change never affects a job you’ve already submitted.

Read the live catalog

curl
# Capabilities, their input slots, and each model's tiers and current prices
curl https://api.windpaint.ai/v1/generation/capabilities \
  -H "Authorization: Bearer $WINDPAINT_API_KEY"

# The same data organized by model
curl https://api.windpaint.ai/v1/generation/models \
  -H "Authorization: Bearer $WINDPAINT_API_KEY"

GET /v1/generation/capabilities returns {"data": [Capability]}:

{
  "data": [
    {
      "id": "image.generate",
      "description": "Text to image.",
      "output": "image",
      "prompt_required": true,
      "prompt_meaning": "Instruction or description.",
      "inputs": [],
      "aspect_ratios": ["1:1", "4:3", "3:4", "3:2", "2:3", "16:9", "9:16", "21:9", "4:5", "5:4"],
      "models": [
        {
          "model": "z-image-turbo",
          "description": "Z-Image Turbo. Fast, 8-step text to image.",
          "status": "live",
          "available": true,
          "prices": [{ "resolution": "1k", "duration_s": null, "credits": "0.08" }],
          "resolutions": ["1k"],
          "default_resolution": "1k",
          "qualities": [],
          "durations": [],
          "max_outputs": 4,
          "output_formats": ["png", "jpeg", "webp"],
          "inputs": [],
          "licence": "Apache-2.0",
          "licence_restricted": false,
          "licence_note": null
        },
        {
          "model": "flux-2-klein-4b",
          "description": "FLUX.2 [klein] 4B. 4-step distilled text to image.",
          "status": "live",
          "available": true,
          "prices": [{ "resolution": "1k", "duration_s": null, "credits": "0.10" }],
          "resolutions": ["1k"],
          "default_resolution": "1k",
          "qualities": [],
          "durations": [],
          "max_outputs": 4,
          "output_formats": ["png", "jpeg", "webp"],
          "inputs": [],
          "licence": "Apache-2.0",
          "licence_restricted": false,
          "licence_note": null
        }
      ]
    },
    {
      "id": "video.generate",
      "description": "Prompt, optionally with a start frame and an end frame, to a video clip.",
      "output": "video",
      "prompt_required": true,
      "prompt_meaning": "Instruction or description.",
      "inputs": [
        { "name": "start_frame", "kinds": ["image"], "min": 0, "max": 1, "description": "First frame." },
        { "name": "end_frame", "kinds": ["image"], "min": 0, "max": 1, "description": "Last frame, for first/last-frame interpolation." }
      ],
      "aspect_ratios": ["1:1", "4:3", "3:4", "3:2", "2:3", "16:9", "9:16", "21:9", "4:5", "5:4"],
      "models": [
        {
          "model": "wan-2.2-i2v",
          "description": "Wan 2.2 image-to-video 14B. Start frame required. 480p, 5 s.",
          "status": "coming-soon",
          "available": false,
          "prices": [{ "resolution": "480p", "duration_s": 5, "credits": "4.00" }],
          "resolutions": ["480p"],
          "default_resolution": "480p",
          "qualities": [],
          "durations": [5],
          "max_outputs": 1,
          "output_formats": [],
          "inputs": [
            { "name": "start_frame", "kinds": ["image"], "min": 1, "max": 1, "description": "First frame." },
            { "name": "end_frame", "kinds": ["image"], "min": 0, "max": 0, "description": "Last frame, for first/last-frame interpolation." }
          ],
          "licence": "Apache-2.0",
          "licence_restricted": false,
          "licence_note": null
        }
      ]
    }
  ]
}

The capability’s inputs are its general slot limits; each model’s inputs repeats them with that model’s limits applied. Read the model’s list when you’re building a request: above, it’s what tells you wan-2.2-i2v needs exactly one start frame and takes no end frame.

statusstring

Where the model stands: live, coming-soon (listed with its planned price, can’t be submitted yet) or not-offered (catalogued for reference; its licence keeps Windpaint from selling it).

availableboolean

Whether you can submit to this model right now. false when the model is coming soon, temporarily unavailable or has no price; submitting then returns 503.

pricesobject[]

One entry per tier that’s for sale: resolution, duration_s (null for images) and credits as a decimal string. A tier missing from this list can’t be submitted.

resolutionsstring[]

Accepted resolution values. default_resolution is used when you omit it.

qualitiesstring[]

Accepted quality values. Empty for every model today.

durationsinteger[]

Accepted duration values in seconds. Empty for models that don’t take one.

max_outputsinteger

The largest num_outputs the model takes: 4 for both image models, 1 for wan-2.2-i2v. See multiple outputs.

output_formatsstring[]

Accepted output_format values, default first: ["png", "jpeg", "webp"] for both image models. Empty when the format can’t be chosen, as for video.

licencestring

The model’s licence. Both live models are Apache-2.0.

GET /v1/generation/models returns {"data": [{"id": "<model>", "capabilities": [...]}]}, where each entry carries the same description, licence, status, available, resolutions, default_resolution, qualities, durations, max_outputs, output_formats and prices for one capability the model implements.

Price a request before you send it

POST /v1/generation/estimate takes a normal request body plus capability, validates it the same way submit does, and returns the price and output size without creating a job or holding credits.

curl
curl -X POST https://api.windpaint.ai/v1/generation/estimate \
  -H "Authorization: Bearer $WINDPAINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"capability": "image.generate", "prompt": "x", "resolution": "1k", "aspect_ratio": "3:2"}'
{
  "data": {
    "capability": "image.generate",
    "model": "z-image-turbo",
    "credits": "0.08",
    "unit_credits": "0.08",
    "num_outputs": 1,
    "output_format": "png",
    "width": 1024,
    "height": 688,
    "available": true
  }
}

credits is unit_credits (the price of one output) times num_outputs, or null when the tier has no price. available is false when a submit would be refused with 503. Because estimate validates like submit, it needs a non-empty prompt for capabilities that require one. It doesn’t fetch URL inputs or run moderation, so a prompt that estimates fine can still be blocked at submit.