Luma AI - Text to Video

Generate high-quality videos from text descriptions using Luma AI's Dream Machine model. Create stunning, realistic videos with customizable length and prompt enhancement capabilities.

Endpoint

POSThttps://api.1min.ai/api/features

Request Headers

Field	Value
API-KEY	<api-key>
Content-Type	application/json

Request Parameters

Field Name	Type	Example	Description	Required
type	string	TEXT_TO_VIDEO	Feature identifier	✔️
model	string	luma	AI provider (must be "luma")	✔️
promptObject.prompt	string	a fish is swimming	Text description of the video to generate	✔️
promptObject.modelName	string	ray-v3	AI model to use (ray-v1, ray-v2, ray-v2-flash, ray-v3, ray-v3-reasoning)	✔️
promptObject.duration	string	5s	Length of video (5s or 10s)	✔️
promptObject.aspectRatio	string	16:9	Video aspect ratio (1:1, 16:9, 9:16, 4:3, 3:4, 21:9, 9:21)	❌
promptObject.resolution	string	720p	Video resolution (720p or 1080p)	❌
promptObject.loop	boolean	false	Enable video looping	❌

Code Examples

cURL

curl --location 'https://api.1min.ai/api/features' \
--header 'API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"type": "TEXT_TO_VIDEO",
"model": "luma",
"promptObject": {
  "prompt": "a majestic lion walking through golden savanna at sunset",
  "modelName": "ray-v3",
  "duration": "5s",
  "aspectRatio": "16:9",
  "resolution": "720p",
  "loop": false
}
}'

JavaScript

fetch('https://api.1min.ai/api/features', {
method: 'POST',
headers: {
  'Content-Type': 'application/json',
  'API-KEY': 'YOUR_API_KEY'
},
body: JSON.stringify({
  type: 'TEXT_TO_VIDEO',
  model: 'luma',
  promptObject: {
    prompt: 'a majestic lion walking through golden savanna at sunset',
    modelName: 'ray-v3',
    duration: '5s',
    aspectRatio: '16:9',
    resolution: '720p',
    loop: false
  }
})
})

Python

import requests

url = "https://api.1min.ai/api/features"
headers = {
"Content-Type": "application/json",
"API-KEY": "YOUR_API_KEY"
}

data = {
"type": "TEXT_TO_VIDEO",
"model": "luma",
"promptObject": {
  "prompt": "a majestic lion walking through golden savanna at sunset",
  "modelName": "ray-v3",
  "duration": "5s",
  "aspectRatio": "16:9",
  "resolution": "720p",
  "loop": False
}
}

response = requests.post(url, headers=headers, json=data)

Interactive Playground

API Playground

GETPOSTPUTDELETEhttps://api.1min.ai/api/features

AI Model *Ray V1Ray V2Ray V2 FlashRay V3Ray V3 Reasoning

Video Description *a majestic lion walking through golden savanna at sunset

Video Duration *

Choose the duration for your generated video

5 seconds10 seconds

Aspect Ratio

Choose the aspect ratio for your video

1:1 (Square)16:9 (Landscape)9:16 (Portrait)4:33:421:9 (Ultrawide)9:21

Resolution

Choose the resolution for your video

720p1080p

Loop Video

Enable seamless video looping

YesNo

Generated cURL Command:

curl -X POST "https://api.1min.ai/api/features" \
  -H "API-KEY: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "TEXT_TO_VIDEO",
  "model": "luma",
  "promptObject": {
    "prompt": "a majestic lion walking through golden savanna at sunset",
    "modelName": "ray-v3",
    "duration": "5s",
    "aspectRatio": "16:9",
    "resolution": "720p",
    "loop": false
  }
}'

Response

{
"aiRecord": {
  "uuid": "06e92293-ee32-47d7-85f2-fd4b59482b91",
  "userId": "2f57c2a4-1fff-48e7-972f-3c1d6c59bced",
  "teamId": "eb48d89f-1bb7-4d82-9b25-481971a0e97a",
  "teamUser": {
    "teamId": "eb48d89f-1bb7-4d82-9b25-481971a0e97a",
    "userId": "2f57c2a4-1fff-48e7-972f-3c1d6c59bced",
    "userName": "Jon",
    "userAvatar": "https://lh3.googleusercontent.com/a/ACg8ocLqgsNsHRfmWF9d-E1RvJetVsEzxNOsOg-NXWNTpMxLDPJbwELI=s96-c",
    "status": "ACTIVE",
    "role": "ADMIN",
    "creditLimit": 100000000,
    "usedCredit": 12472338,
    "createdAt": "2025-11-25T11:04:08.620Z",
    "createdBy": "SYSTEM",
    "updatedAt": "2025-11-26T08:26:25.461Z",
    "updatedBy": "SYSTEM"
  },
  "model": "luma",
  "type": "TEXT_TO_VIDEO",
  "metadata": null,
  "rating": null,
  "feedback": null,
  "conversationId": null,
  "status": "SUCCESS",
  "createdAt": "2025-11-26T08:29:05.973Z",
  "aiRecordDetail": {
    "promptObject": {
      "loop": false,
      "prompt": "a majestic lion walking through golden savanna at sunset",
      "duration": "5s",
      "modelName": "ray-v3",
      "resolution": "720p",
      "aspectRatio": "16:9"
    },
    "resultObject": [
      "development/videos/2025_11_26_15_36_08_840_865624.mp4"
    ],
    "responseObject": {}
  },
  "additionalData": null,
  "temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/videos/2025_11_26_15_36_08_840_865624.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAVRUVQEFIHSKAXGE7%2F20251126%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20251126T083634Z&X-Amz-Expires=604800&X-Amz-Signature=0b2c9d3101848945f3718e616bb7bd016389b6939894671b62b6bd2327e5c444&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"
}
}