create_character
ChatGPTUse this when the user wants a new game character drawn from a text description and there is no image of it in the conversation. Generates the character art (one full-body pose on a plain background) and saves it to the user's AutoSprite library. quality "turbo" (default): 1 credit, about 5 seconds. quality "pro": 3 credits, about 30-60 seconds, sharper; use it for legible text or complex designs, or when turbo produced a bad result and the user wants another try. For pixel-art characters set pixelArt to true instead (3 credits): a 16-bit pixel sprite snapped to a crisp pixel grid and palette. For vehicles, creatures and other non-walking characters set isHumanoid to false and describe the body in characterDescription. Returns the new character id and shows the character in an AutoSprite card. Next step is usually generate_spritesheet.
create_character_from_image
ChatGPTUse this when the user has an image of their character in the conversation (uploaded, or generated by ChatGPT) and wants to animate it. Saves the image as an AutoSprite character for free (no credits). Works best with one full-body character on a plain background. Shows the character in an AutoSprite card. Next step is usually generate_spritesheet.
generate_attack_moves
ChatGPTUse this when the user wants weapon attack moves for a side-view AutoSprite character, e.g. a sword combo or a greatsword overhead slam. Each move becomes its own animation (5 credits per move). The moves of one call share the same weapon look, so ask for all the moves for one weapon in a single call. Weapons and move ids: sword (quick_strike, triple_combo, cyclone_slash, rising_crescent); spear (quick_jab, lunging_pierce, whirlwind_twirl, dragon_dive); axe (quick_chop, overhead_cleave, berserker_rush, critical_cleave); hammer (quick_bash, ground_pound, hammer_hurricane, thunder_slam); greatsword (heavy_cut, titan_cleave, dragon_upper); staff (staff_swing, arcane_channel, ground_invocation); dagger (twin_stab, blade_flurry, viper_pounce); bow (quick_shot, charged_shot, kneeling_shot). list_animations describes each move. A move's frame is twice frameSize so the weapon fits. Shows an AutoSprite card that plays each move when ready, usually in 1-3 minutes. After calling, tell the user the moves are generating and end your turn.
generate_isometric_pack
ChatGPTUse this for isometric, top-down or RPG characters: one call renders an action in all eight directions (up, northeast, right, southeast, down, southwest, left, northwest) as eight spritesheets, for 15 credits. Call it once per action. action: idle, walk, run, jump, attack (optional weapon preset, or weaponPrompt for a custom weapon, plus an optional prompt describing the strike), custom (name and prompt required), or a preset such as death, victory or wave. Defaults: 25 frames per direction at 256x256 px; only set frameCount or frameSize when the user asks. Shows an AutoSprite card that plays all eight directions when ready, usually in 2-5 minutes. After calling, tell the user the pack is generating and end your turn.
generate_spritesheet
ChatGPTUse this when the user wants animations or a spritesheet for a side-view AutoSprite character: walk cycle, idle, run, attack, jump, a preset (punch, kick, block, hurt, hit_react, dodge, dodge_lean, death, shoot, cast, pickup, push, pull, throw, wave, sit, kneel, point, sleep, victory, dance, talk, dash, fall, climb, swim, crouch, roll, fly, slide), or any custom move described in words. For weapon attack moves use generate_attack_moves; for isometric or top-down characters use generate_isometric_pack. Starts one animation per entry (5 credits each) and shows an AutoSprite card that plays each animation when it is ready, usually in 30-90 seconds. Defaults to 25 frames at 256x256 px with a transparent background; only set spritesheet options when the user asks. Requires a characterId from create_character, create_character_from_image or list_characters. After calling, tell the user the animations are generating and end your turn.
get_account
ChatGPTUse this when the user asks how many AutoSprite credits they have. Returns the account's total credit balance. Read-only.
get_job_status
ChatGPTUse this only when the user asks whether their animations are done; the AutoSprite card already updates itself. Returns the job status and, once finished, the spritesheet ids (eight for an isometric pack, plus a zip link with all of them). Pass an id to get_spritesheet for download links. Read-only.
get_spritesheet
ChatGPTUse this to show a finished spritesheet or get its download links (from get_job_status or list_characters). Returns the PNG sheet and JSON atlas links plus frame size, frame count and columns, and shows the animation in an AutoSprite card. Links expire after about an hour; call again for fresh ones. Read-only.
list_animations
ChatGPTUse this when the user asks which animations or attacks AutoSprite can make, or to find a preset or weapon move. Returns the preset animations (death, victory, punch, dance and more) and each weapon's attack moves with a short description. Read-only.
list_characters
ChatGPTUse this when the user wants to see or reuse their existing AutoSprite characters, e.g. "show my characters" or "add a jump to my knight". Returns character ids, names and each character's spritesheets with download links, and shows the characters' pictures in an AutoSprite card. Optional search filters by name. Read-only.