> ## Documentation Index
> Fetch the complete documentation index at: https://developer.beeble.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> This site documents two API families. Choose the family before generating integration code and keep its request fields, billing, statuses, responses, and webhooks together.
> SwitchX API: POST /v1/switchx/generations; use /quickstart and /authentication. Completed generation files are under output.
> Enterprise API: POST /v1/products/{product}/jobs and GET /v1/product-jobs/{job_id}; use /enterprise/quickstart and /products. Check /enterprise for current access requirements. Completed product files are under outputs.
> For product jobs, fetch model-specific input_schema from GET /v1/products/{product}/models. OpenAPI defines the common job response; product guides show illustrative completed outputs. Do not treat output examples as exhaustive schemas.
> SwitchX 2.0 Finish uses the separate switchx_finish product and model_id switchx-2.0. Follow /products/switchx-finish: pass inputs.parent_job_id (a completed Standard switchx product generation's public dap_ ID owned by the same key owner, organization, and team) and inputs.target_resolution (1080 or 2160), without uploading media. Fast results, Finish results, and legacy SwitchX API generations cannot be parents. Estimate the transition, then submit and poll the new child ID; result files are under outputs.
> For product APIs, authenticate with an Organization API Key in x-api-key and keep the same organization and X-Beeble-Team-Id context for uploads, estimates, submissions, and reads. Use Beeble Cloud credits; product routes do not support USD.
> Follow /enterprise/llms-txt for the product API workflow: discover products and models, upload media, estimate credits, submit with an idempotency_key, and poll or receive webhooks. On an uncertain submission, retry the same body and key; do not create a replacement job.
> Product-job success is status=success; stop polling on failed, cancelled, or credit_required. Use the chosen product guide for completed response examples and download fields. Refer to /enterprise/errors, /enterprise/rate-limits, /guides/billing, and /guides/jobs for failures, limits, and refunds.

# Create job request

> Model, inputs, spending cap, and retry key for a product job.

This request body is shared by all `POST /v1/products/{product}/jobs` calls.
Use the selected model's `input_schema` from the [model catalog](/docs/api-reference/products/list-product-model-input-schemas)
for the fields inside `inputs`.

Single-file image, video, and supported audio inputs accept Beeble URIs,
authorized Beeble CDN URLs, public/presigned HTTPS URLs, or base64 data URIs.
See [media inputs and limits](/docs/guides/uploads#choose-a-media-input). The model's
file requirements still apply. Fields such as Finish's `parent_job_id` remain
job IDs, not media URIs.

`billing_unit` defaults to `credits`, using Beeble Cloud credits. Although the
shared billing enum below includes `usd`, product endpoints reject that value.

See the [job response schema](/docs/enterprise/schemas/product-job) for the returned status and outputs.