Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Recraft Images API

The Images API from Recraft — 16 operation(s) for images.

Recraft Images API is one of 5 APIs that Recraft publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 2 JSON Schema definitions.

Tagged areas include Images. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 2 JSON Schemas.

This API exposes 16 operations across 16 paths, and defines 10 schemas. It is described by OpenAPI 3.0.3, at version 2026-05-22.

Requests are made against a single base URL, https://external.api.recraft.ai/v1.

16 operations 16 paths 10 schemas 16 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2026-05-22
Base URL
https://external.api.recraft.ai/v1
Authentication
HTTP Bearer
Contact
Resource Areas
1

Authentication & Security 1

Recraft Images API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — Recraft API token issued from the Recraft profile. Sent as Authorization.

Paths & Operations 16

Across 16 paths, the API surfaces 16 operations — 16 POST. Each is listed below with its method, path, parameters, and response codes.

Images 16
POST
/images/generations
Create Image From Prompt
createImage body → 200
POST
/images/generations/raster
Create Raster Image
createRasterImage body → 200
POST
/images/generations/vector
Create Vector Image
createVectorImage body → 200
POST
/images/imageToImage
Transform Image To Image
imageToImage body → 200
POST
/images/inpaint
Inpaint Masked Region
inpaintImage body → 200
POST
/images/outpaint
Outpaint Image Beyond Edges
outpaintImage body → 200
POST
/images/replaceBackground
Replace Background
replaceBackground body → 200
POST
/images/generateBackground
Generate Background Behind Subject
generateBackground body → 200
POST
/images/vectorize
Vectorize Raster Image
vectorizeImage body → 200
POST
/images/removeBackground
Remove Image Background
removeBackground body → 200
POST
/images/crispUpscale
Crisp Upscale Image
crispUpscale body → 200
POST
/images/creativeUpscale
Creative Upscale Image
creativeUpscale body → 200
POST
/images/eraseRegion
Erase Masked Region
eraseRegion body → 200
POST
/images/variateImage
Variate Image
variateImage body → 200
POST
/images/explore
Explore Diverse Variations
exploreImages body → 200
POST
/images/explore/similar
Explore Similar Images
exploreSimilarImages body → 200

Schemas 10

The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are GenerationRequest (11 properties), ImageToImageRequest (10 properties), OutpaintRequest (8 properties), BackgroundRequest (6 properties). Each schema is shown below with its type and property counts.

BackgroundRequest
object
6 properties 1 required
ImageToImageRequest
object
10 properties 2 required
Color
object
2 properties 1 required
OutpaintRequest
object
8 properties 1 required
Image
object
4 properties
FileOnlyRequest
object
2 properties 1 required
GenerationRequest
object
11 properties 1 required
BrandControls
object
Brand-level controls applied during generation.
4 properties
MaskedEditRequest
ImageSet
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

recraft-ai-images-api-openapi.yml Raw ↑

Other APIs Recraft publishes across the network.

Recraft MCP Server
Recraft Prompts API
Recraft Styles API
Recraft Users API