Skip to Content
GrowSocialelion API
Read endpoints

List image/video models, styles and voices

Optional browse of what generation can use: image and video models with their price and one sample per fixed prompt (same prompt for every model, the ex...

GET | POST /api/v1/list_media_options · MCP tool list_media_options · scope read

Optional browse of what generation can use: image and video models with their price and one sample per fixed prompt (same prompt for every model, the exact prompt+params shown), the design styles with a sample video, and ElevenLabs voices with their preview (filters: language, gender, age, accent, useCase; 24 per page), and the 9 series formats (kind 'format': 'make it like this' templates with a sample and real example links). Never needed: every tool uses the agent's default when you pass no model, style or voice. Costs nothing.

Scope. Read your own brand data: posts, metrics, runs, the audit trail, the plan, stored mentions and trends. Free, unless you ask a billed network for a fresh read. This endpoint never costs credits.

Arguments

NameTypeRequiredDescription
kind"image" | "video" | "style" | "voice" | "format"NoWhich picker: image models, video models, design styles, ElevenLabs voices, or series formats ('make it like this' templates).
allbooleanNotrue = every option; default = the 6 recommended (models) or the first page (voices).
languagestringNoVoices only: ISO 639-1 code, e.g. en, he.
genderstringNoVoices only.
agestringNoVoices only.
accentstringNoVoices only.
useCasestringNoVoices only: use case or tone, e.g. narration, energetic.
offsetintegerNoVoices only: paging offset (24 per page).

Request

curl -X POST https://growsocialelion.com/api/v1/list_media_options \
  -H "Authorization: Bearer gse_mcp_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Response

200 with the tool's answer. The shape below is generated from the output schema; real answers can carry more fields.

{
  "status": "string",
  "reason": "string"
}

Errors use the shared body. See Errors. The full schema is in the API reference.