健康检查

服务存活探测

服务存活探测。msg 固定返回 pong；data.time 为 UTC 时间。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/tax/ping JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息，存活探测固定返回 pong
data	object	业务数据
data.version	string	数据版本
data.time	string	数据时间（UTC 时间）
data.features	array	功能特性
data.features[]	string	功能特性
data.scenes	array	场景列表
data.scenes[]	string	场景
data.batch_limit	integer	批量查询允许的最大条数

请求示例

返回示例

{"msg":"pong","code":200,"data":{"time":"2026-10-22 14:47:24","scenes":["monthly","annual","bonus"],"version":"1.0","features":["monthly_cumulative_withholding","annual_settlement","annual_bonus"],"batch_limit":10}}

税率规则

返回税率表、扣除标准

返回全部税率规则：场景列表、基本减除费用（月度 5000 / 年度 60000）、综合所得与月度税率表（含税率与速算扣除数）、年终奖计税方式与政策说明、专项附加扣除标准、住房租金分档、批量上限及计算公式。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/tax/rules JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.scenes	array	场景列表
data.scenes[]	string	场景
data.basic_deduction	object	基本减除费用
data.basic_deduction.monthly	integer	月度金额
data.basic_deduction.annual	integer	年度金额
data.basic_deduction.note	string	备注
data.comprehensive_brackets	array	综合所得税率表
data.comprehensive_brackets[]	object	综合所得税率表
data.comprehensive_brackets[].level	integer	等级
data.comprehensive_brackets[].range	string	区间
data.comprehensive_brackets[].min	integer	最小值
data.comprehensive_brackets[].max	integer	最大值
data.comprehensive_brackets[].rate	number	税率/费率（小数）
data.comprehensive_brackets[].rate_pct	integer	税率（百分比）
data.comprehensive_brackets[].quick_deduction	integer	速算扣除数
data.monthly_brackets	array	月度税率表
data.monthly_brackets[]	object	月度税率表
data.monthly_brackets[].level	integer	等级
data.monthly_brackets[].range	string	区间
data.monthly_brackets[].min	integer	最小值
data.monthly_brackets[].max	integer	最大值
data.monthly_brackets[].rate	number	税率/费率（小数）
data.monthly_brackets[].rate_pct	integer	税率（百分比）
data.monthly_brackets[].quick_deduction	integer	速算扣除数
data.bonus_methods	array	年终奖计税方式列表
data.bonus_methods[]	string	年终奖计税方式
data.bonus_policy_note	string	年终奖政策说明
data.special_additional_deduction	object	专项附加扣除
data.special_additional_deduction.children_education	integer	子女教育扣除
data.special_additional_deduction.continuing_education	integer	继续教育扣除
data.special_additional_deduction.housing_loan	integer	住房贷款利息扣除
data.special_additional_deduction.housing_rent	array	住房租金扣除
data.special_additional_deduction.housing_rent[]	integer	住房租金扣除
data.special_additional_deduction.elderly_care	integer	赡养老人扣除
data.special_additional_deduction.infant_care	integer	婴幼儿照护扣除
data.housing_rent_tiers	array	住房租金分档
data.housing_rent_tiers[]	object	住房租金分档
data.housing_rent_tiers[].amount	integer	金额
data.housing_rent_tiers[].cities	string	适用城市
data.batch_limit	integer	批量查询允许的最大条数
data.formulas	object	计算公式
data.formulas.monthly	string	月度金额
data.formulas.annual	string	年度金额
data.formulas.bonus_separate	string	年终奖单独计税
data.formulas.bonus_combined	string	年终奖并入综合所得计税
data.currency	string	货币单位
data.policy_basis	string	政策依据

请求示例

返回示例

