Skip to main content
POST
/
v1
/
ai
/
text-to-video
/
happy-horse-1
Happy Horse 1.0 - Create video from text
curl --request POST \
  --url https://api.magnific.com/v1/ai/text-to-video/happy-horse-1 \
  --header 'Content-Type: application/json' \
  --header 'x-magnific-api-key: <api-key>' \
  --data '
{
  "prompt": "A serene mountain landscape at golden hour with mist rising through the valley, cinematic slow camera pan",
  "webhook_url": "https://www.example.com/webhook",
  "aspect_ratio": "16:9",
  "resolution": "1080P",
  "duration": 5,
  "seed": 12345
}
'
{
  "data": {
    "generated": [],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "CREATED"
  }
}

Authorizations

​
x-magnific-api-key
string
header
required

Your Magnific API key. Required for authentication. Learn how to obtain an API key

Body

application/json

Generate video from a text prompt using Happy Horse 1.0. Supports configurable aspect ratios (16:9, 9:16, 1:1, 4:3, 3:4), resolutions (720P, 1080P), and duration from 3 to 15 seconds.

​
prompt
string
required

Text prompt describing the desired video content. Describe the scene, characters, motion, camera movements, lighting, and style in detail for best results.

Tips:

  • Be specific about scenes and visual details
  • Describe camera movements (zoom, pan, tilt)
  • Mention lighting and atmosphere
Required string length: 1 - 2500
Example:

"A serene mountain landscape at golden hour with mist rising through the valley, cinematic slow camera pan"

​
webhook_url
string<uri>

Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.

Example:

"https://www.example.com/webhook"

​
aspect_ratio
enum<string>
default:16:9

Output video aspect ratio:

  • 16:9: Landscape (widescreen)
  • 9:16: Portrait (vertical, mobile-optimized)
  • 1:1: Square
  • 4:3: Standard landscape
  • 3:4: Standard portrait
Available options:
16:9,
9:16,
1:1,
4:3,
3:4
​
resolution
enum<string>
default:1080P

Output video resolution:

  • 720P: 720p HD (1280x720)
  • 1080P: 1080p Full HD (1920x1080)
Available options:
720P,
1080P
​
duration
enum<integer>
default:5

Duration of the generated video in seconds. One of: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15.

Available options:
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
​
seed
integer

Random seed for reproducibility. Use the same seed with identical parameters to improve reproducibility (does not guarantee identical results). Leave unset for a random seed.

Required range: 0 <= x <= 2147483647
Example:

12345

Response

OK - The task exists and the status is returned

​
data
object
required
Example:
{
  "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
  "status": "CREATED",
  "generated": [
    "https://openapi-generator.tech",
    "https://openapi-generator.tech"
  ]
}