Models: Catalog & Pricing Reference

curl "https://api.budgetpixel.com/v1/models?type=video" \
  -H "Authorization: Bearer $BUDGETPIXEL_API_KEY"

{
  "data": [
    { "name": "flux-2-pro", "type": "image", "credits_per_generation": 25,
      "resolution_pricing": { "0.5MP": 15, "1MP": 25, "2MP": 50, "4MP": 80 } },
    { "name": "seedream-4.5", "type": "image", "credits_per_generation": 45 },
    { "name": "seedance-2.0-mini", "type": "video", "credits_per_generation": 0,
      "credits_per_unit": 120, "unit_type": "second",
      "resolution_pricing": { "480p": 60, "720p": 120 } },
    { "name": "seedance-2.0", "type": "video", "credits_per_generation": 0,
      "credits_per_unit": 220, "unit_type": "second",
      "resolution_pricing": { "480p": 100, "720p": 220, "1080p": 550, "4k": 1250 },
      "resolution_codecs": { "480p": "h264", "720p": "h264", "1080p": "h264", "4k": "h265" } }
  ]
}

​

Reading the response

​

Multiple images per request

• seedream-4.5 and seedream-5.0-lite support grouped generation. Set sequential_image_generation: "auto" and max_images (up to 4 on seedream-4.5, up to 14 on seedream-5.0-lite). The model returns a group of related images up to max_images and decides the exact count — it may return fewer (a plain prompt often yields one; a prompt that explicitly asks for a set yields several). Use max_images for this, not num_images.
• seedream-5.0-pro does not support grouped generation — it has no sequential_image_generation parameter. Use num_images (1–4) for multiple takes; each is generated and billed independently. It prices by output size (1K = 55, 2K = 110 credits per image) and bills reference_images beyond the first at 5 credits each — see pricing & credits.
• seedream-5.0-flash has no grouped generation either: use num_images (1–4). It costs a flat 25 credits per image at 1K or 2K, and its reference_images (up to 10) are free.
• flux-3-image takes num_images (1–4); each image is generated and billed independently at its size’s price. Its reference_images (up to 10) are free.
• nano-banana-2.1 takes num_images (1–4); each image is generated and billed independently at its size’s price, plus search grounding if you enabled it. Its reference_images (up to 9) are free.

​

Grounding

{
  "prompt": "A travel poster of the Sagrada Família at golden hour",
  "size": "2K",
  "aspect_ratio": "3:4",
  "grounding": true
}

​

Search grounding

{
  "prompt": "An illustrated postcard of today's weather in Tokyo, with the temperature written on it",
  "size": "1K",
  "aspect_ratio": "4:3",
  "google_search": true
}

​

Transparent backgrounds

{
  "prompt": "Put a knitted red scarf on the fox",
  "reference_images": ["https://example.com/fox-cutout.png"],
  "background": "transparent",
  "size": "1K"
}

​

Video output format

{
  "status": "succeeded",
  "model": "seedance-2.5",
  "resolution": "1080p",
  "video_url": "https://...",
  "video_codec": "h265",
  "video_codec_note": "This video is H.265 (HEVC), 10-bit, in an MP4 container. ..."
}

ffmpeg -i input.mp4 -c:v libx264 -pix_fmt yuv420p -crf 17 -c:a copy -movflags +faststart output.mp4

​

Video generation modes

​

SeeDance 2.5 (flagship)

• Text-to-video — prompt only (aspect_ratio applies here; other modes are adaptive).
• Image-to-video — a start frame (image), optionally with an end frame (end_image).
• Reference-to-video — any mix of up to 15 reference_images (free), up to 5 reference_videos (each 2–15s, 30s combined), and up to 5 reference_audios (30s combined, free; audio-only input works). Editing or extending an existing clip = passing it as a reference_videos entry. Reference media can’t be combined with start/end frames.

​

SeeDance 2.0

• Text-to-video — prompt only.
• Image-to-video — a start frame (image), optionally with an end frame (end_image) to interpolate between the two.
• Reference-images-to-video — up to 9 reference_images to guide the result.
• Video-to-video — supply a video to edit an existing clip. Video inputs are passed by URL (a public URL or one from POST /v1/uploads), not inlined as base64. You can also pass reference_images (up to 6) and/or an audio track alongside the video to guide the edit.

​

MiniMax H3

• Text-to-video — prompt only (aspect_ratio applies here; other modes are adaptive).
• Image-to-video — a start frame (image), optionally with an end frame (end_image).
• Reference-to-video — mix up to 5 reference_images, up to 3 reference_videos clips, and up to 3 reference_audios clips in one request. Clips are passed by URL (public or from POST /v1/uploads); each clip must be 2–15s, with at most 15s combined per media type.

