Seedance API return_last_frame and last_frame_url

Parameter

Name

return_last_frame

Type

boolean

Required

No

Default

false

Upstream field

return_last_frame

Local validation

Boolean and model field support

Supported models

• Seedance 2.0
• Seedance 2.0 Fast
• Seedance 2.0 Mini
• Seedance 1.5 Pro
• Seedance 1.0 Pro
• Seedance 1.0 Pro Fast

Request example

curl https://api.seedanceapi.app/v1/videos/generations \  -H "Authorization: Bearer sk_live_xxx" \  -H "Content-Type: application/json" \  -d '{    "model": "seedance-2-0",    "prompt": "A slow aerial move over a green valley",    "duration": 5,    "resolution": "720p",    "return_last_frame": true  }'

Task result

Poll the local task ID. When generation returns a last frame, the API persists it and includes it with the video URL.

{  "id": "vid_01jx...",  "object": "video.generation",  "model": "seedance-2-0",  "status": "succeeded",  "result": {    "url": "https://example.com/generated-video.mp4",    "last_frame_url": "https://example.com/generated-last-frame.png"  },  "created_at": 1783900000,  "completed_at": 1783900120}

Continuous-video workflow

1. Create the first task with return_last_frame=true.
2. Poll until the task succeeds and save result.last_frame_url.
3. Use that URL as first_frame_url in the next request.
4. Keep the prompt, ratio, and visual direction consistent across segments.

{  "model": "seedance-2-0",  "prompt": "Continue the same camera movement toward the waterfall",  "first_frame_url": "https://example.com/generated-last-frame.png",  "duration": 5,  "return_last_frame": true}

Common errors

• unsupported_parameter: the selected registry model does not expose the field.
• invalid_request: the field is not a boolean or another request constraint failed.
• A succeeded task may omit last_frame_url if generation did not return it.
• A retryable polling error does not remove a previously persisted last-frame URL.

Billing and generation time