HappyHorse API Belgeleri

HappyHorse 1.0 Video Oluşturma API’sini uygulamalarınıza entegre etmek için eksiksiz kılavuz.

API v1.0 Base URL: https://happyhorse.app

Hızlı başlangıç

bash

curl -X POST 'https://happyhorse.app/api/generate' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "happyhorse-1.0/video",
    "prompt": "A cinematic shot of mountains at sunrise",
    "mode": "pro",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

Kimlik doğrulama

Tüm API istekleri Authorization başlığında Bearer jetonu gerektirir.

API anahtarınızı alın: API anahtarınızı kontrol panelindeki API Keys sayfasından alabilirsiniz. → API anahtarınızı alın

http

Authorization: Bearer YOUR_API_KEY

Kullanılabilir modeller

HappyHorse 1.0

HappyHorse ile yüksek kaliteli yapay zekâ video üretimi

Tür	Açıklama	Süre	Kredi
`pro (text-to-video)`	Pro kalite metinden videoya	3-15s	54/s (no audio) · 80/s (with audio)
`pro (image-to-video)`	Pro kalite görüntüden videoya	3-15s	54/s (no audio) · 80/s (with audio)
`std (text-to-video)`	Standart kalite metinden videoya	3-15s	40/s (no audio) · 60/s (with audio)
`std (image-to-video)`	Standart kalite görüntüden videoya	3-15s	40/s (no audio) · 60/s (with audio)

API uç noktaları

Yeni bir video oluşturma görevi başlatır. model alanı 'happyhorse-1.0/video' olmalıdır.

İstek gövdesi

Gövde parametreleriJSON

model:string

Model adı; 'happyhorse-1.0/video' olmalıdır

prompt:optional string

Oluşturulacak videonun metin açıklaması (en fazla 2500 karakter). multi_shots true ise zorunlu değil.

mode:optional string

Kalite modu: 'pro' veya 'std' (varsayılan: std) Defaults to std.

duration:optional number

Video süresi saniye cinsinden (3–15, varsayılan: 5) Defaults to 5.

aspect_ratio:optional string

Çıkış en-boy oranı (16:9, 9:16, 1:1) Defaults to 16:9.

image_urls:optional string[]

Görüntüden videoya görevleri için görüntü URL dizisi

sound:optional boolean

Yerel ses üretimini etkinleştir (varsayılan: true) Defaults to true.

cfg_scale:optional number

İstem bağlılığı (0-1, varsayılan: 0.5). Yüksek değerler isteme daha sadık kalır. Defaults to 0.5.

multi_shots:optional boolean

Birden fazla istemle çok planlı mod Defaults to false.

multi_prompt:optional array

Çok planlı mod için 'prompt, duration' nesne dizisi

happyhorse_elements:optional array

Eleman nesneleri dizisi. Istemde ilgili elemanin name degerinin basina @ yazin (or. name 'element_dog' → @element_dog). Her eleman: name, description, element_input_urls (2-4 gorsel URL). Gorev basina en fazla 3 eleman.

Metinden videoya

json

{
  "model": "happyhorse-1.0/video",
  "prompt": "A majestic eagle soaring through clouds at sunset",
  "mode": "pro",
  "duration": 5,
  "aspect_ratio": "16:9",
  "sound": true
}

Görüntüden videoya

json

{
  "model": "happyhorse-1.0/video",
  "prompt": "The character slowly turns and smiles",
  "mode": "pro",
  "image_urls": ["https://example.com/my-image.jpg"],
  "duration": 5
}

Çok planlı video

json

{
  "model": "happyhorse-1.0/video",
  "mode": "pro",
  "multi_shots": true,
  "multi_prompt": [
    { "prompt": "A woman walks into a coffee shop", "duration": 3 },
    { "prompt": "She orders a latte and sits by the window", "duration": 4 },
    { "prompt": "She looks outside and smiles", "duration": 3 }
  ],
  "aspect_ratio": "16:9"
}

Yanıtlar

Task created successfully

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n92abc123hh10",
    "status": "IN_PROGRESS"
  }
}

generate uç noktasının döndürdüğü task_id ile video oluşturma durumunu kontrol eder.

Sorgu parametreleri

task_id:string

generate’ın döndürdüğü benzersiz görev kimliği (n92 öneki)

Örnek istek

bash

curl -X GET 'https://happyhorse.app/api/status?task_id=n92abc123hh10' \
  -H 'Authorization: Bearer YOUR_API_KEY'

İpucu: response alanı resultUrls dizisini içerir. Video URL’si için data.response.resultUrls[0] kullanın.

javascript

// Extract video URL from response
const videoUrl = data.response.resultUrls[0];

Yanıtlar

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n92abc123hh10",
    "status": "SUCCESS",
    "consumed_credits": 400,
    "created_at": "2026-04-08T10:30:00Z",
    "type": "text-to-video",
    "request": {
      "model": "happyhorse-1.0/video",
      "prompt": "A majestic eagle soaring through clouds at sunset",
      "mode": "pro",
      "duration": 5,
      "aspect_ratio": "16:9"
    },
    "response": {
      "resultUrls": [
        "https://cdn.example.com/videos/abc123.mp4"
      ]
    },
    "error_message": null
  }
}

API oyun alanı

API’yi doğrudan tarayıcıdan test edin. YOUR_API_KEY’i gerçek anahtarınızla değiştirin.

API oyun alanıPOST

Temel URL

Uç nokta

Başlıklar

İstek gövdesi

Hata kodları

HTTP durumu	Kod	Açıklama
400 Hatalı istek	INVALID_PROMPT	İstem geçersiz veya boş
400 Hatalı istek	INVALID_DURATION	Süre desteklenen aralığın dışında (3–15 sn)
400 Hatalı istek	INVALID_MODEL	Model 'happyhorse-1.0/video' olmalıdır
401 Yetkisiz	INVALID_API_KEY	API anahtarı eksik veya geçersiz
402 Ödeme gerekli	INSUFFICIENT_CREDITS	Bu işlem için yeterli kredi yok
429 Çok fazla istek	RATE_LIMITED	Çok fazla istek; lütfen yavaşlayın
500 Sunucu hatası	INTERNAL_ERROR	Sunucu hatası; daha sonra tekrar deneyin