---
title: "Enhance a Google Ads image prompt"
method: POST
path: "/api/apps/{app_id}/google-ads/suggestions/enhance-prompt"
---

# Enhance a Google Ads image prompt

`POST /api/apps/{app_id}/google-ads/suggestions/enhance-prompt`

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Rewrites a short image prompt into a fuller one that produces better Performance Max creative.

Send the text someone typed as `raw_prompt`. Nothing is saved.

An empty or whitespace-only `raw_prompt` returns an empty `enhanced_prompt` immediately, without running a model and without spending quota. If the model fails, you get your original prompt back as `enhanced_prompt`, so compare it against `original_prompt` when you need to know whether the rewrite actually happened.

<Note>This endpoint runs a language model and draws on a shared quota of 20 requests per minute per app, which every Google Ads AI endpoint debits. Enterprise workspaces get a higher quota. A 429 means the quota is spent, not that this endpoint has its own limit.</Note>

<Note>The copy is written in the language you send in the `Accept-Language` header. Omit the header and you get English — the app's own language is not consulted — so send it explicitly for a non-English app.</Note>

<Note>This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.</Note>

## Path parameters

- `app_id` string, required — ID of the app you are planning a Google Ads campaign for.

## Headers

- `Accept-Language` string, nullable — Language to return generated text in, as a standard `Accept-Language` value. An unsupported language falls back to English.

## Request body

- EnhancePromptRequest
  - `raw_prompt` string — The image prompt to rewrite, in the caller's own words. Empty or whitespace-only returns an empty result without running a model.

## Response `200`

The rewritten prompt.

- GoogleAdsEnhancedPrompt — A rewritten image-generation prompt.
  - `enhanced_prompt` string, required — The rewritten prompt. Empty when you sent an empty or whitespace-only `raw_prompt`, in which case no model runs and no quota is spent.
  - `original_prompt` string, required — The `raw_prompt` you sent, echoed back unchanged.

## Other responses

- `401` — Missing or invalid credentials.
- `403` — You don't have access to this app, the app does not exist, or you used a workspace API key. A missing app and an app you cannot reach are deliberately the same answer.
- `422` — Validation Error
- `429` — The shared AI quota for this app is spent. Retry in a minute.

---

[API](https://skmtc.dev/base44/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/base44/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/base44/apis/base44-app-management-api/revisions/cf164639a9bf?raw)