🎬 Видео модель luma
- 2024.06.24 Этот сайт теперь поддерживает видео модель
luma - У
lumaнет официального API; оно получено методом обратной разработки, аналогично GPTs - Поддерживает
text-to-videoиimage-to-video - Тарификация за генерацию, одно видео за запрос
- Два ценовых уровня:
relaxиpro— см. Версии эндпоинтов - По умолчанию
relax(с водяным знаком, требуется очередь);proбез водяного знака и без очереди - Как использовать: посетите https://luma.ddaiai.com и см. раздел
Онлайн тестниже
Онлайн тест 1. Посетите https://luma.ddaiai.com (если заблокирован, попробуйте изменить префикс поддомена на suibian)
2. Если заблокирован, вы можете изменить адрес самостоятельно: https://suibian.ddaiai.com — замените suibian на что-то другое, например https://2024.ddaiai.com, все работают
Версии эндпоинтов
- Версия relax по умолчанию: https://api.openai-hk.com/luma
- Версия Pro: https://api.openai-hk.com/pro/luma
- Оба режима тарифицируются по ставке pro
- 2024.10.9 режим relax прекращен (luma больше не предоставляет его); тарификация по
Настройка
- Откройте https://luma.ddaiai.com
- Настройте поля, показанные на изображении ниже
- luma API эндпоинт: https://api.openai-hk.com
- luma pro API эндпоинт: https://api.openai-hk.com/pro
- Luma KEY: hk-your-apiKey

