MCP

design.generate

Create and save a product design in the connected Vaybel or PrintGen account.

EffectwritesReachesoutside VaybelScopedesign:writePlanStarter+Credits5Rate limit10/minIdempotent

Use for requests to create a T-shirt or other apparel design in the app, including follow-ups selecting a trend and requests for a saved-design link. Uses the account's design-generation allowance and saves a new design; it does not publish a listing or place an order. Poll design.get_generation with the returned handle, then call design.get once for the saved gallery and app URL.

Parameters

product_uuidstringRequired

Product uuid (e.g. an AOP blank).

promptstringRequired

Free-text design brief passed to the AI Design Generator.

variant_group_uuidstring

Optional variant group uuid — pin the colorway. Omit to let the pipeline pick a default.

trend_match_uuidstring

Optional keyword id, not a named trend id. For a named trend, call trend.get and choose a keywords[].id matching the selected product type. Alternatively use an id from trend.list_keywords. Pass it when the design comes from a trend or design ideas, so listings retain the real search-demand link. Never pass the top-level id from trend.list or trend.get.

idempotency_keystring

Send the same key when retrying this exact call. A completed request replays for 24 hours without running or billing again.

callback_urlstring

An https URL that receives a signed completion event when the work finishes, so you can skip polling. See Webhooks.

Returns

handlestring

Opaque async handle. Pass to design.get_generation.

status"pending"

messagestring

Describes the design.get_generation(..., wait_sec=...) contract.

Request

json

{
  "name": "design.generate",
  "arguments": {
    "product_uuid": "b62beb9f-cfbb-5ad9-be26-254b50c6638a",
    "prompt": "Retro sunset over palm trees, bold serif lettering"
  }
}