数字到文本专业版 API

API ID 6348

将数字转换为28种语言和35种预定义货币中完美格式化的文本。我们的API处理标准格式、正式格式和支票书写格式,并支持自定义货币。非常适合财务文件、法律合同、发票和多语言应用。简单集成并提供全面文档

100% 正常运行时间 189 ms 平均响应

API 文档

端点

请求

数字转文本 (POST)

此端点通过请求体中的 JSON 有效载荷将数值转换为其文本表示。它支持对语言、货币、方言和格式风格的广泛自定义。为了确保正确使用并避免错误,请使用以下指定的参数值:

  • languageCode:设置转换的语言。可用值包括“en”(英语)、“es”(西班牙语)、“fr”(法语)、“de”(德语)、“it”(意大利语)、“pt”(葡萄牙语)、“nl”(荷兰语)、“ru”(俄语)、“ar”(阿拉伯语)、“zh”(中文)、“ja”(日语)、“ko”(韩语)、“hi”(印地语)及其他超过 20 种。
  • dialect:指定语言的地区变体。可用值取决于 languageCode,例如,对于“en”: “US”、“UK”和“IN”;对于阿拉伯语“ar”: “EG”、“SA”和“AE”。
  • currencyCode:定义货币转换的货币种类。可用值包括“USD”(美元)、“EUR”(欧元)、“GBP”(英镑)、“JPY”(日元)、“CAD”(加元)、“AUD”(澳元)、“CHF”(瑞士法郎)、“CNY”(人民币)、“INR”(印度卢比)及其他超过 30 种。
  • formatStyle:设置输出样式。可用值为“standard”(例如:“一百二十三”)和“check”(例如:“一百二十三及 00/100”),以及用于法律文件的“formal”

在 JSON 有效载荷中提供这些参数以确保准确结果并避免错误。示例有效载荷:{"value": 123.45, "languageCode": "en", "dialect": "US", "currencyCode": "USD", "formatStyle": "standard"}

参数

参数 类型 必需 可用值
value 数字 任何数值(例如,123.45)
languageCode 字符串 “en”、“es”、“fr”、“de”、“it”、“pt”、“nl”、“ru”、“ar”、“zh”、“ja”、“ko”、“hi”等(总计 35 种以上)
dialect 字符串 取决于 languageCode,例如,“en”的“US”、“UK”、“AU”;“es”的“ES”、“MX”。
currencyCode 字符串 “USD”、“EUR”、“GBP”、“JPY”、“CAD”、“AUD”、“CHF”、“CNY”、“INR”等(总计 40 种以上)
formatStyle 字符串 “standard”、“check”和“formal”
debug 布尔值 true,false
Endpoint ID: 9088
POST https://docs.zylalabs.com/api/6348/number+to+text+pro+api/9088/postnumbertotext
输入参数

邮政号码转文本 — 端点功能

对象 描述
请求体 必需 Json

剩余免费测试请求:3 / 3。


输入参数

API 示例响应
JSON
twelve million three hundred forty-five thousand six hundred seventy-eight dollars and ninety cents
邮政号码转文本 — 代码片段

curl --location --request POST 'https://zylalabs.com/api/6348/number+to+text+pro+api/9088/postnumbertotext' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "value": 100,
  "languageCode": "en",
  "dialect": "",
  "options": {
    "formatStyle": "check"
  },
  "currencyCode": "eur"
}'

    
请求

获取数字到文本 (GET)

此端点通过查询参数将数值转换为其文本表示。它支持广泛的语言、货币、方言和格式风格以定制输出。为避免错误,请使用以下指定的参数值:

  • languageCode: 指定用于转换的语言。可用值包括 "en"(英语)、"es"(西班牙语)、"fr"(法语)、"de"(德语)、"it"(意大利语)、"pt"(葡萄牙语)、"nl"(荷兰语)、"ru"(俄语)、"ar"(阿拉伯语)、"zh"(中文)、"ja"(日语)、"ko"(韩语)、"hi"(印地语)及其他20多种语言。
  • dialect: 定义语言的区域变体。可用值取决于languageCode,例如,对于 "en": "US"、"UK" 和 "IN";对于阿拉伯语 "ar": "EG"、"SA"、"AE"。
  • currencyCode: 指定货币以进行货币转换。可用值包括 "USD"(美元)、"EUR"(欧元)、"GBP"(英镑)、"JPY"(日元)、"CAD"(加元)、"AUD"(澳元)、"CHF"(瑞士法郎)、"CNY"(人民币)、"INR"(印度卢比)及其他30多种。
  • formatStyle: 确定输出风格。可用值有 "standard"(标准, 例如 "one hundred twenty-three")和 "check"(例如 "one hundred twenty-three and 00/100"),以及用于法律文件的 "formal"。

