跳转到文档内容
接口文档 / 口播音视频

查询计费与套餐配置

获取功能积分单价和各套餐的批量视频上限,用于生成前展示预估费用。该接口不返回当前账号的积分余额或当前订阅级别。

v1查询接口 Bearer 鉴权
POSThttps://popto.cn/api/open/v1/credit_package/get

鉴权与请求头

在 API 密钥管理 ↗ 创建密钥,每次请求在 HTTP Header 中携带。

AuthorizationBearer <POPTO_API_KEY>必填
Content-Typeapplication/json必填

请求参数 Body · JSON

无需业务参数,发送空 JSON 对象 {} 即可。

返回值与结构

成功时 ret = 0,业务数据位于 data.ent。以下为 data.ent 中的字段。

credit_consume_itemsobject[]

各功能消耗配置。

查看数组元素字段 4
featurestring

计费功能,如 render_avatar、actor_say。

label_cnstring

中文名称。

label_enstring

英文名称。

creditsnumber

配置中的单价,可能为小数。

subscription_entitlementobject

按套餐列出的权益;*_plan_batch_render_avatar_limit 是单次视频数量上限。

查看子字段 20
free_plan_video_analysis_limitinteger

free 套餐的 video_analysis 权益上限;-1 表示不限制。

free_plan_voiceover_script_limitinteger

free 套餐的 voiceover_script 权益上限;-1 表示不限制。

free_plan_batch_render_avatar_limitinteger

free 套餐的 batch_render_avatar 权益上限;-1 表示不限制。

free_plan_custom_actor_limitinteger

free 套餐的 custom_actor 权益上限;-1 表示不限制。

free_plan_wechat_hot_article_search_limitinteger

free 套餐的 wechat_hot_article_search 权益上限;-1 表示不限制。

base_plan_video_analysis_limitinteger

base 套餐的 video_analysis 权益上限;-1 表示不限制。

base_plan_voiceover_script_limitinteger

base 套餐的 voiceover_script 权益上限;-1 表示不限制。

base_plan_batch_render_avatar_limitinteger

base 套餐的 batch_render_avatar 权益上限;-1 表示不限制。

base_plan_custom_actor_limitinteger

base 套餐的 custom_actor 权益上限;-1 表示不限制。

base_plan_wechat_hot_article_search_limitinteger

base 套餐的 wechat_hot_article_search 权益上限;-1 表示不限制。

plus_plan_video_analysis_limitinteger

plus 套餐的 video_analysis 权益上限;-1 表示不限制。

plus_plan_voiceover_script_limitinteger

plus 套餐的 voiceover_script 权益上限;-1 表示不限制。

plus_plan_batch_render_avatar_limitinteger

plus 套餐的 batch_render_avatar 权益上限;-1 表示不限制。

plus_plan_custom_actor_limitinteger

plus 套餐的 custom_actor 权益上限;-1 表示不限制。

plus_plan_wechat_hot_article_search_limitinteger

plus 套餐的 wechat_hot_article_search 权益上限;-1 表示不限制。

pro_plan_video_analysis_limitinteger

pro 套餐的 video_analysis 权益上限;-1 表示不限制。

pro_plan_voiceover_script_limitinteger

pro 套餐的 voiceover_script 权益上限;-1 表示不限制。

pro_plan_batch_render_avatar_limitinteger

pro 套餐的 batch_render_avatar 权益上限;-1 表示不限制。

pro_plan_custom_actor_limitinteger

pro 套餐的 custom_actor 权益上限;-1 表示不限制。

pro_plan_wechat_hot_article_search_limitinteger

pro 套餐的 wechat_hot_article_search 权益上限;-1 表示不限制。

subscription_plansobject[]

订阅套餐。

starter_offerobject

可选新用户套餐配置。

credit_packsobject[]

积分包。

price_per_creditinteger

积分价格配置。

new_user_register_creditsinteger

新用户注册赠送积分。

survey_reward_creditsinteger

问卷奖励积分。

调用说明

  • 示例中的积分与套餐上限仅用于展示,实际以服务端当前配置和生成接口的权益校验为准。
  • 视频预扣费为每条时长 × 向上取整后的 render_avatar 单价,时长未提供时按正文约 5 字/秒向上取整估算。当前批量音频逻辑不单独扣 actor_say 积分,不要将该配置项视为音频任务的扣费凭证。
处理业务响应
HTTP 200 仍可能返回业务错误,请同时检查 ret、code 和 msg。查看响应与错误码