Aller au contenu

generate_a11y_variant

AI-generate SOURCE-language a11y variants for keys that lack them (task 990). aria_label / screen_reader / plain_language are derived from the key's visible text; alt_text from the key's context/description. Only fills (key, surface) cells with NO existing override and an available source. BILLS CREDITS (standard=1, premium=4 per generated item, debit upfront + refund undelivered) - call a11y_estimate first. Results are draft (bot-authored) overrides that flow to the CDN a11y overlays. Returns {generated, requested, credits_charged, credits_refunded}.

NomTypeDescription
project_uuidstringoptionnelProject UUID. Required when multiple projects are configured (SONENTA_PROJECTS); defaults to the single configured project otherwise.
tierstringoptionnelQuality tier (credit_cost per unit: standard=1, premium=4). (standard, premium)
surfacesarrayoptionnela11y surfaces to generate. Omit/empty = all four.
key_uuidsarrayoptionnelRestrict to these keys (get key_uuid from list_keys). Omit to scope the whole project (or a namespace).
namespace_uuidstringoptionnelRestrict to one namespace by its UUID.
idempotency_keystringoptionnelStable token making this billable call safe to retry: reuse the SAME value to avoid a double-charge on retry. A random one is generated if omitted (so a blind retry would re-bill).
{
"tool": "generate_a11y_variant",
"arguments": {}
}