POST
javascript
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 const axios = require('axios'); const api_key = "YOUR API-KEY"; const url = "https://api.segmind.com/v1/higgsfield-image2video"; const data = { "model": "dop-preview", "prompt": "Make the dress flow dramatically in the wind as the camera slowly circles around her, capturing the golden sunset light.", "seed": 12345, "motion_id": "c5881721-05b1-47d9-94d6-0203863114e1", "motion_strength": 0.8, "image_urls": "https://segmind-resources.s3.amazonaws.com/input/5d6b3638-b366-496c-847e-4eb91407b8df-128b5b18cad59a0885903ac2bba97087.png", "enhance_prompt": true, "check_nsfw": true }; (async function() { try { const response = await axios.post(url, data, { headers: { 'x-api-key': api_key } }); console.log(response.data); } catch (error) { console.error('Error:', error.response.data); } })();
RESPONSE
image/jpeg
HTTP Response Codes
200 - OKImage Generated
401 - UnauthorizedUser authentication failed
404 - Not FoundThe requested URL does not exist
405 - Method Not AllowedThe requested HTTP method is not allowed
406 - Not AcceptableNot enough credits
500 - Server ErrorServer had some issue with processing

Attributes


modelenum:str *

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

Allowed values:


promptstr *

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


seedint *

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

min : 1,

max : 1000000


motion_idstr *

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


motion_strengthfloat ( default: 0.8 )

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

min : 0,

max : 1


image_urlsstr ( default: https://segmind-resources.s3.amazonaws.com/input/5d6b3638-b366-496c-847e-4eb91407b8df-128b5b18cad59a0885903ac2bba97087.png )

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


enhance_promptboolean *

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


check_nsfwboolean ( default: true )

Enable NSFW filter. Set true to block explicit content.

To keep track of your credit usage, you can inspect the response headers of each API call. The x-remaining-credits property will indicate the number of remaining credits in your account. Ensure you monitor this value to avoid any disruptions in your API usage.

Generate [DoP]: Image-to-Video Animation Model

What is Generate [DoP]?

Generate [DoP] is a dynamic AI model that creates motion-rich videos from basic images. Developed by Higgsfield, this latest AI model empowers users to generate impressive videos, giving them unfettered control while transforming photos into stunning animations. It offers a library of 100+ motion presets and parameters, including quality tiers in the form of "lite", "preview", and "turbo", ensuring speedy, high-quality results, making it a multifunctional model in terms of production.

Key Features of Generate [DoP]

  • It includes 100+ specialized motion presets - cinematic effects, 3D rotations, and dynamic transitions
  • It offers flexibility in terms of motion strength for precise animation control
  • It supports multiple quality tiers for different use cases: dop-lite, dop-preview, dop-turbo
  • It comes with built-in prompt enhancement capabilities
  • It is integrated with content safety filters
  • It provides Webhook support for render completion notifications
  • It allows seed control for uniform results that are reproducible

Best Use Cases

  • Content Creation: Users can easily create clickable social media content from raw photos
  • Digital Marketing: Anyone can design dynamic advertisements from static images
  • Entertainment: Produce music video effects with creative transitions without high-end tools
  • E-commerce: Utilize professional motion effects for animating product showcases
  • Education: Make learning fun by transforming dull instructional images into entertaining (and informative) video content
  • Art & Design: Bring art alive by adding animation to still digital artwork and illustrations

Prompt Tips and Output Quality

  • Provide precise descriptions in prompts for the motion effects that you want (e.g., "Sunset over the ocean with a flock of flying birds and gentle moving waves")
  • You can adjust motion_strength between 0.3-1.0 (or lower it for softer effects; higher for dramatic motion)
  • A high-resolution input image will yield better output in terms of quality
  • To create complex scenes, you can enable enhance_prompt
  • You will find the right animation style that suits your vision by experimenting with different motion presets
  • To achieve consistency in different renditions, the seed parameter is the best option

FAQs

What's the difference between dop-lite, preview, and turbo modes? Generate [DoP] includes multiple quality tiers for different use cases - Dop-lite is ideal for faster rendering and quick previews; dop-preview provides high-quality output; and dop-turbo offers maximum performance and quality.

How do I achieve consistent results across multiple generations? With Generate [DoP], it is pretty easy to maintain consistent quality in your animation style and movement patterns by using the same seed value between 1-1,000,000.

Can I combine different motion effects? When you create any video, it utilizes one motion preset. But you can create multilayered animation by combining different prompts and adjusting motion_strength.

How can I optimize my input images for the best results? Best results require high-resolution images with optimal light and clearly visible subjects. Additionally, Generate [DoP] will render high-quality results when it is provided with images having good contrast and sharp details.

Is the model safe for commercial use? Yes, Generate [DoP] comes with built-in NSFW filtering (enabled by default) and content safety checks, making it ideal for commercial use.