{"msg":"success","code":200,"data":{"scenes":["monthly","annual","bonus"],"currency":"CNY (元)","formulas":{"annual":"应纳税额 = (年度综合所得 - 60000 - 专项扣除 - 专项附加扣除 - 其他扣除) × 税率 - 速算扣除数; 应退补税 = 应纳税额 - 已预缴","monthly":"本月应预扣 = 累计应预扣税额 - 已预扣预缴税额; 累计应纳税所得额 = 累计收入 - 5000×月数 - 累计社保 - 累计专项附加 - 累计其他","bonus_combined":"奖金并入综合所得, 按年度税率表统一计税","bonus_separate":"应纳税额 = 奖金 × 税率 - 速算扣除数; 税率由 (奖金/12) 查月度税率表确定"},"batch_limit":10,"policy_basis":"2019 新个税法 + 2023 专项附加扣除标准","bonus_methods":["separate","combined"],"basic_deduction":{"note":"基本减除费用 (起征点), 全国统一","annual":60000,"monthly":5000},"monthly_brackets":[{"max":3000,"min":0,"rate":0.03,"level":1,"range":"0 ~ 3,000","rate_pct":3,"quick_deduction":0},{"max":12000,"min":3000,"rate":0.1,"level":2,"range":"3,000 ~ 12,000","rate_pct":10,"quick_deduction":210},{"max":25000,"min":12000,"rate":0.2,"level":3,"range":"12,000 ~ 25,000","rate_pct":20,"quick_deduction":1410}],"bonus_policy_note":"全年一次性奖金单独计税政策延续至 2027 年 12 月 31 日","housing_rent_tiers":[{"amount":1500,"cities":"直辖市、省会城市、计划单列市及国务院确定的其他城市"},{"amount":1100,"cities":"除第一档外, 市辖区户籍人口超过 100 万的城市"},{"amount":800,"cities":"市辖区户籍人口不超过 100 万 (含) 的城市"}],"comprehensive_brackets":[{"max":36000,"min":0,"rate":0.03,"level":1,"range":"0 ~ 36,000","rate_pct":3,"quick_deduction":0},{"max":144000,"min":36000,"rate":0.1,"level":2,"range":"36,000 ~ 144,000","rate_pct":10,"quick_deduction":2520},{"max":300000,"min":144000,"rate":0.2,"level":3,"range":"144,000 ~ 300,000","rate_pct":20,"quick_deduction":16920}],"special_additional_deduction":{"infant_care":2000,"elderly_care":3000,"housing_loan":1000,"housing_rent":[800,1100,1500],"children_education":2000,"continuing_education":400}}}

税率表查询

查询税率表

查询税率表。type=all 返回 comprehensive+monthly；type=comprehensive/monthly 返回 brackets。type 非法时返回 code 400000。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/tax/brackets JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
type	string	否	税率表类型：comprehensive 综合所得年度税率\|monthly 月度税率\|all 全部（默认，不传即 all）

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.type	string	请求的类型：all\|comprehensive\|monthly
data.brackets	array	税率表（仅 type=comprehensive 或 monthly 时返回）
data.brackets[]	object	税率表（仅 type=comprehensive 或 monthly 时返回）
data.brackets[].level	integer	等级
data.brackets[].range	string	区间
data.brackets[].min	integer	最小值
data.brackets[].max	integer	最大值（最后一级为 null）
data.brackets[].rate	number	税率
data.brackets[].rate_pct	integer	税率（百分比）
data.brackets[].quick_deduction	integer	速算扣除数
data.comprehensive	array	综合所得税率表（仅 type=all 时返回）
data.comprehensive[]	object	综合所得税率表列表
data.comprehensive[].level	integer	等级
data.comprehensive[].range	string	区间
data.comprehensive[].min	integer	最小值
data.comprehensive[].max	integer	最大值
data.comprehensive[].rate	number	税率/费率（小数）
data.comprehensive[].rate_pct	integer	税率（百分比）
data.comprehensive[].quick_deduction	integer	速算扣除数
data.monthly	array	月度税率表（仅 type=all 时返回）
data.monthly[]	object	月度金额
data.monthly[].level	integer	等级
data.monthly[].range	string	区间
data.monthly[].min	integer	最小值
data.monthly[].max	integer	最大值
data.monthly[].rate	number	税率/费率（小数）
data.monthly[].rate_pct	integer	税率（百分比）
data.monthly[].quick_deduction	integer	速算扣除数

