{
  "schema_version": 1,
  "public_model_id": "model/seedance-2.5",
  "canonical_page": "https://www.maxapi.dev/models/model/seedance-2.5",
  "reviewed_at": "2026-09-10",
  "generated_at": "2026-09-11T02:12:59.281Z",
  "scope": "Checked against MaxAPI's public catalogue, gateway implementation and local regression cases. Shared gateway checks are not separate end-to-end tests of every listed model. This is an integration reference, not a live upstream availability or performance report.",
  "summary": "Seedance 2.5 uses model/seedance-2.5 in MaxAPI's video-generation API. Submit a task, save its identifier, and poll for the final result. Acceptance is not completion. Supported media, duration and resolution depend on this model entry and the selected route.",
  "model_profile": {
    "family_id": "model/seedance-2.5",
    "reviewed_at": "2026-09-10",
    "title": "Longer storytelling and richer reference direction",
    "provider_positioning": "ByteDance positions Seedance 2.5 around up-to-30-second generation and stronger reference-video interpretation and editing. The official page also describes extension and production controls, which must not be assumed to be present on MaxAPI.",
    "selection_advice": "Compare it when a shot needs an introduction, a clear middle action and a conclusion rather than a very short motion test. MaxAPI currently lists 4–30 seconds at 720p for this entry; use that configuration when planning delivery.",
    "limitations": "A newer model number does not mean this entry supports 1080p, 4K, video extension or every official editing control. Long clips need continuity checks across their entire duration, and more references are not automatically better.",
    "suggested_use_cases": [
      {
        "title": "A complete short narrative",
        "body": "Write a beginning, one central action and an ending with approximate timing. Avoid overloading the available seconds."
      },
      {
        "title": "Reference-video interpretation",
        "body": "Specify whether the reference controls pacing, framing or movement. Explain which subject details must not be copied."
      },
      {
        "title": "Longer-shot continuity review",
        "body": "Review subject identity, motion transitions and the ending in separate passes before accepting the full clip."
      }
    ],
    "example_prompt": {
      "title": "A twenty-second miniature story",
      "text": "A single twenty-second scene in a quiet pottery studio. In the first five seconds, establish a finished blue cup on the worktable. Over the next ten seconds, a potter carefully turns the cup to inspect its glaze. In the final five seconds, place it back and hold a calm closing composition. Keep the cup shape, person and studio consistent. No scene changes, captions or unrelated actions.",
      "review": "Set 20 seconds in the API and check hand-object contact and continuity at each timing transition."
    },
    "scope": "Provider capabilities describe the model, not the complete MaxAPI feature set. Use the parameters, input types and routes documented for this MaxAPI entry. Vendor speed or quality descriptions are not service-level guarantees.",
    "variant_note": null,
    "sources": [
      {
        "label": "ByteDance · Seedance 2.5",
        "url": "https://seed.bytedance.com/en/seedance2_5"
      },
      {
        "label": "BytePlus · Seedance 2.x capability comparison",
        "url": "https://docs.byteplus.com/en/docs/byteplus_las/video_gen_enhanced"
      }
    ]
  },
  "illustration": {
    "url": "https://www.maxapi.dev/model-guides/individual-20260910/seedance-2-5.webp",
    "alt": "Pottery-workshop triptych showing an artisan making, inspecting and shelving a blue cup",
    "caption": "Static narrative storyboard: connect actions through one subject and location; not a video-length or continuity benchmark.",
    "provenance": "ai_generated_editorial_concept",
    "is_output_from_named_model": false,
    "is_benchmark": false
  },
  "illustrations": [
    {
      "section": "usecases",
      "url": "https://www.maxapi.dev/model-guides/individual-20260910/seedance-2-5.webp",
      "alt": "Pottery-workshop triptych showing an artisan making, inspecting and shelving a blue cup",
      "caption": "Static narrative storyboard: connect actions through one subject and location; not a video-length or continuity benchmark.",
      "width": 1536,
      "height": 1024,
      "provenance": "ai_generated_editorial_concept",
      "is_output_from_named_model": false,
      "is_benchmark": false
    },
    {
      "section": "features",
      "url": "https://www.maxapi.dev/model-guides/expanded-20260911/seedance-2-5-practice.webp",
      "alt": "Woman potter working beside a blue cup in an orderly workshop",
      "caption": "Establish the setting and subject before describing a sequence of actions.",
      "width": 1536,
      "height": 1024,
      "provenance": "ai_generated_editorial_concept",
      "is_output_from_named_model": false,
      "is_benchmark": false
    },
    {
      "section": "prompts",
      "url": "https://www.maxapi.dev/model-guides/expanded-20260911/seedance-2-5-prompt.webp",
      "alt": "Woman potter inspects a handmade blue cup at eye level by a workshop window.",
      "caption": "Static planning concept for a workshop story.",
      "width": 1536,
      "height": 1024,
      "provenance": "ai_generated_editorial_concept",
      "is_output_from_named_model": false,
      "is_benchmark": false
    },
    {
      "section": "workflow",
      "url": "https://www.maxapi.dev/model-guides/expanded-20260911/seedance-2-5-workflow.webp",
      "alt": "Potter storyboard prints beside the matching blue ceramic cup.",
      "caption": "Review subject and action continuity across the planned sequence.",
      "width": 1536,
      "height": 1024,
      "provenance": "ai_generated_editorial_concept",
      "is_output_from_named_model": false,
      "is_benchmark": false
    }
  ],
  "configured_facts": [
    {
      "label": "Request model ID",
      "value": "model/seedance-2.5",
      "code": true
    },
    {
      "label": "Output type",
      "value": "Video"
    },
    {
      "label": "Base URL",
      "value": "https://api.maxapi.dev",
      "code": true
    },
    {
      "label": "Generation workflow",
      "value": "Asynchronous task + polling"
    },
    {
      "label": "Quality values",
      "value": "720p",
      "code": true
    },
    {
      "label": "Resolution & dimensions",
      "value": "720p"
    },
    {
      "label": "Video duration",
      "value": "4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15 / 16 / 17 / 18 / 19 / 20 / 21 / 22 / 23 / 24 / 25 / 26 / 27 / 28 / 29 / 30 s"
    }
  ],
  "pricing_scope": "1 credit = US$1. These are catalogue base rates, not a live account quote. Account multipliers and the active billing configuration determine the final charge. Token rates are not a fixed price per image.",
  "pricing_index": "https://www.maxapi.dev/pricing.json",
  "routing_rules": [
    {
      "title": "Which route wins?",
      "body": "Routing priority is: the API key's configured route_modes list → an explicitly requested route → the model's default route. A non-empty key list takes precedence over route_mode in the request. To test a specific route, check the key configuration first; changing the request alone may not change the route used."
    },
    {
      "title": "A key cannot grant account permissions",
      "body": "The a, x and pro routes require the corresponding account permission. Listing one on an API key does not grant that permission. An unauthorized gated-route selection returns 403 rather than silently switching to a different pricing tier."
    },
    {
      "title": "RPM is shared at account level",
      "body": "An account's positive RPM limit covers its API keys together. A key can impose a stricter limit, but a higher key limit does not override the user limit. For example, a user limit of 200 RPM is not 200 RPM for each key. Service-level RPM and concurrency controls also apply; adding keys is not a way to bypass them."
    }
  ],
  "troubleshooting": [
    {
      "code": "403",
      "title": "a_route_not_enabled / x_route_not_enabled / pro_route_not_enabled",
      "meaning": "The selected restricted route is not enabled for the account. It is an access issue, not evidence that the model is offline.",
      "action": "Check both the account permission and the API key's route list. Select a route you are entitled to use or request access; do not solve a 403 by increasing retries."
    },
    {
      "code": "429",
      "title": "rate_limit_exceeded / capacity_exhausted",
      "meaning": "429 can represent account/key RPM, service-wide capacity or generation capacity. Use Retry-After and available X-RateLimit-* / X-Global-* headers to distinguish them; one status code does not identify one unique cause.",
      "action": "Respect Retry-After when present, reduce request rate or active concurrency as appropriate, and use bounded backoff. Do not treat the site's total capacity as your account's personal quota."
    }
  ],
  "verification": {
    "environment": "local_mock_requests_and_test_storage",
    "coverage": "shared_gateway_components_not_each_model_end_to_end",
    "paid_upstream_calls": 0,
    "reviewed_at": "2026-09-10",
    "cases": [
      {
        "key": "shared-user-rpm",
        "title": "Multiple keys share the user limit",
        "input": "Use two keys owned by the same account against an in-memory limiter with a small user quota.",
        "result": "Requests across the keys consume the same user quota; subsequent requests are limited. A larger key quota does not override the user quota, and a smaller key quota remains effective."
      }
    ],
    "limitations": "Local tests use simulated requests, responses and test storage; they do not call paid model channels. They verify request handling, not model image quality, live success rates, latency or end-to-end support for the maximum reference count. The concept illustrations elsewhere on this page are not these test outputs."
  },
  "sources": {
    "maxapi_documentation": "https://www.maxapi.dev/docs",
    "catalogue": "https://www.maxapi.dev/models.json",
    "provider_documentation": "https://seed.bytedance.com/en/seedance2_5"
  }
}