​

MiniMax H3 Max

• Text-to-video — prompt only; aspect_ratio defaults to 16:9. An optional audio URL pins a soundtrack (it replaces the generated audio, trimmed to the video length).
• Image-to-video — image (first frame) and/or end_image (last frame). An end frame on its own is allowed. The output follows the frame image, so aspect_ratio is ignored. audio works here too.
• Reference-to-video — up to 5 reference_images, 3 reference_videos (2–15s each, 15s combined) and 3 reference_audios (2–15s each, 15s combined). Address them in the prompt by order: “Image 1”, “Video 1”, “Audio 1”. aspect_ratio defaults to adaptive (the model picks); an explicit ratio is honored.
• Extend — pass a video (1.6–60s, ≤50MB, aspect ratio between 2:5 and 5:2) and describe what happens next. length_seconds is the new footage appended; the output is the source followed by the continuation. aspect_ratio defaults to auto (keep the source framing); any other ratio crops.

​

Wan 3.0

• Text-to-video — prompt only. aspect_ratio is honored in every mode — an explicit ratio reframes the output even with a first frame or reference media, and the default adaptive lets the model pick a suitable ratio from the inputs and prompt.
• Image-to-video — a first frame (image), optionally with a last frame (end_image) to interpolate between the two.
• Reference-to-video — any mix of up to 10 reference_images (free), up to 5 reference_videos (each 2–15s, 15s combined), and up to 5 reference_audios (15s combined, free). Editing, replicating the style or camera move of, or extending an existing clip = passing it as a reference_videos entry. In the prompt you can address assets by their order in each type: “Image 1 hands Video 1 the guitar…”. Reference media can’t be combined with first/last frames.

​

Wan 2.7

• Text-to-video — prompt only.
• Image-to-video — a start frame (image), optionally with an end frame (end_image) to interpolate between the two.
• Video editing — supply a video and the model applies your prompt to that clip (restyle it, change the scene, alter a subject’s action or the camera move). The video is passed by URL (public or from POST /v1/uploads), not inlined as base64. Up to 4 reference_images may accompany it to guide the edit — for example, supplying the person or style to apply to the clip.

​

P-Video

• Text-to-video — prompt only.
• Image-to-video — a start frame (image), optionally with an end frame (end_image) to interpolate between the two.
• Audio-driven — supply an audio track (MP3/WAV/FLAC) by URL and the model generates video to match it.

​

Retired models

{
  "error": {
    "type": "invalid_request_error",
    "code": "model_retired",
    "message": "Model 'seedance-1.5-pro' was retired by its provider on 2026-09-17 and is no longer available. Use 'seedance-2.0' instead — see GET /v1/models?type=video for its parameters and pricing."
  }
}

​

Requesting a model

curl -X POST https://api.budgetpixel.com/v1/images/flux-2-pro \
  -H "Authorization: Bearer $BUDGETPIXEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "prompt": "...", "num_images": 1, "size": "1MP" }'

curl -X POST https://api.budgetpixel.com/v1/videos/seedance-2.0 \
  -H "Authorization: Bearer $BUDGETPIXEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "prompt": "...", "length_seconds": 5 }'

curl -X POST https://api.budgetpixel.com/v1/audios/mureka-v9 \
  -H "Authorization: Bearer $BUDGETPIXEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "lyrics": "[verse]\nSun up before the rooster crows...", "prompt": "slow country, porch vibes" }'

curl -X POST https://api.budgetpixel.com/v1/audios/sonilo-music \
  -H "Authorization: Bearer $BUDGETPIXEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "prompt": "30 seconds of upbeat electronic instrumental for a product launch video, no vocals", "duration": 30 }'

curl -X POST https://api.budgetpixel.com/v1/audios/sonilo-video-music \
  -H "Authorization: Bearer $BUDGETPIXEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "video": "https://example.com/clip.mp4", "prompt": "warm acoustic indie that builds gently, no vocals" }'
# -> a licensed soundtrack composed for the clip, matched to its length; poll GET /v1/audios/{id} for audio_url

curl -X POST https://api.budgetpixel.com/v1/audios/sonilo-sfx \
  -H "Authorization: Bearer $BUDGETPIXEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "prompt": "heavy rain on a tin roof with distant thunder", "duration": 10, "format": "mp3" }'

curl -X POST https://api.budgetpixel.com/v1/audios/sonilo-video-sfx \
  -H "Authorization: Bearer $BUDGETPIXEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "video": "https://example.com/clip.mp4", "prompt": "realistic Foley and ambience, no music" }'
# -> poll GET /v1/audios/{id}: audio_url = the SFX track, video_url = your clip with the effects mixed in