Models

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 },
    { "name": "seedream-4.5", "type": "image", "credits_per_generation": 45 },
    { "name": "seedance-1.5-pro", "type": "video", "credits_per_generation": 0,
      "credits_per_unit": 60, "unit_type": "second",
      "resolution_pricing": { "480p": 40, "720p": 60, "1080p": 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 } }
  ]
}

​

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.

​

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.

​

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.

​

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-1.5-pro \
  -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" }'