Seedance 2.5 Flash
Animate a first frame, or connect first and last frames, at 480p or 720p.
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.
X-API-Key: YOUR_API_KEY
Endpoint
asynchronous · poll for the result
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.
# 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.5-flash/image-to-video
Request
curl -X POST https://api.dev.pika.art/v1/media/bytedance/seedance-2.5-flash/image-to-video \-H "X-API-Key: YOUR_API_KEY" \-H "Content-Type: application/json" \-d '{"prompt": "A short multi-shot film with hard cuts between the numbered shots; Shot 1 starts exactly on the first frame. Cuts only change the camera angle on one continuous action - nobody and nothing jumps position between shots, and anyone new is seen arriving. Every shot stays in this same location with the same light. No text or logos appear.\nStory: he opens his perfume, the dragonfly flies off, and he dives in to chase it.\n[Shot 1, 0-5s] Close-up as in the first frame. With his other hand he clearly lifts the round glass cap straight up off the perfume bottle - the dragonfly is sitting on that cap. As the cap comes off, the startled dragonfly takes off from it and darts away over the pool to the right. He holds the open bottle in one hand and the cap in the other. He does NOT spray the perfume - no spray, no mist.\n[Shot 2, 5-9s] Same close-up angle: his head turns sharply to follow where the dragonfly flew, eyes locked on it, deadpan and determined. He sets the bottle down on the tiles beside him and pushes himself up from the pool edge.\n[Shot 3, 9-15s] Wide shot from the far end of the pool at water level: fully dressed in his oversized cream shirt, he dives from the pale tiled edge into the pale aqua water with a clean splash and swims fast freestyle straight across the pool after the small dragonfly, which skims low over the water just ahead of him. With every stroke the soaked cream shirt clings to his back, shoulders and arms, its long sleeves on his arms and the big round collar floating on the water around his neck. Far behind, the small lifeguard on his tall white chair sits up and watches.\nWARDROBE CONTINUITY: his oversized cream shirt is visible on him in every shot - on the pool edge, in mid-air during the dive and while swimming - wet cream fabric on his back and arms the whole time.\nKeep every person's face, hair, wardrobe, the props and the location exactly as in the first frame in every shot.\nSPEED IS CRITICAL: everything moves at normal real-time speed, like 24fps footage played back at 24fps - natural motion, NO slow motion.\nAudio: open-air pool ambience, water lapping at the tiles, the soft glassy clink of the cap lifting off, the dry buzz of dragonfly wings, a big splash and steady swimming strokes; an original, cool, minimal instrumental with a soft nylon guitar.\nColor: soft but vibrant — never oversaturated, never desaturated or washed out(muted is off-brand, soft is not dull). Full color range; saturated reds,oranges, blues, greens welcome and a bold color can lead. Build one complementary pairing — a lighter tone against a deeper saturated one, warm against cool (pale blue + vivid red, ivory + crimson, tan + cobalt) — for depth and to separate subject from background. Colors true; no cast, no teal-and-orange or stylized tint. Not over-saturated; contrast controlled, low-to-moderate.\nLighting: soft, diffused, even and dimensional — a large soft close source, or overcast / open shade. Never hard or flat: no bare flash, no harsh sun, no sharp-edged shadows. Fill shadows so texture holds in fabric, skin and surface; shadows soft but present — they give the subject DIMENSION without distracting, and detail stays alive inside them. Low-to-moderate contrast. Light neutral and true, not colored for mood — contrast comes from the colors.","duration": 15,"resolution": "720p","generate_audio": true,"watermark": false,"image_url": "https://msaocnoosm1a4.pika.art/v2/media/uploads/b20e8900-95df-4681-9f1b-a6b5c5abc236/060f7cfb8b154e6185e0bf10fdb570d9.png","ratio": "adaptive"}'
Response
{"id": "media_8f3a2c91-5b7d-4e0a-9c26-31d4f2a8e6b0","status": "queued"}
Request body
Accepted values
- resolution
- output_format
- bitrate_mode
Input modes
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.
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.
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, failed, or cancelled. A completed job carries its download URL in output, and GET /v1/media/jobs/{request_id}/content returns that same URL as { "url" } for clients that only kept the id.
DELETE /v1/media/jobs/{request_id} erases the stored media for a job, and the request captured at submit (the prompt and parameters). The job then reports deleted_at and no output, and the content endpoint answers 410.
The job object
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.
| Status | When | Body |
|---|---|---|
| 401 Unauthorized | The API key is missing or invalid. | {"message":"Invalid API key"} |
| 403 Forbidden | An 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. GET /billing/balance separates the two: a 200 means the key is active, so the rejection was the balance or the cycle limit. | {"id":"media_8f3a2c91-5b7d-4e0a-9c26-31d4f2a8e6b0","status":"failed","error":{"code":"insufficient_balance","message":"Insufficient org balance"}} |
| 404 Not Found | No job with that id exists in your org, or the media path names an unknown vendor/model/function. | {"message":"media job not found"} |
| 409 Conflict | The 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 Entity | The 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":"unexpected_field: Extra inputs are not permitted"} |
| 429 Too Many Requests | You've hit your per-minute or per-day request limit, or your org's job queue is full. Returned as the failed job envelope. If there's a Retry-After header, wait that long, then 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 Unavailable | The 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"}} |