使用这些值以确保准确转换并避免错误。示例: ?value=123.45&languageCode=en&dialect=US&currencyCode=USD&formatStyle=standard

参数

参数 类型 必需 可用值
value 数字 任何数值(例如,123.45)
languageCode 字符串 "en"、"es"、"fr"、"de"、"it"、"pt"、"nl"、"ru"、"ar"、"zh"、"ja"、"ko"、"hi"等(总计35种以上)
dialect 字符串 取决于languageCode,例如,对 "en" 来说是 "US"、"UK"、"AU";对 "es" 来说是 "ES"、"MX"
currencyCode 字符串 "USD"、"EUR"、"GBP"、"JPY"、"CAD"、"AUD"、"CHF"、"CNY"、"INR"等(总计40种以上)
formatStyle 字符串 "standard"、"check" 和 "formal"
debug 布尔 true、false
Endpoint ID: 9287
GET https://docs.zylalabs.com/api/6348/number+to+text+pro+api/9287/getnumbertotext
输入参数

获取数字到文本 — 端点功能

对象 描述
languageCode 可选
currencyCode 可选
dialect 可选
formatStyle 可选

剩余免费测试请求:3 / 3。


输入参数

languageCode
currencyCode
dialect
formatStyle
API 示例响应
JSON
Twelve million three hundred forty-five thousand six hundred seventy-eight dollars and ninety  cents
获取数字到文本 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/6348/number+to+text+pro+api/9287/getnumbertotext' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API 访问密钥和身份验证

注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 数字到文本专业版 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。

标头
标头 描述
授权 必需 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。

(年度计费可节省 2 个月 🎉)

🚀 企业版套餐

起价
$ 10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控
zeiss-logo amazon-logo zoom-logo decathlon-logo

领先企业的信赖之选

概览

数字转文本专业API文档

数字转文本专业API将数值转换为文本表示,支持多种语言、格式样式和货币。本文档概述了关键参数——languageCodeformatStylecurrencyCode——及其可能的值,以确保正确使用。

 

API端点

  • URL: https://zylalabs.com/api-marketplace/tools+%26+utilities/number+to+text+pro+api/6348
  • 方法: POST,GET

1. languageCode

  • 描述: 指定文本转换的语言。
  • 类型: 字符串
  • 必需: 是
  • 可能的值: API支持超过35种语言。以下是可用语言代码的完整列表:
    • en - 英语(方言:美国、英国、澳大利亚、加拿大、印度)
    • es - 西班牙语
    • fr - 法语
    • de - 德语
    • it - 意大利语
    • pt - 葡萄牙语
    • nl - 荷兰语
    • ru - 俄语
    • ar - 阿拉伯语(方言:埃及、沙特、阿联酋、摩洛哥)
    • zh - 中文
    • ja - 日语
    • ko - 韩语
    • hi - 印地语
    • tr - 土耳其语
    • pl - 波兰语
    • sv - 瑞典语
    • no - 挪威语
    • da - 丹麦语
    • fi - 芬兰语
    • el - 希腊语
    • cs - 捷克语
    • hu - 匈牙利语
    • ro - 罗马尼亚语
    • th - 泰语
    • vi - 越南语
    • id - 印尼语
    • ms - 马来语
    • he - 希伯来语
    • uk - 乌克兰语
    • bg - 保加利亚语
    • hr - 克罗地亚语
    • sr - 塞尔维亚语
    • sk - 斯洛伐克语
    • sl - 斯洛文尼亚语
    • lt - 立陶宛语
    • lv - 拉脱维亚语
    • et - 爱沙尼亚语
    • is - 冰岛语
  • 使用说明: 对于英语(en),可以指定方言(例如,US表示美式英语,GB 表示英式英语,IN表示印度英语)。在此上下文中,其他语言不需要方言说明。

