HappyHorse 비디오 생성

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=happyhorse-1.1 \
  -F 'prompt=A close-up cinematic shot of a ceramic coffee cup on a wooden table. Steam rises slowly while morning light moves across the background.' \
  -F seconds=3 \
  -F size=1920x1080

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "happyhorse-1.1",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

{}

{}

이 엔드포인트를 사용해 HappyHorse 비디오 작업을 생성합니다. API는 즉시 작업 ID를 반환하므로, 반환된 id를 저장하고 작업이 최종 상태에 도달할 때까지 폴링하세요. POST /v1/videos는 multipart/form-data를 사용합니다. 스칼라 제어값은 form 필드로 전달하고, 참조 이미지는 input_reference 파일 필드로 전달하세요.

입력 모드 선택

목표	Model	필수 필드	선택 필드
텍스트-투-비디오	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`	`seconds`, `size`
참조-투-비디오	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`, `input_reference` 파일 1개	`seconds`, `size`, 추가 참조 이미지

참조-투-비디오의 경우 input_reference multipart 필드를 반복하여 참조 이미지 1~9개를 업로드하세요. CometAPI는 업로드된 각 파일을 HappyHorse 참조 이미지로 전송합니다. 각 이미지는 최대 20MB의 JPEG, JPG, PNG 또는 WEBP를 사용하세요. 최상의 결과를 위해서는 가장 짧은 변이 최소 400px 이상인 이미지를 사용하는 것이 좋습니다.

길이와 크기 설정

Model ID	`seconds`	기본값
`happyhorse-1.0`	정수 `3`-`15`	`5`초, `1920x1080`
`happyhorse-1.1`	정수 `3`-`15`	`5`초, `1920x1080`

size는 정확한 WxH 값으로 설정하세요.

Model	프레임 형태	`size` 값
`happyhorse-1.0`	가로형	`1280x720`, `1920x1080`
	세로형	`720x1280`, `1080x1920`
	정사각형	`1440x1440`
`happyhorse-1.1`	가로형	`1280x720`, `1920x1080`
	세로형	`720x1280`, `1080x1920`
	정사각형	`1440x1440`
	클래식 가로형	`1440x1080`
	클래식 세로형	`720x960`, `1080x1440`
	와이드 가로형	`2520x1080`
	와이드 세로형	`1080x2520`
	준정사각형 가로형	`900x720`, `1350x1080`
	준정사각형 세로형	`720x900`, `1080x1350`

작업 흐름

작업 생성

multipart form 요청을 보내고 반환된 id를 저장합니다.

작업 폴링

status가 completed, failed, 또는 error가 될 때까지 HappyHorse 비디오 조회를 호출합니다.

결과 다운로드

작업이 completed 상태가 되면 HappyHorse 비디오 콘텐츠 조회를 호출하여 MP4 파일을 다운로드합니다.

인증

Authorization

string

header

필수

Bearer authentication. Use your CometAPI API key.

본문

multipart/form-data

model

enum<string>

필수

HappyHorse model ID for this endpoint.

사용 가능한 옵션:

happyhorse-1.0,

happyhorse-1.1

예시:

"happyhorse-1.1"

prompt

string

필수

Text prompt that describes the video to generate. For reference-image requests, combine the prompt with the uploaded reference image.

예시:

"Use the uploaded reference image as the visual guide. Create a short cinematic shot with gentle natural motion."

seconds

string

Requested clip duration in seconds. Use an integer from 3 through 15. Default is 5.

예시:

"3"

size

string

Output size as an exact WxH value. Use one of the documented size values for the selected HappyHorse model.

예시:

"1920x1080"

input_reference

file

Reference image file for reference-to-video. Required when using reference-to-video; repeat this multipart field to send additional reference images. CometAPI preserves upload order. Use JPEG, JPG, PNG, or WEBP images up to 20 MB each.

응답

Task created. Store the returned id and poll GET /v1/videos/{task_id}.

string

필수

Task ID. Use this value with retrieve and content endpoints.

예시:

"task_example"

object

string

필수

Object type. Video tasks return video.

예시:

"video"

model

string

필수

Model ID used for the task.

예시:

"happyhorse-1.1"

status

enum<string>

필수

Task lifecycle status. Poll until the value is completed, failed, or error.

사용 가능한 옵션:

queued,

in_progress,

completed,

failed,

error

예시:

"queued"

progress

integer

필수

Task progress as a coarse percentage.

필수 범위: 0 <= x <= 100

예시:

0

created_at

integer

필수

Task creation time as a Unix timestamp in seconds.

예시:

1779938152

task_id

string

Compatibility alias for id when present.

예시:

"task_example"

completed_at

integer

Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.

예시:

1779938219

video_url

string

Temporary video delivery URL. This field appears on completed tasks.

예시:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

Seedance 비디오 조회

HappyHorse 비디오 조회

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=happyhorse-1.1 \
  -F 'prompt=A close-up cinematic shot of a ceramic coffee cup on a wooden table. Steam rises slowly while morning light moves across the background.' \
  -F seconds=3 \
  -F size=1920x1080

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "happyhorse-1.1",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

{}

{}

콘텐츠 검토

API 키

입력 모드 선택

길이와 크기 설정

작업 흐름

인증

본문

응답

​입력 모드 선택

​길이와 크기 설정

​작업 흐름

인증

본문

응답

입력 모드 선택

길이와 크기 설정

작업 흐름