API — In arrivo

Accesso API Happyhorse-1.0

Pay-as-you-go · Nessun abbonamento · Usalo nella tua app

La REST API di Happyhorse-1.0 sta arrivando. Mentre l’accesso diretto all’API happyhorse è in anteprima privata, puoi generare video fin da subito via web — stesso modello, stessa qualità, paghi solo ciò che usi.

Usa Happyhorse-1.0 online — senza chiave API

Il sistema di chiavi API di happyhorse è in fase di sviluppo, ma il modello è già disponibile. Acquista crediti, genera video in 4K sul sito e scarica — licenza commerciale completa inclusa. Quando verrà lanciata la REST API, i tuoi crediti verranno trasferiti automaticamente.

01

Acquista crediti

Pagamento una tantum, nessun abbonamento. I crediti sono condivisi tra l’app web, le future chiamate API di happyhorse e il nodo ComfyUI.

02

Genera un video

Inserisci il tuo prompt in Happyhorse-1.0 Lab. Lo stesso modello che alimenterà la REST API — architettura daVinci-MagiHuman, 4K nativo.

03

Scarica e pubblica

Output MP4 con il 100% dei diritti IP a uso commerciale. Quando l’endpoint API di happyhorse sarà disponibile, inserisci la tua chiave e automatizza lo stesso flusso di lavoro.

Come funziona l’API

La REST API di Happyhorse-1.0 segue un semplice modello asincrono richiesta/polling. Autenticati con la tua API key di Happyhorse, invia un job e recupera l’output quando è pronto. Di seguito trovi un’anteprima dell’integrazione con l’API happyhorse-1.0.

01

Autenticazione

Includi la tua API key di Happyhorse nell’header Authorization. Le chiavi sono con ambito per workspace e soggette a rate limit in base al piano.

02

Invia un job

Invia via POST il prompt e i parametri all’endpoint /v1/generate. L’endpoint API di Happyhorse restituisce immediatamente un job_id.

03

Verifica lo stato (polling)

Esegui GET /v1/jobs/{job_id} per controllare l’avanzamento. Quando lo stato è completed, la risposta include un URL video firmato valido per 24 ore.

04

Scarica e usa

Scarica l’output MP4 oppure riproducilo in streaming direttamente. I crediti vengono scalati solo in caso di generazione riuscita — i job falliti non vengono mai addebitati.

curl — Invia un job di generazione video

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 — Esempio completo di integrazione

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)

Prezzi e crediti

L’accesso all’API di Happyhorse utilizza lo stesso sistema di crediti del sito: nessun abbonamento separato, nessun costo per postazione. I crediti acquistati oggi funzionano sulla web app e verranno trasferiti al modello pay-as-you-go dell’API di Happyhorse al lancio.

Standard

A partire da ~0,10 $ / video

1080p, fino a 8 s, coda standard. Ideale per prototipare e valutare l’API video AI di Happyhorse.

Most Popular

Pro

A partire da ~0,25 $ / video

4K nativo, fino a 16 s, coda prioritaria. Pensato per carichi di lavoro in produzione: il modello pay-as-you-go dell’API di Happyhorse su larga scala.

Enterprise

Prezzi personalizzati

Sconti sui volumi, garanzie SLA, endpoint dedicati e gestione delle chiavi API di Happyhorse tra i team.

I crediti acquistati sul sito sono completamente intercambiabili con i futuri crediti API. Non esiste un livello di prezzo separato per l’API di Happyhorse: paghi solo per ciò che generi.

I crediti non scadono mai finché il tuo account rimane attivo.

Endpoint API (Anteprima)

L’API REST Happyhorse-1.0 espone un insieme mirato di endpoint per la generazione video e la gestione dei job. La documentazione completa dell’API happyhorse-1.0 verrà pubblicata al lancio.

POST/v1/generate

Invia un job di generazione da testo a video o da immagine a video. Restituisce un job_id per il polling.

ParameterTypeRequiredDescription
promptstringrequiredDescrizione testuale del video.
resolutionstringoptional"1080p" (predefinito) o "4K". Il 4K richiede crediti Pro.
durationintegeroptionalDurata del video in secondi. Intervallo: 2–16. Predefinito: 8.
motion_strengthfloatoptionalIntensità del movimento 0.0–1.0. Predefinito: 0.6.
fpsintegeroptionalFotogrammi al secondo: 24 o 30. Predefinito: 24.
seedintegeroptionalSeed per la riproducibilità. Omettere per un valore casuale.
GET/v1/jobs/{job_id}

Esegui il polling dello stato di un job di generazione. Restituisce stato, avanzamento e output_url al completamento.

GET/v1/credits

Verifica il saldo dei crediti API happyhorse rimanenti e la cronologia di utilizzo.

GET/v1/models

Elenca i modelli disponibili e i relativi intervalli dei parametri. Attualmente espone happyhorse-1.0.

Risposta di esempio — Job completato

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
  }
}

FAQ

Domande frequenti su accesso all’API Happyhorse, crediti e integrazione.

1

Come posso ottenere una chiave API Happyhorse?

Il sistema delle chiavi API Happyhorse è attualmente in anteprima privata. Nel frattempo, utilizza l’app web su happyhorselab.net — stesso modello, stessa qualità. Acquista crediti nella pagina dei prezzi e inizia a generare subito. Le chiavi API saranno disponibili nella dashboard quando verrà lanciato l’accesso diretto.

2

L’API Happyhorse-1.0 è compatibile con ComfyUI?

Sì. Il nodo personalizzato ufficiale di Happyhorse per ComfyUI utilizza la stessa API REST “sotto al cofano”. I crediti acquistati per l’app web sono intercambiabili con l’integrazione ComfyUI. Consulta la nostra guida /comfyui per i dettagli di configurazione.

3

Quali sono i limiti di utilizzo (rate limit)?

I rate limit dipendono dal tuo piano crediti. L’accesso standard partirà da 10 job concorrenti e 500 richieste al minuto. I piani Enterprise offrono limiti personalizzati, endpoint dedicati e garanzie SLA — contattaci per il pricing Enterprise dell’API Happyhorse.

4

È disponibile l’accesso API Enterprise o white-label?

Sì. I clienti Enterprise possono richiedere endpoint di inferenza dedicati, pacchetti di crediti ad alto volume, SLA personalizzati e fine-tuning privato del modello. Contattaci tramite la pagina dei prezzi e ti proporremo un piano su misura.

5

I crediti API Happyhorse scadono?

I crediti acquistati su happyhorselab.net non scadono finché il tuo account rimane attivo (almeno un accesso ogni 365 giorni). La stessa policy dei crediti API Happyhorse si applica sia che tu li usi tramite l’app web, l’API o il nodo ComfyUI.

6

Quali linguaggi di programmazione supporta l’API Happyhorse?

L’API REST Happyhorse-1.0 è una normale API HTTP — funziona con qualsiasi linguaggio: Python, Node.js, Go, Ruby, PHP, Java, Rust e altri. Gli SDK ufficiali per Python e TypeScript sono previsti per il lancio. Fino ad allora, usa qualsiasi client HTTP inserendo la tua chiave API Happyhorse nell’header Authorization.

Crea con il modello video n. 1 — Da oggi

Non aspettare l’API. Usa subito Happyhorse-1.0 online, paga a crediti e il tuo saldo verrà trasferito automaticamente quando verrà lanciata l’API REST.