Detail-XEVERY FRAME MATTERS
DEVELOPERS / REST API · OFFICIAL MCP · ECOSYSTEM

Video Upscaler API & MCPREST, OAuth MCP, Replicate & HF

Automate 4K 60fps upscaling from backend scripts or Claude Code, Codex & Cursor with single billing.

Backlit bamboo grove character video upscaled to 4K 60fps in DetailX
Original · 1080p 24 FPS DetailX · 4K 60 FPS
Play the same 1080p→4K 60fps backlit bamboo clip featured on the official DetailX Hugging Face Space.
INTEGRATION COMPARISON

Choosing Between Direct REST API, Official MCP, Replicate & Hugging Face

All four channels invoke the exact same DetailX 4K/60fps enhancement engine under your DetailX credit balance.

ChannelAuth MethodBilling StructureBest Suited For
Direct REST API (/integrations/api)Scoped Bearer API Key (SHA-256 stored)DetailX credits only (lowest cost)Production apps, SaaS backends, CI/CD media pipelines, high-volume batch jobs
Official MCP Server (/api/v1/mcp/)Browser OAuth 2.1 + S256 PKCEDetailX credits onlyClaude Code, Codex, Cursor, Gemini CLI, GitHub Copilot & autonomous AI agents
Replicate Model AdapterReplicate token + DetailX API KeyReplicate CPU wrapper time + DetailX creditsQuick evaluation inside existing Replicate tooling before migrating to Direct API
Hugging Face Static SpaceDetailX API Key (held in browser memory)DetailX credits only (zero HF GPU cost)Interactive browser testing, sharing demos & inspecting sample 4K comparisons
WHY CREATORS & ENGINEERS SWITCH

Core Capabilities Built for Real-World 4K Delivery

DIRECT REST API

Single-Fee Production Billing

Call POST /api/v1/developer/generations with an HTTPS input_video_url, upload_id, or source_result_id. Zero third-party wrapper fees—pay only DetailX credits ($1 = 25 credits).

OFFICIAL MCP REGISTRY & GLAMA

22-Tool Streamable HTTP OAuth MCP

Connect https://www.detail-x.ai/api/v1/mcp/ to Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, or OpenCode using browser OAuth 2.1 PKCE—no API keys pasted in prompts.

REPLICATE MIGRATION TIP

Prototype on Replicate, Save on Direct API

Our Replicate adapter bills both Replicate runtime and DetailX credits. Moving production traffic to the Direct DetailX API takes 3 minutes and removes wrapper runtime fees completely.

HUGGING FACE STATIC SPACE

Browser Playground & Reference Clip

Preview multipart uploads, real-time quotes, and wipe comparisons in the official DetailX Hugging Face Space using your own scoped DetailX API key.

QUICKSTART SNIPPETS

Copy-Ready Direct API & OAuth MCP Commands

Start upscaling from terminal workflows, CI jobs, or MCP-compatible AI assistants in minutes.

Direct REST API — Submit 4K 60fps Upscale by URL
curl -X POST https://www.detail-x.ai/api/v1/developer/generations \
  -H "Authorization: Bearer $DETAILX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_video_url": "https://cdn.example.com/source-720p.mp4",
    "resolution": "4k",
    "fps": 60,
    "detail": 2,
    "keep_color": true,
    "light_correct": false,
    "flow_smooth": false
  }'

Returns task_id and status immediately. Poll GET /api/v1/developer/generations/{task_id} for progress and video_url.

Official MCP Server — Connect Claude Code or Codex
# Claude Code
claude mcp add --transport http --scope local detailx 'https://www.detail-x.ai/api/v1/mcp/'
claude

# Codex
codex mcp add detailx --url 'https://www.detail-x.ai/api/v1/mcp/'
codex mcp login detailx

Also discoverable in the Official MCP Registry (io.github.DetailX-Video-Upscale/detailx-video-upscaler) and Glama.

OFFICIAL LISTINGS

Verified DetailX Ecosystem Listings

Connect through whichever registry or developer directory fits your stack.

Streamable HTTP · OAuth 2.1

Official MCP Registry

Listed as io.github.DetailX-Video-Upscale/detailx-video-upscaler. Connect Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, and OpenCode without manual API keys.

View on MCP Registry ↗
22 Standard Tools

Glama MCP Directory

Verified remote MCP connector supporting local multipart upload discovery, credit quotes, 4K/60fps generation, and status queries directly from AI coding assistants.

Explore on Glama ↗
Quick API Sandbox

Replicate Model

Test DetailX inside Replicate workflows. Note: Replicate runs bill both Replicate runtime and DetailX credits—use the Direct DetailX REST API for single-fee production workloads.

Open on Replicate ↗
Interactive Web Demo

Hugging Face Space

Static browser playground powered by the DetailX API with side-by-side and wipe comparisons, plus an aligned 1080p-to-4K 60fps reference clip.

Launch on Hugging Face ↗
FREQUENTLY ASKED QUESTIONS

Common Questions Answered

Why does Replicate charge both Replicate runtime and DetailX credits?

The Replicate listing runs a lightweight CPU adapter that calls the DetailX API while model inference stays on DetailX infrastructure. For zero wrapper fees and faster direct multipart uploads, call https://www.detail-x.ai/api/v1/developer/generations directly.

How does the DetailX MCP server upload large local videos without sending bytes over JSON-RPC?

Agents with local terminal access call get_upload_instructions and get_local_upload_client to stream multipart chunks directly from your machine to signed OSS endpoints—no video bytes or OAuth tokens ever leave the sanctioned protocol.

What happens to my credits if an API or MCP generation fails?

DetailX pre-authorizes credits on submission, settles strictly on actual processed duration upon completion, and automatically issues a full refund back to your ledger if a task fails or times out.

EXPLORE MORE GUIDES
READY TO SEE IT ON YOUR OWN FOOTAGE?

Test a Single Frame in 4K Before Rendering the Full Clip

Upload an MP4, MOV, WebM, or MKV in Web Studio, install the Windows/macOS desktop client, or connect via REST API & OAuth MCP.