# AdPrompt Creative Generation API

> AdPrompt Creative Generation API is a paid API for AI agents from x402.adprompt.io, paid per call via x402, $1/call, status unknown (last checked 2026-09-14).

Generates on-brand, platform-formatted ad creatives (images or video concepts) with captions and a JSON bundle from a business summary and target platform.

## Facts

- Endpoint: POST https://x402.adprompt.io/creative-generation
- Price: $1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 2
- Tags: x402
- Canonical page: https://www.zero.xyz/c/adprompt-creative-generation-api-6055cadb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_F9MqFiqywRUU7mwBKKsGt

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability adprompt-creative-generation-api-6055cadb -d '<json body>'
```

Example prompt: Generate an on-brand Instagram image ad for my coffee shop, Morning Bloom — we're a cozy neighborhood café specializing in single-origin pour-overs and artisan pastries, open 7am–4pm daily. Use the standard Instagram square format and include a caption promoting our new seasonal latte.

## When to prefer this

Choose this endpoint when you need to generate ready-to-use, platform-formatted ad creatives (images or video concepts) complete with captions directly from a business description — ideal for automating ad production pipelines or quickly producing social media content without a designer.

## Known failure modes

- Missing required fields (platform, media_type, or business_summary) returns a validation error
- Unsupported platform value returns an error referencing social_media_metadata.json
- Invalid custom_size format (not WxH) may cause render failure
- Payment not completed via x402 results in 402 Payment Required before generation begins
- View URL expires after 24 hours and becomes inaccessible

## How this service works

On-brand platform-formatted image/short videos; captions; JSON bundle for downstream tools/agents.

## Output

A JSON payload with an ok status, a run ID, a flow ID, a time-limited view URL (valid 24 hours) linking to the generated creative (image or video concept with caption), and a run_json_url for downstream tool/agent consumption.

## Example request

```json
{
 "platform": "instagram",
 "media_type": "image",
 "description": "Promote our cloud consulting services to business decision-makers",
 "business_summary": "TechFlow Solutions is a B2B software consulting firm specializing in cloud infrastructure and digital transformation for mid-market enterprises. We help businesses modernize their operations through scalable, secure technology solutions."
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "platform",
  "media_type",
  "business_summary"
 ],
 "properties": {
  "platform": {
   "type": "string",
   "description": "Target platform (dropdown from social_media_metadata.json)."
  },
  "media_type": {
   "type": "string",
   "description": "Generate an image or video concept."
  },
  "custom_size": {
   "type": "string",
   "description": "Optional custom size override (e.g., 1080x1350). If set, overrides render_size."
  },
  "description": {
   "type": "string",
   "description": "Optional offer / context / constraints."
  },
  "render_size": {
   "type": "string",
   "description": "Optional size override (WxH) from supported platform sizes."
  },
  "business_summary": {
   "type": "string",
   "description": "Short business summary (2–5 sentences)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ok": {
   "type": "boolean"
  },
  "runId": {
   "type": "string"
  },
  "flowId": {
   "type": "string"
  },
  "message": {
   "type": "string"
  },
  "view_url": {
   "type": "string"
  },
  "run_json_url": {
   "type": "string"
  },
  "view_expires_at": {
   "type": "string"
  }
 },
 "description": "JSON payload containing the report/view link (valid 24 hours) plus metadata."
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/adprompt-creative-generation-api-6055cadb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.adprompt.io](https://www.zero.xyz/host/x402.adprompt.io/llms.txt)