API — Sắp ra mắt

Truy cập API Happyhorse-1.0

Trả theo mức sử dụng · Không đăng ký · Dùng trong ứng dụng của bạn

API REST Happyhorse-1.0 sắp ra mắt. Trong khi quyền truy cập API Happyhorse trực tiếp đang ở giai đoạn xem trước riêng tư, bạn vẫn có thể tạo video ngay bây giờ qua web — cùng mô hình, cùng chất lượng, chỉ trả cho phần bạn sử dụng.

Dùng Happyhorse-1.0 Online — Không cần API Key

Hệ thống API key của Happyhorse đang trong quá trình phát triển, nhưng model đã hoạt động ngay hôm nay. Mua credit, tạo video 4K trực tiếp trên website và tải xuống — đã bao gồm giấy phép thương mại đầy đủ. Khi REST API ra mắt, credit của bạn sẽ tự động được chuyển tiếp.

01

Mua Credit

Thanh toán một lần, không cần đăng ký thuê bao. Credit được dùng chung cho web app, các lời gọi API Happyhorse trong tương lai và node ComfyUI.

02

Tạo Video

Nhập prompt của bạn trong Happyhorse-1.0 Lab. Cùng một model sẽ vận hành REST API — kiến trúc daVinci-MagiHuman, hỗ trợ 4K gốc.

03

Tải xuống & Triển khai

Xuất MP4 với quyền sở hữu IP thương mại 100%. Khi endpoint API của happyhorse hoạt động, chỉ cần nhập key và tự động hóa cùng một quy trình.

API hoạt động như thế nào

Happyhorse-1.0 REST API tuân theo mô hình bất đồng bộ đơn giản: gửi yêu cầu rồi thăm dò (request–poll). Xác thực bằng khóa API happyhorse của bạn, gửi một job và lấy đầu ra khi đã sẵn sàng. Dưới đây là bản xem trước về tích hợp API happyhorse-1.0.

01

Xác thực

Thêm khóa API happyhorse của bạn vào header Authorization. Khóa được phân phạm vi theo workspace và bị giới hạn tốc độ theo từng gói.

02

Gửi job

Gửi POST prompt và các tham số đến endpoint /v1/generate. Endpoint API happyhorse trả về job_id ngay lập tức.

03

Thăm dò trạng thái

Gọi GET /v1/jobs/{job_id} để kiểm tra tiến độ. Khi status là completed, phản hồi sẽ gồm một URL video đã ký, có hiệu lực trong 24 giờ.

04

Tải xuống & sử dụng

Tải xuống file MP4 đầu ra hoặc phát trực tiếp. Credit chỉ bị trừ khi tạo thành công — các job thất bại sẽ không bao giờ bị tính phí.

curl — Gửi job tạo 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 — Ví dụ tích hợp đầy đủ

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)

Giá & Tín dụng

Quyền truy cập Happyhorse API sử dụng cùng hệ thống tín dụng như trên website — không cần gói đăng ký riêng, không phí theo người dùng. Tín dụng mua hôm nay dùng được trên web app và sẽ được chuyển sang mô hình happyhorse api trả theo mức sử dụng khi ra mắt.

Tiêu chuẩn

Từ khoảng ~$0.10 / video

1080p, tối đa 8 giây, hàng đợi tiêu chuẩn. Lý tưởng để tạo mẫu và đánh giá API video AI của Happy Horse.

Most Popular

Pro

Từ khoảng ~$0.25 / video

4K gốc, tối đa 16 giây, hàng đợi ưu tiên. Thiết kế cho khối lượng công việc sản xuất — mô hình happyhorse api trả theo mức sử dụng ở quy mô lớn.

Doanh nghiệp

Báo giá theo nhu cầu

Giảm giá theo sản lượng, cam kết SLA, endpoint riêng, và quản lý khóa happyhorse api cho nhiều nhóm.

Tín dụng mua trên website có thể dùng thay thế hoàn toàn với tín dụng API trong tương lai. Không có bậc giá happyhorse api riêng — bạn chỉ trả cho những gì bạn tạo ra.

Tín dụng không bao giờ hết hạn miễn là tài khoản của bạn vẫn hoạt động.

API Endpoints (Bản xem trước)

REST API Happyhorse-1.0 cung cấp một tập endpoint gọn và tập trung cho việc tạo video và quản lý tác vụ. Tài liệu đầy đủ cho API happyhorse-1.0 sẽ được công bố khi ra mắt.

