happyhorse-1.1-r2v

Upload a reference image and describe the scene to create a video.

POSThttps://orux.top/api/v1/tasks

Authorization

Pass your Orux API key in the request header. Keep keys on your server.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Request body

model: happyhorse-1.1-r2v. Place model parameters inside input.

Examples use configured defaults. Replace placeholders in angle brackets with actual values.

Parameters

Fields accepted in the request body for this model.

prompttext

Required

imagesimage URL[]

Required

Count: 1 – 1

durationenum

Optional

Values: 5 / 10Default: 5

resolutionenum

Optional

Values: 720P / 1080PDefault: 720P

ratioenum

Optional

Values: 16:9 / 9:16 / 1:1Default: 16:9

Response examples

Illustrative response structures. Actual content depends on the request.

Retrieve the result

Save task_id and poll the task endpoint. An accepted task has not yet finished generating.

Open playground

Code examples

Request body

curl 'https://orux.top/api/v1/tasks' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "happyhorse-1.1-r2v",
  "input": {
    "duration": 5,
    "resolution": "720P",
    "ratio": "16:9",
    "images": [
      "https://orux.top/examples/seedream-5.0-pro-orux-brand.webp"
    ],
    "prompt": "Morning sunlight on a ceramic coffee cup on a wooden table. A gentle slow camera push, steam rising, calm cinematic lighting."
  }
}'

Swipe horizontally to view the full content

Response examples

{
  "task_id": "tk_1a2b3c4d5e6f7a8b9c0d1e2f",
  "status": "QUEUED",
  "created_at": 1755000000,
  "model": "happyhorse-1.1-r2v"
}

Swipe horizontally to view the full content

Retrieve the result

curl 'https://orux.top/api/v1/tasks/YOUR_TASK_ID' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Swipe horizontally to view the full content