> ## Documentation Index
> Fetch the complete documentation index at: https://docs.higgsfield.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Seedance 2.5 Video Extend API

> Video extend with ByteDance Seedance 2.5 through the Higgsfield API.

<div className="models-color-scope" aria-hidden="true" />

<div className="model-workflow-tabs" aria-label="Seedance endpoints">
  <a className="model-workflow-tab" href="/docs/models/seedance-2-5/text-to-video">Text to video</a>
  <a className="model-workflow-tab" href="/docs/models/seedance-2-5/image-to-video">Image to video</a>
  <a className="model-workflow-tab" href="/docs/models/seedance-2-5/reference-to-video">Reference to video</a>
  <a className="model-workflow-tab" href="/docs/models/seedance-2-5/video-edit">Video edit</a>
  <a className="model-workflow-tab is-active" href="/docs/models/seedance-2-5/video-extend">Video extend</a>
</div>

**Endpoint:** `POST https://api.higgsfield.ai/bytedance/seedance-2.5/video-extend`

**Endpoint ID:** `bytedance/seedance-2.5/video-extend`

<a className="model-playground-card" href="https://console.higgsfield.ai/models/bytedance%2Fseedance-2.5%2Fvideo-extend/playground" target="_blank" rel="noreferrer">
  <span className="model-playground-icon">▶</span>
  <span className="model-playground-copy"><span className="model-playground-title">Try Seedance 2.5 Video Extend</span><span>Open this endpoint in the Higgsfield API Playground.</span></span>
  <span className="model-card-arrow">↗</span>
</a>

## Quick Start

<CodeGroup>
  ```python Python theme={"dark"}
  import higgsfield_client

  result = higgsfield_client.subscribe(
      "bytedance/seedance-2.5/video-extend",
      arguments={'prompt': 'Continue the camera movement along the coast',
   'resolution': '720p',
   'generate_audio': True,
   'duration': 5,
   'video_url': 'https://cdn.example.com/source.mp4',
   'output_format': 'mp4'},
  )

  print(result["video"]["url"])
  ```

  ```typescript TypeScript theme={"dark"}
  import { config, higgsfield } from "@higgsfield/client/v2";

  config({ credentials: process.env.HF_CREDENTIALS });

  const result = await higgsfield.subscribe(
    "bytedance/seedance-2.5/video-extend",
    {
      input: {
    "prompt": "Continue the camera movement along the coast",
    "resolution": "720p",
    "generate_audio": true,
    "duration": 5,
    "video_url": "https://cdn.example.com/source.mp4",
    "output_format": "mp4"
  },
      withPolling: true,
    },
  );

  if (result.isCompleted) console.log(result.jobs[0].results?.raw.url);
  ```

  ```bash cURL theme={"dark"}
  curl --request POST \
    --url https://api.higgsfield.ai/bytedance/seedance-2.5/video-extend \
    --header "Authorization: Key ${HF_API_KEY_ID}:${HF_API_KEY_SECRET}" \
    --header "Content-Type: application/json" \
    --data '{
    "prompt": "Continue the camera movement along the coast",
    "resolution": "720p",
    "generate_audio": true,
    "duration": 5,
    "video_url": "https://cdn.example.com/source.mp4",
    "output_format": "mp4"
  }'
  ```
</CodeGroup>

## Input Schema

<ParamField body="prompt" type="string" required>
  Text instructions describing the desired output. Must not be empty when provided.
</ParamField>

<ParamField body="resolution" type="string" default="720p">
  Output video resolution. Supported values: `480p`, `720p`.
</ParamField>

<ParamField body="generate_audio" type="boolean" default="true">
  Generate synchronized audio for the output video.
</ParamField>

<ParamField body="duration" type="integer" default="5">
  Output duration in seconds. Supported range: `4`–`30`.
</ParamField>

<ParamField body="output_format" type="string" default="mp4">
  Container format of the output video. Supported values: `mp4`, `mov`.
</ParamField>

<ParamField body="video_url" type="string" required>
  Public URL of the source video to edit or extend.
</ParamField>

<ParamField body="image_urls" type="array">
  Public reference image URLs. Accepts `1`–`30` URLs when provided.
</ParamField>

<ParamField body="video_urls" type="array">
  Public reference video URLs. Accepts `1`–`10` URLs when provided.
</ParamField>

<ParamField body="audio_urls" type="array">
  Public reference audio URLs. Accepts `1`–`10` URLs when provided.
</ParamField>

<Note>
  Use public media URLs; `asset://` references are not supported. Framing follows the source video. First/last-frame inputs are not accepted. Automatic duration (`-1`) is not supported.
</Note>

## Output Schema

<ResponseField name="status" type="string" required>
  Request state. A newly accepted request returns `queued`.
</ResponseField>

<ResponseField name="request_id" type="string" required>
  Identifier used for polling and cancellation.
</ResponseField>

<ResponseField name="status_url" type="string" required>
  URL to poll for request status.
</ResponseField>

<ResponseField name="cancel_url" type="string" required>
  URL used to cancel the request before processing starts.
</ResponseField>

<ResponseField name="video" type="object">
  Completed video output containing its download `url`.
</ResponseField>

## Input Example

```json theme={"dark"}
{
  "prompt": "Continue the camera movement along the coast",
  "resolution": "720p",
  "generate_audio": true,
  "duration": 5,
  "video_url": "https://cdn.example.com/source.mp4",
  "output_format": "mp4"
}
```

## Output Example

<CodeGroup>
  ```json Accepted theme={"dark"}
  {
    "status": "queued",
    "request_id": "d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff",
    "status_url": "https://api.higgsfield.ai/requests/d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff/status",
    "cancel_url": "https://api.higgsfield.ai/requests/d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff/cancel"
  }
  ```

  ```json Completed theme={"dark"}
  {
    "status": "completed",
    "request_id": "d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff",
    "video": {
      "url": "https://cdn.example.com/seedance-2-5-video-extend.mp4"
    }
  }
  ```
</CodeGroup>

<Tip>
  Use an SDK for automatic polling, or poll the returned [status URL](/docs/concepts/polling).
</Tip>


## Related topics

- [Seedance 2.5 API](/docs/models/seedance-2-5.md)
- [Seedance 2.5 Image To Video API](/docs/models/seedance-2-5/image-to-video.md)
- [Seedance 2.5 Reference To Video API](/docs/models/seedance-2-5/reference-to-video.md)
- [Seedance 2.5 Text To Video API](/docs/models/seedance-2-5/text-to-video.md)
- [Seedance 2.5 Video Edit API](/docs/models/seedance-2-5/video-edit.md)