Whiteboard Doodle Render

Turn any image or illustration into a whiteboard-doodle video: a hand draws the outline, then paints the colours. Submit a render, poll for status, download the MP4.

原始信息汇总

数据集概述：Whiteboard Doodle Render API

基本信息

• 名称：Whiteboard Doodle Render
• 类别：Video, Images
• 提供者：Arnet Digital
• 当前版本：1.1.0

核心功能

将任何图像转换为手绘白板风格的动画视频（MP4格式）。具体流程为：一只手绘制图像轮廓，然后填充颜色，最终呈现原始图像。支持反向擦除模式（wipe），即手部使用板擦将图像从全图状态擦除至空白白板。

使用方式

渲染采用异步模式：

1. 提交渲染任务：POST /v1/renders，返回一个 job_id
2. 轮询任务状态：GET /v1/renders/{job_id}，直到 status 变为 succeeded
3. 下载视频：GET /v1/renders/{job_id}/video

没有回调/webhook，建议每2-3秒轮询一次。

API 端点

方法	路径	用途
POST	/v1/renders	提交渲染任务，返回 202 {job_id, status}
GET	/v1/renders/{job_id}	轮询任务状态及结果
GET	/v1/renders/{job_id}/video	流式下载完成的 MP4 视频
GET	/ping · /healthz	公开存活检查

提交渲染请求参数（JSON）

提供 image_url 或 image_b64 其中之一。

可选渲染选项

选项	默认值	说明
animate_color	true	轮廓绘制后填充颜色
draw_hand	true	显示绘制手部跟随笔尖
wipe	false	擦除模式：反向动画，从全图擦除至空白板
target_duration	null	视频总时长（秒，1-60），覆盖自然时长
duration	2	最终静止图像停留的秒数
frame_rate	25	输出帧率
object_skip_rate	8	值越高轮廓绘制越快/越粗略
bg_skip_rate	14	值越高背景绘制越快/越粗略
fine_reveal	false	使用更精细网格进行平滑展示
end_color	true	最终帧对齐原始图像
max_1080p	true	限制输出为1080p
split_len	null	高级网格粒度参数

输入图像最大 25 MiB，PNG/JPG 格式效果最佳。

认证方式

使用 RapidAPI 标准请求头：

• X-RapidAPI-Key
• X-RapidAPI-Host

定价与配额

提供 BASIC（$0.00/月）、PRO（$10.00/月）、ULTRA（$40.00/月）三个订阅计划。每个完成的渲染视频通常消耗约4-8次请求（1次提交 + 若干次轮询 + 1次下载）。超出速率限制会返回 429 状态码。

错误状态码

状态码	含义
202	渲染已接受并排队
400	错误请求（缺少/无效图像或选项）
401	缺少或无效认证
402	计划配额已用完
404	未知 job_id 或视频未就绪
429	请求过多

使用限制

• 用户须保证对提交的图像拥有合法权利
• 禁止用于非法、侵权或滥用内容
• 渲染过程为纯确定性图像处理，不使用AI生成，不会使用输入数据进行训练