请求示例

返回示例

{"msg":"success","code":200,"data":{"type":"all","monthly":[{"max":3000,"min":0,"rate":0.03,"level":1,"range":"0 ~ 3,000","rate_pct":3,"quick_deduction":0},{"max":12000,"min":3000,"rate":0.1,"level":2,"range":"3,000 ~ 12,000","rate_pct":10,"quick_deduction":210},{"max":25000,"min":12000,"rate":0.2,"level":3,"range":"12,000 ~ 25,000","rate_pct":20,"quick_deduction":1410}],"comprehensive":[{"max":36000,"min":0,"rate":0.03,"level":1,"range":"0 ~ 36,000","rate_pct":3,"quick_deduction":0},{"max":144000,"min":36000,"rate":0.1,"level":2,"range":"36,000 ~ 144,000","rate_pct":10,"quick_deduction":2520},{"max":300000,"min":144000,"rate":0.2,"level":3,"range":"144,000 ~ 300,000","rate_pct":20,"quick_deduction":16920}]}}

个税计算

单次个税计算

单次个税计算，支持 monthly/annual/bonus 三种场景，返回结构不同，详见请求/响应参数。示例为 monthly 场景。参数错误返回 code 400000。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

POST http://www.shujuyu.cn/v1/api/tax/calc JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
scene	string	否	计算场景：monthly 月度累计预扣（默认）\|annual 年度汇算\|bonus 全年一次性奖金
income	number	否	月度收入；scene=monthly 时必填，scene=annual 可用 annual_income 代替，scene=bonus 不需要
month	integer	否	月份 1-12，仅 scene=monthly 有效，默认 1
social_insurance	number	否	月度社保扣除（scene=monthly，0~1e10）
special_deduction	number	否	月度专项附加扣除（scene=monthly，0~1e10）
other_deduction	number	否	月度其他扣除（scene=monthly，0~1e10）
basic_deduction	number	否	基本减除费用；monthly 默认 5000，annual/bonus 默认 60000
accumulated_income	number	否	累计收入（scene=monthly 完整模式；传入本字段或 accumulated_social_insurance/prev_tax_withheld 即按 full 模式计算）
accumulated_social_insurance	number	否	累计社保（scene=monthly 完整模式）
accumulated_special_deduction	number	否	累计专项附加扣除（scene=monthly 完整模式）
accumulated_other_deduction	number	否	累计其他扣除（scene=monthly 完整模式）
prev_tax_withheld	number	否	已预扣预缴税额（scene=monthly 完整模式）
annual_income	number	否	年度综合所得；scene=annual 时必填（可用 income 代替），scene=bonus 并入计税时可选
annual_social_insurance	number	否	年度专项扣除（scene=annual/bonus）
annual_special_deduction	number	否	年度专项附加扣除（scene=annual/bonus）
annual_other_deduction	number	否	年度其他扣除（scene=annual/bonus）
prev_tax_paid	number	否	已预缴税额（scene=annual）
bonus	number	否	全年一次性奖金；scene=bonus 时必填且必须大于 0，scene=annual 时可选
bonus_method	string	否	奖金计税方式：separate 单独计税（默认）\|combined 并入综合所得（scene=annual/bonus）
detail	boolean	否	是否返回计算明细 data.detail（scene=monthly/annual 有效）

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据（三种场景返回结构不同）
data.scene	string	场景：monthly\|annual\|bonus
data.month	integer	月份（scene=monthly）
data.mode	string	计算模式：simple 简化\|full 完整（scene=monthly）
data.income	number	收入（scene=monthly）
data.social_insurance	number	社保扣除（scene=monthly）
data.special_deduction	number	专项扣除（scene=monthly）
data.other_deduction	number	其他扣除（scene=monthly）
data.basic_deduction	number	基本减除费用
data.current_month_tax	number	本月应纳税额（scene=monthly）
data.after_tax_income	number	税后收入
data.cumulative	object	累计数据（scene=monthly）
data.cumulative.income	number	累计收入
data.cumulative.basic_deduction	number	累计基本减除费用
data.cumulative.social_insurance	number	累计社保扣除
data.cumulative.special_deduction	number	累计专项扣除
data.cumulative.other_deduction	number	累计其他扣除
data.cumulative.taxable_income	number	累计应纳税所得额
data.cumulative.tax	number	累计应预扣税额
data.cumulative.prev_tax_withheld	number	已预扣预缴税额
data.cumulative.rate	number	适用税率
data.cumulative.quick_deduction	number	速算扣除数
data.detail	object	计算明细（detail=true 时返回，scene=monthly/annual）
data.detail.formula	string	计算公式（scene=monthly/annual 且 detail=true）
data.detail.acc_taxable	number	累计应纳税所得额（scene=monthly 且 detail=true）
data.detail.acc_tax	number	累计应预扣税额（scene=monthly 且 detail=true）
data.detail.prev_withheld	number	已预扣预缴税额（scene=monthly 且 detail=true）
data.detail.current_tax_raw	number	本月应预扣税额 = 累计应预扣税额 - 已预扣预缴税额（未取整，scene=monthly 且 detail=true）
data.detail.bracket	object	适用税率档位（scene=monthly 且 detail=true）
data.detail.bracket.min	integer	档位下限
data.detail.bracket.max	integer	档位上限（最高档为 1e18）
data.detail.bracket.rate	number	档位税率
data.detail.bracket.quick_deduction	integer	档位速算扣除数
data.detail.comp_taxable	number	综合所得应纳税所得额（scene=annual 且 detail=true）
data.detail.comp_tax	number	综合所得税额（scene=annual 且 detail=true）
data.detail.bonus_taxable	number	并入计税的奖金金额，无奖金时为 0（scene=annual 且 detail=true）
data.detail.bonus_tax	number	奖金税额（scene=annual 且 detail=true）
data.detail.total_tax	number	应纳税总额（scene=annual 且 detail=true）
data.annual_income	number	年度综合所得（scene=annual）
data.annual_social_insurance	number	年度专项扣除（scene=annual）
data.annual_special_deduction	number	年度专项附加扣除（scene=annual）
data.annual_other_deduction	number	年度其他扣除（scene=annual）
data.bonus	number	全年一次性奖金（scene=annual/bonus）
data.bonus_method	string	奖金计税方式：separate\|combined
data.comprehensive_taxable_income	number	综合所得应纳税所得额（scene=annual）
data.comprehensive_tax	number	综合所得税额（scene=annual）
data.comprehensive_rate	number	综合所得适用税率（scene=annual）
data.comprehensive_quick_deduction	number	综合所得速算扣除数（scene=annual）
data.bonus_tax	number	奖金税额（scene=annual）
data.total_tax	number	应纳税总额（scene=annual）
data.prev_tax_paid	number	已预缴税额（scene=annual）
data.refund_or_owe	number	应退/补税额：正数补税，负数退税（scene=annual）
data.refund_or_owe_label	string	退补标识：owe 补税\|refund 退税\|even 不退不补（scene=annual）
data.effective_tax_rate_pct	number	实际税负率（%，scene=annual）
data.monthly_equivalent	number	奖金月度等效额 = bonus/12（scene=bonus）
data.separate	object	单独计税结果（scene=bonus）
data.separate.rate	number	单独计税适用税率
data.separate.quick_deduction	number	单独计税速算扣除数
data.separate.tax	number	单独计税税额
data.separate.after_tax	number	单独计税税后奖金
data.combined	object	并入综合所得结果（scene=bonus）
data.combined.tax	number	并入计税下奖金部分的税额
data.combined.after_tax	number	并入计税下税后奖金
data.combined.diff_vs_separate	number	并入与单独的税额差 = 并入 - 单独；正数表示单独更划算，负数表示并入更划算
data.recommendation	string	推荐计税方式：separate\|combined（scene=bonus）
data.chosen_tax	number	所选计税方式的税额（scene=bonus）
data.after_tax_bonus	number	所选计税方式的税后奖金（scene=bonus）

