Bytedance Text to Video

Readme

Seedance 1.0 Pro Fast [Text-to-Video]

Transform text prompts into professional-grade videos with ByteDance's next-generation video model engineered for maximum performance at minimal cost.

Overview

Seedance 1.0 Pro Fast delivers high-quality video generation from text prompts with exceptional speed and efficiency. Built to support versatile production workflows, this model excels at creating videos with realistic motion and physical stability—making it ideal for everything from social media content to commercial productions. Generate compelling visual narratives without requiring complex video editing skills or production infrastructure.

Key Capabilities

• Text-to-video transformation: Convert detailed text descriptions directly into coherent, high-quality video sequences
• Fast inference times: Deliver quick turnarounds for time-sensitive content creation workflows
• Wide dynamic range: Generate smooth large-scale movements from subtle expressions to active scenes with high stability
• Production-ready output: Create commercially viable videos suitable for marketing, social media, and professional applications

Popular Use Cases

Social Media Content Creation
Generate engaging video content for Instagram Reels, TikTok, and YouTube Shorts directly from text descriptions. Transform product descriptions, promotional copy, or creative concepts into thumb-stopping videos that capture attention across multiple platforms without hiring production crews or investing in expensive equipment.

Marketing and Advertising
Create compelling commercial video content for campaigns, product launches, and brand storytelling. Generate multiple variations of marketing videos to test different messaging approaches, visual styles, and creative directions—enabling rapid iteration and A/B testing at a fraction of traditional production costs.

Educational and Training Content
Develop instructional videos, demonstrations, and training materials by describing the scenes you need. Produce consistent, professional-quality educational content that illustrates complex concepts, procedures, or workflows without coordinating filming schedules or managing production logistics.

Getting Started

Getting up and running with Seedance 1.0 Pro Fast takes just a few minutes. Here's how to begin:

1. Get your API key
Sign up at https://fal.ai/login to obtain your credentials and access the platform.

2. Install the client library
Add the fal.ai client to your project:

bash
npm install --save @fal-ai/client

3. Make your first API call
Submit a video generation request with your text prompt:

javascript
import { fal } from "@fal-ai/client";

fal.config({
  credentials: "YOUR_FAL_KEY"
});

const result = await fal.subscribe("fal-ai/bytedance/seedance/v1/pro/fast/text-to-video", {
  input: {
    prompt: "Inside a quiet dojo, a martial artist moves with precision and grace. The performance highlights the beauty and discipline inherent in the ancient practice. Each form unfolds clearly, a testament to dedication and skill."
  },
  logs: true,
  onQueueUpdate: (update) => {
    if (update.status === "IN_PROGRESS") {
      update.logs.map((log) => log.message).forEach(console.log);
    }
  }
});

// Access the generated video
console.log(result.data.video.url);
console.log(result.requestId);

For Python developers:

python
from fal_client import FalClient

client = FalClient("YOUR_FAL_KEY")
result = client.subscribe("fal-ai/bytedance/seedance/v1/pro/fast/text-to-video", {
    "prompt": "Inside a quiet dojo, a martial artist moves with precision and grace. The performance highlights the beauty and discipline inherent in the ancient practice. Each form unfolds clearly, a testament to dedication and skill."
})

# Access the generated video
print(result["video"]["url"])

Technical Specifications

Model Architecture

• Next-generation text-to-video model optimized for speed and quality balance
• Designed for commercial-scale deployment with reliable performance
• Features wide dynamic range enabling smooth generation of large-scale movements, from subtle expressions to active scenes with high stability and physical realism

Input Capabilities

• Text prompt-based video generation
• Default output: 1080p resolution at standard frame rates

Performance

• Fast inference optimized for production workflows
• Queue-based processing with status tracking and webhooks
• Scalable infrastructure for handling multiple concurrent requests
• No charges for cold starts or server errors (5xx)

Best Practices

Achieve optimal results with these proven approaches:

Craft Detailed, Specific Prompts
The quality of your generated video directly correlates with prompt specificity. Instead of generic descriptions like "a person walking," provide rich contextual details: "A young woman in a red coat walks confidently down a rain-slicked city street at dusk, her reflection shimmering in puddles as neon signs illuminate the background." Include information about movement, lighting, atmosphere, and visual style to guide the model toward your creative vision. ByteDance's Seedance technology excels at translating nuanced descriptions into visually coherent sequences.

Leverage the Queue System for Production Workflows
For applications requiring multiple video generations or integration into larger content pipelines, utilize the queue system with webhooks rather than blocking operations. This approach enables you to submit requests asynchronously, track progress through status updates, and retrieve results when ready—essential for building responsive applications that maintain performance under load. Consider implementing webhook endpoints to automatically process completed videos without polling.

Combine with Other AI Tools for Complete Workflows
Maximize creative potential by integrating Seedance into broader AI-powered production pipelines. Start with AI image generators like Flux to create reference frames, then extend them into video sequences. Add AI-generated music through CassetteAI or create talking head videos with lipsync capabilities to build complete multimedia experiences that would traditionally require entire production teams.

Advanced Features

Webhook Integration for Asynchronous Processing
Configure webhook URLs to receive automatic notifications when video generation completes, enabling event-driven architectures and seamless integration with existing systems:

javascript
const { request_id } = await fal.queue.submit("fal-ai/bytedance/seedance/v1/pro/fast/text-to-video", {
  input: {
    prompt: "A serene mountain landscape at sunrise, with mist rolling through valleys"
  },
  webhookUrl: "https://your-domain.com/webhooks/video-complete"
});

Queue Management and Status Tracking
Monitor generation progress in real-time and implement sophisticated retry logic for production applications:

javascript
const status = await fal.queue.status("fal-ai/bytedance/seedance/v1/pro/fast/text-to-video", {
  requestId: request_id,
  logs: true
});

// Retrieve result when ready
const result = await fal.queue.result("fal-ai/bytedance/seedance/v1/pro/fast/text-to-video", {
  requestId: request_id
});

API Reference

typescript
interface SeedanceInput {
  prompt: string; // Detailed text description of the video to generate (required)
  webhookUrl?: string; // Optional webhook URL for completion notifications
}

interface SeedanceOutput {
  video: {
    url: string; // URL to the generated video file
    content_type: string; // MIME type of the video (e.g., "video/mp4")
    file_name: string; // Generated filename
    file_size: number; // Size of the video file in bytes
  };
  seed: number; // Random seed used for generation
}

Pricing and Usage

Seedance 1.0 Pro Fast uses token-based pricing calculated by video dimensions and duration. Each 1080p 5-second video costs approximately $0.245. For other resolutions, pricing is $1 per million video tokens, where:

tokens(video) = (height × width × FPS × duration) / 1024

Billing Notes:

• Server errors (5xx) are not charged
• Client errors (422) are charged
• Cold starts incur no additional costs
• Purchased credits expire in 365 days; free credits expire in 90 days

For enterprise solutions requiring custom volume arrangements, private deployments, or dedicated infrastructure, contact sales for tailored pricing options. Volume discounts are available for high-usage customers.

Support and Resources

We're here to help you succeed with Seedance 1.0 Pro Fast:

• Documentation: Explore comprehensive guides and API references at https://docs.fal.ai/
• Interactive Playground: Test the model and experiment with different prompts at the Seedance playground
• Alternative Versions: Explore the Seedance 1.0 Lite version for different performance characteristics
• Developer Support: Access technical assistance and integration guidance through our community channels

Ready to transform text into compelling video content? Sign up now at https://fal.ai and start creating with Seedance 1.0 Pro Fast.

Get Started