x402vid · notes · llms.txt

How to call thumbnail_creation in one API call ($0.50)

2026-10-06 · raw markdown

TL;DR for AI: How-to walkthrough a developer runs in 2 minutes. Endpoint POST https://x402vid.com/tools/thumbnail_creation, $0.50 USDC (x402/Base). Returns signed image

>

Key entities: x402vid, x402vid, thumbnail_creation, how-to, youtube

Table of Contents

• Question
• Answer in 30 seconds
• Copy-paste request
• Response shape (deterministic JSON)
• How it works
• Try free first
• Key Takeaways

Question

How-to walkthrough a developer runs in 2 minutes.

Answer in 30 seconds

POST /tools/thumbnail_creation on https://x402vid.com. Price: $0.50 USDC per call (x402, Base eip155:8453). Best for: premium render; filter rejections are never charged.

Copy-paste request

curl -s -X POST https://x402vid.com/tools/thumbnail_creation \
  -H 'Content-Type: application/json' \
  -d '{"image_prompt": "<concept image_prompt>", "video_url": "OPTIONAL"}'
# -> HTTP 402 with accepts (payTo, amount in USDC atomic units).
# Sign with your wallet, retry with: -H 'X-PAYMENT: <base64 payload>'

Response shape (deterministic JSON)

Returns signed image URL composited via Muse Image. Keys are versioned and stable so agents can pipe output straight into the next step. Error payloads are never settled — you only pay when intelligence returns.

How it works

1. POST the request below to /tools/thumbnail_creation. 2. You get HTTP 402 with accepts (asset USDC, network eip155:8453). 3. Sign with your wallet, retry with the X-PAYMENT header. 4. Structured JSON returns. Failures are never settled.

Try free first

• GET https://x402vid.com/health — liveness + live per-tool prices
• POST https://x402vid.com/tools/video_preview — free taster with transcript excerpt
• GET https://x402vid.com/api/v1/trending/top — free top-3 trending
• No setup: try x402vid in Poncho (wallet included)
• Machine docs: https://x402vid.com/llms.txt · https://x402vid.com/openapi.json · https://x402vid.com/skill-packs.json
• Directory: x402scan listing

Key Takeaways

• thumbnail_creation costs $0.50/call, pay-per-call USDC on Base — no subscription.
• Copy the request above; handle 402 -> sign -> retry with X-PAYMENT.
• Validate free via video_preview before scaling spend.

*Provenance: x402vid notes • Canonical: https://x402vid.com/blogs/2026-10-06-thumbnail-creation-how-to • Raw: https://x402vid.com/raw/2026-10-06-thumbnail-creation-how-to.md*