Bearer API key

527 models

Pixio API developer reference

Build requests against the same generation system the Pixio app uses. Browse every model, inspect params, and copy request examples — image, video, audio, and 3D over one API.

Saved workflow references and plan-specific pricing appear when you are signed in. This public view shows the free-plan catalog.

Base URL

https://beta.pixio.myapps.ai

Media handling

Upload files directly or import public media URLs. Pixio stores both in user assets before generation uses them.

Public integration boundary

Each integration key grants access to the account's complete public /api/v1 surface and can spend account credits. Integration keys have no per-key scopes. They do not authenticate Pixio's internal app routes.

Supported

AI media generation and credit estimates
Uploaded and generated media assets
Generation history and status
Model discovery and prompt optimization

Model Catalog

527 visible models

527 total

Type

Selected

Add Audio to Video

pixio/video-ops/add-audio

Params

Req

Cost

video-to-video

Pixio

0 credits

Add Audio to Video

Model ID

pixio/video-ops/add-audio

Inputs

Required

Output

video

Input Params

videoUrl

Video

file

required

Example

"https://example.com/reference.mp4"

audioUrl

Audio

file

required

Example

"https://example.com/reference.mp4"

startAt

Audio start offset (s)

number

Example

0

audioVolume

Audio volume

number

Example

1

Request Flow

Create

POST a model id and params. Media URL inputs and uploaded assets use Pixio media first.

Process

Pixio creates a normal generation row, spends account credits, and dispatches the job.

Fetch

Poll the generation id until output URLs, variants, and status are available.

Integration Reference

Copy a selected-model reference, check endpoint paths, and track the generation lifecycle without leaving this model.

Endpoints

GET

https://beta.pixio.myapps.ai/api/v1/guide

GET

https://beta.pixio.myapps.ai/api/v1/openapi.json

POST

https://beta.pixio.myapps.ai/api/v1/generate

POST

https://beta.pixio.myapps.ai/api/v1/images

POST

https://beta.pixio.myapps.ai/api/v1/media

POST

https://beta.pixio.myapps.ai/api/v1/uploads

GET

https://beta.pixio.myapps.ai/api/v1/assets

POST

https://beta.pixio.myapps.ai/api/v1/assets

DELETE

https://beta.pixio.myapps.ai/api/v1/assets

GET

https://beta.pixio.myapps.ai/api/v1/assets/{id}

GET

https://beta.pixio.myapps.ai/api/v1/assets/{id}/download

GET

https://beta.pixio.myapps.ai/api/v1/assets/download?ids=...

DELETE

https://beta.pixio.myapps.ai/api/v1/assets/{id}

PATCH

https://beta.pixio.myapps.ai/api/v1/assets/{id}

POST

https://beta.pixio.myapps.ai/api/v1/generations/estimate

GET

https://beta.pixio.myapps.ai/api/v1/generations

GET

https://beta.pixio.myapps.ai/api/v1/generations/{id}

DELETE

https://beta.pixio.myapps.ai/api/v1/generations/{id}

POST

https://beta.pixio.myapps.ai/api/v1/prompts/optimize

GET

https://beta.pixio.myapps.ai/api/v1/models

GET

https://beta.pixio.myapps.ai/api/v1/models/{id}

GET

https://beta.pixio.myapps.ai/api/v1/params?modelId=...

GET

https://beta.pixio.myapps.ai/api/v1/credits

GET

https://beta.pixio.myapps.ai/api/v1/credits/ledger

GET

https://beta.pixio.myapps.ai/api/v1/subscription

GET

https://beta.pixio.myapps.ai/api/v1/workflows

POST

https://beta.pixio.myapps.ai/api/v1/workflows/{id}/runs

GET

https://beta.pixio.myapps.ai/api/v1/workflows/{id}/runs

GET

https://beta.pixio.myapps.ai/api/v1/workflows/{id}/runs/{runId}

Status Lifecycle

Poll /api/v1/generations/{id} until output URLs are ready.

pendingprocessingsucceededfailed

Discover models & params

List the models you can use, then ask one model exactly what inputs it accepts — names, required flags, options, and defaults.

GET /api/v1/models

every model id visible to your account

curl https://beta.pixio.myapps.ai/api/v1/models \
  -H "Authorization: Bearer pxio_live_your_api_key"

