Every change Wellknown observed on this MCP server, newest first, with what it was before and what it became. Tool-surface changes carry the definition diff. Nothing here is edited after the fact.
Added "get_character", "list_characters" and "recommend_influencers"; changed the definition of "generate_depth_map", "generate_image" and "generate_video" (18 tools before, 21 now)
⟨201 unchanged words⟩ the left, depth map on the right), face_mesh (no extra charge: draws each face's mesh so a video model keeps lip, eye and head movement; set it when people talk or emote), max_faces (1-4, default 4), include_face_landmarks (no extra charge: also returns a face landmarks JSON link). The price is held when the job ⟨56 unchanged words⟩
⟨47 unchanged words⟩ ,"viridis"],"type":"string"},"face_mesh":{"default":false,"description":"Draw a mesh over each face (eyes, brows and lips in colour) so a video model given the depth map keeps lip, eye and head movement: use it when people talk or show expressions. Faces are found automatically; a face turned to full profile gets no mesh. No extra charge (default false).","type":"boolean"},"include_face_landmarks":{"default":false,"description":"Also return a link to a JSON file of per-frame face landmarks (478 3D points), 52 expression scores and head pose for each face, for animation or analysis. Works with or without face_mesh. No extra charge (default false).","type":"boolean"},"keep_audio":{"default":false,"description":"Copy ⟨6 unchanged words⟩ video (default false).","type":"boolean"},"max_faces":{"default":4,"description":"Most faces tracked at once, 1-4, largest first (default 4). Applies to face_mesh and include_face_landmarks.","maximum":4,"minimum":1,"type":"integer"},"resolution":{"default":"auto", ⟨142 unchanged words⟩
⟨118 unchanged words⟩ every available model with prices and input limits. Write @handle in the prompt to cast a character (list_characters), e.g. a free BudgetPixel AI influencer like @barry.
⟨146 unchanged words⟩ call list_models for available video models and prices. Write @handle in the prompt to cast a character (list_characters), e.g. a free BudgetPixel AI influencer like @barry.
Get Character — Use this to learn one character before casting it or using it elsewhere: its look word for word, personality, speaking style, backstory, directing notes, signature details and consistency rules, every picture with a download link (full size for the BudgetPixel influencers and the user's own characters, so they can be used with other tools too), the models a mention works on, and the terms for using an influencer. Use the profile to write prompts, captions and scripts in the character's own voice. Free.
List Characters — Use this to see the characters the user can cast in images and videos: the free BudgetPixel AI influencers (memorable personas with a consistent face, like @barry, @rosa or @fifi, free for every user) plus the user's own and collected characters. To cast one, write its @handle in the prompt of generate_image or generate_video (e.g. "@barry orders coffee like he owns the cafe") on a model that takes characters. q filters by words (e.g. "fitness"); source narrows to official, mine or collected. For one character's full profile and pictures call get_character; to pick influencers for a brief cal…
Recommend Influencers — Use this when the user wants an AI influencer or a character for a product, brand, campaign, ad or post and hasn't picked one. Pass the brief (what it is, for whom, where it will be posted) and get the BudgetPixel AI influencers who fit it best, each with why, a content idea and a ready-to-use prompt that starts with their @handle (pass it to generate_image or generate_video). include_mine also considers the user's own characters. Free.
Added "generate_depth_map"; changed the definition of "check_generation_status" and "list_models" (17 tools before, 18 now)
Use this after calling generate_image, generate_video, generate_music, generate_sound_effect, generate_3d_model, orgenerate_3d_modelgenerate_depth_map to poll for results. Pass a job_id to ⟨11 unchanged words⟩ , and for MUSIC / SOUND-EFFECT / 3D-MODEL / DEPTH-MAP jobs also pass type "music" / "sound_effect" / "3d" / "depth" (3D jobs are uuids too, like video) ⟨92 unchanged words⟩ the user downloads expire in about 24 hours. Completed DEPTH-MAP jobs return the depth video, which is saved in the user's BudgetPixel library. Poll every few seconds for images and sound effects (~15 s), every 15–30 seconds for videos, musicand, 3D models and depth maps (they take minutes). Call repeatedly until ⟨5 unchanged words⟩
Changed the definition of "generate_video" and "upscale_video"
⟨177 unchanged words⟩ with the video (no price impact on seedance-2.5/2.0 or flux-3-video).","type":"boolean"},"image" ⟨459 unchanged words⟩ footage appended; source billed 170 credits/sec, first 15s). On flux-3-video it is EXTENDED too (1s-2min source, free; length_seconds = 5-15s of new footage at the extend rate; the result is the source followed by the new footage).","type":"string"}},"required ⟨3 unchanged words⟩
Use this to upscale a video,towith
Changed the definition of "generate_image"
⟨15 unchanged words⟩ 1:1 — except an edit with flux-3-image, flux-3-image-klein or nano-banana-2.1, which keeps the first input image's ⟨334 unchanged words⟩ images). For fast, low-cost drafts pickflux-2-kleinflux-3-image-klein (FLUX 3 Klein: 12 credits at 1K, up to 10 free references, images in seconds) or seedream-5.0-flash (flat 25 credits, free references) ⟨171 unchanged words⟩ nano-banana-2: up to 4K; nano-banana-2.1: 1K/2K/4K; flux-3-image and flux-3-image-klein: 768px/1K/1.5K/2K/4K — see list_models for what each ⟨14 unchanged words⟩ flux-3-image is 55/65/90/130/790 credits per image at 768px/1K/1.5K/2K/4K (flux-3-image-klein 11/12/15/19/48), so confirm with the user before choosing ⟨15 unchanged words⟩
Added "generate_3d_model"; changed the definition of "check_generation_status", "generate_video" and "list_models" (16 tools before, 17 now)
Use this after calling generate_image, generate_video, generate_music, generate_sound_effect, orgenerate_sound_effectgenerate_3d_model to poll for results. Pass a job_id to ⟨9 unchanged words⟩ = video, and for MUSIC / SOUND-EFFECT / 3D-MODEL jobs also pass type "music" / "sound_effect" / "3d" (their3Didsjobs arenumericuuids too, like video) — with no job_id it lists jobs ⟨57 unchanged words⟩ user (chat UIs can't embed players). Completed 3D-MODEL jobs return the thumbnail inline plus download links (GLB/FBX/USDZ/STL) and a viewer link — share the links and tell the user downloads expire in about 24 hours.
Added "search_stock_audio"; changed the definition of "search_stock_images" (15 tools before, 16 now)
⟨50 unchanged words⟩ , licensed CC BY 4.0 for commercial use. Set transparent to true for cut-outs only: PNG files with a transparent background, for stickers, overlays and compositing. Costs 10 credits per search, charged even when ⟨52 unchanged words⟩
⟨190 unchanged words⟩ ,"top"],"type":"string"},"transparent":{"description":"Optional: true returns cut-outs only — PNG files with a transparent background, for stickers, overlays and compositing. Omit for every image.","type":"boolean"},"type":{"description":"Optional: photos only, ⟨15 unchanged words⟩
Changed the definition of "generate_image"
⟨15 unchanged words⟩ 1:1 — except an edit with flux-3-image or nano-banana-2.1, which keeps the first input image's shape ⟨93 unchanged words⟩ ,"transparent"],"type":"string"},"google_search":{"description":"Optional, nano-banana-2.1 only: ground the image in live Google Search results (weather, scores, recent events, current facts). Off by default. Costs extra: 10 credits per image (list_models shows the current price). Turn it on only when the request needs current, real-world information, and tell the user it adds to the cost.","type":"boolean"},"grounding":{"description":"Optional, flux-3-image only: ⟨26 unchanged words⟩ the default.","type":"boolean"},"image_search":{"description":"Optional, nano-banana-2.1 only: let the model look up web images as visual reference before rendering (what a real place, product or landmark looks like). Off by default. It runs a Google Search too, so it costs 20 credits per image in total, with or without google_search (list_models shows the current price). Tell the user it adds to the cost.","type":"boolean"},"input_images":{"description":"Optional input image(s ⟨100 unchanged words⟩ (photorealism), gpt-image-2 (text in images), nano-banana-2.1 (fast, sharp text in images, up to 9 free references; optional paid search grounding),
Changed the definition of "create_social_post", "list_models" and "upscale_video"
⟨132 unchanged words⟩ theme_id (call list_my_themes to find it). Posts are All Rights Reserved by default; pass license ("cc-by" or "cc0") ONLY when the user explicitly asks for a Creative Commons license — it is permanent and cannot be changed after publishing. Returns the public post URL — share it ⟨22 unchanged words⟩
⟨105 unchanged words⟩ ,"Other"],"type":"string"},"license":{"description":"Optional content license: \"arr\" (All Rights Reserved — the default), \"cc-by\" (CC BY 4.0) or \"cc0\" (CC0, public domain). OMIT unless the user EXPLICITLY asks for a Creative Commons license — never choose one on their behalf. Permanent: the license cannot be changed after publishing.","enum":["arr","cc-by","cc0"],"type":"string"},"lyrics":{"description":"Audio posts only: ⟨171 unchanged words⟩
Changed the definition of "check_generation_status", "create_social_post", "generate_image" and 9 more
CheckgenerationGenerationstatusStatus
⟨40 unchanged words⟩ " (their ids are numeric too) —orwithomitno job_idtoitlistlistsalljobs
Changed the definition of "upscale_video"
⟨89 unchanged words⟩ local files). Up to 20 seconds,≤100MB.≤50MB. Required unless job_id is set.","type": ⟨3 unchanged words⟩
Added "list_my_themes"; changed the definition of "create_social_post" and "generate_image" (14 tools before, 15 now)
⟨113 unchanged words⟩ , never as a second media item). To enter the post in one of the user's clan themes, pass theme_id (call list_my_themes to find it). Returns the public post URL — share it ⟨22 unchanged words⟩
⟨223 unchanged words⟩ track's display name.","type":"string"},"theme_id":{"description":"Optional: enter the post in a live clan theme — the id from list_my_themes (or the number in a budgetpixel.com/themes/<id> link). Works with any media type; posting to a theme of a clan the user hasn't joined joins them to it, like on the site.","minimum":1,"type":"integer"}},"required":["media"],"type":"object"}
Changed the definition of "generate_video"
⟨333 unchanged words⟩ },"reference_audios":{"description":"minimax-h3 / minimax-h3-max / seedance-2.5 / wan-3.0-video(-prime) only: reference AUDIO ⟨80 unchanged words⟩ },"reference_videos":{"description":"minimax-h3 / minimax-h3-max / seedance-2.5 / wan-3.0-video(-prime) only: reference VIDEO ⟨141 unchanged words⟩ output per-second rate on top of the output. On minimax-h3-max the video is EXTENDED instead (1.6-60s source; length_seconds = new footage appended; source billed 170 credits/sec, first 15s).","type":"string"}},"required": ⟨3 unchanged words⟩
Added "search_stock_images" (13 tools before, 14 now)
Search free stock images — Use this when the user needs an existing stock photo, illustration, background, wallpaper or texture — for a website, slide, blog post, app, video or design — rather than a newly generated image. Searches BudgetPixel's free image library: AI-generated images, each reviewed before listing (no real people, logos or text), licensed CC BY 4.0 for commercial use. Works on EVERY plan, including Free. Costs 10 credits per search, charged even when nothing matches, so write one specific query rather than many vague ones. It never generates: if nothing fits, say so (on a paid plan, generate_image can …
Certificate recorded, valid to 2027-02-06
Authorization not required
First tool surface recorded: 13 tools (server version 0.1.0)
Showing the latest 16 events. The API returns up to 500 and filters by kind: ?kind=tool_surface_changed
⟨6 unchanged words⟩ job ID to check — a number forimage/music/sound-effectimage/music/sound-effect/depth-map jobs, a uuid for video and 3D-model ⟨30 unchanged words⟩ music jobs, \"sound_effect\" for sound-effect jobs, \"depth\" for generate_depth_map jobs (their numeric ids would otherwise be read as ⟨32 unchanged words⟩ ","video","music","sound_effect","3d","depth"],"type":"string"}},"type":"object"}
⟨6 unchanged words⟩ , sound-effect, and 3D models available on BudgetPixel, plus the depth-map tool's sizes, with standard credit prices and capabilities. Featured models ⟨60 unchanged words⟩ per job (base price plus named options).; depth maps (generate_depth_map) are priced per second of the input video by model size (small / base / large), 5-second minimum. Prices shown are standard rates in credits. Video ⟨16 unchanged words⟩
Generate Depth Map — Use this to turn a video into a depth map video (Video Depth Anything, on BudgetPixel's own GPUs): a steady, flicker-free video where near is white and far is black, at the input's size (up to 1080p) and frame rate (up to 30 fps). Use it as a depth / structure / motion reference or control video for video models — grayscale (the default colormap) is what they take as a depth reference; turbo, inferno, magma and viridis colour it for viewing only. Priced per second of the INPUT video, rounded up to whole seconds, 5-second minimum, by model size: small 20 / base 30 / large 40 credits per second…
⟨20 unchanged words⟩ video URL.","type":"integer"},"mode":{"description":"FLUX only: precise (default) keeps the source as it is (faces, products); creative adds fine detail and costs more (95 vs 135 credits per output megapixel-second).","enum":["precise","creative"],"type":"string"},"model":{"description":"Upscaler: topazlabs-video-upscale (default; 1080p/4K at 30/60 fps, any input size) or flux-3-video-upscale (FLUX 3 super-resolution, 1.5x-3x the input, precise or creative detail; input up to 2560x1440). target_resolution/target_fps are Topaz's; upscale_factor/mode/prompt are FLUX's.","enum":["topazlabs-video-upscale","flux-3-video-upscale"],"type":"string"},"prompt":{"description":"FLUX only, optional: what the clip shows, to steer the detail creative mode adds (up to 1000 characters).","type":"string"},"target_fps":{"description":"Target frame rate ( ⟨37 unchanged words⟩ ["1080p","4k"],"type":"string"},"upscale_factor":{"description":"FLUX only: how many times larger the output frame is (default 2). 720p at 3 is 4K.","enum":[1.5,2,2.5,3],"type":"number"},"video":{"description":"The video ⟨32 unchanged words⟩
⟨13 unchanged words⟩ for image/music/sound-effect jobs, a uuid for video and 3D-model jobs. If omitted, returns all active generation jobs ⟨16 unchanged words⟩ to. REQUIRED as \"music\" for music jobsand, \"sound_effect\" for sound-effect jobs (their numeric ids would otherwise be read as image jobs), and \"3d\" for generate_3d_model jobs (their uuid would otherwise be read as video). Optional otherwise: other uuids are detected as video, plain numbers default ⟨3 unchanged words⟩ :["image","video","music","sound_effect","3d"],"type":"string"}},"type":"object"}
⟨211 unchanged words⟩ or video.","type":"string"},"mode":{"description":"p-video-2-pro ONLY: generation mode, which sets the price together with resolution — cost (cheapest AND fastest, ~20s for a 5s clip), speed (default), quality (most detail, slowest). Per-second prices per mode are in list_models. Omit for every other model.","enum":["cost","speed","quality"],"type":"string"},"model":{"description":"Video model id. Omit ⟨394 unchanged words⟩
List the AI image, video, music, sound-effect, andsound-effect3D models available on BudgetPixel with standard credit prices ⟨51 unchanged words⟩ sound effects are per second with a 3-secondminimum.minimum; 3D models are priced per job (base price plus named options). Prices shown are standard rates in credits. Video ⟨16 unchanged words⟩
Generate 3D Model — Turn one picture into a textured 3D model (image-to-3D). Always returns a GLB; meshy-7.1 also offers FBX, USDZ (iPhone AR) and STL (3D printing). Pick the model by job: tripo-h3.1 (default) is the most faithful reconstruction — including cartoons and stylized art — with PBR materials, ~4 min, 400 credits; meshy-7.1 makes lighter ~30K-triangle models in more formats and supports rigging + animation for humanoid characters, ~2 min, 1600 credits. Best input is one subject on a plain background. Submits an async job and returns a job_id — 3D models take 2-5 minutes, so poll check_generation_statu…
Search Stock Sound Effects & Music — Use this when the user needs an existing sound effect or a piece of background music — for a video, podcast, stream, game, app or presentation — rather than a newly generated one. Searches BudgetPixel's free audio library, licensed CC BY 4.0 for commercial use, every item listened to and scored before listing. kind "sound_effect": whooshes, impacts, UI sounds, Foley, ambiences, animals, vehicles (a fraction of a second to about 6 s). kind "music": instrumental background tracks such as lofi, corporate, cinematic, acoustic (up to about a minute). Costs 10 credits per search, charged even when …
⟨75 unchanged words⟩ minimum. Prices shown are standard rates in credits. Video resolutions delivered as H.265 (HEVC) instead of H.264 are marked, because some browsers cannot play H.265.
⟨109 unchanged words⟩ is also saved to the user's BudgetPixel library. The result is an H.265 (HEVC) 10-bit MP4, which some browsers cannot play (black frame with audio) — tell the user.
CreatePostSocialtoPostBudgetPixel Feed
{"destructiveHint":falsetrue,"openWorldHint":falsetrue,"readOnlyHint":false}
⟨84 unchanged words⟩ the finished image inline for you to display.CostsEach call starts a new job that spends credits from the user'splan (their discountsBudgetPixelandbalancefree-model(failedperksjobsapplyaren'tautomaticallycharged). Default model: seedream-5.0-pro; call list_models to ⟨9 unchanged words⟩
⟨4 unchanged words⟩ {"description":"Aspect ratio of the generatedimageimage. Omit for the default: 1:1 — except an edit with flux-3-image, which keeps the first input image's shape unless you set a ratio here.","enum":["1:1","4: ⟨83 unchanged words⟩ ,"transparent"],"type":"string"},"grounding":{"description":"Optional, flux-3-image only: let the model research the prompt with web and image search before rendering. On by default and free. Set false for faster, self-contained generation. Omit for the default.","type":"boolean"},"input_images":{"description":"Optional input image(s ⟨57 unchanged words⟩ id. Omit for the default (seedream-5.0-pro —premium flagship: top quality, strongeststrong identity preservation,greatgood for edits, up to 9 reference images). For fast&,cheaplow-cost drafts pick flux-2-klein(free on Pro/Ultra plans)or seedream-5.0-flash (flat 25 credits, free references).Other strongBypicksjob: gpt-image-2.5-sunburst (OpenAI precisionprecise edits, premium quality), gpt-image-2.5-flare (fastOpenAIeverydaymodelgeneration), seedream-4.5 (photorealism), gpt-image-2 (text in images), nano-banana-2 (premiumediting), qwen-image-3.0 (all-rounder), flux-3-image (FLUX 3: up to 10 free references, optional web grounding; priced by size, 55 credits at 768px up to 790 at 4K). Call list_models for the full catalog with ⟨101 unchanged words⟩ seedream-5.0-flash: 1K/2K; gpt-image-2 & nano-banana-2: up to4K4K; flux-3-image: 768px/1K/1.5K/2K/4K — see list_models for what each size costs). Omit for the model default. Larger costsmore.more, sometimes far more: flux-3-image is 55/65/90/130/790 credits per image at 768px/1K/1.5K/2K/4K, so confirm with the user before choosing 4K.","type":"string"},"seed":{ ⟨11 unchanged words⟩
{"destructiveHint":falsetrue,"openWorldHint":falsetrue,"readOnlyHint":false}
⟨141 unchanged words⟩ the Sonilo models), charged on success only;theeachuser'scallplanstartsdiscountsaapplynewautomatically.paid job. Submits an async job and returns a numeric ⟨35 unchanged words⟩
{"destructiveHint":falsetrue,"openWorldHint":falsetrue,"readOnlyHint":false}
⟨104 unchanged words⟩ and the video with the effects mixed in.ChargedEachoncallsuccessstartsonly;athenewuser'spaidplanjob,discountschargedapplyonautomatically.success only. Keep text clips as short as the sound ⟨63 unchanged words⟩
{"destructiveHint":falsetrue,"openWorldHint":falsetrue,"readOnlyHint":false}
⟨93 unchanged words⟩ (long durations or many reference clips).ChargedEachoncallsuccessstartsonly;aplannewdiscountspaidapply.job, charged on success only. Submits an async job and returns a job_id ⟨35 unchanged words⟩
{"destructiveHint":falsetrue,"openWorldHint":falsetrue,"readOnlyHint":false}
GetcreditCreditbalanceBalance
⟨6 unchanged words⟩ , and sound-effect models available on BudgetPixel withbasestandard credit prices and capabilities. Featured models come first with a one-line role hint (when to pick each). Image models that charge by output size list every size's price (the size you pass as resolution sets the price). Video models are priced per SECOND by resolution; ⟨8 unchanged words⟩ are per second with a 3-second minimum. Prices shown arebasestandard rates— the user's plan discounts and free-model perks apply automatically wheningenerating.credits.
ListmyMythemesThemes
Searchfree stockStockimagesImages
⟨27 unchanged words⟩ rather than a newly generated image. Searches BudgetPixel'sfreestock image library: AI-generated images, each reviewed before ⟨7 unchanged words⟩ , licensed CC BY 4.0 for commercial use.Works on EVERY plan, including Free.Costs 10 credits per search, charged even when ⟨12 unchanged words⟩ It never generates: if nothing fits, sayso (on a paid plan, generate_image can make one).so. LICENCE: wherever an image is used, include ⟨25 unchanged words⟩
{"destructiveHint":falsetrue,"openWorldHint":false,"readOnlyHint":false}
⟨95 unchanged words⟩ image's URL — share it with the user. Unlike generations, the upscaled image is also saved to the user's BudgetPixel library.
{"destructiveHint":falsetrue,"openWorldHint":falsetrue,"readOnlyHint":false}
⟨9 unchanged words⟩ 4K (30 or 60 fps) with TopazLabs professional-gradevideoAI.upscaling. Priced per second of the INPUT video: ⟨73 unchanged words⟩ video URL, then share it with the user. The upscaled video is also saved to the user's BudgetPixel library.
{"destructiveHint":falsetrue,"openWorldHint":falsetrue,"readOnlyHint":false}
⟨26 unchanged words⟩ 21:9"],"type":"string"},"background":{"description":"Optional output background for models that support it (seedream-5.0-flash, seedream-5.0-pro — see list_models). \"transparent\" keeps a transparent background when EDITING: pass exactly one input image, a PNG that already has transparent pixels (a cutout, sticker or logo), and you get back a PNG with transparency. It cannot make a transparent image from text alone. Omit (or \"opaque\") for a normal image.","enum":["opaque","transparent"],"type":"string"},"input_images":{"description":"Optional input image(s ⟨79 unchanged words⟩ drafts pick flux-2-klein (free on Pro/Ultra plans) or seedream-5.0-flash (flat 25 credits, free references). Other strong picks: gpt-image-2.5-sunburst (OpenAI precision ⟨120 unchanged words⟩ "Optional output size (per-model options, e.g. seedream-5.0-pro & seedream-5.0-flash: 1K/2K; gpt-image-2 & nano-banana-2: up to 4K ⟨26 unchanged words⟩
List my themes — List the live clan themes the user can post to — themes of the clans they own, moderate, or have joined (each with the user's role, the theme's brief, and when entries close). Use it when the user wants to post into a theme / enter a theme / share to their clan, then pass the chosen theme's id as create_social_post's theme_id. Free and read-only; themes that haven't started or have ended are not listed.