什么时候用,什么时候不用
适用场景
- 单条视频请求,时长和画幅明确。
- 用户已经有想动起来的静图。
- 想先用便宜的草稿判断方向,再决定要不要出全分辨率。
不适用
- apipod-short-film — 不止一个镜头,还要跨镜头连续性。
- apipod-vertical-video — 目标是 9:16 信息流,有它自己的安全区规则。
执行流程
5 个技能这个技能按顺序做什么。
- 01
先报价——视频是最贵的部分
除非用户已经确认过费用,否则先 estimate_cost 并把数字亮出来再调 generate_video。视频按秒计费,模型之间价差很大。
- 02
先给一张看得见的定帧
做新镜头时,先按视频画幅出一张关键帧,给用户看过再作为 image_urls[0] 传入。用户看过的静图比模型自由理解的提示词更可靠——但要说明这会多一次图片生成。
- 03
先定义这条片子再写提示词
用途、画幅、时长、主体、一个主要动作、一个镜头运动、声音或对白、以及如何结束。每条片子只放一个动作和一个镜头想法。
- 04
遵守时长枚举
从 get_model_params 读模型真正接受的时长和分辨率。自己凑一个「应该有」的数字,得到的是报错而不是视频。
- 05
每 10 秒轮询,并且只说一次
视频要 1–5 分钟。告诉用户一次,然后安静地继续轮询。交付链接、最终 cost_usd,以及关于主体、运动、节奏、音画同步的直白说明。
试一下
从这里直接发出去
示例请求
用 APIPod 生成一条 5 秒 720p 视频:日落时的海浪,带原生音频。
按钮会在新会话里预填这条提示词。若 APIPod 尚未连接,提示词会让助手先停下、协助你完成连接。在 Claude Code 或终端里,直接复制粘贴即可。
调用轨迹
list_models (category: "video")
→ seedance 在列
get_model_params (duration · generate_audio)
→ input_schema
estimate_cost (duration: "5", resolution: "720p")
→ $— · sufficient
generate_video (prompt 按时间轴写)
→ vid_7f3a9c
check_job (every 10 s)
→ completed · 1–5 min
示意轨迹:左侧请求发出后,这个技能按顺序实际会走的工具。价格一律是 estimate_cost 实时返回的形态——本页自己不报价。
它不做的事
它给自己定的规矩。
01
一次请求只出一条。想改是提议,不是直接跑——再跑一次要花钱,需要明确同意。
02
只有模型会生成语音时才写对白,而且要逐字写。场景编号和生产备注会被语音模型念出来。
03
模型有草稿或低分辨率选项时,长片或贵的片子先出草稿;用户认可后再出全分辨率。