Stability AI REST API

API Endpoints

Code Examples

curl -X POST https://api.stability.ai/v1/generation/stable-diffusion-xl-1024-v1-0/text-to-image \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sk-your-api-key-here' \
  -d '{
    "text_prompts": [
      {
        "text": "A serene landscape with mountains and lake at sunset",
        "weight": 1
      }
    ],
    "cfg_scale": 7,
    "height": 1024,
    "width": 1024,
    "steps": 30,
    "samples": 1
  }'

const response = await fetch('https://api.stability.ai/v1/generation/stable-diffusion-xl-1024-v1-0/text-to-image', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer sk-your-api-key-here'
  },
  body: JSON.stringify({
    text_prompts: [
      {
        text: 'A serene landscape with mountains and lake at sunset',
        weight: 1
      }
    ],
    cfg_scale: 7,
    height: 1024,
    width: 1024,
    steps: 30,
    samples: 1
  })
});

const data = await response.json();
const base64Image = data.artifacts[0].base64;

import requests
import base64

url = 'https://api.stability.ai/v1/generation/stable-diffusion-xl-1024-v1-0/text-to-image'

headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer sk-your-api-key-here'
}

payload = {
    'text_prompts': [
        {
            'text': 'A serene landscape with mountains and lake at sunset',
            'weight': 1
        }
    ],
    'cfg_scale': 7,
    'height': 1024,
    'width': 1024,
    'steps': 30,
    'samples': 1
}

response = requests.post(url, headers=headers, json=payload)
data = response.json()

image_data = base64.b64decode(data['artifacts'][0]['base64'])
with open('generated_image.png', 'wb') as f:
    f.write(image_data)

Related APIs