API — Tulossa pian

Happyhorse-1.0 API-käyttöoikeus

Käytön mukaan · Ei tilausta · Käytä omassa sovelluksessasi

Happyhorse-1.0 REST API on tulossa. Vaikka suora Happyhorse API -käyttö on vielä suljetussa esikatselussa, voit luoda videoita jo nyt verkossa — sama malli, sama laatu, maksat vain käytöstäsi.

Käytä Happyhorse-1.0:aa verkossa — API-avainta ei tarvita

happyhorse API -avainjärjestelmä on kehitteillä, mutta malli on jo käytössä. Osta krediittejä, luo 4K-video sivustolla ja lataa — täysi kaupallinen lisenssi sisältyy. Kun REST API julkaistaan, krediittisi siirtyvät automaattisesti.

01

Osta krediittejä

Kertamaksu, ei tilausta. Krediitit toimivat sekä web-sovelluksessa että tulevissa happyhorse API -kutsuissa ja ComfyUI-solmussa.

02

Luo video

Syötä promptisi Happyhorse-1.0 Labissa. Sama malli, joka toimii REST API:n pohjana — daVinci-MagiHuman-arkkitehtuuri, natiivi 4K.

03

Lataa ja julkaise

MP4-tulos 100 %:n kaupallisella IP-omistuksella. Kun happy horse API -päätepiste julkaistaan, lisää avaimen ja automatisoi sama työnkulku.

Miten API toimii

Happyhorse-1.0 REST API noudattaa yksinkertaista asynkronista pyyntö–kyselymallia. Tunnistaudu happyhorse API -avaimellasi, lähetä työ ja hae tulos, kun se on valmis. Alla on esikatselu happyhorse-1.0 API -integraatiosta.

01

Tunnistaudu

Lisää happyhorse API -avaimesi Authorization-otsakkeeseen. Avaimet on rajattu työtilakohtaisesti, ja nopeusrajoitukset määräytyvät suunnitelman mukaan.

02

Lähetä työ

POSTaa promptisi ja parametrit /v1/generate-päätepisteeseen. Happyhorse API -päätepiste palauttaa job_id:n välittömästi.

03

Kysy tilaa

Tarkista eteneminen kutsulla GET /v1/jobs/{job_id}. Kun status on completed, vastaus sisältää allekirjoitetun video-URL:n, joka on voimassa 24 tuntia.

04

Lataa ja käytä

Lataa MP4-tulos tai suoratoista se suoraan. Krediittejä vähennetään vain onnistuneesta luomisesta — epäonnistuneita töitä ei veloiteta koskaan.

curl — Lähetä videon luontityö

bash
curl -X POST https://api.happyhorselab.net/v1/generate \
  -H "Authorization: Bearer hh_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A lone astronaut walks across a red desert at golden hour, cinematic 4K",
    "resolution": "4K",
    "duration": 8,
    "motion_strength": 0.7,
    "fps": 24
  }'

Python — Täydellinen integraatioesimerkki

python
import requests
import time

API_KEY = "hh_xxxxxxxxxxxxxxxxxxxx"
BASE_URL = "https://api.happyhorselab.net/v1"

# Submit generation job
response = requests.post(
    f"{BASE_URL}/generate",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "prompt": "A lone astronaut walks across a red desert at golden hour",
        "resolution": "4K",
        "duration": 8,
        "motion_strength": 0.7,
        "fps": 24,
    },
)
job_id = response.json()["job_id"]

# Poll until complete
while True:
    status = requests.get(
        f"{BASE_URL}/jobs/{job_id}",
        headers={"Authorization": f"Bearer {API_KEY}"},
    ).json()
    if status["status"] == "completed":
        print("Video URL:", status["output_url"])
        break
    elif status["status"] == "failed":
        print("Generation failed:", status["error"])
        break
    time.sleep(5)

Hinnoittelu ja krediitit

Happyhorse API -käyttö perustuu samaan krediittijärjestelmään kuin sivusto — ei erillistä tilausta eikä käyttäjäpaikkamaksuja. Tänään ostetut krediitit toimivat web-sovelluksessa ja siirtyvät lanseerauksen yhteydessä happyhorse API:n käytön mukaan laskutettavaan malliin.

Standard

Alkaen noin 0,10 $ / video

1080p, enintään 8 s, standardijono. Ihanteellinen prototypointiin ja Happy Horse AI Video API:n arviointiin.

Most Popular

Pro

Alkaen noin 0,25 $ / video

Natiivi 4K, enintään 16 s, prioriteettijono. Suunniteltu tuotantokäyttöön — Happyhorse API:n käytön mukaan laskutettava malli skaalautuvasti.

Enterprise

Räätälöity hinnoittelu

Volyymialennukset, SLA-takuut, dedikoidut päätepisteet sekä happyhorse API -avainten hallinta tiimien välillä.

Sivustolta ostetut krediitit ovat täysin vaihdettavissa tuleviin API-krediitteihin. Erillistä happyhorse API -hinnoittelutasoa ei ole — maksat vain siitä, mitä luot.

Krediitit eivät vanhene, kunhan tilisi pysyy aktiivisena.

