文档

API 参考

取得持久视频报价

POST/v1/video-quotes

retention=persistent，按目录支持模式与托管帧报价；开关关闭路由直接 404。报价到期或价格变化须重新确认。

鉴权与权限

使用当前 GloopAPI Key。模型、功能与权限以当前 Key 的目录及接口说明为准。

Authorization: Bearer $GLOOP_API_KEY

鉴权方案： BearerAuth

请求

请求体 · application/json

类型
object
必填字段
modelprompt
额外属性
false

请求体必填

  • modestring选填

    persistent 必填。

    枚举
    ["text_to_video","image_to_video"]
  • retentionstring选填

    persistent 使用持久工作区；省略为普通任务。

  • quote_idstring选填

    persistent 新请求须先确认 video-quotes 返回的有效报价。

  • start_frameobject选填

    persistent 图生视频必填，同 Key 的托管文件；文生视频禁止。

    start_frame 子字段（1）
    • file_idstring必填

      同账户同 Key 的托管文件公开 ID。

    allOf 分支 1

    类型: object

    分支必填： file_id

    • file_idstring必填

      同账户同 Key 的托管文件公开 ID。

  • end_frameobject选填

    persistent 可选尾帧，能力必须支持。

    end_frame 子字段（1）
    • file_idstring必填

      同账户同 Key 的托管文件公开 ID。

    allOf 分支 1

    类型: object

    分支必填： file_id

    • file_idstring必填

      同账户同 Key 的托管文件公开 ID。

  • webhook_endpoint_idstring选填

    普通任务可引用控制台已配置的接收端；persistent 禁止。

  • modelstring必填

    来自当前 Key 目录的公开模型 ID，历史模型是否可用以当前目录为准。

  • promptstring必填

    生成提示词。

    最短长度
    1
    最长长度
    2500
  • durationinteger选填

    模型相关秒数，使用 video-models mode.presets 的完整组合，不能作笛卡尔积。Wan Turbo 不支持此字段；无统一默认。

  • image_urlstring选填

    仅普通任务模型相关 HTTPS 首帧；persistent 禁止。

  • end_image_urlstring选填

    仅普通任务模型相关 HTTPS 尾帧；persistent 禁止。

  • resolutionstring选填

    模型 preset 中的分辨率值。

  • aspect_ratiostring选填

    模型 preset 中的宽高比值。

  • generate_audioboolean选填允许 null

    模型相关，使用模式的音频策略和 presets；禁止假定所有模型生成音频。

响应与错误

HTTP 200

取得持久视频报价成功

application/json

类型
object
必填字段
idexpires_atrequest_hashpricing_kindcurrencyreserved_quotareserved_amountestimated_final_amountsettlement_note
  • idstring必填

    该对象的公开标识符；用于对应详情路径。

  • expires_atinteger必填

    Unix 秒有效期，0 表示不按固定时间到期。

  • request_hashstring必填

    规范化请求摘要，报价与创建绑定，不是幂等请求键。

  • pricing_kindstring必填

    该报价实际使用的计价方式。

  • currencystring必填

    报价/账务币种。

  • reserved_quotainteger必填

    以平台 quota 单位表示的预留额度，不是美元数。

  • reserved_amountstring必填

    报价币种中的最大预留金额字符串。

  • estimated_final_amountstring必填允许 null

    预估最终金额字符串；null 表示生成前无法确定。

  • settlement_notestring必填

    实际计量与结算说明。

HTTP 400

请求字段或参数无效。

application/json

类型
object
必填字段
error

HTTP 401

Key 缺失、无效、过期或已撤销。

application/json

类型
object
必填字段
error

HTTP 403

IP、账户、模型或工具权限不足。

application/json

类型
object
必填字段
error

HTTP 404

对象/能力不可用，或功能开关关闭。

application/json

类型
object
必填字段
error

HTTP 409

幂等/报价冲突、对象未准备或仍被引用。

application/json

类型
object
必填字段
error

HTTP 429

请求/队列限流。

application/json

类型
object
必填字段
error

HTTP 500

鉴权或数据存储内部失败。

application/json

类型
object
必填字段
error

HTTP 503

服务、定价或存储不可用。

application/json

类型
object
必填字段
error

接口说明

这些参数仅为完整预设的说明值。请从当前 Key 的 video-models 目录为所选 model/mode 复制整个 preset（duration、resolution、aspect_ratio、generate_audio），不要仅替换模型或拼接预设。