---
title: "Recommend photoshoot vibes"
method: POST
path: "/api/photoshoot/recommend-vibes"
tags: ["Photoshoot"]
---

# Recommend photoshoot vibes

`POST /api/photoshoot/recommend-vibes`

## Request

- Base URL: `https://api.crayonz.ai`
- URL: `https://api.crayonz.ai/api/photoshoot/recommend-vibes`
- Auth: API key in header `X-API-Key`

Ranks the model-photoshoot vibes for a design from its title and description, with a one-line reason each. One credit; use the top result as the vibe for /api/photoshoot/v3/generate.

## Request body

- object
  - `title` string, required: Design title or the idea you generated it from
  - `description` string: What is in the design
  - `top_k` integer: 1–5 recommendations
  - `image_url` string: Optional design URL so the ranking can look at the artwork

## Response `200`

Success

- object
  - `recommendations` object[]: Up to top_k entries, ranked: vibe, confidence (0–1), why
  - `model_used` string

## Other responses

- `401`: Unauthorized — invalid or missing API key
- `402`: Insufficient credits
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/crayonz/apis/crayonz-api.md) · [All operations](https://skmtc.dev/crayonz/apis/crayonz-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crayonz/apis/crayonz-api/revisions/1114c84167b2?raw)