请求示例

返回示例

{"msg":"success","code":200,"data":{"mode":"simple","month":1,"scene":"monthly","income":20000,"cumulative":{"tax":450,"rate":0.03,"income":20000,"taxable_income":15000,"basic_deduction":5000,"other_deduction":0,"quick_deduction":0,"social_insurance":0,"prev_tax_withheld":0,"special_deduction":0},"basic_deduction":5000,"other_deduction":0,"after_tax_income":19550,"social_insurance":0,"current_month_tax":450,"special_deduction":0}}

批量计算

批量计算最多 10 条

批量计算，最多 10 条，超出直接报错（4002）。单条失败不影响其他条目，通过 data.list[].ok/error 区分。全失败时 msg 为 all_failed。参数错误返回 code 400000。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

POST http://www.shujuyu.cn/v1/api/tax/calc-batch JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
cases	array	是	计算参数数组，最多 10 条，超出返回 4002。每项结构同 /calc 的请求参数，通过 scene 指定场景（monthly 默认 / annual / bonus），如示例可直接混合三种场景。

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息；全部失败时为 all_failed
data	object	业务数据
data.total	integer	总条数
data.returned	integer	本次实际返回条数
data.ok	integer	成功处理的条目数
data.fail	integer	失败数量
data.truncated	boolean	保留字段，当前恒为 false（超过 10 条时直接返回 4002 错误，不会截断）
data.max_limit	integer	允许返回的最大条数
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].index	integer	序号
data.list[].result	object	计算结果，结构同 /calc 对应 scene 的 data；该条传了 detail=true 时同样含 detail
data.list[].result.scene	string	场景
data.list[].result.month	integer	月份
data.list[].result.mode	string	模式
data.list[].result.income	integer	收入
data.list[].result.social_insurance	integer	社保扣除
data.list[].result.special_deduction	integer	专项扣除
data.list[].result.other_deduction	integer	其他扣除
data.list[].result.basic_deduction	integer	基本减除费用
data.list[].result.current_month_tax	integer	本月应纳税额
data.list[].result.after_tax_income	integer	税后收入（scene=monthly/annual）
data.list[].result.cumulative	object	累计数据
data.list[].result.cumulative.income	integer	收入
data.list[].result.cumulative.basic_deduction	integer	基本减除费用
data.list[].result.cumulative.social_insurance	integer	社保扣除
data.list[].result.cumulative.special_deduction	integer	专项扣除
data.list[].result.cumulative.other_deduction	integer	其他扣除
data.list[].result.cumulative.taxable_income	integer	应纳税所得额
data.list[].result.cumulative.tax	integer	税额
data.list[].result.cumulative.prev_tax_withheld	integer	已预扣预缴税额
data.list[].result.cumulative.rate	number	累计税率（小数）
data.list[].result.cumulative.quick_deduction	integer	速算扣除数
data.list[].result.annual_income	number	年度综合所得（scene=annual）
data.list[].result.annual_social_insurance	number	年度专项扣除（scene=annual）
data.list[].result.annual_special_deduction	number	年度专项附加扣除（scene=annual）
data.list[].result.annual_other_deduction	number	年度其他扣除（scene=annual）
data.list[].result.bonus	number	全年一次性奖金（scene=annual/bonus）
data.list[].result.bonus_method	string	奖金计税方式：separate\|combined（scene=annual/bonus）
data.list[].result.comprehensive_taxable_income	number	综合所得应纳税所得额（scene=annual）
data.list[].result.comprehensive_tax	number	综合所得税额（scene=annual）
data.list[].result.comprehensive_rate	number	综合所得适用税率（scene=annual）
data.list[].result.comprehensive_quick_deduction	number	综合所得速算扣除数（scene=annual）
data.list[].result.bonus_tax	number	奖金税额（scene=annual）
data.list[].result.total_tax	number	应纳税总额（scene=annual）
data.list[].result.prev_tax_paid	number	已预缴税额（scene=annual）
data.list[].result.refund_or_owe	number	应退/补税额：正数补税，负数退税（scene=annual）
data.list[].result.refund_or_owe_label	string	退补标识：owe 补税\|refund 退税\|even 不退不补（scene=annual）
data.list[].result.effective_tax_rate_pct	number	实际税负率（%，scene=annual）
data.list[].result.monthly_equivalent	number	奖金月度等效额 = bonus/12（scene=bonus）
data.list[].result.separate	object	单独计税结果（scene=bonus）
data.list[].result.separate.rate	number	单独计税适用税率
data.list[].result.separate.quick_deduction	number	单独计税速算扣除数
data.list[].result.separate.tax	number	单独计税税额
data.list[].result.separate.after_tax	number	单独计税税后奖金
data.list[].result.combined	object	并入综合所得结果（scene=bonus）
data.list[].result.combined.tax	number	并入计税下奖金部分的税额
data.list[].result.combined.after_tax	number	并入计税下税后奖金
data.list[].result.combined.diff_vs_separate	number	并入与单独的税额差 = 并入 - 单独；正数表示单独更划算，负数表示并入更划算
data.list[].result.recommendation	string	推荐计税方式：separate\|combined（scene=bonus）
data.list[].result.chosen_tax	number	所选计税方式的税额（scene=bonus）
data.list[].result.after_tax_bonus	number	所选计税方式的税后奖金（scene=bonus）
data.list[].ok	boolean	该条是否成功
data.list[].error	string	失败原因（ok=false 时返回，ok=true 时无此字段）

