AI Name Meaning Agent Skill - AI Pass API

Add name meaning capabilities to your AI agent. Generate cultural origins, personality portraits, and custom artwork with the AI Pass API.

Quick Start

curl -X POST https://aipass.one/apikey/v1/chat/completions \
  -H "Authorization: Bearer $AIPASS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-2.5-flash-lite",
    "messages": [
      {"role": "system", "content": "You are an expert in etymology and cultural history. Analyze names for cultural origins and personality traits."},
      {"role": "user", "content": "Analyze the name 'Sarah'"}
    ],
    "temperature": 1,
    "max_tokens": 16000
  }'

Generate Name Meaning

#!/bin/bash

API_KEY="$AIPASS_API_KEY"

get_name_meaning() {
    local name="$1"

    curl -s -X POST https://aipass.one/apikey/v1/chat/completions \
        -H "Authorization: Bearer $API_KEY" \
        -H "Content-Type: application/json" \
        -d "{
            \"model\": \"google/gemini-2.5-flash-lite\",
            \"messages\": [
                {
                    \"role\": \"system\",
                    \"content\": \"You are an expert in etymology, cultural history, and personality analysis. Analyze the given name and provide:\\n1. Cultural origins (language family, historical roots)\\n2. Personality traits associated with the name\\n3. Famous bearers throughout history\\n4. Cultural significance and symbolism\\n\\nBe specific, well-researched, and insightful.\"
                },
                {
                    \"role\": \"user\",
                    \"content\": \"Analyze the name \\\"$name\\\". Provide detailed cultural analysis and personality portrait.\"
                }
            ],
            \"temperature\": 1,
            \"max_tokens\": 16000
        }" | python3 -c "import json,sys; print(json.load(sys.stdin)['choices'][0]['message']['content'])"
}

# Usage
get_name_meaning "Alexander"

Generate Name Portrait Image

#!/bin/bash

API_KEY="$AIPASS_API_KEY"

generate_name_portrait() {
    local name="$1"
    local style="${2:-artistic}"

    local style_prompt
    case "$style" in
        artistic)
            style_prompt="surreal oil painting with vibrant colors, cultural motifs, dreamlike quality"
            ;;
        modern)
            style_prompt="clean minimalist illustration, bold colors, contemporary style"
            ;;
        traditional)
            style_prompt="classic renaissance style portrait, rich detail, warm tones"
            ;;
        *)
            style_prompt="artistic portrait with cultural symbolism"
            ;;
    esac

    local prompt="A visual portrait representing the name \"$name\". $style_prompt. The image should embody the essence, energy, and cultural symbolism of this name. High quality, artistic interpretation."

    curl -s -X POST https://aipass.one/apikey/v1/images/generations \
        -H "Authorization: Bearer $API_KEY" \
        -H "Content-Type: application/json" \
        -d "{
            \"model\": \"flux-pro/v1.1\",
            \"prompt\": \"$prompt\",
            \"n\": 1,
            \"size\": \"1024x1024\"
        }" | python3 -c "import json,sys; print(json.load(sys.stdin)['data'][0]['url'])"
}

# Usage
portrait_url=$(generate_name_portrait "Sophia" "artistic")
echo "Portrait URL: $portrait_url"

Python Integration

import requests
import os

class NameMeaningAgent:
    def __init__(self, api_key=None):
        self.api_key = api_key or os.environ.get("AIPASS_API_KEY")
        self.base_url = "https://aipass.one/apikey/v1"
        self.headers = {
            "Authorization": f"Bearer {self.api_key}",
            "Content-Type": "application/json"
        }

    def get_name_meaning(self, name):
        """Generate detailed cultural analysis and personality portrait for a name."""
        response = requests.post(
            f"{self.base_url}/chat/completions",
            headers=self.headers,
            json={
                "model": "google/gemini-2.5-flash-lite",
                "messages": [
                    {
                        "role": "system",
                        "content": """You are an expert in etymology, cultural history, and personality analysis. Analyze the given name and provide:
1. Cultural origins (language family, historical roots)
2. Personality traits associated with the name
3. Famous bearers throughout history
4. Cultural significance and symbolism

Be specific, well-researched, and insightful."""
                    },
                    {
                        "role": "user",
                        "content": f'Analyze the name "{name}". Provide detailed cultural analysis and personality portrait.'
                    }
                ],
                "temperature": 1,
                "max_tokens": 16000
            }
        )
        response.raise_for_status()
        return response.json()["choices"][0]["message"]["content"]

    def generate_portrait(self, name, style="artistic"):
        """Generate a visual portrait representing the name."""
        style_prompts = {
            "artistic": "surreal oil painting with vibrant colors, cultural motifs, dreamlike quality",
            "modern": "clean minimalist illustration, bold colors, contemporary style",
            "traditional": "classic renaissance style portrait, rich detail, warm tones"
        }

        prompt = f'A visual portrait representing the name "{name}". {style_prompts.get(style, style_prompts["artistic"])}. The image should embody the essence, energy, and cultural symbolism of this name. High quality, artistic interpretation.'

        response = requests.post(
            f"{self.base_url}/images/generations",
            headers=self.headers,
            json={
                "model": "flux-pro/v1.1",
                "prompt": prompt,
                "n": 1,
                "size": "1024x1024"
            }
        )
        response.raise_for_status()
        return response.json()["data"][0]["url"]

    def analyze_name_complete(self, name, portrait_style="artistic"):
        """Complete analysis: meaning + portrait."""
        meaning = self.get_name_meaning(name)
        portrait_url = self.generate_portrait(name, portrait_style)
        return {
            "name": name,
            "meaning": meaning,
            "portrait_url": portrait_url
        }

