> ## Documentation Index > Fetch the complete documentation index at: https://docs.budgetpixel.com/llms.txt > Use this file to discover all available pages before exploring further. # List available models > Returns the models available via the API, with pricing. ## OpenAPI ````yaml /openapi.yaml get /models openapi: 3.1.0 info: contact: email: support@budgetpixel.com name: BudgetPixel Support description: > The BudgetPixel developer API for programmatic image, video, music and sound-effect generation. Generation is **asynchronous**: you create a job, then poll its status until it reaches a terminal state (`succeeded` / `failed`). You are charged in credits only on success — never for failures, timeouts, or content blocked before generation. **Authentication.** All requests require an API key sent as a bearer token: Authorization: Bearer bpx_live_xxx Create and manage keys from your BudgetPixel account dashboard. The developer API is available on **every paid plan**. On the **Free** plan, API keys can call one endpoint: `GET /v1/stock/images`, the free stock image library search. **Pricing.** API usage is metered in credits at each model's published price (see `GET /v1/models`), and your plan's model discounts and active promotions apply to API charges exactly as they do on the web — `POST /v1/cost` quotes your discounted price. Pro and Ultra plans include a daily free-models allowance (a shared pool of free generations per day across qualified image models such as FLUX 2 Klein and Qwen-Image) that covers API requests too — the standard price applies once the day's pool is used. Other promotional free daily generations remain web/app-only. Failed generations are never charged. **Rate limits.** Requests are limited per minute: **600 requests/min per API key** and **1200 requests/min per source IP** (defaults; subject to tuning). Every response carries `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset` (seconds until the window resets). Exceeding a limit returns HTTP `429` with a `Retry-After` header — wait that long before retrying. Rejected requests still count against the window, so a tight retry loop keeps you limited; back off instead. Generation jobs additionally have a per-plan concurrency cap (the same one as the web workshop), independent of these request limits. `POST /v1/uploads` also has a dedicated **60 uploads/min per account** cap (it's free/unmetered) on top of these limits. title: BudgetPixel API version: '2026-06-20' servers: - description: Production url: https://api.budgetpixel.com/v1 security: - ApiKeyAuth: [] tags: - description: Account and credit balance name: Account - description: Discover available models and pricing name: Models - description: Upload input media for image/video generation name: Uploads - description: Image job status name: Images - description: FLUX image models name: Black Forest Labs - description: SeeDream image models name: Bytedance - description: Video job status name: Videos - description: Kuaishou Kling video models name: Kling - description: SeeDance video models name: ByteDance (SeeDance) - description: Music and sound-effect job status name: Audios - description: Music generation models name: Music - description: Text-to-sound-effect models (priced per second) name: Sound Effects - description: Format conversion for images, video, and audio name: Conversions - description: Publish posts to your BudgetPixel feed and enter clan themes name: Social - description: Content moderation — NSFW rating and CSAM detection name: Moderation - description: Content classification — music genre detection name: Classification - description: >- Search the free stock image library — available on every plan, including Free name: Stock Images paths: /models: get: tags: - Models summary: List available models description: Returns the models available via the API, with pricing. operationId: listModels parameters: - description: Filter by model type. in: query name: type required: false schema: enum: - image - video - audio type: string responses: '200': content: application/json: schema: properties: data: items: $ref: '#/components/schemas/Model' type: array type: object description: The list of available models. '401': $ref: '#/components/responses/Unauthorized' components: schemas: Model: properties: credits_per_generation: description: >- Per-output-image cost (images) or per-track cost (music). For image models priced by output size this is the default size's rate — see resolution_pricing. 0 for per-second models (video, sound effects) — see credits_per_unit. example: 45 type: integer credits_per_unit: description: >- Per-unit cost for metered models (e.g. per second of video). For resolution-priced models this is the default resolution's rate. example: 220 type: integer min_billable_seconds: description: >- Billing floor for per-second audio models (sound effects, Sonilo Music) — cost = credits_per_unit × max(min_billable_seconds, seconds rounded up). Absent for flat-priced models. example: 3 type: integer name: example: flux-2-klein type: string option_pricing: additionalProperties: type: integer description: >- For image models with paid on/off options, a map of the option's parameter name to the credits it adds per image when enabled (e.g. nano-banana-2.1 `google_search` 10, `image_search` 20). Each amount is the option on its own; the parameter's description says when two options cost less together. Absent when the model has no paid options. example: google_search: 10 image_search: 20 type: object resolution_codecs: additionalProperties: enum: - h264 - h265 type: string description: >- For video models where some resolution delivers H.265 (HEVC) instead of H.264, a map of resolution to the output codec (`h264` or `h265`). Absent when every resolution delivers H.264. H.265 outputs are 10-bit and do not play in every browser — see `video_codec` on the job status. example: 480p: h264 720p: h264 1080p: h265 type: object resolution_pricing: additionalProperties: type: integer description: >- For models whose rate varies by resolution or output size, a map of resolution to cost — per second for video models, per image for image models (keys are the model's `size` / `resolution` values, e.g. flux-3-image 768px / 1K / 1.5K / 2K / 4K). Absent when pricing is flat. example: 4k: 1250 480p: 100 720p: 220 1080p: 550 type: object type: enum: - image - video - audio type: string unit_type: description: The unit `credits_per_unit` applies to. enum: - generation - second type: string required: - name - type - credits_per_generation type: object Error: properties: error: properties: code: description: Stable machine-readable code. example: model_not_available type: string message: type: string type: description: Error category. example: invalid_request_error type: string required: - type - code - message type: object required: - error type: object responses: Unauthorized: content: application/json: schema: $ref: '#/components/schemas/Error' description: Missing or invalid API key. securitySchemes: ApiKeyAuth: bearerFormat: bpx_live_* description: 'API key as a bearer token: Authorization: Bearer bpx_live_xxx' scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.