Get API

Seedance 2.0 Mini

Seedance 2.0 Mini Reference To Video is available in the Business API catalog.

bytedance/seedance-2.0-mini/reference-to-video

Capabilities

Best for

  • •Cinematic text-to-video shots
  • •Short social and ad clips
  • •Consistent multi-shot sequences
  • •Look-dev and style exploration

Not for

  • •Frame-exact rotoscoping
  • •Feature-length renders
  • •Pixel-perfect compositing
  • •Precise on-screen text

Authentication

api key header

The Pika API uses API keys to authenticate requests. Send your key in the X-API-Key header. Your API key is a secret. Don't expose it in browsers or other client-side code. Instead, call the API from your server. The signed-in playground uses a portal session and never sends your API key.

header
X-API-Key: YOUR_API_KEY

Endpoint

asynchronous · poll for the result

POSThttps://api.dev.pika.art/v1/media/bytedance/seedance-2.0-mini/reference-to-videogenerate endpoint
GEThttps://api.dev.pika.art/v1/media/jobs/{request_id}poll until completed
GEThttps://api.dev.pika.art/v1/media/jobs/{request_id}/contentget the result URL

Reference Uploads

media inputs

Media inputs accept any public URL. To use a local file, POST its content_type and size_bytes to /v1/media/uploads, PUT the file to the returned upload_url, then pass the url.

upload
# 1. Request a presigned upload URL. Send the file's content
#    type and its exact size in bytes.
curl -X POST https://api.dev.pika.art/v1/media/uploads \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content_type": "image/png", "size_bytes": 12345}'


# The response returns two URLs:
#   upload_url: a temporary URL to upload the file to. Expires in 5 minutes.
#   url:        the permanent Pika URL. Pass it to the model as the input.
# {
#   "upload_url": "https://upload.r2.pika.art/...?X-Amz-Signature=...",
#   "url": "https://cdn.pika.art/v2/media/uploads/org_abc/9f8e7d.png"
# }


# 2. Upload the file to upload_url, then pass url to the model.
curl -X PUT "<upload_url>" \
  -H "Content-Type: image/png" \
  --data-binary @input.png

Generate

POST /v1/media/bytedance/seedance-2.0-mini/reference-to-video

Request

curl -X POST https://api.dev.pika.art/v1/media/bytedance/seedance-2.0-mini/reference-to-video \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "Cinematic multi-shot: the character holds and showcases the product across a wide shot, a close-up in her hands, and a turn holding it to her chest; consistent character and product, warm film grade.",
  "duration": 8,
  "ratio": "1:1",
  "watermark": false,
  "resolution": "720p",
  "image_urls": [
    "https://cdn.pika.art/v2/media/uploads/a7112d4d-62ed-4a11-8dee-74e89c2ec037/a9a39b67806c43c79a4a688faf646728.png",
    "https://cdn.pika.art/v2/media/media_1a16dc75-644f-4e64-b98e-d34e833dc166/output.png"
  ],
  "video_urls": [
    "https://example.com/reference.mp4"
  ]
}'

Response

{
  "id": "media_8f3a2c91-5b7d-4e0a-9c26-31d4f2a8e6b0",
  "status": "queued"
}

Request body

promptstringrequired
Text prompt describing the video to generate.
durationenumrequired
Video length in seconds (4-15), or 'auto' to let the model choose.
ratioenum
Output aspect ratio.
generate_audioboolean
Whether to generate audio for the video.
watermarkbooleandefault: false
Whether to add a watermark to the output video.
image_urlsstring[]
Up to 9 reference images (referenced in the prompt as @Image1…).
video_urlsstring[]
Up to 3 reference videos (referenced in the prompt as @Video1…).
audio_urlsstring[]
Up to 3 reference audio clips (referenced in the prompt as @Audio1…).
resolutionenum
Output resolution (480p/720p for Mini).

Accepted values

ratio
resolution

Input modes

Image urlsimage_urls

Use a public URL directly, or POST { content_type, size_bytes } to /v1/media/uploads, PUT the image to the returned upload_url with the returned headers, then pass the url.

Video urlsvideo_urls

Use a public URL directly, or POST { content_type, size_bytes } to /v1/media/uploads, PUT the video to the returned upload_url with the returned headers, then pass the url.

Audio urlsaudio_urls

Use a public URL directly, or POST { content_type, size_bytes } to /v1/media/uploads, PUT the audio to the returned upload_url with the returned headers, then pass the url.

Returns

Returns a job object with status , not the final output. Store the id from the response and poll the job until it completes.

Poll status

GET /v1/media/jobs/{request_id}

Request

curl https://api.dev.pika.art/v1/media/jobs/{request_id} \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "id": "media_8f3a2c91-5b7d-4e0a-9c26-31d4f2a8e6b0",
  "status": "running"
}

Poll the job by id until it reaches a terminal state: completed or failed.

The job object

idstring
Unique identifier for the job.
statusenum
The status of the job.One of:
object
The generation output. Present once the job completes.
errorstring
If the job failed, the reason for the failure.

Get result

