Generate（公式画像から動画生成）

POST

/higgsfield/v1/image2video

higgsfield.aiの動画生成モデルで、画像から動画を生成します。
1つまたは2つのテンプレートを指定して、特定の効果を適用できます。
2つのテンプレートを指定した場合、効果は自動的に重ね合わせられます。
注意：プロンプトは最終的な効果に大きく影響します。プロンプトを入力しない場合が最も良い効果となります。どうしても入力する場合は、テンプレートの説明を含めてください。

価格：lite 0.1375 PTC / 回
価格：standard 0.6188 PTC / 回
価格：turbo 0.4466 PTC / 回

Request

Header Params

Body Params application/json

Example

{
    "params": {
        "model": "dop-lite",
        "prompt": "a cat",
        "seed": 500000,
        "motions": [
            {
                "id": "2bae49e6-ffe7-42a8-a73f-d44632c4acaa",
                "strength": 0.5
            }
        ],
        "input_images": [
            {
                "type": "image_url",
                "image_url": "https://file.302.ai/gpt/imgs/c2699a9527d4840969529dac3cd0d8cd.jpg"
            }
        ],
        "enhance_prompt": true,
        "check_nsfw": true
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/higgsfield/v1/image2video' \
--header 'Authorization: Bearer sk-mfYQzy0XTFfz4P16vRE4gFrKK1Nly4TozsMqbbb9PSiJUvFO' \
--header 'Content-Type: application/json' \
--data-raw '{
    "params": {
        "model": "dop-lite",
        "prompt": "a cat",
        "seed": 500000,
        "motions": [
            {
                "id": "2bae49e6-ffe7-42a8-a73f-d44632c4acaa",
                "strength": 0.5
            }
        ],
        "input_images": [
            {
                "type": "image_url",
                "image_url": "https://file.302.ai/gpt/imgs/c2699a9527d4840969529dac3cd0d8cd.jpg"
            }
        ],
        "enhance_prompt": true,
        "check_nsfw": true
    }
}'

Responses

🟢200成功

application/json

Body

Example

{
    "board_ids": [],
    "id": "higgsfield_472f8f0319ac",
    "result": null,
    "results": null,
    "status": "queued"
}

Modified at 2025-09-05 02:05:55

Motions（テンプレートリスト取得）

Speak（デジタルヒューマン生成）