请求示例

返回示例

{"msg":"success","code":200,"data":{"ok":1,"fail":0,"list":[{"ok":true,"index":0,"result":{"mode":"simple","month":1,"scene":"monthly","income":20000,"cumulative":{"tax":450,"rate":0.03,"income":20000,"taxable_income":15000,"basic_deduction":5000,"other_deduction":0,"quick_deduction":0,"social_insurance":0,"prev_tax_withheld":0,"special_deduction":0},"basic_deduction":5000,"other_deduction":0,"after_tax_income":19550,"social_insurance":0,"current_month_tax":450,"special_deduction":0}}],"total":1,"returned":1,"max_limit":10,"truncated":false}}

产品说明

产品概述

个人所得税计算器（中国个税），支持月度累计预扣/年度汇算/年终奖。

使用场景

数据查询：快速集成个税计算器到您的应用中

业务系统：将个税计算器数据嵌入业务流程

开发工具：通过 API 接口获取金融财税数据

数据分析：基于个税计算器数据进行分析和决策

费用计算

按次计费单价

¥0.002 / 次

每次调用接口从账户余额中扣除相应费用，VIP 用户可享折扣

扣费优先级

免费额度

次数包

余额扣费

计费方式详解

1 免费额度

· 接口每日免费额度已关闭
· VIP 用户月度免费额度：
· 个人版：每月 5000 次，本接口月上限 5000 次
· 专业版：每月 30000 次，本接口月上限 30000 次
· 企业版：每月 200000 次，本接口月上限 200000 次
· 账户如有注册/活动赠送的免费次数，会优先于接口免费额度扣减
· VIP 月度免费额度仅适用于单次售价不高于 ¥0.0800/次的接口；接口每日免费额度按接口配置执行
VIP 月度免费额度每月重置，未使用部分不累计至下月。