GET /v1/media/jobs/{request_id}/content

Request

curl https://api.dev.pika.art/v1/media/jobs/{request_id}/content \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "url": "https://api.dev.pika.art/v1/files/video_8f3a2c91.mp4"
}

Once the job completes, fetch a download URL for the generated media.

Returns

urlstring
Download URL for the generated file.

Errors

shared across calls

Errors use conventional HTTP status codes with a JSON body of the shape {"message": "..."}. Validation failures return 422 with a message naming the offending field. Submit rejections after the job row exists (balance, rate limit) return the failed job envelope — branch on error.code.

StatusWhenBody
401 UnauthorizedThe API key is missing or invalid.{"message":"Invalid API key"}
403 ForbiddenAn inactive key is rejected with a `{"message"}` body. A submit that the org balance or postpaid cycle limit cannot cover is rejected after the job row exists and returns the failed job envelope.{"id":"media_8f3a2c91-5b7d-4e0a-9c26-31d4f2a8e6b0","status":"failed","error":{"code":"insufficient_balance","message":"Insufficient org balance"}}
404 Not FoundNo job with that id exists in your org, or the media path names an unknown vendor/model/function.{"message":"media job not found"}
409 ConflictThe result was requested before the job completed, or an Idempotency-Key header was reused with a different body.{"message":"media job is not ready"}
422 Unprocessable EntityThe request body failed validation: an invalid enum value, a missing required field, a wrong type, or malformed JSON. The JSON message names the offending field. A schema-valid parameter combination that cannot be priced instead fails after job creation and returns the failed job envelope with error code `invalid_input`.{"message":"duration: Input should be less than or equal to 15"}
429 Too Many RequestsOrg limit reached: requests per minute or day, or concurrent jobs. Returned as the failed job envelope; check the Retry-After header and retry with a fresh Idempotency-Key.{"id":"media_8f3a2c91-5b7d-4e0a-9c26-31d4f2a8e6b0","status":"failed","error":{"code":"rate_limited","message":"rate limit exceeded: rpm"}}
503 Service UnavailableThe model rail or a backend dependency is temporarily unavailable. Returned as the failed job envelope; retry with backoff and a fresh Idempotency-Key.{"id":"media_8f3a2c91-5b7d-4e0a-9c26-31d4f2a8e6b0","status":"failed","error":{"code":"provider_unavailable","message":"media dispatch unavailable"}}

Pricing

only successful runs are charged

TierPrice
480p · mini · with video input$2.21 / 1M tokens
720p · mini · with video input$2.21 / 1M tokens
480p · mini · no video input$3.67 / 1M tokens
720p · mini · no video input$3.67 / 1M tokens

Per-model pricing

Transparent, usage-based rates for every ByteDance model.

Seedance 2.0

Video

Image to Video

4kstandard$4.20 / 1M tok
480pstandard$7.35 / 1M tok
720pstandard$7.35 / 1M tok
1080pstandard$8.085 / 1M tok

Reference to Video

4kstandard · with video input$2.52 / 1M tok
4kstandard · no video input$4.20 / 1M tok
480pstandard · with video input$4.515 / 1M tok
720pstandard · with video input$4.515 / 1M tok
1080pstandard · with video input$4.935 / 1M tok
480pstandard · no video input$7.35 / 1M tok
720pstandard · no video input$7.35 / 1M tok
1080pstandard · no video input$8.085 / 1M tok

Text to Video

4kstandard$4.20 / 1M tok
480pstandard$7.35 / 1M tok
720pstandard$7.35 / 1M tok
1080pstandard$8.085 / 1M tok

Seedance 2.0 Fast

Video

Image to Video

480p$5.88 / 1M tok
720p$5.88 / 1M tok

Reference to Video

480pwith video input$3.465 / 1M tok
720pwith video input$3.465 / 1M tok
480pno video input$5.88 / 1M tok
720pno video input$5.88 / 1M tok

Text to Video

480p$5.88 / 1M tok
720p$5.88 / 1M tok

Seedance 2.0 Mini

Video

Image to Video

480p$3.675 / 1M tok
720p$3.675 / 1M tok

Reference to VideoCurrent

480pwith video input$2.205 / 1M tok
720pwith video input$2.205 / 1M tok
480pno video input$3.675 / 1M tok
720pno video input$3.675 / 1M tok

Text to Video

480p$3.675 / 1M tok
720p$3.675 / 1M tok

Seedream 5.0 Pro Image Editing

Image

Image to Image

Output1K$0.045 / image
Output2K$0.09 / image
Input images$0.003 / image

Text to Image

1K$0.045 / image
2K$0.09 / image

Seedream 5.0 Lite Image Editing

Image

Image to Image

$0.035 / image

Text to Image

$0.035 / image

Seedream 4.5

Image • Text to Image

$0.04 / image

Seedream 4.0 Image Editing

Image

Image to Image

1K$0.03 / image

Text to Image

1K$0.03 / image

Seed Audio 1.0

Audio • Text to Audio

$0.15 / min

Join theclub

Get StartedContact Sales