# → { "models": [ { "id": "pixio/flux/dev", "type": "text-to-image", ... }, … ] }

GET /api/v1/params?modelId=…

exact inputs for one model

Pass a model id from /models. Use the returned param names and allowed options when you build the params for /generate.

curl "https://beta.pixio.myapps.ai/api/v1/params?modelId=pixio/songcraft/generate" \
  -H "Authorization: Bearer pxio_live_your_api_key"

# → { "model": { ... }, "params": [
#      { "name": "model_id", "type": "select", "required": true,
#        "options": [ { "value": "chirp-v4" }, … ] },
#      { "name": "lyrics", "type": "string" }, { "name": "tags" }, … ] }

Media inputs — get a clean URL

Generation params like image_url, video_url, and audio_url need a URL. Turn a local file or a remote link into one of these:

POST /api/v1/images

POST /api/v1/media

clean, permanent, public URL — no signed query string

/images is for images; /media takes any media (image, video, audio). Both return { "url": "https://…" }. Use that url directly in a generation param.

Upload a local file (multipart)

curl -X POST https://beta.pixio.myapps.ai/api/v1/media \
  -H "Authorization: Bearer pxio_live_your_api_key" \
  -F "file=@./clip.mp4"

# → { "url": "https://pixiomedia.nyc3.digitaloceanspaces.com/uploads/…clip.mp4" }

Mirror a remote URL (JSON)

curl -X POST https://beta.pixio.myapps.ai/api/v1/images \
  -H "Authorization: Bearer pxio_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/photo.png"}'

# → { "url": "https://pixiomedia.nyc3.digitaloceanspaces.com/uploads/…photo.png" }

Use the clean URL in a generation

curl -X POST https://beta.pixio.myapps.ai/api/v1/generate \
  -H "Authorization: Bearer pxio_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "modelId": "pixio/xai/grok-imagine-video/image-to-video",
    "params": {
      "image_url": "https://pixiomedia.nyc3.digitaloceanspaces.com/uploads/…photo.png",
      "prompt": "slow cinematic zoom",
      "resolution": "720p"
    }
  }'

POST /api/v1/uploads

store in your Pixio assets (signed URL + filePath)

Use /uploads when you want the file saved to your account's Pixio assets. It returns filePath, url, signedUrl (valid ~7 days), and metadata — pass filePath in params to reference the stored asset, or signedUrl for a temporary link.

# local file
curl -X POST https://beta.pixio.myapps.ai/api/v1/uploads \
  -H "Authorization: Bearer pxio_live_your_api_key" \
  -F "file=@./reference.png"

# or import a URL
curl -X POST https://beta.pixio.myapps.ai/api/v1/uploads \
  -H "Authorization: Bearer pxio_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/reference.png"}'

Up to 8 items per request via file, files, media, assets, url, or urls.

Which one?

/images or /media → simplest: a clean public url to paste into a param. Use /media for video/audio.
/uploads → save into your Pixio assets and get filePath + signed URL.
Or just pass a public URL directly in a param — /generate imports it into Pixio storage automatically.

API Guarantees

Pixio media first

Direct file uploads and public media URLs become Pixio assets before generation starts.

Same credits

API jobs spend from the same account balance as the app.

Account concurrency

API keys share the account's in-flight generation limit.

Live Example

Updates with the selected model.

{
  "providerId": "pixio",
  "modelId": "pixio/video-ops/add-audio",
  "params": {
    "videoUrl": "https://example.com/reference.mp4",
    "audioUrl": "https://example.com/reference.mp4",
    "startAt": 0,
    "audioVolume": 1
  }
}

Accepted response

202 Accepted

{
  "success": true,
  "message": "Generation started successfully!",
  "contentId": "00000000-0000-0000-0000-000000000000",
  "providerId": "pixio",
  "modelId": "pixio/video-ops/add-audio"
}

Not enough credits

402 Payment Required

{
  "error": "Insufficient credits",
  "availableCredits": 0,
  "requiredCredits": 1,
  "shortfall": 1
}

Pixio API developer reference

Public integration boundary

Supported

Add Audio to Video

Input Params

Request Flow

Create

Process

Fetch

Integration Reference

Endpoints

Status Lifecycle

Discover models & params

Media inputs — get a clean URL

Which one?

API Guarantees

Not supported