Skip to content

Bytedance Seedance 1.5 Pro ​

Endpoint ​

POST /videos/generations

Full URL: https://modelfold.ai/v1/videos/generations

Authentication: every request must include the Authorization: Bearer <API_KEY> header.

Send model parameters directly in the JSON body. Do not wrap them in input. This request waits for generation to finish and returns data[].url; supported media models also offer async jobs, polling and callbacks. Replace example media URLs with your own publicly accessible files. See API gateway for billing and errors.

Input parameters for the generation task

Request Parameters ​

Body (application/json) ​

ParameterTypeRequiredDescription
modelstringYesThe model name to use for generation. Required field.
- Must be bytedance/seedance-1.5-pro for this endpoint Default:"bytedance/seedance-1.5-pro"。 Allowed values:bytedance/seedance-1.5-pro。 Example:bytedance/seedance-1.5-pro。
promptstringYesPrompt required by the ModelFold gateway; at most 2000 characters. The text prompt used to generate the video. Required field. (Min length: 3, Max length: 20000 characters) minLength: 3. maxLength: 2000. Example:A serene beach at sunset with waves gently crashing on the shore, palm trees swaying in the breeze, and seagulls flying across the orange sky。
input_urlsarray&lt;string&gt;NoURLs of input images for image-to-video generation. Optional field.
- Accepts 0-2 images
- If not provided, the model will perform text-to-video generation
- File URLs after upload, not file content
- Accepted types: image/jpeg, image/png, image/webp
- Max size per image: 10.0MB maxItems: 2.
aspect_ratiostringYesRequired. One of 1:1, 4:3, 3:4, 16:9, 9:16, 21:9. Allowed values:1:1 / 4:3 / 3:4 / 16:9 / 9:16 / 21:9。 Example:1:1。
resolutionstringNoVideo resolution - 480p for faster generation, 720p for balance, 1080p for higher quality Default:"720p"。 Allowed values:480p / 720p / 1080p。 Example:720p。
durationnumberYesRequired. Output length in whole seconds, 4–12. ModelFold minimum: 4 seconds; -1 is not supported.
fixed_lensbooleanNoSeedance adds dynamic camera movement. Enable this feature to lock the camera for stable, static shots.
- true: Lock camera for static shots
- false: Allow dynamic camera movement Default:false。 Example:false。
generate_audiobooleanNoWhether to generate synchronized audio. Default: true. Pass false for a silent video. Audio doubles the per-second price. Default:true。 Example:false。
nsfw_checkerbooleanNoDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.

Request Example ​

bash
curl -X POST "https://modelfold.ai/v1/videos/generations" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bytedance/seedance-1.5-pro",
  "prompt": "A serene beach at sunset with waves gently crashing on the shore, palm trees swaying in the breeze, and seagulls flying across the orange sky",
  "aspect_ratio": "1:1",
  "duration": 5,
  "resolution": "720p",
  "fixed_lens": false,
  "generate_audio": true
}'
json
{
  "model": "bytedance/seedance-1.5-pro",
  "prompt": "A serene beach at sunset with waves gently crashing on the shore, palm trees swaying in the breeze, and seagulls flying across the orange sky",
  "aspect_ratio": "1:1",
  "duration": 5,
  "resolution": "720p",
  "fixed_lens": false,
  "generate_audio": true
}

Response ​

200 — Generation completed. usage contains actual billing details; result URLs are illustrative. ​

json
{
  "ok": true,
  "created": 1792134000,
  "data": [
    {
      "url": "https://modelfold.ai/uploads/outputs/result.mp4"
    }
  ],
  "usage": {}
}

ModelFold — one API for all the best AI models.