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/seedance-1.5-pro"; const data = { "first_frame_url": "https://segmind-resources.s3.amazonaws.com/output/862b6e07-5f98-4a5a-9f04-25c45c38bfda-seedance_1.5_input.webp", "duration": 5, "prompt": "Rapid acceleration along a sunlit highway with the camera racing low to the ground, seamlessly overtaking passing vehicles in a fluid, dynamic motion. The surroundings blur with vibrant speed as road lines streak beneath and wind rushes past, conveying a continuous sense of velocity and momentum. Sunlight flashes between moving forms and shadows, while clouds drift quickly overhead and the perspective shifts with every subtle turn. Each overtaking maneuver is smooth and uninterrupted, highlighting pure movement and immersive traveling energy with no fire or sparks—just the true sensation of high-speed highway motion", "resolution": "720p", "seed": 12345, "camera_fixed": false, "aspect_ratio": "adaptive", "generate_audio": 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


first_frame_urlstr ( default: 1 )

Specifies the starting frame image. Use for improved transitions; example: https://example.com/start.png.


last_frame_urlstr ( default: 1 )

Specifies the ending frame image. Combine with start frame for coherent transitions; example: https://example.com/end.png.


durationenum:int *

Controls video length. Choose 2 for shorts, 10 for detailed scenes.

Allowed values:

min : 2,

max : 12


promptstr *

Defines the animation content. Describe vividly; example: A space odyssey with flying ships.


resolutionenum:str *

Sets video quality. Use 720p for standard view.

Allowed values:


seedint ( default: 12345 )

For consistent results, input a seed. Any number between 1-999999; example: 98765.

min : 1,

max : 999999


camera_fixedboolean ( default: 1 )

Determines camera movement. Enable for scenes needing stable views.


aspect_ratioenum:str *

Defines video shape. Use 16:9 for landscapes, 9:16 for mobiles.

Allowed values:


generate_audiobool ( default: true )

Activate to create audio. Essential for clips with sound elements.

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.

BytePlus Video: AI-Powered Text-to-Video Generation Model

Edited by Segmind Team on December 24, 2025.


What is BytePlus Video?

BytePlus Video is the latest AI model that turns text prompts into cinematic-quality videos, which also supports optional audio. This intelligent model is designed for video generation of up to 1080p resolution and 12 seconds in length, with dynamic, motion-rich animations. BytePlus Video delivers smooth, consistent video motion with customizable camera angles, aspect ratios, and scene transitions, making it far ahead of other static image generators. It is an ideal option for quick video prototyping, social media, and any multimedia projects that need intuitive, AI-driven video generation, so the developers and creative professionals can utilize it for producing professional-level videos from text prompts.

Key Features of BytePlus Video

  • Flexible Duration Control: It is perfect to generate 2 to 12-second videos needed for short-form content or detailed scene storytelling.
  • Multi-Resolution Support: It generates visual output at 480p, 720p, or 1080p resolutions, depending on quality requirements and bandwidth constraints.
  • Frame Transition Control: It supports custom start and end frames for seamless video loops and coherent visual transitions.
  • Adaptive Aspect Ratios: Supports landscape (16:9), square (1:1), portrait (9:16), and adaptive formats for platform-specific optimization.
  • Camera Movement Options: Users can toggle between dynamic camera motion and fixed perspectives for stable or cinematic effects.
  • Integrated Audio Generation: It is integrated with optional audio synthesis that perfectly aligns with video content for a holistic multimedia output.
  • Reproducible Results: It offers seed control (1-999999), which ensures consistent outputs across multiple generations.

Best Use Cases

BytePlus Video excels in rapid video content creation without traditional production workflows, making it invaluable for -

  • Social media marketers who can utilize it to generate platform-optimized clips for Instagram Reels, TikTok, and YouTube Shorts.
  • Product teams can leverage it for quick concept visualization and storyboarding before committing to full production.
  • E-learning platforms can automate explainer video creation for their educational content at scale.
  • Gaming studios can effectively leverage it to prototype cinematic sequences and environmental animations during pre-production.
  • Advertising agencies can benefit from its frame control features to create looping background videos.
  • App developers can build dynamic onboarding experiences.

Prompt Tips and Output Quality

Writing effective prompts requires balancing specificity with creative flexibility.

  • Start with clear subject descriptions, then add contextual details: "A majestic eagle soars gracefully through misty mountains, with sunlight breaking through, highlighting its plumage" works better than "eagle flying."
  • Include camera angles in brackets like [Wide shot] or [Close-up] to guide composition.

Resolution impacts both quality and processing time

  • Use 720p for standard web content; 1080p for high-detail requirements.
  • The duration parameter affects motion coherence: 2-5 seconds work best for focused actions, while 10-12 seconds suit narrative sequences.
  • Enable camera_fixed for product demonstrations or stable architectural visualizations; disable it for dynamic action scenes.

For consistent branding or iterative refinement, always specify a seed value.

  • To create content series, maintain the same seed while adjusting prompts.
  • The aspect_ratio parameter should match your distribution platform: use 9:16 for mobile-first content, 16:9 for YouTube, and 1:1 for Instagram feeds.

FAQs

Is BytePlus Video open-source?
BytePlus Video is a proprietary model accessible through Segmind's API. The model weights are not open-source, but comprehensive documentation and code examples are provided for integration.

How does it differ from other text-to-video models?
BytePlus Video comes with frame-level control (first/last frame specification), built-in audio generation, and aspect ratio flexibility; all these features often require separate tools in competing solutions.

What parameters should I tweak for the best results?
Start with resolution (720p balances quality/speed) and duration (5 seconds is optimal for most content). Fine-tune seed for consistency, adjust camera_fixed based on subject matter, and experiment with aspect_ratio for platform requirements.

Can I create looping videos?
Yes, the model supports creation of looping videos; set identical first_frame_url and last_frame_url to create seamless loops, which is particularly effective for background animations and product showcases.

Does the model support multiple languages in prompts?
The model primarily processes English prompts for optimal results; simple phrases in other languages will also generate appropriate content.

What video formats does it output?
BytePlus Video generates standard MP4 files with H.264 encoding, which is universally compatible with web players, mobile devices, and editing software.