Get Vibes

Returns vibe IDs and names for all system vibes and custom user vibes accessible to the authenticated user. Pass the id as presentation_options.vibe_id on a generation request.

GET /api/v1/vibes

List available vibes

cURL

curl --request GET \
  --url https://slides-api.getalai.com/api/v1/vibes \
  --header 'Authorization: Bearer <token>'

200

{
  "vibes": [
    {
      "id": "<string>",
      "name": "<string>",
      "source": "<string>"
    }
  ]
}

Retrieve the vibes available to the authenticated user.

A vibe is a visual aesthetic preset (mood, palette, illustration style) that gets applied to creative slide variants. This endpoint returns both system vibes and any custom vibes you have created. Use the returned id values as presentation_options.vibe_id when generating presentations.

Vibes are applied through creative image variants. When you pass vibe_id, you must also set image_options.num_image_variants >= 1 on the generation request.

---

Response

Field	Type	Description
vibes	array	List of vibes available to the authenticated user

Vibe Object

Field	Type	Description
id	string	Unique vibe identifier to pass as presentation_options.vibe_id
name	string	Human-readable vibe display name
source	string	Either system (built-in) or custom (created by the user)

---

Example Request

curl -X GET "https://slides-api.getalai.com/api/v1/vibes" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "vibes": [
    {
      "id": "b8e3a9ae-f36c-458b-a816-acd5f43072d3",
      "name": "Standard",
      "source": "system"
    },
    {
      "id": "f1c2d3e4-5678-90ab-cdef-1234567890ab",
      "name": "Neon Dreams",
      "source": "system"
    },
    {
      "id": "a1b2c3d4-5678-90ab-cdef-fedcba987654",
      "name": "My Brand Vibe",
      "source": "custom"
    }
  ]
}

---

Using a Vibe ID in Presentation Generation

curl -X POST "https://slides-api.getalai.com/api/v1/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_text": "Launch announcement for our new product line",
    "presentation_options": {
      "title": "Product Launch",
      "vibe_id": "f1c2d3e4-5678-90ab-cdef-1234567890ab",
      "slide_range": "6-10"
    },
    "image_options": {
      "num_image_variants": 1
    }
  }'

Authorizations

Authorization · string · header · required

Your Alai API key. Get one from your account settings at app.getalai.com

Response

200

application/json

Successful Response

vibes · VibeSummary · object[] · required

Vibes available to the authenticated user

Show child attributes