API Documentation

Integrate dream visualization into your applications with our powerful API.

Getting Started

To use the Dreams.ml API, you'll need an API key. You can generate one from your account dashboard.

Authorization: Bearer YOUR_API_KEY

Base URL

https://api.dreams.ml

Endpoints

POST/api/v1/dreams/generate

Generate a dream visualization from a text description

{
  "description": "Flying over a crystal city at sunset",
  "style": "cinematic",
  "aspectRatio": "landscape"
}
GET/api/v1/dreams/{id}

Retrieve a generated dream by ID

{
  "id": "dream_abc123",
  "status": "completed",
  "imageUrl": "https://..."
}
GET/api/v1/dreams

List all dreams for the authenticated user

{
  "dreams": [...],
  "pagination": { "page": 1, "total": 50 }
}
DELETE/api/v1/dreams/{id}

Delete a dream by ID

{
  "success": true,
  "message": "Dream deleted"
}

Need More Help?

Check out our SDKs and integration guides for popular frameworks.