ByteDance: Seedance 2.5 (Text to Video) API Reference

About

Dreamina Seedance 2.5 generates native 30-second single-shot video at up to 720p from a single text prompt, reasoning about the whole shot at once so motion, lighting, and subject identity stay coherent from first frame to last.

1. Calling the API

Setup your API Key

To begin using Infron, you first need to create an account and generate your API Key.

Once you have your API key, set it as an environment variable in your runtime environment. This allows your applications to securely access Infron’s API.

export INFRON_KEY="YOUR_API_KEY"

Submit a request

For long-running requests, you can poll for results.

curl https://media.onerouter.pro/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
-d @- <<'EOF'
{
  "model": "bytedance/seedance-2.5/text-to-video",
  "prompt": "Live-Action Anime Adaptation · Breathing Technique Clash — `Ember vs Gale` (5 seconds · Hyper-Speed Burning FX Version)【Core Focus】: Ember Breathing (Crimson Phoenix) VS Gale Breathing (Silver Whirlwind Serpent) — live-action, three-beat instant-kill exchange. Zero downtime, pure velocity.【Style】: Hollywood live-action anime adaptation quality, dark samurai aesthetic, 4K ultra-clear, whip-pan cuts every 1.5s, volumetric particle FX, high-contrast rim lighting, no gore.【Duration】: 5 seconds【Scene】: Storm-battered coastal cliff shrine at dusk. Rows of half-collapsed red torii gates, black volcanic sand, sheet rain driven sideways, sea spray exploding off the rocks below, distant lightning strobing the sky.【Camera】: Handheld-stabilized, low angle, aggressive dolly-in. Motion-blur streaks on every cut. Two frames of hard black between shots.",
  "aspect_ratio": "adaptive",
  "duration": "-1",
  "resolution": "720p",
  "generate_audio": true,
  "n": 1,
  "seed": 123456
}
EOF

Response with queue task id

The response will look like this:

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "20260810071740512070642ScEacnZX",
    "object": "video",
    "model": "bytedance/seedance-2.5/text-to-video",
    "status": "created",
    "urls": {
      "query": "https://media.onerouter.pro/v1/videos/tasks/20260810071740512070642ScEacnZX"
    },
    "created_at": "2026-08-10 07:17:40.56"
  }
}

Fetch request status

You can fetch the status of a request to check if it is completed or still in progress.

curl https://media.onerouter.pro/v1/videos/tasks/{task_id} \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" 

# For example
curl https://media.onerouter.pro/v1/videos/tasks/20260810071740512070642ScEacnZX \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response with queue task status query

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "20260810071740512070642ScEacnZX",
    "object": "video",
    "model": "bytedance/seedance-2.5/text-to-video",
    "status": "in_progress",
    "fail_reason": "",
    "submit_time": 1786346261,
    "start_time": 1786346260,
    "finish_time": 0,
    "outputs": [],
    "created_at": "2026-08-10 07:17:41"
  }
}

Possible statuses:

• created
• in_progress
• processing
• completed
• failed

created -> in_progress → processing → completed | failed

Poll every 1-2 seconds until status is "completed" or "failed"

Get the result (when status is "completed")

Once the request is completed, you can fetch the result. See the Output Schema for the expected result format.

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "20260810071740512070642ScEacnZX",
    "object": "video",
    "model": "bytedance/seedance-2.5/text-to-video",
    "status": "completed",
    "fail_reason": "",
    "submit_time": 1786346261,
    "start_time": 1786346260,
    "finish_time": 1786346462,
    "outputs": [
      "https://infron.ai/cdn/media/video/video_v2/output/output_d8b89894-2bd7-44a6-9e11-65f064bc615e.mp4"
    ],
    "usage": {
      "completion_tokens": 108900,
      "duration": 5,
      "generate_audio": true,
      "output_count": 1,
      "prompt_tokens": 0,
      "request_num": 1,
      "resolution": "720p",
      "tokens": 108900,
      "total_tokens": 108900,
      "video_duration": 5
    },
    "cost": {
      "total_cost": 1.16523,
      "cost_details": {
        "prompt_cost": 0,
        "completion_cost": 0,
        "image_cost": 0,
        "video_cost": 1.16523,
        "audio_cost": 0,
        "native_web_search_cost": 0,
        "plugin_web_search_cost": 0,
        "tools_cost": 0,
        "prompt_cache_read_cost": 0,
        "prompt_cache_write_cost": 0,
        "prompt_cache_write_5_min": 0,
        "prompt_cache_write_1_h": 0,
        "reasoning_cost": 0,
        "discount_rate": 1,
        "is_byok": false,
        "byok_cost": 0
      }
    },
    "created_at": "2026-08-10 07:17:41"
  }
}

2. Schema

Input

Example request

curl https://media.onerouter.pro/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
-d @- <<'EOF'
{
  "model": "bytedance/seedance-2.5/text-to-video",
  "prompt": "Live-Action Anime Adaptation · Breathing Technique Clash — `Ember vs Gale` (5 seconds · Hyper-Speed Burning FX Version)【Core Focus】: Ember Breathing (Crimson Phoenix) VS Gale Breathing (Silver Whirlwind Serpent) — live-action, three-beat instant-kill exchange. Zero downtime, pure velocity.【Style】: Hollywood live-action anime adaptation quality, dark samurai aesthetic, 4K ultra-clear, whip-pan cuts every 1.5s, volumetric particle FX, high-contrast rim lighting, no gore.【Duration】: 5 seconds【Scene】: Storm-battered coastal cliff shrine at dusk. Rows of half-collapsed red torii gates, black volcanic sand, sheet rain driven sideways, sea spray exploding off the rocks below, distant lightning strobing the sky.【Camera】: Handheld-stabilized, low angle, aggressive dolly-in. Motion-blur streaks on every cut. Two frames of hard black between shots.",
  "aspect_ratio": "adaptive",
  "duration": "-1",
  "resolution": "720p",
  "generate_audio": true,
  "n": 1,
  "seed": 123456
}
EOF

Output

Example output

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "20260810071740512070642ScEacnZX",
    "object": "video",
    "model": "bytedance/seedance-2.5/text-to-video",
    "status": "completed",
    "fail_reason": "",
    "submit_time": 1786346261,
    "start_time": 1786346260,
    "finish_time": 1786346462,
    "outputs": [
      "https://infron.ai/cdn/media/video/video_v2/output/output_d8b89894-2bd7-44a6-9e11-65f064bc615e.mp4"
    ],
    "usage": {
      "completion_tokens": 108900,
      "duration": 5,
      "generate_audio": true,
      "output_count": 1,
      "prompt_tokens": 0,
      "request_num": 1,
      "resolution": "720p",
      "tokens": 108900,
      "total_tokens": 108900,
      "video_duration": 5
    },
    "cost": {
      "total_cost": 1.16523,
      "cost_details": {
        "prompt_cost": 0,
        "completion_cost": 0,
        "image_cost": 0,
        "video_cost": 1.16523,
        "audio_cost": 0,
        "native_web_search_cost": 0,
        "plugin_web_search_cost": 0,
        "tools_cost": 0,
        "prompt_cache_read_cost": 0,
        "prompt_cache_write_cost": 0,
        "prompt_cache_write_5_min": 0,
        "prompt_cache_write_1_h": 0,
        "reasoning_cost": 0,
        "discount_rate": 1,
        "is_byok": false,
        "byok_cost": 0
      }
    },
    "created_at": "2026-08-10 07:17:41"
  }
}

3. Detailed Pricing