Результат
Пример вывода 
Luma API
- Заголовок запроса должен включать
Authorization: Bearer hk-your-key - эндпоинт версии relax: https://api.openai-hk.com/luma
- эндпоинт версии pro: https://api.openai-hk.com/pro/luma
- Следующие примеры используют версию relax
Создать задачу видео
shell
curl 'https://api.openai-hk.com/luma/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/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": "特斯拉飞速在公路上",
"resolution": "720p",
"duration": "5s",
"model_name": "ray-v1"
}{
"aspect_ratio": "16:9",
"expand_prompt": true,
"loop": false,
"image_url": "",
"image_end_url": "",
"user_prompt": "特斯拉飞速在公路上",
"resolution": "720p",
"duration": "5s",
"model_name": "ray-v1"
}| Поле | Тип | Описание |
|---|---|---|
| user_prompt | string | Текст промпта |
| image_url | string | URL начального изображения ключевого кадра, поддерживает base64 |
| image_end_url | string | URL конечного изображения ключевого кадра, поддерживает base64 |
| aspect_ratio | string | Соотношение сторон видео |
| expand_prompt | boolean | Расширять ли промпт |
| loop | boolean | Зацикливать ли (плавный переход от конца к началу) |
| resolution | string | 720p или 1080p, по умолчанию 720p |
| duration | string | Продолжительность: 5s или 10s |
| model_name | string | Модель: ray-v1 ray-v2 ray-v3 (официально показаны как ray1.6 ray2 ray3) |
Тело ответа
json
{
"created_at": "2024-06-24T03:40:47.505420Z",
"estimate_wait_seconds": "",
"id": "50deb9e0-d135-4173-a530-82ed3449a7b9",
"liked": "",
"prompt": "特斯拉飞速在公路上",
"state": "pending",
"video": {
"height": 0,
"thumbnail": "",
"url": "",
"download_url": "",
"width": 0
}
}{
"created_at": "2024-06-24T03:40:47.505420Z",
"estimate_wait_seconds": "",
"id": "50deb9e0-d135-4173-a530-82ed3449a7b9",
"liked": "",
"prompt": "特斯拉飞速在公路上",
"state": "pending",
"video": {
"height": 0,
"thumbnail": "",
"url": "",
"download_url": "",
"width": 0
}
}Продлить видео (extend)
shell
curl 'https://api.openai-hk.com/luma/generations/50deb9e0-d135-4173-a530-82ed3449a7b9/extend' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer hk-你的key' \
--data '{ "expand_prompt":true,"image_url":"","user_prompt":"后面跟着一辆卡车"}'curl 'https://api.openai-hk.com/luma/generations/50deb9e0-d135-4173-a530-82ed3449a7b9/extend' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer hk-你的key' \
--data '{ "expand_prompt":true,"image_url":"","user_prompt":"后面跟着一辆卡车"}'Тело запроса
json
{
"expand_prompt": true,
"loop": false,
"image_url": "",
"image_end_url": "",
"user_prompt": "后面跟着一辆卡车"
}{
"expand_prompt": true,
"loop": false,
"image_url": "",
"image_end_url": "",
"user_prompt": "后面跟着一辆卡车"
}| Поле | Тип | Описание |
|---|---|---|
| image_url | string | URL начального изображения ключевого кадра, поддерживает base64 |
| image_end_url | string | URL конечного изображения ключевого кадра, поддерживает base64 |
| aspect_ratio | string | Соотношение сторон видео |
| expand_prompt | boolean | Расширять ли промпт |
| loop | boolean | Зацикливать ли (плавный переход от конца к началу) |
Тело ответа
json
{
"created_at": "2024-06-24T03:40:47.505420Z",
"estimate_wait_seconds": "",
"id": "50deb9e0-d135-4173-a530-82ed3449a7b9",
"liked": "",
"prompt": "特斯拉飞速在公路上",
"state": "pending",
"video": {
"height": 0,
"thumbnail": "",
"url": "",
"download_url": "",
"width": 0
}
}{
"created_at": "2024-06-24T03:40:47.505420Z",
"estimate_wait_seconds": "",
"id": "50deb9e0-d135-4173-a530-82ed3449a7b9",
"liked": "",
"prompt": "特斯拉飞速在公路上",
"state": "pending",
"video": {
"height": 0,
"thumbnail": "",
"url": "",
"download_url": "",
"width": 0
}
}Получить URL видео без водяного знака
- Поддерживается только в pro версии
- Версия relax также может вызвать этот эндпоинт, но видео все равно будет с водяным знаком
- Возвращаемый URL имеет срок действия — загрузите и сохраните файл своевременно
get https://api.openai-hk.com/pro/luma/generations/{id}/download_video_url
shell
curl 'https://api.openai-hk.com/luma/generations/50deb9e0-d135-4173-a530-82ed3449a7b9/download_video_url' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer hk-your-key'curl 'https://api.openai-hk.com/luma/generations/50deb9e0-d135-4173-a530-82ed3449a7b9/download_video_url' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer hk-your-key'Тело ответа
json
{
"url": "https://dc53a917a6f427706a8ca3ecc7d70ea4.r2.cloudflarestorage.com/ai-lumalabs-storage-private/lit_lite_inference_im2vid_v1.0/410586f1-f2b9-447a-9651-66e502cf10da/410586f1-f2b9-447a-9651-66e502cf10da_raw_video_1_video0593ab596eb51488a8f5e00fcb5401b93.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=60bf44f30d45b472f9dd032de33e15d1%2F20240630%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20240630T165615Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=205ac50f173f7f6b260bc5026b9f6b3719c7c690f27fccec8cce0b4b43491750"
}{
"url": "https://dc53a917a6f427706a8ca3ecc7d70ea4.r2.cloudflarestorage.com/ai-lumalabs-storage-private/lit_lite_inference_im2vid_v1.0/410586f1-f2b9-447a-9651-66e502cf10da/410586f1-f2b9-447a-9651-66e502cf10da_raw_video_1_video0593ab596eb51488a8f5e00fcb5401b93.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=60bf44f30d45b472f9dd032de33e15d1%2F20240630%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20240630T165615Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=205ac50f173f7f6b260bc5026b9f6b3719c7c690f27fccec8cce0b4b43491750"
}Получить статус задачи
shell
curl 'https://api.openai-hk.com/luma/generations/50deb9e0-d135-4173-a530-82ed3449a7b9' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer hk-your-key'curl 'https://api.openai-hk.com/luma/generations/50deb9e0-d135-4173-a530-82ed3449a7b9' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer hk-your-key'Тело ответа
json
{
"created_at": "2024-06-24T03:40:47.505420Z",
"estimate_wait_seconds": "",
"id": "50deb9e0-d135-4173-a530-82ed3449a7b9",
"liked": "",
"prompt": "特斯拉飞速在公路上",
"state": "processing",
"video": {
"height": 0,
"thumbnail": "",
"url": "",
"download_url": "pro版本无水印在这个地址, 注意保存这个地址可能过期失效",
"width": 0
}
}{
"created_at": "2024-06-24T03:40:47.505420Z",
"estimate_wait_seconds": "",
"id": "50deb9e0-d135-4173-a530-82ed3449a7b9",
"liked": "",
"prompt": "特斯拉飞速在公路上",
"state": "processing",
"video": {
"height": 0,
"thumbnail": "",
"url": "",
"download_url": "pro版本无水印在这个地址, 注意保存这个地址可能过期失效",
"width": 0
}
}- Когда
stateравенcompleted, задача выполнена —video.download_urlбудет содержать ссылку - Когда
stateравенfailed, генерация не удалась - Различия между версиями pro и relax:
- Видео по адресу
download_urlбез водяного знака; обратите внимание, что этот URL может истечь - pro версия не требует ожидания в очереди
- Видео по адресу
OpenAi-HK