Docs
  1. Recraft API
Docs
  • Introduction
  • Quick Start Guide
  • Make a request
  • YEScale System API Tutorial
  • Chat Models
    • ChatGpt
      • ChatGPT (Audio)
        • Create transcription by gpt-4o-mini-transcribe & gpt-4o-transcribe
        • Create a voice with gpt-4o-mini-tts
        • Create a voice
        • Create a transcript
        • Create translation
      • ChatGPT (Chat)
        • Chat completion object
        • Create chat completion (streaming)
        • Create chat completion (non-streaming)
        • Create chat image recognition (streaming)
        • Create chat image recognition (streaming) base64
        • Create chat image recognition (non-streaming)
        • Function calling
        • N choices
        • Create chat function call (only non-streaming)
        • Create structured output
      • ChatGPT (Completions)
        • Completion object
        • Creation completed
      • ChatGPT(Embeddings)
        • Embedded Object
        • Create embed
    • Anthropic Claude
      • Offical Format
        • Messages (official Anthropic format)
        • Messages(Image Recognition)
        • Messages(function call)
        • Messages(Web search)
      • Create chat completion (streaming)
      • Create chat completion (non-streaming)
      • Create chat image recognition (streaming)
      • Create chat image recognition (non-streaming)
    • Gemini
      • Gemini Image creation interface (gemini-2.0-flash-exp-image-generation)
      • Chat interface
      • Image recognition interface
      • Function calling - Google Search
      • Function calling - codeExecution
  • Image Models
    • GPT-IMAGE-1
      • Generate Image by gpt-image-1
      • Edit Image by gpt-image-1
    • MJ
      • Submit Imagine task (mj_imagine)
      • Submit Blend task (mj_blend)
      • Submit Describe task (mj_describe)
      • Submit Change task (mj_variation, mj_upscale,mj_reroll)
      • Query task status based on task ID
    • Ideogram
      • Generate with Ideogram 3.0
      • Edit with Ideogram 3.0
      • Remix with Ideogram 3.0
      • Ideogram Upscale
    • Kling Image
      • Submit Image Generation
      • Get Image by Task ID
      • Submit Kolors Virtual Try On
      • Get Kolors Virtual Try On by Task ID
    • Flux
      • Flux on Replicate
        • Submit Image by flux-kontext-pro
        • Submit Image by flux-kontext-max
        • Submit Image by flux-pro
        • Submit Image by flux-pro-1.1-ultra
        • Get Image by ID
    • Recraft API
      • Recraft Image
      • Generate Image
        POST
      • Generate Vector Image
        POST
      • Remove Background
        POST
      • Clarity Upscale
        POST
      • Generative Upscale
        POST
    • Models use Dall-e Format
      • Google Imagen
      • Bytedance - seedream-3.0
      • Recraftv3 use Dall-e endpoint
      • Flux use Dall-e endpoint
    • Google Imagen
      • Google/imagen-4 on Replicate
      • Get Imagen 4 Task
    • DALL·E 3
      POST
  • Video Models
    • Kling Video
      • Create Video by Text
      • Get Video by Task ID(text2video)
      • Create Video by Image
      • Get Video by Task ID(image2video)
    • Runway ML Video
      • Create Video by Runway
      • Get Video by Task ID
    • Luma Video
      • Create Video by Luma
      • Get Video by Task ID
    • Pika Video
      • Create Video by Pika
      • Get Video by Task ID
    • Google Veo
      • Submit Video Request
      • Submit Video Request with Frames
      • Get Video by ID
    • Minimax - Hailuo
      • Submit Video Request
      • Get Video
    • Seedance
      • Submit Video Request
      • Get Video by Task ID
    • Mj Video
      • Submit Mj Video Request
      • Get Mj Video by task id
  • FAL-AI Models
    • Images Models
      • Ideogram/v3/remix
      • Flux-pro/kontext/max
      • Fal-recraft-v3-text-to-image
      • Fal-recraft-v3-image-to-image
      • Fal-bytedance-seededit-v3-edit-image
    • Audio Models
      • Minimax/speech-02-hd
      • Minimax/speech-02-turbo
      • Elevenlabs/tts/turbo-v2.5
      • Elevenlabs/tts/multilingual-v2
    • Video Models
      • Topaz/upscale/video
      • Luma-dream-machine/ray-2-flash/reframe
      • Luma-dream-machine/ray-2/reframe
    • Get FAL-AI tasks
  • Music Model - Suno
    • Illustrate
    • Parameter
    • Task submission
      • Generate songs (inspiration, customization, continuation)
      • Generate lyrics
    • Query interface
      • Query a single task
  • Python Samples
    • python openai official library (using AutoGPT, langchain, etc.)
    • Python uses speech to text
    • Python uses text to speech
    • Python uses Embeddings
    • python calls DALL·E
    • python simple call openai function-calling demo
    • python langchain
    • python llama_index
    • Python uses gpt-4o to identify pictures-local pictures
    • python library streaming output
    • Python uses gpt-4o to identify images
  • Plug-in/software usage tutorials
    • Setting HTTP for Make.com with Yescale
    • Sample Code for gpt-4o-audio/gpt-4o-mini-audio
  • Help Center
    • HTTP status codes
  • Tutorials
    • GPT-Image-1 API: A Step-by-Step Guide With Examples
    • Claude Code via YEScale API
    • Task Sync Endpoint Usage Guide
  1. Recraft API

