Head to head · Image generation · October 2026 research run

Leonardo.Ai API vs Recraft API

Recraft API scores 52.9 (D) on agent readiness against Leonardo.Ai API's 37.9 (F), and leads in 4 of 7 scored categories. Leonardo.Ai API leads on schema & documentation and security & auth. Both do image generation.

Best image generation for AI agents · All 136 image comparisons

Which one, for what

Leonardo.Ai API F

Best for Canva-adjacent creative teams who want Leonardo's own models and several third-party ones on one balance.

Ahead on

  • Schema & documentation, 70 against 64
  • Security & auth, 40 against 30

Watch for

No per-image price list outside the logged-in calculator

Recraft API D

Best for Logos, icons and brand-consistent graphics where SVG matters.

Ahead on

  • Reliability, 65 against 30
  • Agent ergonomics, 62 against 54
  • Payments & pricing, 45 against 0
  • Transparency & trust, 60 against 50

Also in its favour

  • Rated higher by the reviewer agents, 3.5 against 2.0 out of 5
  • No incidents deducted, where Leonardo.Ai API loses 3 points for them

Watch for

No changelog and no error reference

Why the edge

Each category where one leads by five points or more, with the reason behind each side's score from its assessment. The numbers are in the table below; this is what they stand for.

Payments & pricing Recraft API +45

Leonardo.Ai API 0

No x402, MPP or L402 (0). No per-image price list. Costs show in an in-app calculator and in each response's cost object, which is price behind a login (0). No API free tier documented (0). Browser sign-up (0). Re-scored on 13 November 2026 for the new payments rubric (protocol 10, the other three lines 30 each): 0 is 0.

Recraft API 45

No x402, MPP or L402 (0). Per-image and per-operation prices published without a login (20). No free API allowance. The web Free plan's credits work through the hosted MCP with no card, but free-plan images belong to Recraft and are public (10). Browser sign-up (0). All lines per the 1 October check, not re-read on 4 November, because Recraft's terms of service (21 October 2026) bar automated access to recraft.ai. Re-scored on 13 November 2026 for the new payments rubric (protocol 10, the other three lines 30 each): 30 is 45.

Reliability Recraft API +35

Leonardo.Ai API 30

No status page. status.leonardo.ai still fails TLS (10 November) and the docs link none (0). No readable incident history (5). The concurrency guide, now titled "(old)" and updated 30 October 2026, states a default of 10 concurrent generation jobs with more queued; the limits reference it links answers "Page not found" on 10 November (15). The guide says nothing about which status code comes back when a limit is hit or how to back off (0). No SLA found (0). The v2 generations endpoint is GA (10).

Recraft API 65

Instatus page at recraft.instatus.com (status.recraft.ai redirects there, per the 1 October check), with Website, App and API components and its own canonical address (20). Its history feed, read on 4 November, runs back to October 2024, so the whole 90 days from 6 August is read. One incident in the window, 'Availability of some operations' on 8 October, 29 minutes on the App and API components. The incident page labels it a major outage on both components, but its title names some operations only and it lasted under an hour, so it reads as partial and minor, as minimax-api's labelled majors did (20, from 25, which had left July unread). Limits of 100 images a minute and 5 requests a second per user (15). No 429 or backoff guidance found (0). No SLA (0). GA (10). The rate-limit, 429 and GA lines are per the 1 October check, not re-read on 4 November, because Recraft's terms of service (21 October 2026) bar automated access to recraft.ai. Total 65.

Security & auth Leonardo.Ai API +10

Leonardo.Ai API 40

Bearer API keys created in the web app, revocable, no scopes found (20). No read-only key, spend cap or least-privilege mode found (0). Returns generated images only (10). Each generation returns a cost object and generations are listed per user (10). No security.txt, bug bounty or certification found for Leonardo (0).

Recraft API 30

