🎬 Video Model luma-v2

2024.11.26 Following luma's official website redesign, this site now supports luma-v2
Supports text-to-video, image-to-video, and first/last frame
Billing is per request; each request generates 2 videos
Trial pricing is the same as before; adjustments will be made based on risk control going forward
The request body is essentially the same as v1; the response body has changed due to multiple videos being returned

Luma API

The request header must include Authorization: Bearer hk-your-key
API endpoint: https://api.openai-hk.com/luma/v2
The following examples use relax as a reference

Create Video Task

post https://api.openai-hk.com/luma/v2/generations

shell

curl 'https://api.openai-hk.com/luma/v2/generations' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer hk-你的key' \
  --data '{"aspect_ratio":"16:9","expand_prompt":true,"image_url":"","user_prompt":"特斯拉飞速在公路上"}'

curl 'https://api.openai-hk.com/luma/v2/generations' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer hk-你的key' \
  --data '{"aspect_ratio":"16:9","expand_prompt":true,"image_url":"","user_prompt":"特斯拉飞速在公路上"}'

Request body

json

{
    "aspect_ratio": "16:9",
    "expand_prompt": true,
    "loop": false, 
    "image_url": "",
    "image_end_url": "",
    "user_prompt": "特斯拉飞速在公路上"
}

{
    "aspect_ratio": "16:9",
    "expand_prompt": true,
    "loop": false, 
    "image_url": "",
    "image_end_url": "",
    "user_prompt": "特斯拉飞速在公路上"
}

Field	Type	Description
user_prompt	string	Prompt text
image_url	string	Keyframe start image URL, supports base64
image_end_url	string	Keyframe end image URL, supports base64
aspect_ratio	string	Video aspect ratio
expand_prompt	boolean	Whether to expand the prompt
loop	boolean	Whether to loop (seamless start-to-end)

Response body

json

{
	"task_id": "90254e88-2591-4007-99b8-9ee442b54b9b"
}

{
	"task_id": "90254e88-2591-4007-99b8-9ee442b54b9b"
}

Get Task Status

get https://api.openai-hk.com/luma/v2/generations/{id}

shell

curl 'https://api.openai-hk.com/luma/generations/90254e88-2591-4007-99b8-9ee442b54b9b' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer hk-your-key'

curl 'https://api.openai-hk.com/luma/generations/90254e88-2591-4007-99b8-9ee442b54b9b' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer hk-your-key'

Response body

json

{
	"data": [
		{
			"id": "cad904d3-1093-421b-9c2c-92450edf5fe6",
			"state": "completed",
			"artifact": {
				"artifact_type": "video",
				"last_frame": {
					"height": 752,
					"media_type": "image",
					"palette": null,
					"url": "https://storage.cdn-luma.com/dream-machine/c502ac30-aa05-40e6-9afc-fa4db9e615c1/9253a6d1-b78f-46ee-b4d1-754d62e0731b/video_0_last_frame.jpg",
					"width": 1360
				},
				"thumbnail": {
					"height": 752,
					"media_type": "image",
					"palette": {
						"grid": "HjAlMkxLQWBmXHx9K0E6DBYSPFRMbo6OfpSPGy0mCRIOEyIbT2xgQFhPCxYSFx8QHCQcK0AtL0AsJysbHh4XGBsWR1NMS05BNSwe"
					},
					"url": "https://imagedelivery.net/1KomXrSWiTojGGip43n0SQ/fe84f546-8e08-4b06-016f-a00447d1eb00/public",
					"width": 1360
				},
				"video": {
					"duration": 5.041667,
					"height": 752,
					"media_type": "video",
					"url": "https://storage.cdn-luma.com/dream-machine/c502ac30-aa05-40e6-9afc-fa4db9e615c1/b2a10e77-af94-41c7-a955-a34e35cc8933/watermarked_video04e84533635074d8cbde758dfe782ae8a.mp4",
					"width": 1360
				},
				"video_raw": {
					"duration": 5.041667,
					"height": 752,
					"media_type": "video",
					"url": "https://storage.cdn-luma.com/dream-machine/c502ac30-aa05-40e6-9afc-fa4db9e615c1/187b0311-2e8c-4fb6-84d9-78f0f4404d93/video04e84533635074d8cbde758dfe782ae8a.mp4",
					"width": 1360
				}
			}
		},
		{
			"id": "f0101ff1-af25-4e6a-91d0-92765c9065bb",
			"state": "completed",
			"artifact": {
				"artifact_type": "video",
				"last_frame": {
					"height": 752,
					"media_type": "image",
					"palette": null,
					"url": "https://storage.cdn-luma.com/dream-machine/5c254f53-a978-46ee-9689-742d4870c74c/ea330f60-e7b1-44d9-940b-e3af59d48dab/video_0_last_frame.jpg",
					"width": 1360
				},
				"thumbnail": {
					"height": 752,
					"media_type": "image",
					"palette": {
						"grid": "DhMTITU5YYCBS2VnDxcaEBQUGy0xXnd3PVNXCxESIzQ4PFVYlKSbXXNxFSYrGSUmJDc8e4qDVmdlDxodFh0cFCMncoeFSFtcCxQW"
					},
					"url": "https://imagedelivery.net/1KomXrSWiTojGGip43n0SQ/c5963779-230a-4abe-677e-c6e8f2177300/public",
					"width": 1360
				},
				"video": {
					"duration": 5.041667,
					"height": 752,
					"media_type": "video",
					"url": "https://storage.cdn-luma.com/dream-machine/5c254f53-a978-46ee-9689-742d4870c74c/296c1ae1-1d82-4bb2-8b7b-526b5acda110/watermarked_video0b6389c1ca8cc465f9d6be99026be8aae.mp4",
					"width": 1360
				},
				"video_raw": {
					"duration": 5.041667,
					"height": 752,
					"media_type": "video",
					"url": "https://storage.cdn-luma.com/dream-machine/5c254f53-a978-46ee-9689-742d4870c74c/567a5c0a-c3bf-4a7d-88b0-80d710e34289/video0b6389c1ca8cc465f9d6be99026be8aae.mp4",
					"width": 1360
				}
			}
		}
	],
	"status": "completed",
	"task_id": "90254e88-2591-4007-99b8-9ee442b54b9b"
}

