happyhorse-1.1-i2v API

Sử dụng ID mẫu chính xác happyhorse-1.1-i2v. Trường mô hình phải khớp chính xác với trang này.

Đầu ra mẫuhappyhorse-1.1-i2vPOST /v1/videos5.2s

Thông số: duration=5resolution=1080pratio=16:9Hình ảnh đầu vào

Câu lệnh: One continuous take, no cuts. The braided steam keeps thickening until the ribbons lock into one coral and ultraviolet serpent that uncoils along the ceiling, drops down past the stools and pours out through the open door into the rain, the cook in the orange jacket stepping back to let it pass. The camera holds at counter height, then tracks with the serpent to the doorway and tilts to watch it leave. One hard tungsten bulb overhead stays the only warm source. Real weight and inertia, visible density in the steam, no text.

Yêu cầu tạo ra mẫu này với URL phương tiện đầu vào được thay thế

{
  "model": "happyhorse-1.1-i2v",
  "prompt": "One continuous take, no cuts. The braided steam keeps thickening until the ribbons lock into one coral and ultraviolet serpent that uncoils along the ceiling, drops down past the stools and pours out through the open door into the rain, the cook in the orange jacket stepping back to let it pass. The camera holds at counter height, then tracks with the serpent to the doorway and tilts to watch it leave. One hard tungsten bulb overhead stays the only warm source. Real weight and inertia, visible density in the steam, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9",
  "image": "https://example.com/input-image.png"
}

Xác thực và điểm cuối

Sử dụng khóa API Modelflare với https://modelflare.dev/v1. Điểm vào cổng là POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Tạo nhiệm vụ

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-i2v",
    "input": {"prompt": "The cat runs across the grass as the camera follows smoothly.", "media": [{"type": "first_frame", "url": "https://example.com/cat.png"}]},
    "parameters": {"resolution": "1080P", "duration": 5, "watermark": false}
  }'

Thăm dò ý kiến và tải xuống

Lưu ID nhiệm vụ. Thăm dò GET /v1/videos/{task_id} và tải xuống với GET /v1/videos/{task_id}/content. URL kết quả có thể hết hạn, vì vậy hãy chuyển tệp ngay.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Ghi chú yêu cầu

HappyHorse sử dụng input.prompt; chọn hình dạng input.media khớp với ID kiểu máy t2v, i2v hoặc r2v.

Tham số yêu cầu

HappyHorse I2V đặt một hình ảnh first_frame vào input.media.

Cánh đồng	Bắt buộc	Ghi chú
model	Có	happyhorse-1.1-i2v
input.prompt	Không	Mô tả chuyển động và camera tùy chọn, tối đa 5.000 ký tự không phải tiếng Trung hoặc 2.500 ký tự tiếng Trung
input.media[]	Có	Chính xác là một first_frame; URL công khai hoặc URL dữ liệu Base64, dưới 20 MB, cạnh tối thiểu 300px và tỷ lệ khung hình 1:2,5–2,5:1
parameters.resolution	Không	720P / 1080P, mặc định 1080P
parameters.ratio	Không	Không được hỗ trợ; đầu ra tuân theo tỷ lệ hình ảnh khung hình đầu tiên
parameters.duration	Không	3–15 giây, mặc định 5
parameters.watermark	Không	Có nên thêm hình mờ HappyHorse hay không
parameters.seed	Không	Seed tùy chọn từ 0 đến 2.147.483.647

Giới hạn đầu vào và đầu ra

I2V sử dụng một hình ảnh first_frame; chấp nhận URL công khai hoặc URL dữ liệu Base64 dưới 20 MB với các cạnh tối thiểu 300px và tỷ lệ khung hình 1:2,5–2,5:1, đồng thời duy trì tỷ lệ đầu vào gần đúng.

Lỗi và tác vụ không thành công

Tham số mô hình không hợp lệ trả về 4xx cùng với ID yêu cầu. Tác vụ không đồng bộ cũng có thể bị lỗi sau khi quá trình tạo thành công; sử dụng error_code và error_message từ phản hồi thăm dò làm lý do nhiệm vụ cuối cùng. Đừng thử lại cùng một yêu cầu với hình dạng JSON khác.

Phạm vi được hỗ trợ

Trang này bao gồm các cuộc gọi chỉnh sửa và tạo mô hình Modelflare. Tính năng làm giàu bản đồ hoặc tìm kiếm, quản lý giọng nói và quản lý thư viện thành phần là các API tài nguyên nằm ngoài bề mặt lệnh gọi mô hình công khai này và không phải là các trường yêu cầu bắt buộc.

Định giá và thanh toán

Mô hình này sử dụng tính phí video theo giây. Xem trang định giá mẫu để biết giá khách hàng hiện tại, giá niêm yết tham khảo và thông số kỹ thuật đầy đủ.

Ghi chú

Trang này ghi lại giao diện công cộng của Modelflare; các trường và giới hạn hiển thị ở đây là hợp đồng hiện tại.