Number to Words

Convert any number to words in 56 languages with a single GET request. Supports cardinal, ordinal, year, and currency modes. Covers integers, negatives, and decimals - no libraries, no setup.

原始信息汇总

数据集概述：Number to Words API

该API提供数字到文字的转换服务，支持56种语言和多种转换模式，无需安装任何库或进行额外设置。

核心功能

• 数字转换：将整数、负数或小数转换为对应语言的自然书写形式。
• 支持56种语言：包括英语、法语、德语、西班牙语、俄语、日语、阿拉伯语等。
• 五种转换模式：
  • cardinal（基数词，默认）：如 42 → "forty-two"
  • ordinal（序数词，仅整数）：如 42 → "forty-second"
  • ordinal_num（数字序数后缀）：如 42 → "42nd"
  • year（年份口语形式）：如 1999 → "nineteen ninety-nine"
  • currency（货币金额）：如 1042.50 → "one thousand and forty-two euro, fifty cents"
• 数值范围：支持 -10^15 到 10^15 之间的整数与小数。

主要端点

端点	用途
GET /v1/convert	将数字转换为文字
GET /v1/languages	列出所有56种支持的语言代码和名称
GET /v1/health	服务健康检查

核心参数（/v1/convert）

参数	类型	是否必需	默认值	说明
number	字符串	是	—	要转换的数字，支持整数、负数、小数，范围 -10^15 到 10^15
lang	字符串	否	en	语言代码，可通过 GET /v1/languages 查看所有支持代码
to	字符串	否	cardinal	转换模式，可选值：cardinal、ordinal、ordinal_num、year、currency

响应字段

字段	说明
number	输入的数字，原样返回
words	转换后的文字形式
lang	使用的语言代码
to	使用的转换模式

HTTP 状态码

状态码	含义
200	转换成功
400	转换失败（如小数传入 ordinal/ordinal_num 模式，或该模式不被语言支持）
422	输入验证失败（如缺少 number、非数字、超出范围、未知语言或模式）
429	超出当前套餐的速率限制
500	服务器内部错误

典型使用场景

• 发票与收据生成：将金额转换为文字，防止欺诈或歧义。
• 支票打印：将小数金额转换为完整文字表示。
• 多语言电商：按用户本地语言显示价格或数量。
• 语音与TTS预处理：将数字转换为自然口语形式，再输入TTS引擎。
• 教育与测验应用：生成排名描述（如“你获得第四十二名”）。
• 法律与财务文档：按法规要求同时显示数字和文字形式。
• 无障碍与屏幕阅读器支持：为数字提供口语形式的 aria-label 值。
• 本地化管道：在翻译内容中，按目标语言自然表达数字。

注意事项

• ordinal 和 ordinal_num 模式仅支持整数，传入小数会返回 400 错误。
• 并非所有模式在所有56种语言中均可用：cardinal 全部支持，其他模式因语言而异，不支持时返回 400 并提示回退方案。
• number 参数使用字符串类型，以避免JSON解析器出现浮点精度问题。