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 を使用します。スカラー制御はフォームフィールドとして渡し、参照画像は 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 の参照画像として送信します。各画像は 20 MB までの JPEG、JPG、PNG、または WEBP を使用できます。より良い結果を得るには、短辺が少なくとも 400 px の画像を使用してください。

長さとサイズを設定する

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 フォームリクエストを送信し、返された 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キー

入力モードを選択する

長さとサイズを設定する

タスクの流れ

承認

ボディ

レスポンス

​入力モードを選択する

​長さとサイズを設定する

​タスクの流れ

承認

ボディ

レスポンス

入力モードを選択する

長さとサイズを設定する

タスクの流れ