RPGJS Studio API Skill

Use this skill to execute content-management tasks against an RPGJS Studio instance.

Image and cinematic generation

Base64 references accept MIME parameters; recognized PNG/JPEG/GIF/WebP signatures take precedence over missing or incorrect MIME headers, including text/xml. Invalid references return HTTP 400 and refund the startup debit.

Media generation debits metered API-key credits on execute before enqueueing; estimates do not debit. Startup failures are refunded, and terminal execution failures use a persisted refund step. A queued response is acceptance only: poll the returned instance. See references/media.md for billing and reference storage behavior.

For image/video generation with multiple references, video duration and pricing, read references/media.md. Use metadata.referenceImages for up to 9 ordered context images, or up to 15 for type: "spritesheet" and type: "animation"; do not combine it with legacy referenceImage. Spritesheet and VFX animation generation cost 15 credits and use spritesheet.ai with a fixed top-down RPG context. Generic images use Fal.ai openai/gpt-image-2.5/sunburst. Video duration is 5–15 whole seconds, default 5, at 8 credits per second. Use metadata.style: "reference" to preserve reference aesthetics (requires at least one reference image). Use metadata.mapReferenceIndices (unique zero-based indices into referenceImages) to identify map thumbnails as environment context without imposing their overhead camera; explicit camera requests and technical asset constraints still apply. Read map thumbnail bytes with GET /api/maps/:mapId/thumbnail before including them as references.

To play a video in an event, use show_cinematic with { "video": "media-id", "allowSkip": false, "bgm": "pause", "preload": true }. Only video is required: skipping and preloading default to true; bgm defaults to "duck" (15% music volume). "pause" resumes music afterwards. Adjacent video blocks share one overlay. See references/media.md for details; no map-to-video association is required.

Inputs