Cloudflare Docs
Workers AI
Edit this page on GitHub
Set theme to dark (⇧+D)

stable-diffusion-xl-lightning

Beta

Model ID: @cf/bytedance/stable-diffusion-xl-lightning

SDXL-Lightning is a lightning-fast text-to-image generation model. It can generate high-quality 1024px images in a few steps.

More Information  

​​ Properties

Task Type: Text-to-Image

​​ Code Examples

Workers - TypeScript
export interface Env {
AI: Ai;
}
export default {
async fetch(request, env): Promise<Response> {
const inputs = {
prompt: "cyberpunk cat",
};
const response = await env.AI.run(
"@cf/bytedance/stable-diffusion-xl-lightning",
inputs
);
return new Response(response, {
headers: {
"content-type": "image/png",
},
});
},
} satisfies ExportedHandler<Env>;
curl
curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/run/@cf/bytedance/stable-diffusion-xl-lightning \
-X POST \
-H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
-d '{ "prompt": "cyberpunk cat" }'

​​ Response

The response is a binary PNG file.

​​ API Schema

The following schema is based on JSON Schema

Input JSON Schema
{
"type": "object",
"properties": {
"prompt": {
"type": "string"
},
"image": {
"oneOf": [
{
"type": "string",
"format": "binary"
},
{
"type": "object",
"properties": {
"image": {
"type": "array",
"items": {
"type": "number"
}
}
}
}
]
},
"mask": {
"oneOf": [
{
"type": "string",
"format": "binary"
},
{
"type": "object",
"properties": {
"mask": {
"type": "array",
"items": {
"type": "number"
}
}
}
}
]
},
"num_steps": {
"type": "integer",
"default": 20,
"maximum": 20
},
"strength": {
"type": "number",
"default": 1
},
"guidance": {
"type": "number",
"default": 7.5
}
},
"required": [
"prompt"
]
}
Output JSON Schema
{
"type": "string",
"contentType": "image/png",
"format": "binary"
}