AI Persona Generator REST API 与 MCP Server 文档

将 AI Persona Generator 集成到您的应用程序和 AI Agent 中。

获取 API Key

要使用 API 和 MCP 服务器，您需要一个 API Key。您可以在您的个人资料页面中生成它。

基础 URL

https://aipersonagen.com

鉴权 (Authentication)

在请求头或查询参数中包含您的 API Key：

Authorization: Bearer YOUR_API_KEY

REST API 接口列表

POST/api/v1/personas

生成用户画像 (Persona)

根据您的配置生成虚拟用户画像。

请求体

{
  "personaCount": 5,
  "format": "json",
  "projectDescription": "An AI fitness app...",
  "outputLanguage": "english",
  "schemaMode": "hybrid",
  "aiRecommendCount": 3,
  "personalPrompt": true,
  "customFields": true,
  "enableAvatar": true,
  "fields": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "mbti",
      "type": "MBTI Type",
      "description": "Myers-Briggs Type Indicator",
      "values": ["INTJ", "ENFP"],
      "valueWeightPercent": [70, 30],
      "multi": false
    }
  ]
}

Parameter	Type	Description
`personaCount`	number	[必填] 生成用户画像的数量
`format`	string	[必填] 输出格式：json, sql, csv, excel
`projectDescription`	string	[必填] 项目背景描述
`outputLanguage`	string	[必填] 输出语言 (例如：english, zh-CN)
`schemaMode`	string	[选填] 字段生成模式："ai", "hybrid", "strict"
`aiRecommendCount`	number	[选填] AI推荐字段数量
`personalPrompt`	boolean	[必填] 是否生成AI用户画像提示词
`customFields`	boolean	[必填] 是否包含自定义字段配置
`enableAvatar`	boolean	[必填] 是否启用AI头像生成
`fields`	array	[必填] 自定义字段定义列表 — `id` ([必填] 唯一标识符 (UUID)), `name` ([必填] 字段名称), `type` ([必填] 字段类型), `values` ([选填] 该字段的可选值列表)

响应结果

{
  "success": true,
  "data": "[{\"mbti\": [\"INTJ\"]}, ...]",
  "format": "json",
  "personaCount": 5,
  "taskId": "123e4567-e89b-12d3-a456-426614174000"
}

GET/api/v1/personas

获取生成任务

根据任务 ID 获取之前生成的数据。

查询参数

taskId (required): 生成的任务的 UUID。