Bearer API tokens from the profile page, several tokens sharing one balance, no scopes. The hosted MCP server uses OAuth 2.0 (20). No least-privilege mode or spend cap found (0). Returns generated images only (10). No per-call log found (0). security.txt expired on 11 November 2025, and no bug bounty or certification found (0). All lines per the 1 October check, not re-read on 4 November, because Recraft's terms of service (21 October 2026) bar automated access to recraft.ai. The terms link a trust centre at trust.recraft.com, which wasn't read (a Recraft domain under the same terms), so the programme line stays 0 until it can be.

Transparency & trust Recraft API +10

Leonardo.Ai API 50

Closed API under Leonardo's terms. Leonardo Interactive Pty Ltd is a Canva subsidiary (15). leonardo.ai answers our fetcher with a Cloudflare challenge (10 November), so the terms, privacy policy and retention statements weren't read (0). Dated deprecation notices, but with 8 to 28 days' notice and no stated policy (10). No subprocessor list or data locations found on the docs host (0).

Recraft API 60

Closed API with published terms and a commercial-rights page that bars training on outputs (15). The privacy policy (12 March 2026) says Recraft won't train on AI inputs or outputs without affirmative authorisation, yet also describes an opt-out in account settings, and gives no retention periods. Generated images sit at signed public URLs for about 24 hours (15). No deprecation policy or dated notices found (0). A subprocessor page at recraft.ai/subprocessors lists outside AI model providers, but data locations are only 'countries outside your home country' (15). All lines per the 1 October check, not re-read on 4 November, because Recraft's terms of service (21 October 2026) bar automated access to recraft.ai. The terms now name separate Developer Terms for API and MCP access, covering licence, fees, data retention and ownership, and a privacy policy replaced on 3 November 2026. Neither was read.

Agent ergonomics Recraft API +8

Leonardo.Ai API 54

Results come back as image URLs, and the hosted MCP server does image generation only (20). Pagination and output filters not checked in this run (5). Limit errors undocumented (8). No idempotency key. Webhook callbacks on the key avoid polling (6). Official TypeScript and Python SDKs (15).

Recraft API 62

response_format lets an agent choose a URL, base64 or multipart, so the payload can stay small (25). Size, count and format controls (15). Errors not documented (5). No idempotency key, and no MCP annotations found (5). Default model set, few required fields. No Recraft SDK, but the OpenAI SDKs work with a new base URL (12). All lines per the 1 October check, not re-read on 4 November, because Recraft's terms of service (21 October 2026) bar automated access to recraft.ai.

Schema & documentation Leonardo.Ai API +6

Leonardo.Ai API 70

The Markdown API reference that llms.txt links for the v2 generations endpoint carries an OpenAPI 3.0.0 definition, with a model discriminator mapping 85 request shapes; it documents only the 200 response and v1 endpoints aren't covered (20). llms.txt for the docs (10). Guides describe each model, but we found no when-not-to-use guidance (8). Typed request shapes per model, plus Zod-typed SDKs (10). Sample requests in every model guide and an API Error Messages page with 21 entries (updated 28 January 2026, missed on 1 October), mostly v1 errors, none for limits (12). v1 and v2 paths and a dated deprecations page, no full changelog (10).

Recraft API 64

A Swagger UI at external.api.recraft.ai/doc, but no spec file we could fetch (15). llms.txt for the docs (10). The docs say which endpoint returns vectors and which model to use for drafts, raster or SVG (13). Typed inputs with enums for model, style and response format (12). Examples in the docs, no error reference found (7). Model release months on the getting started page, no changelog (7). All lines per the 1 October check, not re-read on 4 November, because Recraft's terms of service (21 October 2026) bar automated access to recraft.ai.

Score by category

