Rapper Name Generator Endpoint
Route
POST /wp-json/extrachill/v1/blog/rapper-name
Purpose
Generate rapper name suggestions using AI. This endpoint powers the ExtraChill Blog "Rapper Name Generator" block, providing AI-powered creative suggestions for hip-hop and rap artists.
Permission
- POST: Public (no authentication required)
POST Request
{
"input": "lyrics about struggle and success",
"gender": "neutral",
"style": "west coast"
}
Request Parameters
| Parameter | Type | Required | Notes |
|---|---|---|---|
input |
string | Yes | Prompt or seed text for name generation. Minimum 1 character. |
gender |
string | No | Gender for name style (e.g., ‘male’, ‘female’, ‘neutral’). Influences name suggestions. |
style |
string | No | Rap style preference (e.g., ‘west coast’, ‘east coast’, ‘trap’, ‘conscious’, ‘drill’). Guides thematic focus. |
POST Response
{
"names": [
"King Cipher",
"Lyric Storm",
"Echo Phantom",
"Rhythm Shadow",
"Soul Prophet"
]
}
The response contains an array of generated rapper names tailored to the input criteria.
Error Codes
| Code | Status | Description |
|---|---|---|
invalid_input |
400 | Input is missing or empty |
ai_unavailable |
500 | AI provider is not available or configured |
ai_error |
500 | AI provider returned an error or timed out |
Implementation Notes
- This endpoint delegates to the extrachill-blog plugin’s AI generation logic
- The AI provider is accessed through the
extrachill-ai-clientplugin’s filter system - Input is sanitized before sending to the AI provider
- Generation is typically fast but may take a few seconds depending on API response time
- Results are diverse and culturally aware, suitable for brainstorming rapper stage names
- The endpoint respects gender and style preferences to generate contextually appropriate names
Related Endpoints
POST /blog/band-name– Generate band names insteadPOST /ai-adventure– Generate adventure story segments
Usage Examples
Basic Rapper Name Generation
curl -X POST "http://site.local/wp-json/extrachill/v1/blog/rapper-name"
-H "Content-Type: application/json"
-d '{
"input": "street stories and social commentary"
}'
Generate with Gender and Style Preferences
curl -X POST "http://site.local/wp-json/extrachill/v1/blog/rapper-name"
-H "Content-Type: application/json"
-d '{
"input": "fast flow with conscious lyrics",
"gender": "neutral",
"style": "east coast"
}'
Generate Trap-Style Rapper Names
curl -X POST "http://site.local/wp-json/extrachill/v1/blog/rapper-name"
-H "Content-Type: application/json"
-d '{
"input": "hi-hat heavy beats with dark production",
"style": "trap"
}'
Generate Conscious Hip-Hop Names
curl -X POST "http://site.local/wp-json/extrachill/v1/blog/rapper-name"
-H "Content-Type: application/json"
-d '{
"input": "political activism and introspective lyrics",
"style": "conscious"
}'
Frontend Integration
The ExtraChill Blog "Rapper Name Generator" block calls this endpoint when users click a "Generate Names" button, displaying the results in real-time.