Skip navigation

Skip to main content

Tools
Tools

generate-design

Create design candidates from a natural-language brief.

Use generate-design to produce candidate designs. Present the candidates to the user to choose from rather than auto-selecting.

Example prompt

"Create an Instagram post announcing our new AI editing feature. Bold and modern."

Example response

IDs, URLs, and tokens below are placeholders; field names and structure are exactly as returned.

This tool wraps results in an asynchronous job object.

{
  "job": {
    "id": "job_EXAMPLE",
    "status": "success",
    "result": {
      "generated_designs": [
        { "candidate_id": "dg-EXAMPLE1", "url": "https://www.canva.com/d/EXAMPLE1", "thumbnails": [ { "url": "https://design.canva.ai/EXAMPLE1" } ] },
        { "candidate_id": "dg-EXAMPLE2", "url": "https://www.canva.com/d/EXAMPLE2", "thumbnails": [ { "url": "https://design.canva.ai/EXAMPLE2" } ] }
      ]
    }
  }
}
JSON

Returns a job whose result.generated_designs holds the candidates. Each has a candidate_id, url, and thumbnails. The job's top-level id is needed for create-design-from-candidate.

Thumbnail URLs may need redirects resolved. Thumbnails are typically returned in the form https://design.canva.ai/<id> and aren't always directly embeddable in an HTML <img> tag. Your application may need to follow redirects to resolve the URL to the underlying image before displaying it.

Learn more