POST/v1/generate

Gửi một tác vụ tạo video từ văn bản hoặc từ hình ảnh. Trả về job_id để bạn thăm dò.

ParameterTypeRequiredDescription
promptstringrequiredMô tả bằng văn bản về video.
resolutionstringoptional"1080p" (mặc định) hoặc "4K". 4K yêu cầu tín dụng Pro.
durationintegeroptionalĐộ dài video tính bằng giây. Phạm vi: 2–16. Mặc định: 8.
motion_strengthfloatoptionalCường độ chuyển động 0.0–1.0. Mặc định: 0.6.
fpsintegeroptionalSố khung hình/giây: 24 hoặc 30. Mặc định: 24.
seedintegeroptionalSeed để tái lập kết quả. Bỏ trống để ngẫu nhiên.
GET/v1/jobs/{job_id}

Thăm dò trạng thái của một tác vụ tạo video. Trả về status, progress và output_url khi hoàn tất.

GET/v1/credits

Kiểm tra số dư tín dụng API happyhorse còn lại và lịch sử sử dụng.

GET/v1/models

Liệt kê các mô hình khả dụng và phạm vi tham số của chúng. Hiện đang cung cấp happyhorse-1.0.

Phản hồi mẫu — Tác vụ đã hoàn tất

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

Câu hỏi thường gặp

Những câu hỏi phổ biến về quyền truy cập API Happyhorse, tín dụng và tích hợp.

1

Làm thế nào để nhận API key Happyhorse?

Hệ thống API key của Happyhorse hiện đang ở giai đoạn xem trước riêng (private preview). Trong thời gian này, bạn có thể dùng web app tại happyhorselab.net — cùng mô hình, cùng chất lượng. Mua tín dụng ở trang giá và bắt đầu tạo ngay lập tức. API key sẽ có trong bảng điều khiển khi quyền truy cập trực tiếp được ra mắt.

2

API Happyhorse-1.0 có tương thích với ComfyUI không?

Có. Custom node ComfyUI chính thức của Happyhorse sử dụng cùng REST API ở phía dưới. Tín dụng mua cho web app có thể dùng chung với tích hợp ComfyUI. Xem hướng dẫn /comfyui để biết chi tiết thiết lập.

3

Giới hạn tốc độ (rate limit) là bao nhiêu?

Giới hạn tốc độ sẽ phụ thuộc vào gói tín dụng của bạn. Quyền truy cập tiêu chuẩn sẽ bắt đầu từ 10 tác vụ đồng thời và 500 yêu cầu mỗi phút. Các gói Doanh nghiệp cung cấp giới hạn tuỳ chỉnh, endpoint riêng và cam kết SLA — liên hệ với chúng tôi để nhận báo giá happyhorse api dành cho doanh nghiệp.

4

Có hỗ trợ quyền truy cập API dạng doanh nghiệp hoặc white-label không?

Có. Khách hàng Doanh nghiệp có thể yêu cầu endpoint suy luận (inference) riêng, gói tín dụng theo sản lượng, SLA tuỳ chỉnh và tinh chỉnh mô hình (fine-tuning) riêng tư. Hãy liên hệ qua trang giá, và chúng tôi sẽ phản hồi với một kế hoạch phù hợp.

5

Tín dụng API Happyhorse có hết hạn không?

Tín dụng mua trên happyhorselab.net sẽ không hết hạn miễn là tài khoản của bạn vẫn hoạt động (đăng nhập ít nhất một lần mỗi 365 ngày). Chính sách tín dụng happyhorse api áp dụng như nhau dù bạn dùng qua web app, API hay node ComfyUI.

6

API Happyhorse hỗ trợ những ngôn ngữ lập trình nào?

REST API Happyhorse-1.0 là API HTTP tiêu chuẩn — dùng được với mọi ngôn ngữ: Python, Node.js, Go, Ruby, PHP, Java, Rust, v.v. SDK chính thức cho Python và TypeScript dự kiến sẽ có khi ra mắt. Trước mắt, hãy dùng bất kỳ HTTP client nào và đặt happyhorse api key của bạn trong header Authorization.

Xây dựng với mô hình video số 1 — Bắt đầu ngay hôm nay

Đừng chờ API. Dùng Happyhorse-1.0 trực tuyến ngay, thanh toán theo tín dụng, và số dư của bạn sẽ tự động được chuyển tiếp khi REST API ra mắt.