API
CLUB

Seedance 2.5

一次讲完整个故事:连续 30 秒的多镜头视频,配合原生音频。

bytedance/seedance-2.5/text-to-video

能力

最适合

  • •电影感文生视频镜头
  • •社交媒体短片与广告
  • •连贯的多镜头片段
  • •视觉开发与风格探索

不适合

  • •逐帧精确转描
  • •长篇视频渲染
  • •像素级精确合成
  • •准确呈现画面文字

身份验证

API 密钥标头

Uika API 使用 API 密钥来验证请求。将您的密钥发送到 X-API 密钥 标题。您的 API 密钥是一个秘密。不要在浏览器或其他客户端代码中公开它。相反,从您的服务器调用 API。登录的 Playground 使用门户会话,并且从不发送您的 API 密钥。

标题
X-API-Key: YOUR_API_KEY

端点

异步·轮询结果

发布https://api.dev.pika.art/v1/media/bytedance/seedance-2.5/text-to-video生成端点
获取https://api.dev.pika.art/v1/media/jobs/{request_id}民意调查直至完成
获取https://api.dev.pika.art/v1/media/jobs/{request_id}/content输出 URL,适用于仅保留 id 的客户端
删除https://api.dev.pika.art/v1/media/jobs/{request_id}删除存储的媒体并提示

REST 接入

标准 HTTPS

视频生成使用上方 REST 接口。API 通过 HTTPS 传输标准 JSON,可使用任意 HTTP 客户端,无需厂商专用 SDK。

生成

POST /v1/media/bytedance/seedance-2.5/text-to-video

请求

curl -X POST https://api.dev.pika.art/v1/media/bytedance/seedance-2.5/text-to-video \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"draft": false,
"prompt": "A fashion editorial in motion. ONE continuous unbroken take, no cuts. The camera moves constantly but always smoothly, on a crane and dolly — long fluid arcs, motivated reframes, no handheld shake, no whip pans, no speed ramps. Scene: a bare lilac room — lilac walls, lilac wool carpet, white baseboard, a long sheer lilac curtain at the left of frame. In the centre stands an ironing board with pale lilac legs and a lilac cotton cover. Draped over it is one large square silk scarf printed in dusty rose pink and olive green, a fine botanical pattern with a broad olive border: the left half lies perfectly flat and pressed with its edge hanging crisply over the rounded nose, the right half gathered into a soft billowing heap spilling over the far end. A wide polished chrome cuff bracelet stands upright on the pressed section, mirror-finish, warping the pink and lilac around it. A fine silver chain lies beside it and trails off the left edge, pooling on the carpet. Action: the curtain swells inward as a draught enters the room. The gathered folds on the right stir, then begin to rise — the silk lifting off the board and unfurling itself, opening out into a full square that floats and turns in the air above the ironing board, the printed botanicals rippling as it revolves. The loosened chain slides off the edge and drops to the carpet in a bright coil. The chrome cuff rocks, topples onto its side and rolls slowly along the bare lilac board cover toward the nose, reflections spinning across it. The silk keeps rising, drifting toward the window and the curtain, then falls all at once, settling flat across the empty board exactly as it was pressed at the start. Camera: begin low and close on the chrome cuff, the pressed silk and the hanging chain, then rise and arc left around the nose of the board as the curtain moves. As the silk lifts, crane upward with it, turning to follow the scarf as it revolves in the air, holding it centred while the lilac room rotates behind. Descend with the falling chain in one continuous move, level out into a low tracking shot beside the rolling cuff, then crane back up and pull out into a wide, symmetrical frontal of the board just as the silk settles onto it. Look: soft diffuse daylight through the curtain, no hard shadows, a tight palette of lilac, dusty pink and olive. Shot on 35mm film, 80mm lens, medium depth of field, fine natural grain, low contrast, liquid sheen on the silk. Photographic and physically real, like an Hermès still-life campaign — no digital gloss. The room is empty; there is no iron and no person. Audio: quiet room tone, a curtain drawing against the wall, silk snapping open and rustling as it turns in the air, a chain dropping onto carpet, chrome rolling on padded cloth, the soft whump of fabric landing, nothing else.",
"duration": 10,
"resolution": "720p",
"generate_audio": true,
"watermark": false,
"ratio": "16:9"
}'

返回数据

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

