# Luma Ray Flash 2 720p - Core.Today AI API

> Luma's Ray Flash 2 generates 5 or 9 second 720p videos faster and cheaper than Ray 2. Supports keyframe control via start and end images, seamless loops, and a rich library of camera motion concepts — the first Luma model on the platform.

- **Provider**: Luma
- **Model ID**: luma/ray-flash-2-720p
- **Category**: Video Generation
- **Credits**: 700 per 5s video — billed at 140 credits/second; duration is 5 or 9 seconds (9s = 1260)
- **Speed**: Fast
- **Quality**: High

## Features
- Faster and cheaper than Ray 2 at 720p output
- Keyframe control: anchor the first frame (start_image) and last frame (end_image)
- Loop option for seamless, continuously repeating playback
- 34 camera motion concepts (orbit, dolly zoom, aerial drone, crane, and more)
- 7 aspect ratios from 1:1 to ultrawide 21:9

## Use Cases
- Seamless looping backgrounds for websites and digital signage
- Keyframed transitions between two brand images or product shots
- Cinematic camera moves (orbit, crane, dolly zoom) without a film crew
- Image-to-video animation anchored on a start frame
- Ultrawide 21:9 clips for hero banners and trailers

## API Endpoint

Base URL: https://api.core.today/v1
Create Prediction: POST /predictions
Get Status: GET /predictions/{job_id}

## Authentication
Header: X-API-Key: YOUR_API_KEY

## Input Parameters

### Required
- **prompt**: string - Text prompt for video generation

### Optional
- **loop**: boolean (default: false) - Whether the video should loop, with the last frame matching the first frame for smooth, continuous playback
- **concepts**: array - List of camera concepts to apply, e.g. orbit_left, dolly_zoom, aerial_drone, crane_up, push_in, handheld, tiny_planet (34 total)
- **duration**: integer (default: 5) - Duration of the video in seconds
  Options: 5, 9
- **end_image**: string - An optional last frame of the video to use as the ending frame
- **start_image**: string - An optional first frame of the video to use as the starting frame
- **aspect_ratio**: string (default: 16:9) - Aspect ratio of the generated video
  Options: 1:1, 3:4, 4:3, 9:16, 16:9, 9:21, 21:9
- **end_image_url**: string - Deprecated: Use end_image instead
- **start_image_url**: string - Deprecated: Use start_image instead

## Examples

### Cinematic Anime Close-up (5s)
Text-to-video at the default 5 second duration — 450 credits
```json
{
  "model": "luma/ray-flash-2-720p",
  "input": {
    "loop": false,
    "prompt": "A cinematic anime character intimate closeup, she is sitting at a cafe on a busy city street in the morning, it is cold",
    "duration": 5,
    "aspect_ratio": "16:9"
  }
}
```

### Seamless Loop with Camera Orbit
A looping clip with an orbiting camera concept, ideal for background video
```json
{
  "model": "luma/ray-flash-2-720p",
  "input": {
    "prompt": "A glass terrarium with a miniature rainforest inside, soft mist drifting between tiny trees",
    "loop": true,
    "duration": 5,
    "aspect_ratio": "1:1",
    "concepts": [
      "orbit_left"
    ]
  }
}
```

## Response Format
```json
{
  "job_id": "abc123",
  "status": "pending | processing | completed | failed",
  "result": "URL or data (when completed)"
}
```

## Usage Flow
1. POST /predictions with model and input -> receive job_id
2. GET /predictions/{job_id} -> poll until status is completed or failed
3. Result contains output URL(s)

## Tips
- Billing is 90 credits/second: a 5s clip costs 450 and a 9s clip costs 810 — default to 5s unless you truly need the longer cut
- Use start_image and end_image together for keyframed transitions between two specific frames
- Enable loop for background videos — the last frame matches the first for seamless playback
- concepts gives you precise camera language (dolly_zoom, crane_up, aerial_drone) that is hard to reach with prompts alone
- Use start_image/end_image, not the deprecated start_image_url/end_image_url fields

## Documentation
https://replicate.com/luma/ray-flash-2-720p