Skip to main content
This guide walks through generating an image end to end: create a key, submit a job, poll for the result.
1

Create an API key

From your BudgetPixel account dashboard, create a key (private beta — see Availability). Copy it immediately — the full secret (bpx_live_…) is shown only once.
2

Pick a model

List the models available to the API and their pricing:
Each image model has its own endpoint: POST /v1/images/{model-name}. For example, FLUX 2 Pro is POST /v1/images/flux-2-pro and SeeDream 4.5 is POST /v1/images/seedream-4.5.
3

Create an image job

Submit a generation request to the model’s endpoint. The response returns a job_id.
4

Poll for the result

Generation is asynchronous. Poll the job until status is succeeded; the images array then contains your result URLs.
Image URLs are short-lived presigned links (valid ~1 hour). Re-call the status endpoint for fresh URLs; the underlying objects expire 24 hours after generation.

​
Generating video

Video uses the same per-model pattern as images: POST /v1/videos/{model-name}, then poll /v1/videos/{job_id}. See Async jobs.
You’re charged in credits only when a job succeeds — never for failures, timeouts, or content blocked before generation. Check your balance any time with GET /v1/account/credits.