Make assets
Make sprites, 2D art, skyboxes, 3D models, video and sound with your Rosebud credits.
Assets are paid for with your Rosebud credits, at the same prices as the website. Everything you make also shows up in My assets. Need more credits? See Pricing.
Log in once
rosebud whoamiIf it reports "status": "active", skip ahead. If it reports another status, or fails with login_required, run:
rosebud loginOpen the approval_url it prints, sign in and select Allow. Then run rosebud whoami again. It shows your credit balance once the login is active.
Agents should add --agent-client (for example --agent-client claude-code) so you can tell their logins apart when you approve them.
Choose a model
rosebud assets models --category imageEach model lists its inputs, price and license. Categories are image, skybox, model_3d, video, sound_effect, music and speech. Leave out --category to see every model, or browse the same list on Models.
Check the price
rosebud assets quote --model flux-2-flash --prompt 'green slime monster, side view' \
--input asset_type=spriteQuotes are free and check your inputs. --prompt fills the model's prompt input, and --input name=value sets any other input it lists. Add-ons, such as a transparent background for a sprite, are included in the price.
Make the asset
rosebud assets create --model flux-2-flash --prompt 'green slime monster, side view' \
--input asset_type=sprite \
--max-credits 300 --out ./assets/slime.png--max-creditscaps the price.createrefuses a higher quote before anything is charged.createwaits for the file (up to 10 minutes) and saves it to--out. It never replaces an existing file unless you pass--force.- With
--no-waitit returns the job at once. Check it withrosebud assets status <job_id>, then save the file withrosebud assets download <asset_id> --out <path>. - Credits are charged when a job starts and returned if generation fails.
Use it in the game
Save files where the game loads them, then load the game and check each file appears or plays. If you'll publish with Rosebud's free hosting, keep media inside assets/ with lowercase names. See Asset formats and tips for sizes and quirks.
Reuse an asset you already made
Everything you make, from the CLI or the website, stays in My assets. Search it and download a file instead of paying again:
rosebud assets list --query 'slime'
rosebud assets download <asset_id> --out ./assets/slime.pnglist shows the 25 newest matches. Narrow it with --query or --category (image, sprite, skybox, model_3d, audio or file). sprite means animated sprite sheets made on the website; images made with asset_type=sprite are image. audio covers sound effects and music.
Rules for agents
- Show the person the price before anything expensive, and pick the cheapest model that fits.
- Make one asset per command. Make variations by changing the prompt or inputs.
- Run a few commands at a time, not dozens. Quotes and job starts share a limit of 30 per minute per account. The CLI waits out a throttle for up to a minute before it reports
throttled. - Keep the login while you work. Run
rosebud logoutonly to switch accounts or when the person asks. - If a command exits with code 4, run the identical command again. It resumes the same job and won't pay twice.
- Don't retry when the person is out of credits. Tell them instead.
- When you're done, tell the person what you made and what it cost.