{"uid":"cap_AaO_IeW5h6uaGhiH7WVFC","slug":"canonsheet-character-prompt-builder-1cc291ca","name":"CanonSheet Character Prompt Builder","description":"Build a consistent prompt set for one human character: a canonical image prompt with every appearance fact labelled, negative prompts that stop traits like glasses or a cane from vanishing, a video prompt, and optionally a contact sheet that holds everything fixed and walks one axis. Works with any image or video model. Text keeps wardrobe and framing stable; for the same FACE across images, generate the canonical frame once and pass it back as a reference image (has_reference). Paid per call over x402: the first attempt answers HTTP 402 with the price. Invalid arguments are refused before any payment.","url":"https://canonsheet.kaneky.dev/api/build_character_prompts?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"name":{"type":"string"},"video":{"type":"object","properties":{"camera":{"enum":["locked","push-in","push-out","orbit"],"type":"string"},"motion":{"enum":["blink","breathe","weight","turn-to","look-away","smile","step","speak","hair"],"type":"string"},"ambient":{"enum":["still","breeze","dust","flicker"],"type":"string"}},"additionalProperties":false},"traits":{"type":"object","properties":{"ink":{"type":"string"},"glasses":{"type":"string"},"headwear":{"type":"string"},"mobility":{"type":"string"},"facial-hair":{"type":"string"}},"additionalProperties":false},"choices":{"type":"object","properties":{"lens":{"enum":["35","50","85","135","none"],"type":"string"},"seed":{"type":"string"},"shot":{"enum":["full","three-quarter","medium","close","extreme-close"],"type":"string"},"angle":{"enum":["eye","low","high","three-quarter-turn","profile","none"],"type":"string"},"style":{"enum":["photo","cinematic","illustration","painterly","render3d","anime"],"type":"string"},"action":{"type":"string"},"lighting":{"enum":["soft-key","rim","golden","overcast","low-key","practical","none"],"type":"string"},"environment":{"type":"string"}},"additionalProperties":false},"walk_axis":{"enum":["action","shot","angle","lens","lighting","environment","style"],"type":"string"},"appearance":{"type":"object","properties":{"eyes":{"type":"string"},"face":{"type":"string"},"hair":{"type":"string"},"held":{"type":"string"},"skin":{"type":"string"},"build":{"type":"string"},"outfit":{"type":"string"},"distinguishing":{"type":"string"}},"additionalProperties":false},"custom_traits":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"}},"additionalProperties":false},"maxItems":6},"has_reference":{"type":"boolean"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JBBp7TYbGhCCF-dfbt0aX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates a consistent, labeled prompt set for a single human character—including canonical image prompt, negative prompts, video prompt, and optional contact-sheet walk—for use with any image or video generation model.","exampleAgentPrompt":"Build a consistent character prompt set for Elena, a 30s woman with warm brown skin, amber eyes, short natural hair, a tailored burgundy blazer, and wire-rimmed glasses — she should be in a medium shot at eye level with soft-key lighting in a library environment; also generate negative prompts so her glasses never disappear, and include a video prompt with a breathe motion and a locked camera.","exampleUseCases":[{"title":"Stable protagonist across illustration series","prompt":"Create a full prompt set for Marcus, a tall Black man in his 40s with salt-and-pepper locs, a scar on his left cheek, and a long charcoal coat — medium shot, three-quarter turn angle, 85mm lens, cinematic style, overcast lighting in a rainy city street. Include negative prompts so his scar and coat never vanish, and also give me a video prompt with a turn-to motion and a gentle breeze ambient."},{"title":"Contact sheet walk for costume variations","prompt":"I need a contact sheet for Yuki — petite Japanese woman, early 20s, violet eyes, undercut hair dyed silver, usually holding a sketchbook — lock everything to a close shot, eye-level, 50mm lens, soft-key lighting, illustration style, and walk the style axis so I can see how she looks across photo, cinematic, painterly, and anime renders."},{"title":"Video ad character with reference image","prompt":"Build me a video prompt for a recurring brand character named Leo: medium-build Latino man, late 30s, warm olive skin, thick dark eyebrows, wearing a white chef's apron — three-quarter shot, low angle, rim lighting, practical ambient, push-in camera, and a speak motion. I already have a canonical reference image for his face, so set has_reference to true."}],"resultDescription":"Returns a structured prompt set containing: a canonical image prompt with every appearance detail explicitly labeled, one or more negative prompts preventing trait drift (e.g. glasses, mobility aids, tattoos), a video prompt with camera and motion settings, and optionally a series of contact-sheet prompts that hold all variables fixed while stepping through one chosen axis (such as style, lighting, or shot size).","failureModes":["Invalid enum value for choices/shot, angle, lens, lighting, style, or video fields — request refused before payment with a 400-level error","Missing or malformed required fields — rejected prior to charging","HTTP 402 returned on first call with pricing information (expected behavior, not a true failure — retry with payment)","Payment not completed or x402 flow not followed — no prompts returned","Exceeding maxItems 6 on custom_traits — request refused"],"whenToPreferThis":"Choose this endpoint when you need to lock a character's appearance across multiple AI-generated images or video clips and prevent trait drift — especially when the character has distinctive features like glasses, facial hair, a mobility aid, or tattoos that tend to disappear between generations. It is purpose-built for prompt engineering workflows rather than direct image generation, so prefer it when your downstream tool is any image or video model and you want a reusable, labeled prompt corpus rather than a one-off image. Prefer it over generic prompt templates when you need structured negative prompts and optional contact-sheet enumeration.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:30:49.309Z","isFirstParty":false,"canonicalSlug":"canonsheet-character-prompt-builder-1cc291ca"}