seedance-2.0-api README

The project's README from github.com/apiframe-ai/seedance-2.0-api. As one markdown file: README.md.

Seedance 2.0 API

Examples for calling the Seedance 2.0 API (ByteDance text-to-video and image-to-video) through Apiframe.

Model page: Seedance 2.0 API

This repo does not host model weights. Seedance is a closed model. Inference runs on POST /v2/videos/generate with model: "seedance-2".

Related model ids on the same endpoint: seedance-2.5, seedance-2-fast, seedance-2-mini.

What is Seedance 2.0?

Seedance 2.0 is ByteDance's video generation model. It supports text-to-video, image-to-video, and multimodal reference-to-video (images, video, audio), with native synchronized audio. Clips are 4–15 seconds at 480p, 720p, 1080p, or 4K.

Quick start

export APIFRAME_API_KEY=afk_your_api_key_here

Python

pip install requests

import os
import time
import requests

API = "https://api.apiframe.ai/v2"
headers = {
    "X-API-Key": os.environ["APIFRAME_API_KEY"],
    "Content-Type": "application/json",
}

job = requests.post(
    f"{API}/videos/generate",
    headers=headers,
    json={
        "model": "seedance-2",
        "prompt": "A cinematic slow-motion shot of a golden eagle soaring through a mountain valley at sunrise.",
        "seedanceParams": {
            "duration": 8,
            "resolution": "720p",
            "aspect_ratio": "16:9",
            "generate_audio": True,
        },
    },
).json()

while True:
    result = requests.get(f"{API}/jobs/{job['jobId']}", headers=headers).json()
    if result["status"] in ("COMPLETED", "FAILED"):
        break
    time.sleep(2)

print(result.get("result"))

JavaScript

npm i @apiframe-ai/sdk@next

import { Apiframe } from "@apiframe-ai/sdk";

const client = new Apiframe({ apiKey: process.env.APIFRAME_API_KEY });

const { jobId } = await client.videos.generate({
  model: "seedance-2",
  prompt:
    "A cinematic slow-motion shot of a golden eagle soaring through a mountain valley at sunrise.",
  seedanceParams: {
    duration: 8,
    resolution: "720p",
    aspect_ratio: "16:9",
    generate_audio: true,
  },
});

const job = await client.jobs.waitFor(jobId);
console.log(job.result);

Pass webhookUrl on the generate call if you do not want to poll.

Parameters

Parameter Type Default Description
prompt string required Text description of the video
seedanceParams.duration integer 8 Seconds, 4–15
seedanceParams.resolution string "720p" 480p, 720p, 1080p, 4k
seedanceParams.aspect_ratio string "16:9" 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptive
seedanceParams.start_image string — First-frame URL (image-to-video)
seedanceParams.end_image string — Last-frame URL
seedanceParams.reference_image_urls string[] — Up to 9 reference images
seedanceParams.reference_video_urls string[] — Up to 3 reference videos
seedanceParams.reference_audio_urls string[] — Up to 3 reference audio files
seedanceParams.generate_audio boolean true Native synchronized audio
seedanceParams.seed integer — Reproducible generations
seedanceParams.camera_fixed boolean false Lock the camera
seedanceParams.web_search boolean false Ground the prompt with web search

Image to video

requests.post(
    "https://api.apiframe.ai/v2/videos/generate",
    headers=headers,
    json={
        "model": "seedance-2",
        "prompt": "She slowly turns to face the camera, wind catching her hair.",
        "seedanceParams": {
            "start_image": "https://example.com/portrait.jpg",
            "duration": 8,
            "resolution": "720p",
        },
    },
)

Reference to video

requests.post(
    "https://api.apiframe.ai/v2/videos/generate",
    headers=headers,
    json={
        "model": "seedance-2",
        "prompt": "The person from the reference image walks down a neon-lit street at night.",
        "seedanceParams": {
            "reference_image_urls": ["https://example.com/character.jpg"],
            "duration": 10,
            "resolution": "720p",
        },
    },
)

Start/end frames and reference media are mutually exclusive on Seedance 2.5. On Seedance 2.0 they can be combined; keep inputs consistent.

Output

{
  "videoUrl": "https://cdn2.apiframe.ai/videos/….mp4"
}

Examples

Example Python JavaScript
Text to video text_to_video.py text_to_video.js
Image to video image_to_video.py image_to_video.js
Reference to video reference_to_video.py reference_to_video.js 
cp .env.example .env
# set APIFRAME_API_KEY
python examples/text_to_video.py

License

Example code in this repository is provided as-is. Seedance outputs are subject to ByteDance's terms. Seedance is a trademark of ByteDance Ltd.

seedance-2.0-api (apiframe-ai/seedance-2.0-api)

Searching Database…

329 ·GitHub
Seedance-2.0-api
What is this?This repo contains example scripts for calling ByteDance's Seedance 2.0 video generation model through the Apiframe API, covering text-to-video, image-to-video, and reference-to-video generation.
Is this an installable library or just example code?It's just sample scripts, not a packaged SDK — there's no install step beyond copying the Python or JavaScript examples and pointing them at the API endpoint.
How do I generate a video with this?Send a POST request to /v2/videos/generate with model set to 'seedance-2' plus a prompt and optional seedanceParams; the repo includes matching Python and JavaScript examples for text-to-video, image-to-video, and reference-to-video.
Do I have to poll for the result, or can I get notified instead?You can avoid polling by passing a webhookUrl on the generate call, which notifies you when the video is ready.
Can I run this model locally or get the weights?No — Seedance is a closed model and this repo does not include or host any model weights; access is only through the hosted API.
What is Apiframe here?Apiframe is the API provider this repo talks to; it proxies requests to ByteDance's closed Seedance 2.0 model behind a single /v2/videos/generate endpoint.
What video lengths and resolutions can I generate?Clips can be 4–15 seconds long, rendered at 480p, 720p, 1080p, or 4K, with aspect ratios ranging from 21:9 to 9:16.
Can I mix reference images, videos, and audio in one request?Yes — you can supply up to 9 reference images, 3 reference videos, and 3 reference audio clips, and on Seedance 2.0 these can be combined with start/end frames (unlike Seedance 2.5, where they're mutually exclusive).
Does the generated video include sound?Yes, generateaudio defaults to true, so Seedance 2.0 produces native synchronized audio along with the video by default.
What are similar projects?MiniMax-H3, seedance2-skill, DreamX-Creator, LTX-Video, awesome-seedance, awesome-minimax-h3-integration, ComfyUI-ALLinONE-MinimaxH3, Open-Sora-Plan
Which topics is it in?seedance, image-to-video, audio-generation, text-to-video, webhooks, examples, multimodal, video-generation, artificial-intelligence, video, generative-ai, china
Creator
apiframe-ai
Size
<0.1 MB
Stars
329
Updated
CommitAug 14
Age
2mo
Commits · 90 Days