BytePlus官方合作伙伴ByteDance旗下公司 BytePlus
开发者API · BytePlus官方合作伙伴
Seedance 2.0 API和Seedream API
在自己的代码里,用Seedance 2.0生成视频,用Seedream生成图片。KreatorFlow基于BytePlus(ByteDance旗下公司)构建。一个API密钥,每个令牌$0.05的预付令牌,支持文件上传、签名Webhook和幂等请求。
- /v1 REST接口
- 1令牌 = $0.05
- Webhook
- Idempotency-Key
- Seedance 2.0最高4K
最后更新:
开箱即用的Seedance与Seedream API
搜索Seedance API、Seedream API或BytePlus API的开发者,要的通常是同一件事: 发送提示词和几份参考素材,拿回做好的视频或图片,用多少付多少。KreatorFlow开发者API就是为此而生。ByteDance的Seedance 2.0和Seedream模型通过BytePlus(ByteDance旗下公司)提供。你只需调用/v1下几个简洁的REST接口。
视频模型使用稳定的别名(kreator-video-fast、kreator-video-seedance-2-fast、kreator-video-mini、kreator-video-seedance-2-mini、kreator-video-pro、kreator-video-seedance-2、kreator-video-seedance-2-5、kreator-video-wan-3、kreator-video-wan-3-prime、kreator-video-kling-3、kreator-video-kling-3-omni、kreator-video-kling-3-turbo、kreator-video-kling-4),图片模型为kreator-image-fast、kreator-image-pro、kreator-image-wan-2-7-pro、kreator-image-wan-2-6、kreator-image-seedream-5-pro、kreator-image-seedream-5-flash。GET /v1/models会按别名返回时长、画面比例、分辨率和参考素材上限,你可以直接读取,不必把上限写死在代码里。Seedance 2.0可生成 720p、1080p和4K、时长4到15秒的片段,单个任务最多可用9张图片、3段视频和3段音频作为参考素材。Seedance 2.5可生成720p、1080p和4K、最长30秒的片段。
接口
POST /v1/videos
Seedance视频任务:文字生成视频、图片生成视频、指定首尾帧,以及带参考素材的视频。
POST /v1/video-edits
编辑、风格转换、变形或延长你自己的片段,或你有权使用的片段。
POST /v1/images
用提示词、参考图和角色,通过Seedream生成和编辑图片。
POST /v1/uploads
创建上传,用PUT发送文件,再把上传ID作为参考素材传入,不需要公开托管。
POST /v1/characters
把常用角色注册一次,之后在图片或视频任务的character_ids中传入ID即可。
GET /v1/jobs/{job_id}
查询状态并获取结果,也可以通过Webhook接收同样的内容。
用curl快速上手
创建一个Seedance 2.0任务,然后轮询状态或等待Webhook。
curl https://kreatorflow.ai/v1/videos \
-H "Authorization: Bearer $KREATORFLOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: launch-teaser-001" \
-d '{
"model": "kreator-video-seedance-2",
"prompt": "slow dolly in on a glass perfume bottle, soft studio light",
"duration": 5,
"aspect_ratio": "9:16",
"resolution": "720p",
"webhook_url": "https://example.com/hooks/kreatorflow"
}'
curl https://kreatorflow.ai/v1/jobs/JOB_ID \
-H "Authorization: Bearer $KREATORFLOW_API_KEY"令牌价格
每个令牌$0.05。费用在任务受理前计算,并从预付余额中扣除。
Seedream 5.0 Lite图片
1
令牌 · $0.05 · kreator-image-fast
Seedream 4.5图片
2
令牌 · $0.10 · kreator-image-pro
Seedance 2.0 Mini,720p · 5秒
7
令牌 · $0.35 · kreator-video-mini
Seedream 5.0 Flash图片
1
令牌 · $0.05 · kreator-image-seedream-5-flash
Seedream 5.0 Pro图片
2
令牌 · $0.10 · kreator-image-seedream-5-pro
Seedance 2 Fast,720p · 5秒
9
令牌 · $0.45 · kreator-video-fast
Seedance 2.0,720p · 5秒
11
令牌 · $0.55 · kreator-video-pro
Seedance 2.0,1080p · 5秒
24
令牌 · $1.20 · kreator-video-pro
Seedance 2.0,4K · 5秒
58
令牌 · $2.90 · kreator-video-pro
Seedance 2.5,720p · 5秒
21
令牌 · $1.05 · kreator-video-seedance-2-5
Seedance 2.5,1080p · 30秒
267
令牌 · $13.35 · kreator-video-seedance-2-5
在控制台用银行卡充值,每次$20至$5,000。API令牌以美元计费,没有月费也无需订阅,失败任务预留的令牌会退回余额。 与其他Seedance API的单条片段价格比较,请见Seedance API价格比较。
KreatorFlow API替你处理的事
- Seedance 2.5、Seedance 2.0、Seedance 2 Fast、Seedance 2.0 Mini和Seedream,一个可限定权限的KreatorFlow密钥全部搞定。
- 无需订阅的预付令牌,用银行卡充值。
- 上传ID仅限工作区内使用,参考素材不需要公开链接。
- 参考图在提交前会自动准备到可信的素材库中。
- job.completed、job.failed、job.canceled、job.blocked的签名Webhook。
- 支持Idempotency-Key:重复发送同一请求不会重复创建,而是返回原任务。
- 任务失败时,预留的令牌会自动释放。
- 常用角色和原视频编辑,都通过简洁的接口完成。
三步开始
- 1
创建账户和密钥
登录developers.kreatorflow.ai的API控制台,创建API密钥。
- 2
充值令牌
在Billing标签页充值$20或以上。余额由账户下的所有密钥共享。
- 3
发送第一个任务
带上Idempotency-Key调用POST /v1/videos或POST /v1/images,然后轮询状态或接收Webhook。
使用规则
API与工作室遵守同样的可接受使用政策(英文)。参考素材必须是你自己创作的,或你有权使用的。 如果你想手动创作而不是写代码,可以在Seedance 2.0 视频生成中使用同样的模型。
Seedance API常见问题
这是官方的Seedance API吗?
这是KreatorFlow基于BytePlus(ByteDance旗下公司)打造的自有API。KreatorFlow是BytePlus(ByteDance旗下公司)的官方合作伙伴,请求会通过BytePlus送达Seedance 2.0和Seedream。你只需一个KreatorFlow密钥,并使用KreatorFlow稳定的模型名称(别名)。
Seedance 2.0 API怎么收费?
用预付令牌支付,每个令牌$0.05。Seedance 2.0的720p 5秒片段为11个令牌,同样时长的Seedance 2 Fast为9个,Seedance 2.0 Mini为7个,一张Seedream 4.5图片为2个。每次充值金额为$20至$5,000。
Seedream API可以使用参考图吗?
可以。用POST /v1/uploads上传图片,再把返回的上传ID作为参考图传入,或者直接发送公开的HTTPS链接。kreator-image-pro(Seedream 4.5)最多接受14张参考图,需要反复使用的角色可以用POST /v1/characters注册一次。
可以用Webhook接收结果吗?还是必须轮询?
两种都可以。创建请求时传入webhook_url,就会收到job.completed、job.failed、job.canceled和job.blocked事件,并带有用Webhooks标签页中的密钥生成的X-KreatorFlow-Signature签名。也可以用GET /v1/jobs/{job_id}轮询。
任务失败会怎样?
令牌在任务开始时预留,如果失败、超时或在提交前被拒绝,预留的令牌会释放,失败的任务不会花钱。使用相同的Idempotency-Key重新发送请求,会返回原来的任务而不是重复创建,所以网络重试也很安全。想重新尝试时,请换一个新的键。