Video 제공: Alibaba

Happy Horse 1.1 API

Happy Horse의 상위 버전. 텍스트→비디오, 이미지→비디오, 최대 9장의 참조 이미지에서의 참조→비디오를 지원하며 움직임과 캐릭터 일관성이 향상되었습니다. 하나의 API, 비동기 작업, 웹훅으로 사용하세요.

Happy Horse 1.1을(를) 단 한 번의 API 호출로 통합하세요. 하나의 키, 하나의 통합 엔드포인트, 그리고 Apiframe의 모든 모델에 적용되는 통합 청구.

API 키 받기 Apiframe Studio에서 사용 Happy Horse 1.1 API 문서 보기

model: "happyhorse-1.1"

Happy Horse 1.1의 특별한 점

하나의 모델에 세 가지 모드

이미지가 없으면 텍스트→비디오, 1장이면 이미지→비디오, 2~9장이면 참조→비디오를 실행합니다.

최대 9장 참조

캐릭터·제품·장면의 일관성을 유지합니다. 프롬프트에서 [Image 1], [Image 2]처럼 참조하세요.

부드러운 움직임과 동기화 오디오

움직임 표현력과 시간적 일관성이 향상되었고, 동작에 맞춰 오디오가 동기화됩니다.

Happy Horse 1.1(으)로 시도해 볼 프롬프트

Apiframe의 Happy Horse 1.1 API로 실행할 수 있는 프롬프트 예시입니다.

사막 모래언덕을 질주하는 말 무리, 뒤로 흩날리는 먼지, 골든아워

[Image 1]이 해 질 녘 [Image 2]의 문을 통과하는 영화 같은 트래킹 샷

반사되는 표면 위에서 천천히 회전하는 [Image 1]의 제품 히어로 샷, 스튜디오 조명

개요

엔드포인트: POST /v2/videos/generate
모델 ID: happyhorse-1.1
파라미터 키: happyhorse11Params
모달리티: 비디오
제공업체: Alibaba
평균 완료 시간: ~180s

기능

화면 비율16:9, 9:16, 1:1, 4:3, 3:4

해상도720p, 1080p

길이3초, 4초, 5초, 6초, 7초, 8초, 9초, 10초, 11초, 12초, 13초, 14초, 15초

이미지 입력지원

오디오지원

평균 시간~180초

빠른 시작

API 키와 함께 POST /v2/videos/generate 요청을 한 번 보내면 Happy Horse 1.1로 생성이 시작됩니다. 응답으로 폴링하거나 웹훅으로 받을 수 있는 jobId가 반환됩니다.

curl -X POST https://api.apiframe.ai/v2/videos/generate \
  -H "X-API-Key: afk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
        "prompt": "a cinematic sunrise over a futuristic cityscape, smooth camera push-in",
        "model": "happyhorse-1.1",
        "happyhorse11Params": {
            "images": [
                "https://example.com/input.jpg"
            ],
            "resolution": "1080p",
            "aspect_ratio": "16:9",
            "seed": 1
        }
    }'

import requests

response = requests.post(
    "https://api.apiframe.ai/v2/videos/generate",
    headers={
        "X-API-Key": "afk_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={
        "prompt": "a cinematic sunrise over a futuristic cityscape, smooth camera push-in",
        "model": "happyhorse-1.1",
        "happyhorse11Params": {
            "images": [
                "https://example.com/input.jpg"
            ],
            "resolution": "1080p",
            "aspect_ratio": "16:9",
            "seed": 1
        }
    },
)
print(response.json())  # { "jobId": "...", "status": "QUEUED" }

const response = await fetch("https://api.apiframe.ai/v2/videos/generate", {
  method: "POST",
  headers: {
    "X-API-Key": "afk_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "prompt": "a cinematic sunrise over a futuristic cityscape, smooth camera push-in",
    "model": "happyhorse-1.1",
    "happyhorse11Params": {
      "images": [
        "https://example.com/input.jpg"
      ],
      "resolution": "1080p",
      "aspect_ratio": "16:9",
      "seed": 1
    }
  }),
});
const { jobId } = await response.json();
console.log(jobId);

응답 및 작업 수명 주기

생성은 비동기로 처리됩니다. 제출이 성공하면 202 Accepted와 jobId가 반환됩니다. 상태가 COMPLETED가 될 때까지 GET /v2/jobs/{id}를 폴링하거나 webhook_url을 지정하면 result 필드에 출력 URL이 담깁니다.

1. 제출 응답 (202)

{
  "jobId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
  "status": "QUEUED"
}

2. 결과 폴링

curl https://api.apiframe.ai/v2/jobs/JOB_ID \
  -H "X-API-Key: afk_your_api_key_here"

import requests, time

while True:
    job = requests.get(
        "https://api.apiframe.ai/v2/jobs/JOB_ID",
        headers={"X-API-Key": "afk_your_api_key_here"},
    ).json()
    if job["status"] in ("COMPLETED", "FAILED"):
        break
    time.sleep(2)
print(job["result"])

let job;
do {
  await new Promise((r) => setTimeout(r, 2000));
  job = await fetch("https://api.apiframe.ai/v2/jobs/JOB_ID", {
    headers: { "X-API-Key": "afk_your_api_key_here" },
  }).then((r) => r.json());
} while (job.status !== "COMPLETED" && job.status !== "FAILED");
console.log(job.result);

입력 스키마

Happy Horse 1.1 엔드포인트가 허용하는 요청 파라미터입니다. 모델별 옵션은 아래에 표시된 파라미터 객체 안에 중첩됩니다.

파라미터	유형	필수	기본값	허용값 / 범위	설명
prompt	string	필수	—	—	생성할 내용에 대한 텍스트 설명.
model	string	필수	"happyhorse-1.1"	"happyhorse-1.1"	이 엔드포인트의 모델 식별자.
happyhorse11Params.images	string[] (URLs)	선택	—	—	None = text-to-video, one = image-to-video, two to nine = reference-to-video.
happyhorse11Params.resolution	string	선택	"1080p"	"720p", "1080p"	Resolution
happyhorse11Params.aspect_ratio	string	선택	"16:9"	"16:9", "9:16", "1:1", "4:3", "3:4"	Used for text-to-video (and reference-to-video on 1.1); ignored when animating an image.
happyhorse11Params.seed	number	선택	—	step 1	Reuse a number to reproduce the same result.

자주 묻는 질문

Happy Horse 1.1 API에 대한 일반적인 질문입니다.

생성 모드는 어떻게 결정되나요?

happyhorse11Params.images의 개수로 결정됩니다. 없음＝텍스트→비디오, 1장＝이미지→비디오, 2~9장＝참조→비디오입니다.

참조 이미지는 어떻게 사용하나요?

최대 9장을 제공하고 프롬프트에서 [Image 1], [Image 2]처럼 참조하세요. Happy Horse 1.1은 해당 피사체와 장면을 출력에서 일관되게 유지합니다.

Happy Horse 1.1의 요금은 얼마인가요?

출력 초 단위 과금으로 720p는 초당 24크레딧, 1080p는 초당 31크레딧입니다. 10초 1080p 클립은 310크레딧입니다.

아직 궁금한 점이 있으신가요?

고객 지원 문의 Discord 참여