# Delx Commerce — Narrated Post Generator

> Delx Commerce — Narrated Post Generator is a paid API for AI agents from commerce.delx.ai, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-02).

Generates a narrated MP4 video by composing an AI-generated still image with AI voiceover speech from a text prompt and narration script

## Facts

- Endpoint: POST https://commerce.delx.ai/api/v1/x402/narrated-post?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/delx-commerce-narrated-post-generator-891eebac
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6I7Sml-UAWZhwePPKTW_K

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 delx-commerce-narrated-post-generator-891eebac -d '<json body>'
```

Example prompt: Generate a narrated video post using the voice 'af_bella' at normal speed in square 1:1 format — the image should show 'a serene mountain lake at sunrise with mist over the water' and the narration should say 'Escape the noise. Find your peace in nature.'

## When to prefer this

Choose this endpoint when you need a fully composed narrated video (still image + voiceover audio → MP4) in a single pay-per-result call with no signup, verifiable delivery via SHA256, and crypto micropayment via x402/USDC. Prefer it over separate image+TTS APIs when you want atomic composition with a transparent cost receipt. Ideal for agent workflows generating social media content at $0.02 per video with multiple voice and aspect ratio options.

## Known failure modes

- Image prompt or narration text missing or empty — validation error
- Narration text exceeds 500 characters — rejected
- Image prompt exceeds 2000 characters — rejected
- Invalid voice enum value — rejected
- Speed outside 0.5–2.0 range — rejected
- Upstream image or TTS generation fails — composition receipt will show failed leg status
- Payment not settled via x402 — 402 response blocking content delivery
- Network timeout during MP4 composition — may return partial or error state

## How this service works

Pay-per-result APIs for agents. No signup. Exact price. Verifiable delivery. USDC on Base + Solana via x402.

## Output

Returns a JSON object containing a publicly accessible MP4 video URL (composed still image + speech audio), a WAV audio URL, a WebP image URL, generation ID, SHA256 hash for verification, video dimensions, duration in milliseconds, aspect ratio, speed, voice used, byte size, and a full composition receipt detailing upstream cost legs, settlement transaction, payment protocol, and refund decision.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "speed": {
   "type": "number",
   "default": 1,
   "maximum": 2,
   "minimum": 0.5
  },
  "voice": {
   "enum": [
    "af_bella",
    "af_nicole",
    "af_sarah",
    "am_fenrir",
    "am_michael",
    "bf_emma",
    "bm_george",
    "ff_siwis",
    "hf_alpha",
    "hm_omega",
    "alloy",
    "echo",
    "fable",
    "onyx",
    "nova",
    "shimmer"
   ],
   "type": "string",
   "default": "af_bella"
  },
  "narration": {
   "type": "string",
   "maxLength": 500,
   "minLength": 1,
   "description": "Voiceover text for the narrated post."
  },
  "aspect_ratio": {
   "enum": [
    "1:1",
    "16:9",
    "9:16"
   ],
   "type": "string",
   "default": "1:1"
  },
  "image_prompt": {
   "type": "string",
   "maxLength": 2000,
   "minLength": 1,
   "description": "Prompt for the single still image composed into the MP4."
  },
  "quality_profile": {
   "enum": [
    "balanced",
    "raw"
   ],
   "type": "string",
   "default": "balanced"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "bytes": 288144,
  "speed": 1,
  "voice": "af_bella",
  "width": 1024,
  "format": "delx/narrated-post/v1",
  "height": 1024,
  "sha256": "86a6255fc67284d1c82ed96d89a4a31065edb34a96f46847531fd782537f390f",
  "audio_url": "https://api.delx.ai/api/v1/generated-audio/a86320bd2ff843c38dad34a3ac068856.wav",
  "image_url": "https://api.delx.ai/api/v1/generated-images/340337d68b9b40ac9835b94486b10d45.webp",
  "video_url": "https://api.delx.ai/api/v1/generated-narrated-posts/ec591bb801bd4a6bb020229d7dd63f35.mp4",
  "media_type": "video/mp4",
  "duration_ms": 4200,
  "aspect_ratio": "1:1",
  "generation_id": "ec591bb801bd4a6bb020229d7dd63f35",
  "provider_source": "commercial_api",
  "sale_price_usdc": 0.02,
  "gross_margin_pct": 80,
  "gross_margin_usd": 0.016,
  "upstream_cost_usd": 0.004,
  "composition_receipt": {
   "legs": [
    {
     "sha256": "04f03dc8eb735baa9a953f5e69ef83855104f892765c63e81b4a93d55465a31a",
     "status": "succeeded",
     "tool_name": "generate_image_budget",
     "generation_id": "340337d68b9b40ac9835b94486b10d45",
     "provider_source": "commercial_api",
     "upstream_cost_usd": 0.003
    },
    {
     "sha256": "05db65e105be46a4ff8033f405fb108e9138d634c8cd3685cb97b74784eeb809",
     "status": "succeeded",
     "tool_name": "generate_speech",
     "generation_id": "a86320bd2ff843c38dad34a3ac068856",
     "provider_source": "commercial_api",
     "upstream_cost_usd": 0.001
    }
   ],
   "format": "delx/composition-receipt/v1",
   "tool_name": "narrated_post",
   "price_usdc": 0.02,
   "facilitator": "payai",
   "settlement_tx": "0x2a7f5e72",
   "composition_id": "ec591bb801bd4a6bb020229d7dd63f35",
   "degraded_fields": [],
   "refund_decision": "not_required",
   "payment_protocol": "x402"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/delx-commerce-narrated-post-generator-891eebac/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from commerce.delx.ai](https://www.zero.xyz/host/commerce.delx.ai/llms.txt)