视频生成

视频生成是异步流程:你提交一个 job,worker 执行上游生成,你轮询拿到成片。和其它请求一样,它用你的 API 密钥鉴权、预先预扣钱包 Credit,并走标准计费路径结算。

POST   /v1/jobs        # kind: "video_generation"
GET    /v1/jobs/:id     # 轮询状态 + 结果
GET    /v1/jobs
DELETE /v1/jobs/:id     # 取消排队中的 job

从目录中发现支持视频的模型:

curl "https://api.onehop.ai/v1/models?output_modality=video" \
  -H "Authorization: Bearer $ONEHOP_API_KEY"

生成模式

不同模型支持不同的输入模式。job 在任何东西发往上游前会先按模型声明的能力校验, 所以不支持的组合会以清晰的 OneHop 错误快速失败,而不是返回晦涩的供应商错误。

文生视频

只有提示词、无输入帧。要求模型具备文生视频能力。

图生视频

用单张首帧驱动运动。要求图生视频能力。

首尾帧

在起始帧和结束帧之间插值。要求首尾帧支持且已带首帧。

参考图

用一张或多张参考图引导生成。

如果你请求了某个模型不支持的模式,OneHop 会在计费前返回具体错误 —— 例如 MODEL_NO_TEXT_TO_VIDEO、MODEL_NO_IMAGE_TO_VIDEO、MODEL_NO_LAST_FRAME、 MODEL_NO_REFERENCE_IMAGE,或在只发尾帧而无首帧时返回 MODEL_FRAME_REQUIRES_FIRST。

轮询结果

GET /v1/jobs/:id 返回当前状态。job 变为 completed 后,响应里包含一个新鲜签名的媒体 URL。列表响应不会为大对象 URL 签名 —— 请取单个 job 来拿下载链接。

务必用幂等键

视频 job 又贵又慢。请始终发 X-Idempotency-Key,让重试的提交返回已有 job,而不是启动第二次生成。

视频计费

视频模型如何计价取决于它的计费方式:

方式	数量来源
`token`	从上游响应解析出的输出 token
`per_second`	时长(秒)× 采样数
`per_call`	采样数,可按分辨率与时长分档

分辨率、时长、采样数和模式(t2v / i2v)在创建 job 时就记录,使计价可确定。实际扣费金额始终来自 OneHop 自己的计价引擎 —— 见计费与钱包。