Band Name Generator Endpoint

Last updated: January 26, 2026

Route

POST /wp-json/extrachill/v1/blog/band-name

Purpose

Generate band name suggestions using AI. This endpoint powers the ExtraChill Blog "Band Name Generator" block, providing AI-powered creative suggestions for music artists.

Permission

POST: Public (no authentication required)

POST Request

{
  "input": "rock music from the 80s",
  "genre": "rock",
  "number_of_words": 2
}

Request Parameters

Parameter	Type	Required	Notes
`input`	string	Yes	Prompt or seed text for name generation. Minimum 1 character.
`genre`	string	No	Music genre for context-aware generation (e.g., ‘rock’, ‘hip-hop’, ‘pop’, ‘metal’). Helps the AI focus suggestions.
`number_of_words`	integer	No	Preferred word count for generated names (e.g., 1, 2, 3). Guides length of suggestions.

POST Response

{
  "names": [
    "Thunder Echo",
    "Electric Void",
    "Chrome Rebel",
    "Midnight Static",
    "Iron Wave"
  ]
}

The response contains an array of generated band 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-client plugin’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 creative, suitable for brainstorming band names

Related Endpoints

POST /blog/rapper-name – Generate rapper names instead
POST /blog/ai-adventure – Generate adventure story segments

Usage Examples

Basic Band Name Generation

curl -X POST "http://site.local/wp-json/extrachill/v1/blog/band-name" 
  -H "Content-Type: application/json" 
  -d '{
    "input": "experimental electronic music"
  }'

Generate with Genre and Word Count Preference

curl -X POST "http://site.local/wp-json/extrachill/v1/blog/band-name" 
  -H "Content-Type: application/json" 
  -d '{
    "input": "heavy metal influences with modern production",
    "genre": "metal",
    "number_of_words": 2
  }'

Generate Rock Band Names

curl -X POST "http://site.local/wp-json/extrachill/v1/blog/band-name" 
  -H "Content-Type: application/json" 
  -d '{
    "input": "80s rock revival with modern twist",
    "genre": "rock",
    "number_of_words": 2
  }'

Frontend Integration

The ExtraChill Blog "Band Name Generator" block calls this endpoint when users click a "Generate Names" button, displaying the results in real-time.