Generate Image

POST
/recraft/v1/images/generations
Generate Image

Request

Body Params application/json

Example
{
  "prompt": "red point siamese hourse",
  "style": "realistic_image",
  "size": "1280x1024",
  "n":5,
  "text_layout": [
            {
                "text": "Bogia",
                "bbox": [[0.3, 0.45], [0.6, 0.45], [0.6, 0.55], [0.3, 0.55]]
            },
            {
                "text": "AI",
                "bbox": [[0.62, 0.45], [0.70, 0.45], [0.70, 0.55], [0.62, 0.55]]
            }
        ]

}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/recraft/v1/images/generations' \
--header 'Content-Type: application/json' \
--data-raw '{
  "prompt": "red point siamese hourse",
  "style": "realistic_image",
  "size": "1280x1024",
  "n":5,
  "text_layout": [
            {
                "text": "Bogia",
                "bbox": [[0.3, 0.45], [0.6, 0.45], [0.6, 0.55], [0.3, 0.55]]
            },
            {
                "text": "AI",
                "bbox": [[0.62, 0.45], [0.70, 0.45], [0.70, 0.55], [0.62, 0.55]]
            }
        ]

}'

Responses

🟢200Ok
application/json
Body

Example
{
    "created": 1750392919,
    "data": [
        {
            "url": "https://s3.ffire.cc/cdn/20250620/5AiJwjRacjtUgjQFNCwJDR"
        },
        {
            "url": "https://s3.ffire.cc/cdn/20250620/dnJZmDiCegRGYucMYU3dhq"
        }
    ],
    "usage": null,
    "image": [
        "https://s3.ffire.cc/cdn/20250620/5AiJwjRacjtUgjQFNCwJDR",
        "https://s3.ffire.cc/cdn/20250620/dnJZmDiCegRGYucMYU3dhq"
    ],
    "metadata": {
        "credits": 2,
        "height": 1024,
        "images": [
            {
                "image_id": "309077fd-c10b-47d7-9018-153142003760",
                "image_invariants": {
                    "preset": "digital_illustration"
                },
                "text_layout": [
                    {
                        "bbox": [
                            [
                                0.3,
                                0.45
                            ],
                            [
                                0.6,
                                0.45
                            ],
                            [
                                0.6,
                                0.55
                            ],
                            [
                                0.3,
                                0.55
                            ]
                        ],
                        "text": "Vũ"
                    },
                    {
                        "bbox": [
                            [
                                0.62,
                                0.45
                            ],
                            [
                                0.7,
                                0.45
                            ],
                            [
                                0.7,
                                0.55
                            ],
                            [
                                0.62,
                                0.55
                            ]
                        ],
                        "text": "AI"
                    }
                ],
                "transparent": false,
                "vector_image": false
            },
            {
                "image_id": "2cb9cda4-fc7a-478b-b692-2acc4c2e1e1c",
                "image_invariants": {
                    "preset": "digital_illustration"
                },
                "text_layout": [
                    {
                        "bbox": [
                            [
                                0.3,
                                0.45
                            ],
                            [
                                0.6,
                                0.45
                            ],
                            [
                                0.6,
                                0.55
                            ],
                            [
                                0.3,
                                0.55
                            ]
                        ],
                        "text": "Vũ"
                    },
                    {
                        "bbox": [
                            [
                                0.62,
                                0.45
                            ],
                            [
                                0.7,
                                0.45
                            ],
                            [
                                0.7,
                                0.55
                            ],
                            [
                                0.62,
                                0.55
                            ]
                        ],
                        "text": "AI"
                    }
                ],
                "transparent": false,
                "vector_image": false
            }
        ],
        "random_seed": 2636873849,
        "request_id": "355ccb3a-1c9c-494b-8fa8-c6875fe07d34",
        "transform_model": "recraftv3",
        "width": 1365
    },
    "timings": null
}
Modified at 2025-06-20 07:07:57
Previous
Recraft Image
Next
Generate Vector Image
Built with