# Narrated Post for Agents

> Narrated Post for Agents is a paid API for AI agents from api.delx.ai, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Generates a narrated still-image MP4 by composing a FLUX Schnell image and Kokoro voiceover into a single agent-ready video file for $0.02 USDC per call.

## Facts

- Endpoint: POST https://api.delx.ai/api/v1/x402/narrated-post
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/narrated-post-for-agents-c922321c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_z06oyotHbwRL9ZAJDYueX

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 narrated-post-for-agents-c922321c -d '<json body>'
```

Example prompt: Make me a narrated square MP4 post using the voice 'af_bella' — the image prompt is 'a sleek minimal product showcase on a white background' and the narration is 'Introducing our new collection — designed for those who move fast and think clearly.' Use balanced quality.

## When to prefer this

Choose this endpoint when you need a single, self-contained narrated still-image MP4 produced cheaply ($0.02 USDC) with no API key or subscription — ideal for agents generating social posts, product cards, or short announcements at scale. Prefer alternatives if you need generative motion video, timeline editing, captions overlay, background music, or multi-scene production.

## Known failure modes

- Image prompt or narration text missing or empty — validation error returned
- Narration text exceeds 500 characters — rejected with length error
- Invalid voice enum value — returns validation error listing accepted values
- Aspect ratio not in allowed enum — rejected
- Speed value outside 0.5–2.0 range — rejected with bounds error
- Upstream FLUX Schnell or Kokoro service unavailable — error with provider failure message
- Payment of $0.02 USDC not completed via x402 — request not processed

## How this service works

Create one narrated still-image MP4 for $0.02 USDC: a bounded FLUX Schnell visual, Kokoro voiceover, and first-party composition in one agent-ready result. Call for a short social post, announcement, product card, or explainer—not generative motion, timeline editing, captions, music, or a full video-production suite. Returns durable MP4, image, and WAV URLs with SHA-256, actual provider source, cost, and margin receipt; no buyer API key or subscription.

## Output

Returns durable URLs for the composed MP4 video, the source still image, and the WAV audio file, along with SHA-256 hashes for integrity verification, the actual AI provider source used, the cost in USDC, and a margin receipt — no external API key required.

## 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/narrated-post-for-agents-c922321c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.delx.ai](https://www.zero.xyz/host/api.delx.ai/llms.txt)