Generate (Official Image-to-Video Generation)

POST

/higgsfield/v1/image2video

A video generation model from higgsfield.ai that generates videos from images.
Supports inputting 1 or 2 templates to generate adaptations with specific effects.
When 2 templates are provided, the effects will be automatically combined.
Note: Prompts will greatly affect the final result. The best results are achieved without prompts. If you must use a prompt, please include the template description.

Price: lite 0.1375 PTC / time
Price: standard 0.6188 PTC / time
Price: turbo 0.4466 PTC / time

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 ' \
--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:00:44

Motions (Get Template List)

Speak (Digital Human Generation)