マーケットサポート← アプリに戻る

HappyHorse

HappyHorse モデルは統一された非同期ジョブ API で呼び出します。POST /api/generate でタスクを開始し、完了するまで GET /api/generate/{taskId} をポーリングします。このファミリーは 7 個のエンドポイントを提供します。

概要

すべてのエンドポイントは同じ外枠を共有し、変わるのは model と input フィールドだけです。モデルマーケットの playground から任意に実行できます。

認証

/api-keys で API キーを作成し、Bearer トークンとして送信します。ログイン中のブラウザからのリクエストはセッション cookie 経由でも動作します。

Authorization: Bearer <YOUR_API_KEY>

タスクの作成

POST
POST https://api.lithovas.com/api/generate

ボディ：{ "model": "<slug>", "input": { … } }

レスポンス：{ "taskId": "<id>", "state": "waiting" }

結果の照会

GET
GET https://api.lithovas.com/api/generate/<taskId>

レスポンス：{ "taskId", "state": "waiting" | "success" | "fail", "resultUrls": [ … ], "creditsConsumed", "failMsg", "balance" }

非同期
タスク作成の 200 は、タスクが受理されたことを意味するだけで、完了ではありません。state が success または fail になるまでこのエンドポイントをポーリングしてください。失敗したタスクは課金されません。

エンドポイント

モデルタスクmodel slug
HappyHorseText to Videohappyhorse/text-to-video
HappyHorseImage to Videohappyhorse/image-to-video
HappyHorseVideo to Videohappyhorse/reference-to-video
HappyHorseVideo Editinghappyhorse/video-edit
HappyHorse 1.1Image to Videohappyhorse-1-1/image-to-video
HappyHorse 1.1Text to Videohappyhorse-1-1/text-to-video
HappyHorse 1.1Video to Videohappyhorse-1-1/reference-to-video

HappyHorse · Text to Video

POSTText to Videohappyhorse/text-to-video
input フィールド
promptstring必須

Text description of video to generate; max 5000 chars (2500 Chinese)

resolutionenum<string>任意

Output video resolution setting

aspect_ratioenum<string>任意

Output aspect ratio format

durationinteger任意

Video length in seconds (3-15 range)

seedinteger任意

Random seed for reproducible generation (0-2147483647)

例
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "happyhorse/text-to-video",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "seed": 0
  }
}'

HappyHorse · Image to Video

POSTImage to Videohappyhorse/image-to-video
input フィールド
promptstring任意

Text description for video generation (max 5000 chars)

image_urlsarray<string>必須

Exactly one first-frame image URL (JPEG/PNG/WEBP, 300+ px)

resolutionenum<string>任意

Output video resolution

durationinteger任意

Video length in seconds (3-15 range)

seedinteger任意

Random seed for reproducibility (0-2147483647)

例
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "happyhorse/image-to-video",
  "input": {
    "prompt": "Animate the image with natural motion, subtle camera movement, and cinematic lighting.",
    "image_urls": [
      "https://example.com/input.jpg"
    ],
    "resolution": "1080p",
    "duration": 5,
    "seed": 0
  }
}'

HappyHorse · Video to Video

POSTVideo to Videohappyhorse/reference-to-video
input フィールド
promptstring必須

Text prompt describing the video to generate (any language)

reference_imagearray<string>必須

Reference image URL list. Provide 1-9 images

resolutionenum<string>任意

Output video resolution

aspect_ratioenum<string>任意

Output aspect ratio

durationinteger任意

Output duration in seconds (integer, 3-15)

seedinteger任意

Random seed for reproducibility (if supported)

例
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "happyhorse/reference-to-video",
  "input": {
    "prompt": "Restyle the source footage with richer lighting, cleaner motion, and a cinematic grade.",
    "reference_image": [
      "https://example.com/input.jpg"
    ],
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "seed": 0
  }
}'

HappyHorse · Video Editing

POSTVideo Editinghappyhorse/video-edit
input フィールド
promptstring必須

Edit instruction for intended change; max 5000 chars (2500 Chinese)

video_urlstring必須

Input video URL (MP4/MOV, 3-60s, max 2160px longer side)

reference_imagearray<string>任意

Optional reference images (0-5 URLs, JPEG/PNG/WEBP, >=300px)

resolutionenum<string>任意

Output video resolution

audio_settingenum<string>任意

Audio handling strategy

seedinteger任意

Random seed for reproducibility (0-2147483647)

例
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "happyhorse/video-edit",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "video_url": "https://example.com/reference.mp4",
    "reference_image": [
      "https://example.com/input.jpg"
    ],
    "resolution": "1080p",
    "audio_setting": "auto",
    "seed": 0
  }
}'

HappyHorse 1.1 · Image to Video

POSTImage to Videohappyhorse-1-1/image-to-video
input フィールド
promptstring任意

Describes video content to generate; max 5000 chars

image_urlsarray<string>必須

URL of first frame image (JPEG/PNG/WEBP, 300px+ min)

resolutionenum<string>任意

Output video resolution

durationnumber任意

Video length in seconds; range [3, 15]

例
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "happyhorse-1-1/image-to-video",
  "input": {
    "prompt": "Animate the image with natural motion, subtle camera movement, and cinematic lighting.",
    "image_urls": [
      "https://example.com/input.jpg"
    ],
    "resolution": "1080p",
    "duration": 5
  }
}'

HappyHorse 1.1 · Text to Video

POSTText to Videohappyhorse-1-1/text-to-video
input フィールド
promptstring必須

Text description of the video; max 5000 chars (2500 Chinese)

resolutionenum<string>任意

Output video resolution

aspect_ratioenum<string>任意

Output video aspect ratio

durationnumber任意

Output video duration in seconds (3-15, whole numbers)

例
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "happyhorse-1-1/text-to-video",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5
  }
}'

HappyHorse 1.1 · Video to Video

POSTVideo to Videohappyhorse-1-1/reference-to-video
input フィールド
promptstring必須

Description of desired elements and visual style for the video

reference_imagearray<string>必須

URLs of reference images (JPEG/PNG/WEBP, min 400px, max 20MB)

resolutionenum<string>任意

Output video resolution tier

aspect_ratioenum<string>任意

Video aspect ratio format

durationnumber任意

Video length in seconds (integer, 3-15 range)

例
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "happyhorse-1-1/reference-to-video",
  "input": {
    "prompt": "Restyle the source footage with richer lighting, cleaner motion, and a cinematic grade.",
    "reference_image": [
      "https://example.com/input.jpg"
    ],
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5
  }
}'