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

Hailuo

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

概要

すべてのエンドポイントは同じ外枠を共有し、変わるのは 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
Hailuo 2.3Image to Videohailuo/2-3-image-to-video-pro
Hailuo 2.3Image to Videohailuo/2-3-image-to-video-standard
Hailuo 02Text to Videohailuo/02-text-to-video-pro
Hailuo 02Image to Videohailuo/02-image-to-video-pro
Hailuo 02Text to Videohailuo/02-text-to-video-standard
Hailuo 02Image to Videohailuo/02-image-to-video-standard

Hailuo 2.3 · Image to Video

POSTImage to Videohailuo/2-3-image-to-video-pro
input フィールド
promptstring必須

Text describing desired video animation (max 5000 chars)

image_urlstring必須

Input image URL to animate (JPEG/PNG/WebP, max 10MB)

durationenum<string>任意

Video duration in seconds (10s not supported at 1080p)

resolutionenum<string>任意

Generated video resolution

nsfw_checkerboolean任意

Toggle content filtering (disabled when false)

例
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "hailuo/2-3-image-to-video-pro",
  "input": {
    "prompt": "Animate the image with natural motion, subtle camera movement, and cinematic lighting.",
    "image_url": "https://example.com/input.jpg",
    "duration": "6",
    "resolution": "768P",
    "nsfw_checker": false
  }
}'

Hailuo 2.3 · Image to Video

POSTImage to Videohailuo/2-3-image-to-video-standard
input フィールド
promptstring必須

Text prompt describing the desired video animation (max 5000 chars)

image_urlstring必須

Input image file URL to animate (JPEG/PNG/WebP, max 10MB)

durationstring任意

Video duration in seconds; 10s videos lack 1080p support

resolutionstring任意

Output video resolution setting

nsfw_checkerboolean任意

Disables content filtering when set to false

例
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "hailuo/2-3-image-to-video-standard",
  "input": {
    "prompt": "Animate the image with natural motion, subtle camera movement, and cinematic lighting.",
    "image_url": "https://example.com/input.jpg",
    "duration": "6",
    "resolution": "768P",
    "nsfw_checker": false
  }
}'

Hailuo 02 · Text to Video

POSTText to Videohailuo/02-text-to-video-pro
input フィールド
promptstring必須

Text prompt for video generation (max 1500 chars)

prompt_optimizerboolean任意

Whether to use the model's prompt optimizer

nsfw_checkerboolean任意

Content filtering toggle; set false to disable filtering

例
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "hailuo/02-text-to-video-pro",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "prompt_optimizer": false,
    "nsfw_checker": false
  }
}'

Hailuo 02 · Image to Video

POSTImage to Videohailuo/02-image-to-video-pro
input フィールド
promptstring必須

Text prompt describing the desired video animation (max 1500 chars)

image_urlstring必須

Input image to animate; JPEG/PNG/WebP, max 10MB

end_image_urlstring任意

Optional URL for the final frame of the video

prompt_optimizerboolean任意

Whether to use the model's prompt optimizer

nsfw_checkerboolean任意

Content filtering toggle; false disables filtering

例
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "hailuo/02-image-to-video-pro",
  "input": {
    "prompt": "Animate the image with natural motion, subtle camera movement, and cinematic lighting.",
    "image_url": "https://example.com/input.jpg",
    "end_image_url": "https://example.com/input.jpg",
    "prompt_optimizer": false,
    "nsfw_checker": false
  }
}'

Hailuo 02 · Text to Video

POSTText to Videohailuo/02-text-to-video-standard
input フィールド
promptstring必須

Text description for video generation (max 1500 chars)

durationenum<string>任意

Video duration in seconds; 10s not supported at 1080p

prompt_optimizerboolean任意

Whether to use the model's prompt optimizer

nsfw_checkerboolean任意

Content filtering toggle

例
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "hailuo/02-text-to-video-standard",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "duration": "6",
    "prompt_optimizer": false,
    "nsfw_checker": false
  }
}'

Hailuo 02 · Image to Video

POSTImage to Videohailuo/02-image-to-video-standard
input フィールド
promptstring必須

Text description for video generation (max 1500 chars)

image_urlstring必須

URL of image to use as first video frame (JPEG/PNG/WebP, max 10MB)

end_image_urlstring任意

Optional URL of image to use as final video frame

durationenum<string>任意

Video duration in seconds

resolutionenum<string>任意

Output video resolution

prompt_optimizerboolean任意

Enable model's prompt optimization

nsfw_checkerboolean任意

Content filtering toggle; false disables filtering

例
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "hailuo/02-image-to-video-standard",
  "input": {
    "prompt": "Animate the image with natural motion, subtle camera movement, and cinematic lighting.",
    "image_url": "https://example.com/input.jpg",
    "end_image_url": "https://example.com/input.jpg",
    "duration": "10",
    "resolution": "768P",
    "prompt_optimizer": false,
    "nsfw_checker": false
  }
}'