Higgsfield Image 2 Video

Transform static images into dynamic, motion-rich videos with unparalleled control and creative depth.

~237.78s
$0.160 - $0.700 per generation
PlaygroundAPI
Pricing
 1import requests
 2import json
 3
 4url = "https://api.segmind.com/v1/higgsfield-image2video"
 5headers = {
 6    "x-api-key": "YOUR_API_KEY",
 7    "Content-Type": "application/json"
 8}
 9
10data = {
11    "model": "dop-preview",
12    "prompt": "Make the dress flow dramatically in the wind as the camera slowly circles around her, capturing the golden sunset light.",
13    "seed": 12345,
14    "motion_id": "c5881721-05b1-47d9-94d6-0203863114e1",
15    "motion_strength": 0.8,
16    "image_urls": [
17        "https://segmind-resources.s3.amazonaws.com/input/5d6b3638-b366-496c-847e-4eb91407b8df-128b5b18cad59a0885903ac2bba97087.png"
18    ],
19    "enhance_prompt": true,
20    "check_nsfw": true
21}
22
23response = requests.post(url, headers=headers, json=data)
24
25if response.status_code == 200:
26    result = response.json()
27    print(json.dumps(result, indent=2))
28else:
29    print(f"Error: {response.status_code}")
30    print(response.text)

API Endpoint

POSThttps://api.segmind.com/v1/higgsfield-image2video

Parameters

enhance_promptrequired
boolean

Enable to refine prompts. Improves output when set to true.

Default: null
modelrequired
string

Select the model quality. Use 'dop-preview' for high-quality renders, or 'dop-lite' for faster previews.

Default: null
Allowed values :
"dop-lite""dop-preview""dop-turbo"
motion_idrequired
string

Choose an animation style. 'Cinematic' for dramatic effects or '360 Orbit' for full scene views.

Default: null
Allowed values (122 total):
360 Orbit→"ea035f68-b350-40f1-b7f4-7dff999fdd67"
3D Rotation→"2bae49e6-ffe7-42a8-a73f-d44632c4acaa"
Abstract→"7f8971a6-9e96-45b6-a05a-8f5c99b1e13d"
Action Run→"dc8d7d9c-ae0c-45fc-b780-7d470b171b45"
Agent Reveal→"65b0a5a3-953d-471c-86d5-967ab44d0dab"
Angel Wings→"d21ff628-0d91-40b2-8508-cd5a0ce375d4"
Arc Left→"c5881721-05b1-47d9-94d6-0203863114e1"
Arc Right→"a85cb3f2-f2be-4ee2-b3b9-808fc6a81acc"
Baseball Kick→"ab0fa3d8-fcbe-4a6a-96bb-eae7a0e2c2cb"
Basketball Dunks→"1b4c1b9a-898b-451c-bff8-7288382ccaf2"
+112 more
promptrequired
string

Enter a detailed description for the animation. Use 'A futuristic skyline at sunset' for cityscapes.

Default: "Make the dress flow dramatically in the wind as the camera slowly circles around her, capturing the golden sunset light."
seedrequired
integer

Set random seed for consistent outputs. Change seed for varied results up to 1,000,000.

Default: nullRange: 1 - 1000000
check_nsfwoptional
boolean

Enable NSFW filter. Set true to block explicit content.

Default: true
image_urlsoptional
string[]

Include reference image URLs. Use high-res images for improved detail.

motion_strengthoptional
number

Control motion intensity; 0.3 for subtle effects, 1 for dramatic motion.

Default: 0.8Range: 0 - 1

Response Type

Returns: Video

Common Error Codes

The API returns standard HTTP status codes. Detailed error messages are provided in the response body.

400

Bad Request

Invalid parameters or request format

401

Unauthorized

Missing or invalid API key

403

Forbidden

Insufficient permissions

404

Not Found

Model or endpoint not found

406

Insufficient Credits

Not enough credits to process request

429

Rate Limited

Too many requests

500

Server Error

Internal server error

502

Bad Gateway

Service temporarily unavailable

504

Timeout

Request timed out