NearToken

外观

SD 2.0 / 2.5 视频 ​

SD 系列用 Seedance低价1x 分组。创建令牌时选择该分组，并确认模型限制包含要用的模型。接口路径和视频生成一致，但参数独立：不要套用 omni / veo-3.1 的 mode、metadata 或比例型 size 约定。

模型与分辨率 ​

model 选公开模型，resolution 选档位。不要把分辨率或版本写进模型名。

公开模型名可选 resolution默认档位计费
sd2.0480p、720p480p按秒，档位不同价格不同
sd2.5仅 720p720p按秒
  • 分辨率写完整字符串：720p，不要写 720 或 1280x720。
  • 不支持的档位返回 400，不会自动降级或换成默认档位。
  • sd2.0-1、sd2.5-1、sd2.5-2 已下架，不再接受新任务；历史任务仍可用原任务 ID 查询。
  • 具体价格以控制台模型广场和实际账单为准。

创建任务 ​

bash
curl -sS -X POST "$BASE_URL/videos" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sd2.5",
    "prompt": "白色桌面上的蓝色积木缓缓转动，固定镜头，没有文字",
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9",
    "n": 1
  }'
json
{
  "id": "task_EXAMPLE",
  "object": "video",
  "model": "sd2.5",
  "status": "queued",
  "progress": 0
}

创建成功只表示入队。保存返回的 id，后续查询和下载都用它。

参数 ​

字段必填说明
model是sd2.0 或 sd2.5
prompt是视频内容与镜头描述
resolution否建议显式指定，取值见上表
duration否正整数秒，默认 5
aspect_ratio否默认 16:9；可传 16:9、9:16、1:1、4:3、3:4、21:9
n否固定 1
images否参考图片 URL 字符串数组
audios否参考音频 URL 字符串数组
videos否参考视频 URL 字符串数组
first_frame_url / last_frame_url否首帧 / 尾帧图片 URL
generateAudio否是否请求生成音频，false 会保留
seed否随机种子，显式传 0 会保留
  • 时长只用一个字段：duration。兼容字段 seconds、video_length 如果同时出现，值必须和 duration 一致，否则返回 400。
  • 比例用 aspect_ratio，清晰度用 resolution，通常不传 size。
  • 素材一律放在 URL 字符串数组里，不要混入对象、数字或空字符串，也不要同时提交 images 和 image_url 这类别名。
  • 素材数量上限以接口校验为准。先从文本或少量参考图开始，确认效果再增加素材。

参考图生视频 ​

json
{
  "model": "sd2.5",
  "prompt": "保持参考图主体，镜头缓慢推进",
  "resolution": "720p",
  "duration": 5,
  "aspect_ratio": "16:9",
  "images": ["https://example.com/reference.png"],
  "n": 1
}

素材用公网可访问的 HTTPS 地址或 data: URL。单张图也放在 images 数组里。

查询与下载 ​

bash
curl -sS "$BASE_URL/videos/$TASK_ID" -H "Authorization: Bearer $API_KEY"
curl -L -sS "$BASE_URL/videos/$TASK_ID/content" -H "Authorization: Bearer $API_KEY" -o output.mp4

状态按 queued → in_progress → completed 变化，失败为 failed。建议 5～10 秒查询一次，进入终态就停止；已经拿到任务 ID 时不要重复创建。

计费 ​

  • 按秒计费：费用由公开模型、resolution 和请求 duration 共同决定。
  • 参数校验失败不会创建任务；任务最终失败时，已预扣的费用自动退回。
  • 如果退款没有出现，带上任务 ID 联系管理员。

NearToken