请求正文

草稿布尔值默认值: false
渲染 480p 草稿预览。通过‘bytedance/seedance-2.5/draft-to-video’可以在7天内完成1080p的草稿,并按自己的工作收费。
提示词字符串需要
描述你想生成的视频。
持续时间枚举需要
视频长度以秒为单位 (4-30),或“自动”以让模型选择。
分辨率枚举
输出分辨率(2.5 为 480p/720p/1080p)。
generate_audio布尔值默认:true
是否为视频生成音频。
水印布尔值默认值: false
是否为输出视频添加水印。
output_formatenum
输出容器格式。
bitrate_modeenum
输出码率。high 会生成码率更高、体积更大的文件,默认为 standard。
比例枚举
输出画面比例。

接受的值

分辨率
output_format
bitrate_mode
比例

返回

返回一个 工作对象 状态 ,不是最终输出。存储响应中的 ID 并轮询作业直至完成。

民意调查状态

获取/v1/media/jobs/{request_id}

请求

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

返回数据

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

按 ID 轮询作业,直到达到最终状态:已完成或失败。已完成的作业在输出中携带其下载 URL,并且 GET /v1/media/jobs/{request_id}/content 返回与 { "url" } 对于只保留 ID 的客户端。

DELETE /v1/media/jobs/{request_id} 删除作业的存储介质以及提交时捕获的请求(提示和参数)。然后作业报告 deleted_at 并且没有输出,内容端点回答410。

作业对象

id字符串
作业的唯一标识符。
状态枚举
作业的状态。其中之一:
对象
生成输出。工作完成后立即出现。
错误字符串
如果作业失败,则失败的原因。
deleted_atnumber
当您删除作业的存储媒体时,以纪元秒为单位。在此之前为空,一旦设置后输出为空。
用法对象
提供者为作业报告的单位,例如 video_output_tokens 或 image_output_tokens。一旦作业终止就存在,仅携带作业报告的单位,并且当没有报告任何内容时为空。
对象
工作收费。工作结束后在场;提交响应和 webhooks 上为 null。

错误

在通话中共享

错误使用传统的 HTTP 状态代码以及形状的 JSON 主体 {"message": "..."}。验证失败返回 422 并带有一条命名有问题字段的消息。作业行存在后提交拒绝(余额、速率限制)返回失败的作业信封 — 分支 error.code.

状态当身体
401 未经授权API 密钥丢失或无效。{"message":"Invalid API key"}
403 禁止非活动密钥被拒绝 {"message"} 身体。作业行存在并返回失败的作业信封后,组织余额或后付费周期限制无法覆盖的提交将被拒绝。 GET /billing/balance 将两者分开: 200 表示密钥处于活动状态,因此拒绝的是余额或循环限制。{"id":"media_8f3a2c91-5b7d-4e0a-9c26-31d4f2a8e6b0","status":"failed","error":{"code":"insufficient_balance","message":"Insufficient org balance"}}
404 未找到您的组织中不存在具有该 ID 的作业,或者媒体路径名称未知的供应商/型号/功能。{"message":"media job not found"}
409冲突在作业完成之前请求结果,或者将 Idempotency-Key 标头与不同的正文重用。{"message":"media job is not ready"}
422 无法处理的实体请求正文验证失败:枚举值无效、缺少必填字段、类型错误或 JSON 格式错误。 JSON 消息命名有问题的字段。无法定价的架构有效参数组合在创建作业后失败,并返回失败的作业信封和错误代码 invalid_input.{"message":"duration: Input should be less than or equal to 15"}
429 请求太多您已达到每分钟或每天的请求限制,或者您组织的作业队列已满。作为失败的作业信封返回。如果存在 Retry-After 标头,请等待那么长时间,然后使用新的 Idempotency-Key 重试。{"id":"media_8f3a2c91-5b7d-4e0a-9c26-31d4f2a8e6b0","status":"failed","error":{"code":"rate_limited","message":"rate limit exceeded: rpm"}}
503服务不可用模型导轨或后端依赖项暂时不可用。作为失败的作业信封退回;使用退避和新的幂等密钥重试。{"id":"media_8f3a2c91-5b7d-4e0a-9c26-31d4f2a8e6b0","status":"failed","error":{"code":"provider_unavailable","message":"media dispatch unavailable"}}