Skip to content

🎬 Видео модель luma-v2

  • 2024.11.26 После редизайна официального сайта luma, этот сайт теперь поддерживает luma-v2
  • Поддерживает текст-в-видео, изображение-в-видео и первый/последний кадр
  • Оплата за запрос; каждый запрос генерирует 2 видео
  • Пробная цена остается прежней; корректировки будут вноситься на основе контроля рисков в дальнейшем
  • Тело запроса по сути такое же, как в v1; тело ответа изменилось из-за возврата нескольких видео

Luma API

  • Заголовок запроса должен включать Authorization: Bearer hk-your-key
  • Конечная точка API: https://api.openai-hk.com/luma/v2
  • В следующих примерах используется relax в качестве справочного

Создание видео задачи

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":"特斯拉飞速在公路上"}'

Тело запроса

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": "特斯拉飞速在公路上"
}
ПолеТипОписание
user_promptstringТекст подсказки
image_urlstringURL начального ключевого кадра, поддерживает base64
image_end_urlstringURL конечного ключевого кадра, поддерживает base64
aspect_ratiostringСоотношение сторон видео
expand_promptbooleanРасширять ли подсказку
loopbooleanЗацикливать ли (бесшовное соединение начала и конца)

Тело ответа

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

Получение статуса задачи

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'

Тело ответа

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"
}
  • Когда state равен completed, задача завершена — data[0].artifact.video_raw будет содержать ссылку
  • Когда state равен failed, генерация не удалась
  • Когда state равен error, в отправке произошла ошибка