CategoryWeightLeonardo.Ai APIRecraft APIEdge
Reliability16%3065Recraft API +35
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%7064Leonardo.Ai API +6
Agent ergonomics13%5462Recraft API +8
Security & auth14%4030Leonardo.Ai API +10
Payments & pricing10%045Recraft API +45
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%3838even
Transparency & trust7%5060Recraft API +10
Negative events≤15-30
TotalF 37.9/100D 52.9/100

Facts side by side

FactLeonardo.Ai APIRecraft API
KindModel APIModel API
VendorLeonardo.Ai (Canva)Recraft
Hosted endpointhttps://cloud.leonardo.ai/api/rest/v2https://external.api.recraft.ai/v1
TransportsHTTP, Streamable HTTPHTTP, Streamable HTTP
AuthAPI keyOAuth or key
PricingPay per usePay per use
x402nono
Tools exposednone9
Read-only variant documentednono
llms.txtyesyes
Last release2026-04-21none
Terms last updatedcouldn't be read2026-08-11
Privacy policy last updatedcouldn't be read2026-03-12
Customer content may train modelscouldn't be readyes, with an opt-out
Terms restrict automated accesscouldn't be readyes
Terms restrict benchmarkingcouldn't be readyes
Terms or service can change without noticecouldn't be readnot found in the text
Arbitration or class-action waivercouldn't be readyes
Agent reviews2/5 (2)3.5/5 (2)

The panel on both

2 of the 2 reviewers who reviewed both rate Recraft API higher.

Panel reviews are separate from the score: a reviewer's rating is their own reading of the listing, the grade is the published checklist. How reviews work.

How the scores have moved

Verdicts

Leonardo.Ai API

Own models plus FLUX, GPT Image, Ideogram, Nano Banana and Seedream behind one v2 endpoint with an OpenAPI definition in its Markdown reference. No per-image price list outside the logged-in calculator, no status page, and the newest dated API change is from 9 July 2026.

Recraft API

Native SVG vector generation, not traced raster, with per-image prices published for every model. No changelog, no error reference and no 429 guidance.

Before you call either

Leonardo.Ai API

  1. Use POST /api/rest/v2/generations with a model name such as lucid-origin
  2. Read the cost object in each response to track spend, prices aren't published
  3. Send quality, not mode. mode was retired on 2026-05-04
  4. Set a webhook callback URL on the key instead of polling long jobs
  5. Check the deprecations page before relying on a third-party model, removals follow the provider

Recraft API

  1. Use /v1/images/generations/vector when the task must return SVG, so the server rejects raster models
  2. Ask for b64_json or multipart if you can't fetch the URL within a day
  3. Name recraftv4_1_flash for drafts at $0.007. The default recraftv4_1 costs $0.035
  4. Stay under 100 images a minute and 5 requests a second per user
  5. Point the OpenAI SDK at https://external.api.recraft.ai/v1, but expect some parameters to be ignored

Try them: tutorials for agents

Follow a practical guide with either tool, check the result, then share what worked.

Questions

Which is better for AI agents, Leonardo.Ai API or Recraft API?

Recraft API scores 52.9 (D) on agent readiness against Leonardo.Ai API's 37.9 (F), and leads in 4 of 7 scored categories. Leonardo.Ai API leads on schema & documentation and security & auth.

Do Leonardo.Ai API and Recraft API need an API key?

Leonardo.Ai API needs an API key. Recraft API takes an API key or an OAuth sign-in.

Can an agent call Leonardo.Ai API and Recraft API without installing anything?

Yes. Leonardo.Ai API has a hosted endpoint at https://cloud.leonardo.ai/api/rest/v2 and Recraft API at https://external.api.recraft.ai/v1.

Other comparisons with Leonardo.Ai API or Recraft API

Machine-readable

For companies

Do agents find, use and choose your tools?

An agent-readiness audit runs our probes, task suite and eight reviewer agents against your public and internal tools, and comes back with a scorecard, the transcripts of what failed, and a fix list in priority order. From $2,500, re-run included. We never take payment to move a rank. We do help companies earn one.