Pixio: images, video & audio
Let your agents make images, video, music, and voice with your own Pixio account.
The Pixio connector lets your Machine agents generate images, video, and audio (music, voice, sound) through your own Pixio account. Ask for "a logo on a white background", "a six-second clip of this photo coming to life", or "a voiceover for this script", and the agent picks a model, checks the price, generates, and saves the result to your workspace.
It is Made by Machine: Machine built and runs the connector, and it uses your Pixio account and credits. Every project has it; nothing happens until you connect a key.
What you need
- A Machine project you can edit connectors in.
- A Pixio account with credits, or a plan that includes the models you want.
- A Pixio API key. Keys start with
pxio_live_.
Set it up
Create a Pixio API key
Open Pixio's Integrations page (sign in if asked) and create an API key. Copy it; Pixio shows it once.
Connect it in Machine
Open Connectors. At the top of the Discovery tab, under Made by Machine, choose Pixio, paste the key, and press Connect Pixio. Machine checks the key with Pixio first, then shows the account, plan, and credit balance.
In Machine Desktop, open Tools → Connected apps. The same card is at the top of the Marketplace tab, and Project chooses which bot the key is for. See Pixio in Machine Desktop.
Every agent in the project can use Pixio once it is connected. There is
nothing to add to kortix.yaml.
How agents spend your credits
Generating costs Pixio credits, so agents follow the same steps every time:
- Pick a model by what you pay. Agents rank models by your account's own price, including plan discounts and daily free uses, and tell you which one they chose.
- Quote first. Before generating, the agent asks Pixio what the exact request will cost. Quotes are free.
- Ask before anything expensive. The agent tells you the cost of every paid run, and waits for your yes when a run is over 100 credits, is a paid video, 3D, or lip-sync run, is part of a batch, can't be priced exactly yet, or would use most of your balance. Give it a budget ("keep it under 200 credits") and it stays under it.
- Generate once. Each request carries an idempotency key, so a retry after a network blip returns the original job instead of charging you twice.
- Save the result. Pixio's download links expire after about a week, so
the agent saves every result into the workspace (in
media/unless you name a folder) and tells you what it cost.
Editing your own files
To edit a photo or animate an image you already have, drop it into the session or the workspace and ask. The agent uploads it to Pixio through Machine (files up to 50 MB), so the key never enters the sandbox. For a longer video, share a public link instead.
Your key
- Machine stores the key encrypted on its server. Agents call Pixio through Machine and never see the key, and it is never put in the sandbox.
- Never paste the key into a chat. If you did, revoke it in Pixio and connect a new one.
- Replace key in the Pixio card swaps in a new key. Disconnect removes it from Machine. Revoking the key in Pixio cuts off access everywhere at once; the card then asks for a new key (in Machine Desktop: "Pixio refused the saved key. It was revoked or replaced — paste a new one.").
What the connector covers
The connector has 72 actions. Agents use them when you ask:
| Area | What the agent can do |
|---|---|
| Generating | Price a request, generate, check and list generations, delete one, import media from a link |
| Models | Look up a model and its inputs, list your favorite models, star or unstar one (only when you ask), read your default models from Pixio Settings |
| Assets | List and open your uploads and results, rename an upload, delete one asset or up to 100 at once (only when you ask, no undo), get one-hour download links for one or up to 100 assets |
| Folders | List, create, rename, recolor, move, and delete asset folders, and file assets into them |
| Prompts | Search your past prompts and replay one, list styles, run the prompt optimizer (5 credits per call) |
| Account | Your account, plan, credit balance, credit history (including what one generation was charged or refunded), and subscription |
| Workflows | List, create, edit, run, and delete saved Pixio workflows, and follow their runs |
| Creative tools | Projects, boards, canvases, timelines, storyboards, Cam View scenes, Video Agent, locked characters, and reading training jobs |
Download links are free, except Songcraft songs: a preview download costs 100 credits and an official one 300, each charged once per song. The agent asks before an official download.
What isn't supported
Pixio's in-app chat agent and starting new model training aren't available through the connector. Default models can be read but not changed; change them in Pixio's Settings.
Troubleshooting
- No Pixio card on the Connectors page. It sits at the top of the Discovery tab, and hides while you search or browse one category. In Machine Desktop it stays visible while you search for words like image, video or music, and shows on the Connected tab only once connected.
- "Pixio did not accept that key." The key was copied incompletely or has been revoked. Create a new one in Pixio.
- The agent says you're out of credits. It reports how many the run needs and how many you have. Top up in Pixio, or ask for a cheaper model.
- "Too many jobs running." Your Pixio plan limits how many generations run at once, across every key on the account. The agent waits for the running job and tries again.