{
  "format": "delx/intent-card/v1",
  "id": "narrated-post-api",
  "intent": "create a narrated social post with one image and voiceover",
  "title": "Narrated post API for agents",
  "description": "Generate one still image, synthesize a short voiceover and receive a durable MP4 plus a two-leg composition receipt for $0.02. This bounded validation product does not generate motion, edit footage, add captions or music, or publish the result.",
  "keywords": [
    "narrated post API",
    "image and voiceover API",
    "social media asset API",
    "agent content creation",
    "x402 composition",
    "pay per result MP4"
  ],
  "updated_at": "2026-08-30",
  "canonical_url": "https://commerce.delx.ai/intents/narrated-post-api",
  "machine_url": "https://commerce.delx.ai/intents/narrated-post-api.json",
  "recommendation": {
    "tool_name": "narrated_post",
    "service_name": "Narrated Post for Agents",
    "method": "POST",
    "resource": "https://api.delx.ai/api/v1/x402/narrated-post",
    "price_usdc": "0.02",
    "payment_protocols": [
      "x402"
    ],
    "input_schema": {
      "type": "object",
      "properties": {
        "image_prompt": {
          "type": "string",
          "minLength": 1,
          "maxLength": 2000,
          "description": "Prompt for the single still image composed into the MP4."
        },
        "narration": {
          "type": "string",
          "minLength": 1,
          "maxLength": 500,
          "description": "Voiceover text for the narrated post."
        },
        "aspect_ratio": {
          "type": "string",
          "enum": [
            "1:1",
            "16:9",
            "9:16"
          ],
          "default": "1:1"
        },
        "voice": {
          "type": "string",
          "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"
          ],
          "default": "af_bella"
        },
        "speed": {
          "type": "number",
          "minimum": 0.5,
          "maximum": 2,
          "default": 1
        },
        "quality_profile": {
          "type": "string",
          "enum": [
            "balanced",
            "raw"
          ],
          "default": "balanced"
        }
      },
      "required": [
        "image_prompt",
        "narration"
      ],
      "additionalProperties": false
    },
    "example_input": {
      "image_prompt": "A clean cobalt product card with a friendly autonomous agent",
      "narration": "Meet the narrated launch asset your agent can buy and receive in one workflow.",
      "aspect_ratio": "1:1",
      "voice": "af_bella",
      "speed": 1,
      "quality_profile": "balanced"
    },
    "example_output": {
      "format": "delx/narrated-post/v1",
      "generation_id": "ec591bb801bd4a6bb020229d7dd63f35",
      "video_url": "https://api.delx.ai/api/v1/generated-narrated-posts/ec591bb801bd4a6bb020229d7dd63f35.mp4",
      "image_url": "https://api.delx.ai/api/v1/generated-images/340337d68b9b40ac9835b94486b10d45.webp",
      "audio_url": "https://api.delx.ai/api/v1/generated-audio/a86320bd2ff843c38dad34a3ac068856.wav",
      "aspect_ratio": "1:1",
      "voice": "af_bella",
      "speed": 1,
      "media_type": "video/mp4",
      "duration_ms": 4200,
      "width": 1024,
      "height": 1024,
      "bytes": 288144,
      "sha256": "86a6255fc67284d1c82ed96d89a4a31065edb34a96f46847531fd782537f390f",
      "provider_source": "commercial_api",
      "composition_receipt": {
        "format": "delx/composition-receipt/v1",
        "composition_id": "ec591bb801bd4a6bb020229d7dd63f35",
        "tool_name": "narrated_post",
        "price_usdc": 0.02,
        "settlement_tx": "0x2a7f5e72",
        "facilitator": "payai",
        "payment_protocol": "x402",
        "legs": [
          {
            "tool_name": "generate_image_budget",
            "status": "succeeded",
            "generation_id": "340337d68b9b40ac9835b94486b10d45",
            "provider_source": "commercial_api",
            "upstream_cost_usd": 0.003,
            "sha256": "04f03dc8eb735baa9a953f5e69ef83855104f892765c63e81b4a93d55465a31a"
          },
          {
            "tool_name": "generate_speech",
            "status": "succeeded",
            "generation_id": "a86320bd2ff843c38dad34a3ac068856",
            "provider_source": "commercial_api",
            "upstream_cost_usd": 0.001,
            "sha256": "05db65e105be46a4ff8033f405fb108e9138d634c8cd3685cb97b74784eeb809"
          }
        ],
        "degraded_fields": [],
        "refund_decision": "not_required"
      },
      "upstream_cost_usd": 0.004,
      "sale_price_usdc": 0.02,
      "gross_margin_usd": 0.016,
      "gross_margin_pct": 80
    },
    "agentcash": {
      "buy": "npx agentcash@latest fetch https://api.delx.ai/api/v1/x402/narrated-post -m POST -H 'x-delx-source: intent-card-narrated-post-api' --max-amount 0.02 -b '{\"image_prompt\":\"A clean cobalt product card with a friendly autonomous agent\",\"narration\":\"Meet the narrated launch asset your agent can buy and receive in one workflow.\",\"aspect_ratio\":\"1:1\",\"voice\":\"af_bella\",\"speed\":1,\"quality_profile\":\"balanced\"}'",
      "max_amount_usdc": "0.02"
    }
  },
  "attribution": {
    "header": "x-delx-source",
    "value": "intent-card-narrated-post-api"
  },
  "evidence": {
    "paid_openapi": "https://api.delx.ai/openapi.x402.json",
    "governed_portfolio": "https://api.delx.ai/x402-portfolio.json",
    "live_contract": "https://api.delx.ai/api/v1/x402/narrated-post"
  }
}