2 次数包

预付费购买固定调用次数，最高可省 20%（相对按次付费），用完为止。
次数包为独立计费，不与 VIP 折扣叠加。
请在有效期内使用，过期后未使用的次数不可再用。

3 余额扣费

按次从账户余额扣除费用；所有用户可享量折扣，VIP 用户额外享 VIP 折扣。
扣费公式：实际扣费 = 接口单价 × (1 - VIP 折扣比例 - 量折扣比例)，并受总折扣上限和最低利润率保护约束
VIP 折扣：个人版9折专业版8折企业版7折
量折扣：月付费调用 ≥1000 次享 2%、月付费调用 ≥10000 次享 5%、月付费调用 ≥20000 次享 10%
· 量折扣按账号当月全部接口的付费调用次数统计，达到更高档位时按更高档位计算
总折扣上限：VIP 折扣 + 量折扣合计不超过 50%
最低利润率保护：折后价不得低于成本价 × (1 + 15%)；若接口售价本身低于该保护价，则取消折扣并按售价计费
余额不足时调用将失败，请及时充值。

次数包方案

方案名称	调用次数	价格	折算单价	比按次付费节省	有效期
100次调用包	100 次	¥0.2	¥0.0020/次	-	365 天
500次调用包	500 次	¥0.95	¥0.0019/次	省5%	365 天
1000次调用包	1000 次	¥1.8	¥0.0018/次	省10%	365 天
5000次调用包	5000 次	¥8.5	¥0.0017/次	省15%	365 天
10000次调用包	10000 次	¥16	¥0.0016/次	省20%	365 天

