API — Em breve

Acesso à API Happyhorse-1.0

Pague conforme o uso · Sem assinatura · Use no seu próprio app

A API REST do Happyhorse-1.0 está chegando. Enquanto o acesso direto à API do Happyhorse está em prévia privada, você já pode gerar vídeos agora mesmo pela web — mesmo modelo, mesma qualidade, pagando apenas pelo que usar.

Use o Happyhorse-1.0 Online — Sem Chave de API Necessária

O sistema de chave de API do Happyhorse está em desenvolvimento, mas o modelo já está no ar hoje. Compre créditos, gere vídeos em 4K no site e faça o download — licença comercial completa incluída. Quando a API REST for lançada, seus créditos serão transferidos automaticamente.

01

Compre Créditos

Pagamento único, sem assinatura. Os créditos são compartilhados entre o app web, futuras chamadas da API do Happyhorse e o nó do ComfyUI.

02

Gere Vídeo

Insira seu prompt no Lab do Happyhorse-1.0. O mesmo modelo que vai alimentar a API REST — arquitetura daVinci-MagiHuman, 4K nativo.

03

Baixe e Publique

Saída em MP4 com 100% de propriedade de IP para uso comercial. Quando o endpoint da API do Happyhorse entrar no ar, conecte sua chave e automatize o mesmo fluxo de trabalho.

Como a API funciona

A API REST Happyhorse-1.0 segue um modelo simples assíncrono de requisição e consulta (request-poll). Autentique-se com sua chave de API da happyhorse, envie um job e recupere a saída quando estiver pronta. A seguir, há uma prévia da integração com a API happyhorse-1.0.

01

Autentique-se

Inclua sua chave de API da happyhorse no cabeçalho Authorization. As chaves são definidas por workspace e têm limite de taxa conforme o plano.

02

Envie um job

Faça POST do seu prompt e dos parâmetros para o endpoint /v1/generate. O endpoint da API happyhorse retorna um job_id imediatamente.

03

Consulte o status

Faça GET em /v1/jobs/{job_id} para acompanhar o progresso. Quando o status for completed, a resposta inclui uma URL assinada do vídeo, válida por 24 horas.

04

Baixe e use

Baixe o MP4 gerado ou faça streaming diretamente. Os créditos são debitados apenas em gerações bem-sucedidas — jobs com falha nunca são cobrados.

curl — Enviar um job de geração de vídeo

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 — Exemplo completo de integração

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)

Preços e Créditos

O acesso à API da Happyhorse funciona no mesmo sistema de créditos do site — sem assinatura separada e sem taxas por usuário. Os créditos comprados hoje valem no app web e serão mantidos no modelo pay as you go da happyhorse api quando ela for lançada.

Padrão

A partir de ~US$ 0,10 / vídeo

1080p, até 8 s, fila padrão. Ideal para prototipar e avaliar a API de vídeo com IA da Happy Horse.

Most Popular

Pro

A partir de ~US$ 0,25 / vídeo

4K nativo, até 16 s, fila prioritária. Desenvolvido para cargas de trabalho em produção — o modelo pay as you go da happyhorse api em escala.

Enterprise

Preço personalizado

Descontos por volume, garantias de SLA, endpoints dedicados e gerenciamento de chaves de API da happyhorse api entre equipes.

Os créditos comprados no site são totalmente intercambiáveis com os futuros créditos da API. Não existe uma categoria de preços separada para a happyhorse api — você paga apenas pelo que gerar.

Os créditos nunca expiram enquanto sua conta permanecer ativa.

Endpoints da API (Prévia)

A API REST Happyhorse-1.0 expõe um conjunto enxuto de endpoints para geração de vídeo e gerenciamento de jobs. A documentação completa da API happyhorse-1.0 será publicada no lançamento.

POST/v1/generate

Envie um job de geração de texto-para-vídeo ou imagem-para-vídeo. Retorna um job_id para consulta (polling).

ParameterTypeRequiredDescription
promptstringrequiredDescrição em texto do vídeo.
resolutionstringoptional"1080p" (padrão) ou "4K". 4K requer créditos Pro.
durationintegeroptionalDuração do vídeo em segundos. Intervalo: 2–16. Padrão: 8.
motion_strengthfloatoptionalIntensidade do movimento: 0.0–1.0. Padrão: 0.6.
fpsintegeroptionalQuadros por segundo: 24 ou 30. Padrão: 24.
seedintegeroptionalSemente para reprodutibilidade. Omita para aleatório.
GET/v1/jobs/{job_id}

Consulte o status de um job de geração. Retorna status, progresso e output_url quando concluído.

GET/v1/credits

Verifique o saldo restante de créditos da API happyhorse e o histórico de uso.

GET/v1/models

Liste os modelos disponíveis e seus intervalos de parâmetros. Atualmente expõe o happyhorse-1.0.

Resposta de Exemplo — Job Concluído

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

Perguntas frequentes sobre acesso à API da Happyhorse, créditos e integração.

1

Como obtenho uma chave de API da Happyhorse?

O sistema de chaves de API da Happyhorse está em prévia privada. Enquanto isso, use o app web em happyhorselab.net — mesmo modelo, mesma qualidade. Compre créditos na página de preços e comece a gerar imediatamente. As chaves de API estarão disponíveis no painel quando o acesso direto for lançado.

2

A API do Happyhorse-1.0 é compatível com o ComfyUI?

Sim. O node customizado oficial da Happyhorse para o ComfyUI usa a mesma API REST por baixo dos panos. Os créditos comprados para o app web são intercambiáveis com a integração do ComfyUI. Veja nosso guia /comfyui para detalhes de configuração.

3

Quais são os limites de taxa?

Os limites de taxa dependem do seu plano de créditos. O acesso padrão começará com 10 jobs simultâneos e 500 requisições por minuto. Planos Enterprise oferecem limites personalizados, endpoints dedicados e garantias de SLA — fale conosco sobre preços Enterprise da API da Happyhorse.

4

Existe acesso Enterprise ou white-label à API?

Sim. Clientes Enterprise podem solicitar endpoints de inferência dedicados, pacotes de créditos em volume, SLAs personalizados e fine-tuning privado do modelo. Entre em contato pela página de preços e retornaremos com um plano sob medida.

5

Os créditos da API da Happyhorse expiram?

Os créditos comprados em happyhorselab.net não expiram enquanto sua conta permanecer ativa (pelo menos um login a cada 365 dias). A mesma política de créditos da API da Happyhorse se aplica, seja pelo app web, pela API ou pelo node do ComfyUI.

6

Quais linguagens de programação a API da Happyhorse suporta?

A API REST do Happyhorse-1.0 é uma API HTTP padrão — qualquer linguagem funciona: Python, Node.js, Go, Ruby, PHP, Java, Rust e outras. SDKs oficiais para Python e TypeScript estão previstos para o lançamento. Até lá, use qualquer cliente HTTP com sua chave de API da Happyhorse no header Authorization.

Crie com o modelo de vídeo nº 1 — a partir de hoje

Não espere pela API. Use o Happyhorse-1.0 online agora, pague por crédito, e seu saldo é transferido automaticamente quando a API REST for lançada.