跳转到内容

Editto

集成

模型 id editto
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/editto?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

与示例类似的文件: $0.405 405 API 积分 运行前会测量你的文件 在此页面运行

获取 API 密钥
Open model 视频生成视频 最高 720p #video-edit#wan-vace

基于指令的视频编辑,根据提示词重写源视频,并支持帧数、fps 和分辨率控制

Open model · 视频

你的第一个结果会显示在这里

在下方构建请求,并使用你的 API 密钥运行。输出会复制到我们的存储中,可永久保存,也可免费保存 7 天。

构建请求

控件根据模型架构生成。修改控件时,代码和价格会同步更新。

•必填

引导视频生成的文本说明。

•必填 video_url
拖放文件,或

源视频文件 URL;执行图像修复时必需。

resolution 默认 auto

输出视频的分辨率。

aspect_ratio 默认 auto

生成视频的宽高比。

默认 81

输出帧数,范围为 81–241(含边界)。

默认 0

插帧数量:0 表示保留原始帧,不进行插帧;其他值表示在相邻帧之间生成的中间帧数量。

高级 negative_prompt · sampler · acceleration · video_quality · video_write_mode · frames_per_second · num_inference_steps · guidance_scale · shift · temporal_downsample_factor · seed · match_input_frames_per_second · enable_safety_checker · enable_auto_downsample · return_frames_zip
默认 letterboxing, borders...

生成视频时应用的负面提示词。

sampler 默认 unipc

生成视频时使用的采样器。

acceleration 默认 regular

推理加速设置,可选 'none' 或 'regular':加速处理可显著提升速度,但会带来极小的输出变化。

video_quality 默认 high

结果视频的质量级别。

video_write_mode 默认 balanced

结果视频的写入模式。

默认 16

生成视频的帧率;仅当 `match_input_frames_per_second` 不为 true 时应用;可接受值为 5–30 帧每秒。

默认 30

采样步数;步数越多,处理时间越长但质量越高。

默认 5

通过无分类器引导控制的提示词对齐强度;增大缩放值会促使生成图像更贴合文本。

默认 5

生成视频时应用的偏移设置。

默认 0

视频跳帧因子,以整数表示;每个下采样因子会自动执行一次上采样。使用 0 可禁用时间下采样。

使生成结果可复现的种子。将其设置为 None 会随机选择种子。

POST /run/editto?wait=20 报价 → $0.405
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/editto?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

运行此请求

你的密钥会保留在此浏览器中:仅发送到 Doitong API;只有勾选“记住”后才会保存到 localStorage。 获取 API 密钥

关于 Editto

编辑由 `video_url` 提供的现有视频,并根据文本 `prompt` 进行引导。输出可以沿用输入视频的帧数和帧率,也可以使用 `num_frames`(17 到 241)和 `frames_per_second`(5 到 30)。分辨率范围为 240p 到 720p,宽高比可设为 auto、16:9、1:1 或 9:16,也可返回包含帧的 ZIP 文件。

参数

发送规范名称或原生名称之一,不要同时发送两者。 规范名称

名称类型 默认值允许值 描述
prompt必填
类型string
引导视频生成的文本说明。
negative_prompt可选
类型string
默认值letterboxing, borders, black bars, bright colors, overexposed, static, blurred details, subtitles, style, artwork, painting, picture, still, overall gray, worst quality, low quality, JPEG compression residue, ugly, incomplete, extra fingers, poorly drawn hands, poorly drawn faces, deformed, disfigured, malformed limbs, fused fingers, still picture, cluttered background, three legs, many people in the background, walking backwards
生成视频时应用的负面提示词。
match_input_num_frames可选
类型boolean
默认值false
生成视频帧数的来源:false 使用 `num_frames`,true 则复制输入视频的帧数。
num_frames可选
类型integer
默认值81
17 – 241
输出帧数,范围为 81–241(含边界)。
match_input_frames_per_second可选
类型boolean
默认值false
生成视频帧率的来源:false 使用 `frames_per_second`,true 则复制输入视频的帧率。
frames_per_second可选
类型integer | null
默认值16
5 – 30
生成视频的帧率;仅当 `match_input_frames_per_second` 不为 true 时应用;可接受值为 5–30 帧每秒。
seed可选
类型integer | null
使生成结果可复现的种子。将其设置为 None 会随机选择种子。
resolution可选
类型enum
默认值auto
auto240p360p480p580p720p
输出视频的分辨率。
aspect_ratio可选
类型enum
默认值auto
auto16:91:19:16
生成视频的宽高比。
num_inference_steps可选
类型integer
默认值30
2 – 50
采样步数;步数越多,处理时间越长但质量越高。
guidance_scale可选
类型number
默认值5
1 – 10
通过无分类器引导控制的提示词对齐强度;增大缩放值会促使生成图像更贴合文本。
sampler可选
类型enum
默认值unipc
unipcdpm++euler
生成视频时使用的采样器。
shift可选
类型number
默认值5
1 – 15
生成视频时应用的偏移设置。
video_url必填 video
类型url · video
源视频文件 URL;执行图像修复时必需。
enable_safety_checker可选
类型boolean
默认值false
安全检查开关。关闭此设置需要账户授权;没有该授权时,无论设置如何,每个请求都会经过检查;true 表示启用检查器。
acceleration可选
类型enum
默认值regular
nonelowregular
推理加速设置,可选 'none' 或 'regular':加速处理可显著提升速度,但会带来极小的输出变化。
video_quality可选
类型enum
默认值high
lowmediumhighmaximum
结果视频的质量级别。
video_write_mode可选
类型enum
默认值balanced
fastbalancedsmall
结果视频的写入模式。
num_interpolated_frames可选
类型integer
默认值0
0 – 5
插帧数量:0 表示保留原始帧,不进行插帧;其他值表示在相邻帧之间生成的中间帧数量。
temporal_downsample_factor可选
类型integer
默认值0
0 – 5
视频跳帧因子,以整数表示;每个下采样因子会自动执行一次上采样。使用 0 可禁用时间下采样。
enable_auto_downsample可选
类型boolean
默认值false
自动调整帧数:启用后,模型可处理时长合适的时间下采样视频,随后通过插帧恢复原始帧数。
return_frames_zip可选
类型boolean
默认值false
控制是否同时返回包含每个生成帧的 ZIP 归档;true 时启用。
必填 规范名称,也可接受

文件参数接受公开的 https:// URL、最大 10 MB 的 data: URI,或上传文件的 file_url。 文件

输出

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "editto",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 405,
    "usd": "0.405",
    "charged": 405,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "fps": 1.0,
      "duration": 5,
      "num_frames": 1
    },
    "prompt": "Make it a Pixel Art video.",
    "seed": 42,
    "frames_zip": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
文件由你选择每个 outputs[].url 都是我们存储中的副本:可永久保存(按 GB-月付费),也可免费保存 7 天,由账户设置或 ?storage= 决定。
所有模型的结构一致图像、视频和音频的字段均为 type、url、content_type、width、height 和 duration。output 是模型自身的结果对象。
输出字段
video
object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames}由图像生成的视频文件。
prompt
string用于生成输出的提示词。
seed
integer生成期间应用的种子值。
frames_zip
object {url, content_type, file_name, file_size} | null包含每个视频帧的 ZIP 归档,在请求时返回。

对于 AI 代理:此页面的 Markdown 版本位于 https://doitong.com/zh-CN/developers/models/editto.md. 所有模型和指南: https://doitong.com/developers/llms.txt