VIP 权益对比

等级	每月免费次数	本接口月免费上限	折扣	VIP 折后单价
免费版	按接口配置	—	-	¥0.002/次
个人版	5000 次	5000 次	10%	¥0.0018/次
专业版	30000 次	30000 次	20%	¥0.0016/次
企业版推荐	200000 次	200000 次	30%	¥0.0014/次

* VIP 月度免费额度每月重置。每月免费次数为账号级 VIP 月额度，本接口月免费上限为其中对本接口的限制（接口可单独设置上限或关闭）。VIP 折扣仅适用于余额扣费方式，VIP 折后单价不含量折扣。本接口已关闭接口级月度免费额度（不影响 VIP 月度免费额度）。接口每日免费额度已关闭。

费用计算示例

* 以下示例未包含量折扣，量折扣按账号当月全部接口的付费调用量另行计算。

示例1：普通用户按次付费

调用 1000 次，费用 = 0.002 × 1000 = ¥2.00

示例2：个人版用户按次付费（仅 VIP 折扣，已考虑最低利润率保护）

调用 1000 次，折扣约 10%，费用 = 0.002 × (1 - 10%) × 1000 ≈ ¥1.80

示例3：购买「500次调用包」次数包

支付 ¥0.95，获得 500 次调用，折算单价 ¥0.0019/次

同等次数按次付费需 ¥1.00，次数包可节省 ¥0.05

错误码说明

错误码	说明	解决方案
200	请求成功	-
400000	请求参数错误	检查参数名、格式与取值
401000	认证失败	检查 Authorization: Bearer 密钥是否正确、是否过期
402000	账户余额不足	充值后重试
403000	无访问权限	确认密钥权限、接口范围与 IP 白名单是否满足要求
404001	接口或端点不存在	检查 API 与端点的请求路径
409000	请求冲突	请稍后重试
422000	参数校验失败	检查参数格式与取值
429000	请求频率或额度超限	降低调用频率，或升级套餐提升额度
500000	服务器内部错误	携带响应中的 request_id 联系技术支持
502000	服务暂时不可用	稍后重试
503000	服务暂时不可用	稍后重试
504000	请求超时	稍后重试

更新日志

暂无更新日志