Clients and SDKs

​

Any HTTP client

curl https://external.api.recraft.ai/v1/images/generations \
  -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "two race cars on a track", "model": "recraftv4_1"}'

​

OpenAI Python library

# pip install openai
import os

from openai import OpenAI

client = OpenAI(
    base_url='https://external.api.recraft.ai/v1',
    api_key=os.environ['RECRAFT_API_TOKEN'],
)

response = client.images.generate(
    prompt='two race cars on a track',
    model='recraftv4_1',
)
print(response.data[0].url)

• Recraft-specific parameters go in extra_body. The library passes prompt, model, n, size, and response_format natively. Everything else (style_id, style_reference_urls, style_match, controls, image_format, negative_prompt, text_layout, …) must go through extra_body, or the library rejects it:
  response = client.images.generate(
      prompt='isometric illustration of a delivery van',
      model='recraftv4_1',
      extra_body={
          'controls': {'colors': [{'rgb': [255, 102, 0]}]},
          'image_format': 'png',
      },
  )
  
• Endpoints outside the OpenAI API (styles, vectorize, upscale, inpaint, and others) are called with client.post:
  style = client.post(
      path='/styles',
      cast_to=object,
      body={
          'model': 'recraftv4_styles',
          'image_urls': ['https://example.com/reference.png'],
      },
  )
  print(style['id'])
  
• multipart responses are not supported. The library reads JSON only, so use response_format url or b64_json with it, and a plain HTTP client for multipart.
• Some OpenAI parameters don’t apply. Parameters without a Recraft meaning are ignored or may be interpreted differently. Check the model page for what each model accepts.

​

Other languages