文档

API 参考

查询视频工作区能力

GET/v1/video-models

按模式返回可执行 presets 与帧限制；仅完整 preset 可组合，不能跨模式拼参数。

鉴权与权限

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

Authorization: Bearer $GLOOP_API_KEY

鉴权方案： BearerAuth

响应与错误

HTTP 200

查询视频工作区能力成功

application/json

类型
object
必填字段
dataworkspace_enabledupload_enabledfile_storage_enabled
  • dataarray必填

    当前页/目录数据数组。

    data 子字段（1）
    • []object选填
      [] 子字段（6）
      • idstring必填

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

      • namestring必填

        用户可读名称。

      • capability_versionstring必填

        该公开模型能力版本。

      • modesarray必填

        该模型可执行模式及各自完整参数组合。

        modes 子字段（1）
        • []object选填
          [] 子字段（9）
          • modestring必填

            执行模式。

          • presetsarray必填

            可执行的完整参数组合，不能跨组合形成笛卡尔积。

            presets 子字段（1）
            • []object选填
              [] 子字段（4）
              • durationinteger选填允许 null

                模型 preset 中的时长秒数。

              • resolutionstring选填

                模型 preset 中的分辨率值。

              • aspect_ratiostring选填

                模型 preset 中的宽高比值。

              • generate_audioboolean选填允许 null

                该模型 preset 是否生成音频。

          • audio_policystring必填

            当前模式音频字段策略。

          • aspect_policystring必填

            当前模式宽高比字段策略。

          • duration_policystring必填

            当前模式时长字段策略。

          • prompt_max_charsinteger必填

            当前模式提示词最大 Unicode 字符数。

          • start_frameobject选填

            当前模式首帧限制。

            start_frame 子字段（5）
            • requiredboolean必填

              此模式是否要求该帧。

            • max_bytesinteger必填

              该帧允许的最大文件字节数。

            • max_pixelsinteger必填

              该帧允许的最大像素总数。

            • max_edgeinteger必填

              该帧允许的最大单边像素数。

            • content_typesarray必填

              该帧允许的图片 MIME 类型。

              content_types 子字段（1）
              • []string选填
            allOf 分支 1

            类型: object

            分支必填： required, max_bytes, max_pixels, max_edge, content_types

            • requiredboolean必填

              此模式是否要求该帧。

            • max_bytesinteger必填

              该帧允许的最大文件字节数。

            • max_pixelsinteger必填

              该帧允许的最大像素总数。

            • max_edgeinteger必填

              该帧允许的最大单边像素数。

            • content_typesarray必填

              该帧允许的图片 MIME 类型。

              content_types 子字段（1）
              • []string选填
          • end_frameobject选填

            当前模式尾帧限制。

            end_frame 子字段（5）
            • requiredboolean必填

              此模式是否要求该帧。

            • max_bytesinteger必填

              该帧允许的最大文件字节数。

            • max_pixelsinteger必填

              该帧允许的最大像素总数。

            • max_edgeinteger必填

              该帧允许的最大单边像素数。

            • content_typesarray必填

              该帧允许的图片 MIME 类型。

              content_types 子字段（1）
              • []string选填
            allOf 分支 1

            类型: object

            分支必填： required, max_bytes, max_pixels, max_edge, content_types

            • requiredboolean必填

              此模式是否要求该帧。

            • max_bytesinteger必填

              该帧允许的最大文件字节数。

            • max_pixelsinteger必填

              该帧允许的最大像素总数。

            • max_edgeinteger必填

              该帧允许的最大单边像素数。

            • content_typesarray必填

              该帧允许的图片 MIME 类型。

              content_types 子字段（1）
              • []string选填
          • cancel_policystring选填

            取消能力策略，取消请求不保证完成或退款。

      • cancel_policystring必填

        取消能力策略，取消请求不保证完成或退款。

      • pricing_kindsarray必填

        该模型允许的计价方式。

        pricing_kinds 子字段（1）
        • []string选填
  • workspace_enabledboolean必填

    当前工作区新任务功能是否可用，不表示历史对象被删除。

  • upload_enabledboolean必填

    服务是否启用参考图上传。

  • file_storage_enabledboolean必填

    服务是否启用托管文件存储。

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