# AdPrompt Video Generation API

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

Generates a video asset on-demand for a given advertising or creative prompt, returning a job ID and polling URL for async retrieval, gated behind x402 micropayment.

## Facts

- Endpoint: POST https://x402.adprompt.io/v1/videos/generate
- Price: $2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/adprompt-video-generation-api-b047cb7b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Xw-bWeN8E_1WBuzoyaF0y

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-video-generation-api-b047cb7b -d '<json body>'
```

Example prompt: Generate a short marketing video for my outdoor gear brand TrailPeak — the ad should highlight our new waterproof hiking boots, feel adventurous and energetic, and be formatted for Instagram Reels.

## When to prefer this

Choose this endpoint when you need to programmatically generate short marketing or advertising videos from a creative prompt, especially within an automated agent workflow that can handle async job polling and x402 micropayment flows. It is particularly suited for agents orchestrating ad creative pipelines where video output is needed at $0.01 USDC per generation. Prefer this over generic video generation APIs when the use case is advertising or marketing creative tied to brand/business context.

## Known failure modes

- 402 Payment Required — no valid x402 payment supplied; must complete x402 v2 payment challenge before content is returned
- Invalid or missing creative/business context fields causing 400 Bad Request
- Job creation failure due to upstream video generation service unavailability (500)
- Payment verification failure if USDC transaction is invalid or insufficient
- Polling URL returns pending status indefinitely if video generation job stalls

## How this service works

Public x402 API for the full AdPrompt engine and bundle catalog. Paid endpoints return an x402 v2 402 challenge until a valid payment is supplied.

## Output

Returns a JSON object with ok=true, a job_id for tracking the async video generation job, a polling_url to check completion status, a receipt_id confirming the x402 micropayment, product_id, price_usd, and a metadata bundle including creative details, request_id, x402_version, business_context, and payments_enforced flag.

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ok",
  "product_id",
  "receipt_id",
  "price_usd",
  "job_id",
  "polling_url",
  "metadata"
 ],
 "properties": {
  "ok": {
   "type": "boolean",
   "const": true
  },
  "job_id": {
   "type": "string"
  },
  "metadata": {
   "type": "object",
   "properties": {
    "creative": {
     "type": "object"
    },
    "request_id": {
     "type": "string"
    },
    "x402_version": {
     "type": "integer"
    },
    "business_context": {
     "type": "object"
    },
    "payments_enforced": {
     "type": "boolean"
    }
   },
   "additionalProperties": true
  },
  "price_usd": {
   "type": "number"
  },
  "product_id": {
   "type": "string"
  },
  "receipt_id": {
   "type": "string"
  },
  "polling_url": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/adprompt-video-generation-api-b047cb7b/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)