API-päätepisteet (esikatselu)

Happyhorse-1.0 REST API tarjoaa kohdennetun joukon päätepisteitä videon luontiin ja työnhallintaan. Täydellinen happyhorse-1.0 API-dokumentaatio julkaistaan julkaisun yhteydessä.

POST/v1/generate

Lähetä teksti-videoksi- tai kuva-videoksi-luontityö. Palauttaa job_id-tunnisteen tilan kyselyä varten.

ParameterTypeRequiredDescription
promptstringrequiredVideon tekstikuvaus.
resolutionstringoptional"1080p" (oletus) tai "4K". 4K vaatii Pro-krediittejä.
durationintegeroptionalVideon pituus sekunteina. Vaihteluväli: 2–16. Oletus: 8.
motion_strengthfloatoptionalLiikkeen voimakkuus 0,0–1,0. Oletus: 0,6.
fpsintegeroptionalKuvia sekunnissa: 24 tai 30. Oletus: 24.
seedintegeroptionalToistettavuuden siemenarvo. Jätä pois satunnaista varten.
GET/v1/jobs/{job_id}

Kysy luontityön tila. Palauttaa tilan, etenemisen ja output_url-osoitteen, kun työ on valmis.

GET/v1/credits

Tarkista jäljellä olevien happyhorse API -krediittien saldo ja käyttöhistoria.

GET/v1/models

Listaa saatavilla olevat mallit ja niiden parametrien vaihteluvälit. Tällä hetkellä tarjoaa happyhorse-1.0:n.

Esimerkkivastaus — valmis työ

json
{
  "job_id": "job_01HZ9X3K7VQWPN8S4TYJB6MDE",
  "status": "completed",
  "model": "happyhorse-1.0",
  "created_at": "2025-06-01T14:22:10Z",
  "completed_at": "2025-06-01T14:23:48Z",
  "credits_used": 25,
  "output_url": "https://cdn.happyhorselab.net/out/job_01HZ9X3K7VQWPN8S4TYJB6MDE.mp4",
  "output_url_expires_at": "2025-06-02T14:23:48Z",
  "metadata": {
    "resolution": "4K",
    "duration": 8,
    "fps": 24,
    "motion_strength": 0.7
  }
}

UKK

Yleisiä kysymyksiä Happyhorse API -käytöstä, krediiteistä ja integraatiosta.

1

Miten saan Happyhorse API -avaimen?

Happyhorse API -avaimet ovat tällä hetkellä yksityisessä esikatselussa. Siihen asti voit käyttää verkkosovellusta osoitteessa happyhorselab.net — sama malli, sama laatu. Osta krediittejä hinnoittelusivulta ja aloita generointi heti. API-avaimet tulevat näkyviin hallintapaneeliin, kun suora pääsy julkaistaan.

2

Onko Happyhorse-1.0 API yhteensopiva ComfyUI:n kanssa?

Kyllä. Virallinen Happyhorse ComfyUI -custom node käyttää taustalla samaa REST APIa. Verkkosovellukseen ostetut krediitit ovat vaihdettavissa ComfyUI-integraation kanssa. Katso asennusohjeet oppaastamme /comfyui.

3

Mitkä ovat nopeusrajat?

Nopeusrajat riippuvat krediittisuunnitelmastasi. Vakiokäyttö alkaa 10 samanaikaisesta työstä ja 500 pyynnöstä minuutissa. Yrityssuunnitelmat tarjoavat räätälöidyt rajat, omistetut päätepisteet ja SLA-takuut — ota yhteyttä Happyhorse API -yrityshinnoittelua varten.

4

Onko yritys- tai white label -API-käyttö saatavilla?

Kyllä. Yritysasiakkaat voivat pyytää omistettuja inferenssipäätepisteitä, volyymikrediittipaketteja, räätälöityjä SLA:eja sekä mallin yksityistä hienosäätöä. Ota yhteyttä hinnoittelusivun kautta, niin palaamme asiaan räätälöidyllä ehdotuksella.

5

Vanhenevatko Happyhorse API -krediitit?

happyhorselab.netissä ostetut krediitit eivät vanhene, kunhan tilisi pysyy aktiivisena (vähintään yksi kirjautuminen 365 päivän aikana). Sama Happyhorse API -krediittikäytäntö pätee riippumatta siitä, käytätkö niitä verkkosovelluksen, API:n vai ComfyUI-noden kautta.

6

Mitä ohjelmointikieliä Happyhorse API tukee?

Happyhorse-1.0 REST API on tavallinen HTTP API — mikä tahansa kieli käy: Python, Node.js, Go, Ruby, PHP, Java, Rust ja muut. Viralliset SDK:t Pythonille ja TypeScriptille on suunnitteilla julkaisun yhteydessä. Siihen asti käytä mitä tahansa HTTP-klienttiä ja lisää happyhorse API -avaimesi Authorization-otsakkeeseen.

Rakenna #1-videomallilla — jo tänään

Älä odota API:a. Käytä Happyhorse-1.0:aa verkossa nyt, maksa per krediitti, ja saldo siirtyy automaattisesti, kun REST API julkaistaan.