公开 API
通过 HTTP 使用的名字生成器。免费，无需密钥，也无需账号。它从不使用 AI，也无法读取任何人的项目。
端点
GEThttps://musael.com/api/public/v1/names
Generate up to 20 names using one of 24 deterministic generators, without AI or account access.
参数
| 名称 | 类型 | 默认值 | 允许的值 |
|---|---|---|---|
kind | string | fantasy | fantasy, fantasy-last, elf, dwarf, dragon, kingdom, town, village, tavern, wizard, orc, city, guild, ship, sword, spell, god, demon, vampire, pirate, knight, sci-fi-planet, alien, starship |
seed | integer | 1 | 1 到 999,999 之间的整数 |
count | integer | 10 | 1 到 20 之间的整数 |
示例
curl 'https://musael.com/api/public/v1/names?kind=elf&seed=42&count=3'试一试
curl 'https://musael.com/api/public/v1/names?kind=elf&seed=42&count=5'响应
一个 JSON 对象，包含版本 "1"、你请求的种类和种子、名字，以及生成器页面的地址。种类和种子相同，在生成器数据变化之前会得到相同的名字。
错误
错误会返回 HTTP 状态和一个错误对象，其中有稳定的代码和可读的消息。遇到 429 和 503 时，请等待 Retry-After 指定的秒数；其他错误不要原样重试。
| 状态 | 含义 |
|---|---|
400 | 某个参数格式不对或超出范围。请先修正请求再重新发送。 |
405 | 只接受 GET 和 HEAD。 |
408 | 请求到达得太慢。 |
413 | 请求正文超过 2,048 字节。 |
414 | 地址超过 1,024 个字符。 |
415 | 正文不是 JSON。 |
429 | 此客户端的请求过多。请等待 Retry-After 指定的秒数。 |
500 | 我们这边出了问题。请稍后再试。 |
503 | 服务繁忙。请等待 Retry-After 指定的秒数。 |
限制
- 每个客户端：同时 10 个请求，之后每分钟 30 个。
- 整个服务：同时 20 个，之后每秒 10 个，最多 8 个在处理。
- 超过 1,024 个字符的地址会被拒绝。
- 无需密钥，无需账号，没有付费层级。不保证可用性。
OpenAPI 文档
完整的接口规范，供代码生成器和 API 客户端使用。 /docs/openapi.json