Skip to main content
POST
Enhance a Google Ads image prompt

Authorizations

Authorization
string
header
required

Personal access token, sent as Authorization: Bearer <token>. Each operation lists the permission it needs: read_only or full_access. A full-access token can call every operation. A read-only token can call only the operations that list read_only; anything else returns 403 read_only_credential_route_not_allowed.

Headers

Accept-Language
string | null

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

Path Parameters

app_id
string
required

ID of the app you are planning a Google Ads campaign for.

Body

application/json
raw_prompt
string
default:""

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

Example:

"oak table photo"

Response

The rewritten prompt.

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.

Example:

"A warm, sunlit photograph of a handmade oak dining table in a bright modern kitchen, shallow depth of field, lifestyle advertising photography"

original_prompt
string
required

The raw_prompt you sent, echoed back unchanged.

Example:

"oak table photo"