Recraft v3

This documentation is valid for the following list of our models:

recraft-v3

Model Overview

A state-of-the-art image generation model specifically designed for professional designers, featuring advanced text generation capabilities, anatomical accuracy, and precise style control. It stands out for its ability to generate images with extended text content and vector art support.

Setup your API Key

If you don’t have an API key for the AI/ML API yet, feel free to use our Quickstart guide.

API Schema

post

Authorizations

Body

modelundefined · enumRequiredPossible values:

promptstring · max: 4000Required

The text prompt describing the content, style, or composition of the image to be generated.

image_sizeany ofOptionalDefault: square_hd

string · enumOptional

The size of the generated image.

Possible values:

stylestring · enumOptional

The style of the generated images.

Default: realistic_imagePossible values:

num_imagesnumber · enumOptional

The number of images to generate.

Default: 1Possible values:

Responses

201Success

post

POST /v1/images/generations HTTP/1.1
Host: api.aimlapi.com
Authorization: Bearer <YOUR_AIMLAPI_KEY>
Content-Type: application/json
Accept: */*
Content-Length: 135

{
  "model": "recraft-v3",
  "prompt": "text",
  "image_size": "square_hd",
  "style": "realistic_image",
  "colors": [
    {
      "r": 1,
      "g": 1,
      "b": 1
    }
  ],
  "num_images": 1
}

201Success

No content

Quick Example

Let's generate an image using a simple prompt.

import requests


def main():
    response = requests.post(
        "https://api.aimlapi.com/v1/images/generations",
        headers={
            # Insert your AIML API Key instead of <YOUR_AIMLAPI_KEY>:
            "Authorization": "Bearer <YOUR_AIMLAPI_KEY>",
            "Content-Type": "application/json",
        },
        json={
            "prompt": "A T-Rex relaxing on a beach, lying on a sun lounger and wearing sunglasses.",
            "model": "recraft-v3"
        }
    )

    response.raise_for_status()
    data = response.json()

    print("Generation:", data)


if __name__ == "__main__":
    main()

async function main() {
  try {
    const response = await fetch('https://api.aimlapi.com/v1/images/generations', {
      method: 'POST',
      headers: {
        // Insert your AIML API Key instead of <YOUR_AIMLAPI_KEY>:
        'Authorization': 'Bearer <YOUR_AIMLAPI_KEY>',
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        prompt: 'A T-Rex relaxing on a beach, lying on a sun lounger and wearing sunglasses.',
        model: 'recraft-v3',
      }),
    });

    if (!response.ok) {
      throw new Error(`HTTP error! Status: ${response.status}`);
    }

    const data = await response.json();
    console.log('Generation:', data);

  } catch (error) {
    console.error('Error:', error);
  }
}

main();

Response

Generation: {'images': [{'url': 'https://cdn.aimlapi.com/eagle/files/elephant/_xsMTrYgz4vMITXeT1gjl_image.webp', 'content_type': 'image/webp', 'file_name': 'image.webp', 'file_size': 558752}]}

We obtained the following 2048x1024 image by running this code example:

One of recraft-v3’s strengths is its wide range of supported styles. By default, it generates realistic images, but we tried a few others—here’s what we got:

Style Experiments

When the 'vector_illustration' style is selected, the model generates an SVG vector format! For preview purposes, we took a screenshot ☝️️

PreviousRecraftAI NextStability AI

Last updated 9 days ago

Was this helpful?