Docs / video / HappyHorse 1.1 Reference to Video

HappyHorse 1.1 Reference to Video online

Generate video guided by reference images with HappyHorse 1.1 — keep characters and style consistent across shots.

Rp Mulai Rp5.460 / video Rp7.550 −27.7% happyhorse-1-1/reference-to-video model id

1 · Create a task

Kirim permintaan untuk membuat tugas generasi video. Wajib header Idempotency-Key. Saldo direservasi sebesar estimasi; task gagal tidak ditagih.

POSThttps://run.getcore.id/v1/tasks

curl -X POST https://run.getcore.id/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: my-task-001" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1-1/reference-to-video",
    "input": {
      "prompt": "[Image 1] and [Image 2] are fighting fiercely with each other with bare hands on a roof in acient China, with very fast pace.",
      "resolution": "1080p",
      "aspect_ratio": "16:9",
      "reference_image": [
        "https://example.com/input.jpg"
      ]
    }
  }'

const res = await fetch('https://run.getcore.id/v1/tasks', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Idempotency-Key': 'my-task-001',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "model": "happyhorse-1-1/reference-to-video",
    "input": {
      "prompt": "[Image 1] and [Image 2] are fighting fiercely with each other with bare hands on a roof in acient China, with very fast pace.",
      "resolution": "1080p",
      "aspect_ratio": "16:9",
      "reference_image": [
        "https://example.com/input.jpg"
      ]
    }
  }),
});
const task = await res.json();

import requests

res = requests.post(
    "https://run.getcore.id/v1/tasks",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Idempotency-Key": "my-task-001",
    },
    json={
      "model": "happyhorse-1-1/reference-to-video",
      "input": {
        "prompt": "[Image 1] and [Image 2] are fighting fiercely with each other with bare hands on a roof in acient China, with very fast pace.",
        "resolution": "1080p",
        "aspect_ratio": "16:9",
        "reference_image": [
          "https://example.com/input.jpg"
        ]
      }
    },
)
task = res.json()

Input parameters

Name	Type	Required	Description	Example
`prompt`	string	Yes	A description of the desired elements and visual style for the generated video. Input in any language is supported. The length is limited to 5,000 non-Chinese characters or 2,500 Chinese characters. Content exceeding this limit is automatically truncated. Image referencing: In the prompt, use "[Image 1]" and "[Image 2]" to refer to the corresponding reference image in the media array. The order must be consistent with the order in the media array. When using a reference, specify the object in the image, such as "the woman in a red qipao in [Image 1]". (max 5000 chars)	`[Image 1] and [Image 2] are fighting fiercely`
`duration`	integer	No	The duration of the generated video, in seconds. Value range: An integer from 3 to 15. (min 3, max 15)	`5`
`resolution`	string	No	The resolution tier of the generated video. Opsi: `720p` `1080p`	`1080p`
`aspect_ratio`	string	No	The aspect ratio of the generated video. Opsi: `16:9` `9:16` `3:4` `4:3` `4:5` `5:4` `1:1` `9:21` `21:9`	`16:9`
`reference_image`	array	Yes	The URL of a reference image. Image requirements: 1. Formats: JPEG, JPG, PNG, WEBP. 2. Resolution: The shortest side must be at least 400 pixels. A clear image with a resolution of 720P or higher is recommended. Avoid using images that are too small, blurry, or overly compressed, as this can degrade the output quality. 3. Maximum file size: 20 MB. (array of file URLs)	`https://example.com/input.jpg`

2 · Poll the result

Ambil status tugas hingga selesai — poll tiap 2–5 detik.

GEThttps://run.getcore.id/v1/tasks/{task_id}

Respons saat sukses:

{
  "id": "task_9f2c…",
  "status": "succeeded",
  "model": "happyhorse-1-1/reference-to-video",
  "price": {
    "currency": "IDR",
    "estimated": 5460,
    "reserved": 5460,
    "final": 5460
  },
  "output": {
    "urls": [
      "https://storage.getcore.id/outputs/task_9f2c…/0.mp4"
    ],
    "expires_at": "(7 hari setelah selesai)"
  }
}

Status values

Status	Keterangan
`queued`	Tugas sedang diantrikan.
`processing`	Sedang diproses.
`succeeded`	Berhasil.
`failed`	Gagal — lihat error detail, tidak ditagih.

Output bertipe video/mp4, dilayani dari CDN kami dan berlaku 7 hari — salin ke penyimpananmu sendiri untuk jangka panjang.

Best practices

Bila generation gagal, task berstatus failed dengan error.code ternormalisasi (mis. moderation_blocked, upstream_error) dan price.final = 0 — saldo dikembalikan otomatis. Daftar lengkap kode error ada di Error handling. Selalu kirim Idempotency-Key unik per tugas agar retry aman.

Coba tanpa kode: jalankan model ini langsung dari Playground atau lihat di API Market.