How to use

generation = client.generations.create(
    prompt="a car",
    model="ray-2",
    resolution="720p",
    duration="5s",
    concepts=[
      {
      	"key": "handheld"
      }
    ]
)

const generation = await client.generations.create({
  prompt: "a car",
  model: "ray-1",
  resolution: "720p",
  duration: "5s",
  concepts: [
    {
    	"key": "bolt_cam"
    }
  ]
});

curl --request POST \
     --url https://api.lumalabs.ai/dream-machine/v1/generations \
     --header 'accept: application/json' \
     --header 'authorization: Bearer luma-xxxx' \
     --header 'content-type: application/json' \
     --data '
{
  "prompt": "a car",
  "model": "ray-2",
  "resolution": "720p",
  "duration": "5s",
  "concepts": [
  	{
    	"key": "dolly_zoom"
    }
  ]
}
'

How to get list of available concepts

We have this new /concepts/list api one can hit to get list of concepts available.

curl --request GET \
     --url 'https://api.lumalabs.ai/dream-machine/v1/generations/concepts/list' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer luma-xxxx'

[
    "truck_left",
    "pan_right",
    "pedestal_down",
    "low_angle",
    "pedestal_up",
    "selfie",
    "pan_left",
    "roll_right",
    "zoom_in",
    "over_the_shoulder",
    "orbit_right",
    "orbit_left",
    "static",
    "tiny_planet",
    "high_angle",
    "bolt_cam",
    "dolly_zoom",
    "overhead",
    "zoom_out",
    "handheld",
    "roll_left",
    "pov",
    "aerial_drone",
    "push_in",
    "crane_down",
    "truck_right",
    "tilt_down",
    "elevator_doors",
    "tilt_up",
    "ground_level",
    "pull_out",
    "aerial",
    "crane_up",
    "eye_level"
]

How to combine concepts

concepts parameter is just an array of objects, so you can combine a few concepts too

generation = client.generations.create(
    prompt="a car",
    model="ray-2",
    resolution="720p",
    duration="5s",
    concepts=[
      {
      	"key": "pull_out"
      },
      {
      	"key": "tilt_down"
      }
    ]
)

const generation = await client.generations.create({
  prompt: "a car",
  model: "ray-1",
  resolution: "720p",
  duration: "5s",
  concepts: [
    {
    	"key": "orbit_right"
    },
    {
    	"key": "handheld"
    }
  ]
});

curl --request POST \
     --url https://api.lumalabs.ai/dream-machine/v1/generations \
     --header 'accept: application/json' \
     --header 'authorization: Bearer luma-xxxx' \
     --header 'content-type: application/json' \
     --data '
{
  "prompt": "a car",
  "model": "ray-2",
  "resolution": "720p",
  "duration": "5s",
  "concepts": [
    {
    	"key": "elevator_doors"
    },
    {
    	"key": "dolly_zoom"
    }
  ]
}
'

Pricing

Same as ray-2 and ray-flash-2

More details: https://lumalabs.ai/api/pricing

SDKs

Python: pypi.org/project/lumaai/

TS/JS: npmjs.com/package/lumaai

Changelog

Camera Concepts

Upscale up to 4K, Progress updates

Photon & Photon Flash API

Callbacks & Credits Balance

Launch