← Docs/

§ API 参考

POST /v1/analyze/individual

模式一 · 个体画像分析. L3 代号 + LLM 渲染的维度交互 + 涌现组合 + 发展建议. 三档深度 (brief / standard / deep).

01

端点

Method
POST
Path
/v1/analyze/individual
Auth
Authorization: Bearer hipmm_sk_...
Cost
10 units (managed) / 4 units (BYOM)
Cache
❌ 走 LLM, 不缓存
Plan
Starter / Pro / Enterprise (Free 不允许)
Latency
brief ~15s / standard ~30s / deep ~60-90s
02

请求体

application/json

{
  "code": "I-A-L-X-ID-AR(PR)-SE-LT",
  "options": {
    "depth": "standard",
    "language": "zh-CN"
  },
  "llm_config": {
    "mode": "managed"
  }
}
字段类型必填说明
codestringPMM-8+ 8 维度代号字符串
options.depthstringbrief / standard / deep (默认 standard)
options.languagestring默认 zh-CN
llm_configobject默认 {mode:managed}. BYOM 见 /docs/byom
03

响应 (200 OK)

response · 节选

{
  "success": true,
  "data": {
    "code":          "I-A-L-X-ID-AR(PR)-SE-LT",
    "portrait_type": "极端纯度型",
    "codename": {
      "short": "深思的孤勇者",
      "long":  "深思的颠覆者 · 孤勇者"
    },
    "symbolic": { "symbolic": "深渊灯塔", ... },
    "dimension_scores": {
      "OI": 15, "CA": 85, "LH": 15, "BX": 85,
      "IDED": 15, "PRAR": 62, "VESE": 85, "STLT": 85
    },
    "llm_analysis": {
      "executive_summary":     "...",
      "dimension_breakdown":   [ /* 8 个 */ ],
      "emergence_combinations": [ /* 2-7 个, 按 depth */ ],
      "development_suggestions": [ /* 3-8 条 */ ]
    }
  },
  "metadata": {
    "engine_version": "0.3.0",
    "deterministic":  false,
    "cost_units":     10,
    "llm_provider":   "anthropic",
    "llm_model":      "claude-opus-4-7",
    "llm_tier":       1,
    "prompt_hash":    "b0c91a88...",
    "latency_ms":     28145
  }
}
04

深度档位差异

深度档位详解. 简表:

depth维度详情字数涌现组合建议条数out tokens
brief30-50 字/项2 个3 条~1,500
standard50-80 字/项3-4 个4-5 条~2,500
deep100-150 字/项 + 退行5-7 个6-8 条~6,000
05

BYOM 用法

byom_proxy 模式

{
  "code": "I-A-L-X-ID-AR(PR)-SE-LT",
  "options": { "depth": "deep" },
  "llm_config": {
    "mode": "byom_proxy",
    "provider": "deepseek",
    "model": "deepseek-v4-pro",
    "api_key": "sk-客户自己的",
    "base_url": "https://api.deepseek.com/v1"
  }
}

提示

BYOM 模式仅扣 4 cost_units (砍 60%). 但 LLM token 由客户自己付给 provider. 仅 Pro / Enterprise 套餐开通. 见 BYOM 文档.
06

错误码

HTTPcode原因
400INVALID_CODE_FORMAT代号解析失败
400INVALID_LLM_CONFIGllm_config 字段非法
401INVALID_API_KEYkey 无效
403ENDPOINT_NOT_ALLOWEDFree 套餐不允许 individual
403BYOM_NOT_ALLOWEDFree / Starter 不支持 BYOM
429RATE_LIMIT_EXCEEDED / QUOTA_EXCEEDED限流 / 配额超
502LLM_PROVIDER_ERRORBYOM 模式客户 LLM 出错
502LLM_VALIDATION_FAILEDLLM 返回的 JSON 不符合 schema (P1.1 容错后罕见)
504LLM_TIMEOUTLLM > timeout (brief 90s / standard 150s / deep 300s)