# Usage
agent = NameMeaningAgent()
result = agent.analyze_name_complete("Isabella", "modern")
print(f"Meaning for {result['name']}:\n{result['meaning']}")
print(f"\nPortrait: {result['portrait_url']}")

Node.js Integration

const https = require('https');

class NameMeaningAgent {
    constructor(apiKey) {
        this.apiKey = apiKey || process.env.AIPASS_API_KEY;
        this.baseURL = 'https://aipass.one/apikey/v1';
    }

    async getMeaning(name) {
        const data = JSON.stringify({
            model: 'google/gemini-2.5-flash-lite',
            messages: [
                {
                    role: 'system',
                    content: `You are an expert in etymology, cultural history, and personality analysis. Analyze the given name and provide:
1. Cultural origins (language family, historical roots)
2. Personality traits associated with the name
3. Famous bearers throughout history
4. Cultural significance and symbolism

Be specific, well-researched, and insightful.`
                },
                {
                    role: 'user',
                    content: `Analyze the name "${name}". Provide detailed cultural analysis and personality portrait.`
                }
            ],
            temperature: 1,
            max_tokens: 16000
        });

        return this._request('/chat/completions', data)
            .then(r => r.choices[0].message.content);
    }

    async generatePortrait(name, style = 'artistic') {
        const stylePrompts = {
            artistic: 'surreal oil painting with vibrant colors, cultural motifs, dreamlike quality',
            modern: 'clean minimalist illustration, bold colors, contemporary style',
            traditional: 'classic renaissance style portrait, rich detail, warm tones'
        };

        const prompt = `A visual portrait representing the name "${name}". ${stylePrompts[style]}. The image should embody the essence, energy, and cultural symbolism of this name. High quality, artistic interpretation.`;

        const data = JSON.stringify({
            model: 'flux-pro/v1.1',
            prompt: prompt,
            n: 1,
            size: '1024x1024'
        });

        return this._request('/images/generations', data)
            .then(r => r.data[0].url);
    }

    async analyzeComplete(name, portraitStyle = 'artistic') {
        const [meaning, portraitUrl] = await Promise.all([
            this.getMeaning(name),
            this.generatePortrait(name, portraitStyle)
        ]);

        return { name, meaning, portraitUrl };
    }

    _request(endpoint, data) {
        return new Promise((resolve, reject) => {
            const options = {
                hostname: 'aipass.one',
                path: `/apikey/v1${endpoint}`,
                method: 'POST',
                headers: {
                    'Authorization': `Bearer ${this.apiKey}`,
                    'Content-Type': 'application/json',
                    'Content-Length': data.length
                }
            };

            const req = https.request(options, (res) => {
                let body = '';
                res.on('data', chunk => body += chunk);
                res.on('end', () => resolve(JSON.parse(body)));
            });

            req.on('error', reject);
            req.write(data);
            req.end();
        });
    }
}

// Usage
(async () => {
    const agent = new NameMeaningAgent();
    const result = await agent.analyzeComplete('Gabriella', 'traditional');
    console.log(`Meaning for ${result.name}:\n${result.meaning}`);
    console.log(`\nPortrait: ${result.portraitUrl}`);
})();

API Reference

Chat Completions

Endpoint: POST /apikey/v1/chat/completions

Model: google/gemini-2.5-flash-lite

Parameters:

• messages: Array of message objects
• temperature: 1 (for creative, varied responses)
• max_tokens: 16000 (for detailed analysis)

Response:

{
  "choices": [
    {
      "message": {
        "content": "The name 'Sarah' has Hebrew origins..."
      }
    }
  ]
}

Image Generation

Endpoint: POST /apikey/v1/images/generations

Model: flux-pro/v1.1

Parameters:

• prompt: Text description of the desired image
• n: Number of images (1)
• size: Image size ("1024x1024")

Response:

{
  "data": [
    {
      "url": "https://cdn.example.com/portrait.jpg"
    }
  ]
}

Get Your API Key

1. Sign up at AI Pass
2. Go to Developer Dashboard
3. Copy your API key
4. Set as environment variable: export AIPASS_API_KEY="your-key-here"

Cost

• Text generation: ~$0.0002 per name analysis
• Image generation: ~$0.015 per portrait
• Total: ~$0.015 per complete analysis

New users get $1 free credit (~66 complete analyses).

Live Demo

Try the interactive app: AI Name Meaning

---
name: ai-name-meaning
description: Generate cultural origins, personality portraits, and custom artwork for any name using AI Pass API
version: 1.0.0
---

# AI Name Meaning Skill

Generate detailed cultural analysis and visual portraits for names using AI Pass API.

## Setup

Set your API key:
```bash
export AIPASS_API_KEY="your-key-here"
```

Get your key from: https://aipass.one/dashboard/developer/clients

## Usage

### Get Name Meaning
```bash
get-name-meaning "Alexander"
```

### Generate Portrait
```bash
generate-name-portrait "Sophia" "artistic"
```

### Complete Analysis
```bash
analyze-name-complete "Isabella" "modern"
```

## Commands

`get-name-meaning <name>`
- Returns cultural origins, personality traits, famous bearers

`generate-name-portrait <name> [style]`
- Styles: artistic, modern, traditional
- Returns image URL

`analyze-name-complete <name> [style]`
- Returns both meaning and portrait URL