Gunakan HappyHorse 1.1 melalui Rivya Public API v1 dengan ID model happyhorse-1-1, input disokong, parameter, peraturan Files API, kredit dan contoh respons.

Tersedia melalui APITeks atau URL sedia; mod rujukan menggunakan Files APIVideo

ID model API

happyhorse-1-1

Input

text, file

Files API

Diperlukan untuk mod rujukan

Kredit asas

per_output_second · 720p=22.5 · 1080p=29 · ⌈total⌉

Keupayaan

Video

Bil

METERED

Had prompt

5000 aksara

Kontrak permintaan

Hantar ID model pada peringkat atas. Kawalan khusus model berada dalam params.

Kunci	Jenis	Wajib	Lalai	Penerangan
model	string	Ya	happyhorse-1-1	Gunakan ID model API happyhorse-1-1.
prompt	string	Tidak	-	Maksimum 5000 aksara untuk model ini.
params	object	Tidak	-	Objek parameter khusus model. Gunakan baris di bawah untuk kunci yang dibenarkan.
client_request_id	string	Tidak	-	ID sisi klien pilihan untuk menjejak permintaan dalam sistem anda.

Parameter model

Kunci	Jenis	Wajib	Lalai	Julat	Pilihan	Penerangan
resolution	select	Tidak	1080p	-	720p, 1080p	Resolusi yang dipilih menetapkan kadar kredit sesaat.
aspect_ratio	select	Tidak	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9	Digunakan untuk larian berasaskan prompt sahaja dan berbilang rujukan; larian satu imej mengikut bingkai pertamanya.
duration	number	Tidak	5	min 3 / max 15 / step 1	-	Pilih tempoh output nombor bulat dari 3 hingga 15 saat.

Polisi muat naik

Muat naik fail rujukan dahulu, kemudian letakkan URL dan token durasi yang dikembalikan dalam params.referenceMediaItems.

Peraturan rujukan

Bingkai pertama atau imej rujukan: Muat naik satu imej JPEG, PNG atau WebP untuk animasi bingkai pertama, atau 2 hingga 9 imej untuk video berpandukan rujukan. Setiap fail boleh bersaiz sehingga 20 MB.

Fail maksimum

Jenis fail diterima

image

Token durasi

Rujukan video dan audio patut membawa durationToken daripada /api/v1/files apabila pengesahan durasi diperlukan.

kind	Saiz maksimum	Jenis MIME
image	20 MB	image/jpeg, image/png, image/webp

Permintaan minimum

{
  "model": "happyhorse-1-1",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5
  }
}

Permintaan fail rujukan

{
  "model": "happyhorse-1-1",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      }
    ]
  }
}

Respons cipta

Endpoint cipta mengembalikan ID tugasan awam. Semak endpoint status sehingga tugasan berjaya atau gagal.

{
  "id": "task_happyhorse_1_1_example",
  "status": "queued",
  "model": "happyhorse-1-1",
  "reserved_credits": 145,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Ralat biasa

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Sesetengah mod memerlukan muat naik rujukan Files API.

Integrasi API HappyHorse 1.1