2. formatStyle

  • 描述: 定义文本输出的格式样式。
  • 类型: 字符串
  • 必需: 否(可选)
  • 可能的值:
    • standard - 默认文本表示(例如,“一百二十三”)。
    • check - 适合财务支票的格式(例如,“一百二十三和00/100”)。
    • legal - 正式法律格式(例如,“一百二十三”。)
  • 使用说明: 如果省略,API默认为standard

3. currencyCode

  • 描述: 指定货币以格式化货币值。
  • 类型: 字符串
  • 必需: 否(可选)
  • 可能的值: API支持超过40种货币。以下是最常用的代码:
    • USD - 美元($)
    • EUR - 欧元(€)
    • GBP - 英镑(£)
    • JPY - 日元(¥)
    • CAD - 加拿大元(C$)
    • AUD - 澳大利亚元(A$)
    • CHF - 瑞士法郎(Fr)
    • CNY - 人民币(¥)
    • INR - 印度卢比(₹)
    • BRL - 巴西雷亚尔(R$)
    • RUB - 俄罗斯卢布(₽)
    • KRW - 韩国元(₩)
    • MXN - 墨西哥比索(Mex$)
    • SGD - 新加坡元(S$)
    • HKD - 香港元(HK$)
    • SEK - 瑞典克朗(kr)
    • NOK - 挪威克朗(kr)
    • DKK - 丹麦克朗(kr)
    • PLN - 波兰兹罗提(zł)
    • TRY - 土耳其里拉(₺)
    • (额外货币可用)
  • 使用说明: 也支持自定义货币。如果未指定货币,API处理不带货币格式的数字。

示例请求

示例1:英语,标准格式

  • 请求:
    GET /api?value=12345678.90&languageCode=en&currenyCode=USD&dialect=US&formatStyle=standard
  • 响应:
    "十二百万三百四十五千六百七十八美元和九十美分"

示例2:英语,支票格式

  • 请求:
    GET /api?value=12345678.90&languageCode=en&currenyCode=USD&dialect=US&formatStyle=check
  • 响应:
    "十二百万三百四十五千六百七十八美元和90/100美分"

示例3:阿拉伯语,标准格式,地方货币

  • 请求:
    POST /api
    {
        "number": 12345678.90,
        "languageCode": "ar",
        "dialect": "",
        "formatStyle": "standard",
        "currencyCode": "EGP"
    }
  • 响应:
    "اثنا عشر مليون و ثلاثمائة خمسة و أربعون ألف و ستمائة ثمان و سبعون جنيه مصري و تسعون قرش"

数字到文本专业版 API FAQs

该端点返回一个JSON对象,包含成功状态、数字的文本表示以及已解析的选项,如地区、货币和格式样式。例如,对于输入数字123.45,它可能返回“一百二十三美元四十五美分”

用户可以指定参数,例如要转换的数值、所需的语言和方言(例如“en-US”)、可选的货币(例如“USD”)以及格式样式(例如“标准”或“正式”)来定制输出

响应数据被结构化为一个具有三个主要字段的 JSON 对象: "success"(布尔值)、"result"(字符串)和 "resolvedOptions"(对象)。“resolvedOptions”字段包含用于转换的细节,如语言环境、货币和格式样式

常见的使用案例包括生成财务文件、法律合同、发票和国际通信的文本。它特别适用于需要在多种语言中进行准确货币表示的应用。

用户可以提取“结果”字段以文本格式显示数字,而“resolvedOptions”可以帮助确保不同应用程序之间在语言和货币上的一致性,从而增强用户体验和清晰度

接受的语言值包括ISO语言代码,例如“en”代表英语,“es”代表西班牙语等。货币值应遵循ISO 4217标准,例如“USD”代表美元或“EUR”代表欧元,以便进行准确的货币转换

该API依赖于既定的语言规则和货币格式以确保准确的转换定期更新和质量检查被实施以维护不同语言和方言之间数据的完整性

输出通常遵循一致的模式,其中数字被转换为单词,并根据指定的风格进行格式化。例如,整数以不带小数的形式表示,而货币值则包括整数和小数部分,以确保在财务上下文中清晰明了

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。
价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]

此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。
定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。
有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]
价格由月度或年度订阅决定,具体取决于所选计划。
API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。
Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。
要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。
要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。
要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。
"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。
是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。
为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。
7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。
当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。
付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。
您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]

相关 API


您可能还喜欢