{
	"data": [
		{
			"id": "cad904d3-1093-421b-9c2c-92450edf5fe6",
			"state": "completed",
			"artifact": {
				"artifact_type": "video",
				"last_frame": {
					"height": 752,
					"media_type": "image",
					"palette": null,
					"url": "https://storage.cdn-luma.com/dream-machine/c502ac30-aa05-40e6-9afc-fa4db9e615c1/9253a6d1-b78f-46ee-b4d1-754d62e0731b/video_0_last_frame.jpg",
					"width": 1360
				},
				"thumbnail": {
					"height": 752,
					"media_type": "image",
					"palette": {
						"grid": "HjAlMkxLQWBmXHx9K0E6DBYSPFRMbo6OfpSPGy0mCRIOEyIbT2xgQFhPCxYSFx8QHCQcK0AtL0AsJysbHh4XGBsWR1NMS05BNSwe"
					},
					"url": "https://imagedelivery.net/1KomXrSWiTojGGip43n0SQ/fe84f546-8e08-4b06-016f-a00447d1eb00/public",
					"width": 1360
				},
				"video": {
					"duration": 5.041667,
					"height": 752,
					"media_type": "video",
					"url": "https://storage.cdn-luma.com/dream-machine/c502ac30-aa05-40e6-9afc-fa4db9e615c1/b2a10e77-af94-41c7-a955-a34e35cc8933/watermarked_video04e84533635074d8cbde758dfe782ae8a.mp4",
					"width": 1360
				},
				"video_raw": {
					"duration": 5.041667,
					"height": 752,
					"media_type": "video",
					"url": "https://storage.cdn-luma.com/dream-machine/c502ac30-aa05-40e6-9afc-fa4db9e615c1/187b0311-2e8c-4fb6-84d9-78f0f4404d93/video04e84533635074d8cbde758dfe782ae8a.mp4",
					"width": 1360
				}
			}
		},
		{
			"id": "f0101ff1-af25-4e6a-91d0-92765c9065bb",
			"state": "completed",
			"artifact": {
				"artifact_type": "video",
				"last_frame": {
					"height": 752,
					"media_type": "image",
					"palette": null,
					"url": "https://storage.cdn-luma.com/dream-machine/5c254f53-a978-46ee-9689-742d4870c74c/ea330f60-e7b1-44d9-940b-e3af59d48dab/video_0_last_frame.jpg",
					"width": 1360
				},
				"thumbnail": {
					"height": 752,
					"media_type": "image",
					"palette": {
						"grid": "DhMTITU5YYCBS2VnDxcaEBQUGy0xXnd3PVNXCxESIzQ4PFVYlKSbXXNxFSYrGSUmJDc8e4qDVmdlDxodFh0cFCMncoeFSFtcCxQW"
					},
					"url": "https://imagedelivery.net/1KomXrSWiTojGGip43n0SQ/c5963779-230a-4abe-677e-c6e8f2177300/public",
					"width": 1360
				},
				"video": {
					"duration": 5.041667,
					"height": 752,
					"media_type": "video",
					"url": "https://storage.cdn-luma.com/dream-machine/5c254f53-a978-46ee-9689-742d4870c74c/296c1ae1-1d82-4bb2-8b7b-526b5acda110/watermarked_video0b6389c1ca8cc465f9d6be99026be8aae.mp4",
					"width": 1360
				},
				"video_raw": {
					"duration": 5.041667,
					"height": 752,
					"media_type": "video",
					"url": "https://storage.cdn-luma.com/dream-machine/5c254f53-a978-46ee-9689-742d4870c74c/567a5c0a-c3bf-4a7d-88b0-80d710e34289/video0b6389c1ca8cc465f9d6be99026be8aae.mp4",
					"width": 1360
				}
			}
		}
	],
	"status": "completed",
	"task_id": "90254e88-2591-4007-99b8-9ee442b54b9b"
}

When state is completed, the task is done — data[0].artifact.video_raw will contain a link
When state is failed, generation has failed
When state is error, the submission had an error

🎬 Video Model luma-v2 ​

Luma API ​

Create Video Task ​

Get Task Status ​

🎬 Video Model luma-v2

Luma API

Create Video Task

Get Task Status