AI Persona Generator REST API & MCP Server Docs

Integrate AI Persona Generator into your applications and AI agents.

Getting your API Key

To use the API and MCP server, you need an API key. You can generate one from your Profile page.

Base URL

https://aipersonagen.com

Authentication

Include your API Key in the request header or query parameter:

Authorization: Bearer YOUR_API_KEY

REST API Endpoints

POST/api/v1/personas

Generate Personas

Generate synthetic user personas based on your configuration.

Request Body

{
  "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	[Required] Number of personas to generate
`format`	string	[Required] Output format: json, sql, csv, excel
`projectDescription`	string	[Required] Project background description
`outputLanguage`	string	[Required] Output language (e.g., english, zh-CN)
`schemaMode`	string	[Optional] Field generation mode: "ai", "hybrid", "strict"
`aiRecommendCount`	number	[Optional] Number of AI recommended fields
`personalPrompt`	boolean	[Required] Generate personal prompt for AI
`customFields`	boolean	[Required] Has custom fields configuration
`enableAvatar`	boolean	[Required] Enable AI avatar generation
`fields`	array	[Required] Custom field definitions list — `id` ([Required] Unique ID (UUID)), `name` ([Required] Field name), `type` ([Required] Field type), `values` ([Optional] Optional values list for this field)

Response

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

GET/api/v1/personas

Get Generation Task

Retrieve the data from a previously generated task.

Query Parameters

taskId (required): The UUID of the generated task.