BytePlus

Generate Seedance videos through RemoteGPU's BytePlus-compatible API. Use a RemoteGPU Token Factory key and the base URL https://byteplus.remotegpu.ai/api/v3.

Send requests

Create a key using API keys, then set REMOTEGPU_API_KEY in your shell. This example creates a five-second video. Submitting it incurs a charge.

curl --fail-with-body \
  'https://byteplus.remotegpu.ai/api/v3/contents/generations/tasks' \
  -H "Authorization: Bearer $REMOTEGPU_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "dreamina-seedance-2-0-mini-260615",
    "content": [{"type": "text", "text": "A sailboat crossing a calm lake."}],
    "resolution": "480p",
    "ratio": "1:1",
    "duration": 5,
    "generate_audio": false
  }'

The response contains an id. Save it to query the task and download its result.

Models

Use the exact model ID in requests. Available resolutions and output durations are listed below. See Pricing for customer rates.

Model ID	Resolutions	Duration in seconds
dreamina-seedance-2-5-260628	480p, 720p, 1080p	5–30
dreamina-seedance-2-0-260128	480p, 720p, 1080p, 4k	5–15
dreamina-seedance-2-0-fast-260128	480p, 720p	5–15
dreamina-seedance-2-0-mini-260615	480p, 720p	5–15

You can also set duration to -1 to let the model choose the duration. Model availability depends on the enabled route; a listed model can return ModelNotAvailable if no route is available.

How requests work

1. RemoteGPU validates the request and reserves the estimated charge from your wallet. If your available balance is insufficient, the request is rejected before generation is submitted.
2. The task runs asynchronously. Poll its ID to check progress.
3. On success, RemoteGPU stores the output and settles the charge. The task response includes a download URL.

To safely retry a create request, send an Idempotency-Key header and reuse the same key and request body. Use a new key only for a new generation. If a request loses its response, creating another task with a new key can incur another charge.

Request options

Field	Behavior
resolution	Defaults to 720p; supported values depend on the model.
ratio	16:9, 4:3, 1:1, 3:4, 9:16, 21:9, or adaptive (default).
duration	Defaults to -1 for Seedance 2.5 and 5 for other models. Use an integer in the model's range, or -1.
generate_audio	Defaults to true.
watermark	Defaults to false.
return_last_frame	Defaults to false; request the last-frame image as an additional output.
execution_expires_after	Execution timeout in seconds; accepts 3,600–259,200, default 172,800. The enabled supplier route caps the value sent upstream at 21,600 seconds (six hours).

The content array accepts a text prompt and reference images, videos, or audio. Use image_url with role reference_image, video_url with role reference_video, or audio_url with role reference_audio. For example, add this item to the array to supply a reference video:

{
  "type": "video_url",
  "video_url": { "url": "https://example.com/reference.mp4" },
  "role": "reference_video"
}

Seedance 2.5 accepts up to 30 images, 10 videos, and 10 audio references. The other models accept up to nine images, three videos, and three audio references. The request supports at most one text item and 51 content items in total. For models other than Seedance 2.5, reference audio must be accompanied by at least one reference image or video.

Parameters camera_fixed, draft, frames, seed, and tools are not supported. Omit them or send null. Only the default service tier is supported.

Seedance 2.5 options

Set output_format to mp4 (default) or mov. Other models do not support this parameter.

For Seedance 2.5 requests with reference media, omni_reference_task_type accepts auto (default), reference, edit, or extend. Both edit and extend require a reference video and ratio: "adaptive". For edit, also set duration: -1. Omit this parameter for requests without reference media or for other models.

Check task status

Set TASK_ID to the returned ID:

curl --fail-with-body \
  "https://byteplus.remotegpu.ai/api/v3/contents/generations/tasks/$TASK_ID" \
  -H "Authorization: Bearer $REMOTEGPU_API_KEY"

Poll while the status is queued or running. Stop polling when it is succeeded, failed, cancelled, or expired. On success, download the video from content.video_url. When requested, content.last_frame_url contains the last-frame image URL.

Cancel or delete a task

Send DELETE to the same task URL. A queued task can be cancelled; a running task cannot. Deleting a completed task removes its record from the API and does not refund the generation charge.

A completed deletion returns HTTP 204. HTTP 409 with CancellationPending means cancellation still needs confirmation. Query the task again to learn its outcome; the reserved balance remains held until the outcome is resolved.

Billing and retention

Prices are in USD per million generated tokens. On the pricing page, With ref video means the request includes a reference video; Without ref video means it does not. These are separate rates, not two charges for the same request.

Before submission, RemoteGPU reserves an estimate based on resolution, duration, and reference-video duration. The final charge uses the reported token usage. If a successful task has no usable token count, the original estimated token count is used instead.

A successful result is delivered even when the final charge exceeds the reserve. Your balance can become negative, which prevents another generation until you add funds. Confirmed failed, cancelled, or expired generations release the reserve. An unresolved submission keeps its reserve while RemoteGPU checks the outcome.

Outputs are stored privately with a three-day S3 lifecycle rule. Download files before that period ends. S3 deletion runs asynchronously, so this is not an exact 72-hour deletion guarantee. Download URLs expire sooner; query the task again for a fresh URL while the object is still available. Refreshing the URL does not extend storage retention.

Reference

All paths below are relative to https://byteplus.remotegpu.ai/api/v3 and require Authorization: Bearer <api-key>.

Method	Path	Purpose
POST	/contents/generations/tasks	Create a generation task.
GET	/contents/generations/tasks	List your tasks.
GET	/contents/generations/tasks/{id}	Read task status and output URLs.
DELETE	/contents/generations/tasks/{id}	Cancel a queued task or delete a completed record.

Read next

• Read API keys to create or manage your Token Factory key.
• Read Token Factory for vLLM and Image API guides.
• See Pricing for published customer prices.