# Generate idea visual

```http
POST https://api.synup.com/api/v4/social-post-ideas/generate-idea-visual
```

Generates an on-demand visual (image) for a social post idea from a prompt, optionally grounded by up to two `referenceImageUrls` and a target `imageSize`.

Source: https://developer.synup.com/api/social-post-ideas/generate-idea-visual

## Header parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `Synup-Version` | string | required | API version date (YYYY-MM-DD). |

## Request body

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `ideaId` | string | required |  |
| `prompt` | string | optional |  |
| `referenceImageUrls` | array of string | optional |  |
| `imageSize` | string | optional |  |

## Example request

```bash
curl -X POST 'https://api.synup.com/api/v4/social-post-ideas/generate-idea-visual' \
  -H 'Authorization: API YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "ideaId": "91b2...",
  "prompt": "bright storefront on a sunny day"
}'
```

## Responses

| Status | Description |
| --- | --- |
| `200` | Successful response |
| `401` | Unauthorized - Invalid or missing API key |