01
端点
- Method
POST- Path
/v1/codename- Auth
Authorization: Bearer hipmm_sk_...- Cost
- 1 unit (managed) / 1 unit (BYOM, 一样)
- Cache
- ✅ 走 ADR-0003 确定性缓存, 24h TTL (命中仍计费)
- Plan
- Free / Starter / Pro / Enterprise (全部支持)
02
请求体
application/json
{
"code": "I-A-L-X-ID-AR(PR)-SE-LT",
"options": {
"language": "zh-CN"
}
}| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| code | string | ✅ | PMM-8+ 8 维度代号字符串. 支持基础 / 量化 / 平衡多种格式 |
| options | object | — | 可选. 当前仅 language=zh-CN |
03
响应 (200 OK)
response
{
"success": true,
"data": {
"short": "深思的孤勇者",
"long": "深思的颠覆者 · 孤勇者",
"prefix": "深思的",
"identity": "颠覆者",
"role": "孤勇者",
"portrait_type": "极端纯度型",
"description": "..."
},
"metadata": {
"engine_version": "0.3.0",
"request_id": "req_a1b2c3d4...",
"deterministic": true,
"cost_units": 1,
"cache_hit": false,
"latency_ms": 4
}
}04
象征版 · /v1/codename/symbolic
独立端点, Cost = 2 units. 返回:
response
{
"data": {
"symbolic": "深渊灯塔",
"terrain": "渊 × 刃 = 深渊",
"light": "霜 × 塔 = 灯塔"
}
}可能 422
约 29/49 个组合的象征版尚未定义, 调用返回
422 SYMBOLIC_NOT_SUPPORTED. 客户应该 fallback 到通俗版. 见 代号系统详解.05
错误码
| HTTP | code | 原因 |
|---|---|---|
| 400 | INVALID_CODE_FORMAT | 代号字符串解析失败 |
| 401 | INVALID_API_KEY | key 无效 / 已撤销 |
| 403 | ENDPOINT_NOT_ALLOWED | (不会发生 — 全 plan 都允许) |
| 422 | SYMBOLIC_NOT_SUPPORTED | 仅 /symbolic 端点, 通俗版不会有 |
| 429 | RATE_LIMIT_EXCEEDED / QUOTA_EXCEEDED | 见限流文档 |
| 500 | INTERNAL_ERROR | 未预期, 联系支持 + request_id |