{"uid":"cap_z06oyotHbwRL9ZAJDYueX","slug":"narrated-post-for-agents-c922321c","name":"Narrated Post for Agents","description":"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.","url":"https://api.delx.ai/api/v1/x402/narrated-post","method":"POST","headers":{},"bodySchema":{"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"}}},"responseSchema":{"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"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_05FxGC5Jy_h1Kf4oL7nt5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Product launch announcement card","prompt":"Create a narrated 16:9 MP4 for our product launch — image prompt: 'a futuristic smartwatch glowing on a dark desk', narration: 'Meet the Watch X — your next-gen companion for every moment.' Use the 'bf_emma' voice at normal speed."},{"title":"Social media explainer post","prompt":"I need a square narrated video post for social — image of 'a warm coffee shop interior with morning light' and narration: 'Start your morning right. Our new blend is here and it is everything you have been waiting for.' Use the 'am_michael' voice."},{"title":"Agent-generated news update clip","prompt":"Generate a 9:16 narrated still-image video with a 'breaking news broadcast desk in a modern studio' visual and this narration: 'Markets rallied today as tech stocks surged to record highs.' Use the 'onyx' voice at 1.2 speed with balanced quality."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T17:51:03.540Z","isFirstParty":false}