# DeckFlow Developer Documentation (English)

> DeckFlow developer API endpoints, developer guides, CLI tool, and MCP server documentation.

## Developer Guides

- [API Key](https://app.deckflow.com/docs/en/guide/authentication.md): Generate your DeckFlow API key from Settings. Use it to authenticate API requests, MCP integrations, CLI workflows, and server-side automation.
- [Core Concepts](https://app.deckflow.com/docs/en/guide/core-concepts.md): An introduction to DeckFlow core concepts, explaining the domain model shared across all API, MCP, and CLI documentation.
- [Examples](https://app.deckflow.com/docs/en/guide/examples.md): An introduction to DeckFlow examples, showcasing typical integration scenarios using the API, MCP, and CLI.
- [Limits & Errors](https://app.deckflow.com/docs/en/guide/limits-errors.md): DeckFlow limits and error specifications, detailing file size restrictions, task constraints, error responses, and troubleshooting strategies.
- [Pricing & Billing](https://app.deckflow.com/docs/en/guide/pricing-billing.md): Understand how DeckFlow developer usage consumes Credit and Spark quota. Estimate Tools tasks before running conversions, extraction, compression, and optimization jobs.
- [Quick Start](https://app.deckflow.com/docs/en/guide/quick-start.md): The quick start guide for DeckFlow developers to establish the shortest path for file uploading, task creation, status querying, and result downloading.
- [Webhooks / Async Jobs](https://app.deckflow.com/docs/en/guide/webhooks-async-jobs.md): Understanding DeckFlow's asynchronous execution model, status polling, and Webhook callbacks for long-running file processing tasks.

## API Reference

- [Create Task (Generation)](https://app.deckflow.com/docs/en/api/create.md): Generate professional presentation slides (PPTX) using complex documents, text prompts, or URLs.
- [Query Generation Task](https://app.deckflow.com/docs/en/api/get-generation-task.md): Query the execution progress and download URL of a document generation task.
- [Query Revamp Task](https://app.deckflow.com/docs/en/api/get-revamp-task.md): Query the execution progress and download URL of a document revamp task.
- [Query Translation Task](https://app.deckflow.com/docs/en/api/get-translation-task.md): Query the execution progress and download URL of a document translation task.
- [Submit Revamp Task](https://app.deckflow.com/docs/en/api/revamp.md): Upgrade presentation layouts, colors, and Brand DNA while preserving the original slide content.
- [File Converter](https://app.deckflow.com/docs/en/api/tools-converter.md): The File Converter API specifications and task parameters, supporting conversion between HTML, Image, Keynote, Markdown, PDF, PPT/PPTX, Word, and other formats.
- [Extractor](https://app.deckflow.com/docs/en/api/tools-extractor.md): The Extractor API specifications and task parameters, supporting optical character recognition (OCR) from images or font detection and text extraction from PPTX presentations.
- [Merger & Splitter](https://app.deckflow.com/docs/en/api/tools-merger-splitter.md): The Merger & Splitter API specifications and task parameters, supporting merging multiple PPTX files, packing HTML pages into a standalone player, or splitting PPTX presentations.
- [Optimizer](https://app.deckflow.com/docs/en/api/tools-optimizer.md): The Optimizer API specifications and task parameters, supporting file compression, image resizing, PPTX font embedding, and video size reduction.
- [Submit Translation Task](https://app.deckflow.com/docs/en/api/translate.md): Translate presentation files (PPTX, PDF, etc.) while keeping the layout and typography intact.

## CLI Tool

- [CLI Commands](https://app.deckflow.com/docs/en/cli/commands.md): DeckUse commands operate on local PPTX workspaces. DeckOps commands operate on DeckFlow backend tasks.
- [CLI Examples](https://app.deckflow.com/docs/en/cli/examples.md): Use DeckUse for local PPTX edits. Use DeckOps for cloud tasks that need DeckFlow backend processing.
- [CLI Install](https://app.deckflow.com/docs/en/cli/install.md): Install DeckUse for local PPTX edits, install DeckOps for cloud-backed DeckFlow tasks. Both packages require Node.js 18 or newer.

## MCP Servers

- [Claude Code](https://app.deckflow.com/docs/en/mcp/claude-code.md): Connect DeckFlow to Claude Code via MCP so terminal-based agents can create, revamp, translate, convert, extract, merge, split, and optimize presentation files.
- [Claude Web / Desktop](https://app.deckflow.com/docs/en/mcp/claude-web.md): Connect DeckFlow to Claude through a custom MCP connector so users can run presentation and document workflows directly inside Claude chats.
- [MCP Confirmation Questions](https://app.deckflow.com/docs/en/mcp/confirmation-questions.md): Questions for DeckFlow product/API owners before replacing MCP placeholders with final values.
- [MCP Examples](https://app.deckflow.com/docs/en/mcp/examples.md): Example prompts and expected tool flows for agents using DeckFlow MCP.
- [Manus](https://app.deckflow.com/docs/en/mcp/manus.md): Connect DeckFlow to Manus agents so automated workflows can create, revamp, translate, convert, and optimize presentation files without manual handoff.
- [OpenAI / ChatGPT](https://app.deckflow.com/docs/en/mcp/open-ai.md): Add DeckFlow to ChatGPT or OpenAI agent surfaces so users can run presentation and document workflows from conversation.
- [MCP Parameter Checklist](https://app.deckflow.com/docs/en/mcp/parameter-checklist.md): Product/API decisions needed before DeckFlow MCP docs can become final tool documentation.
- [MCP Setup](https://app.deckflow.com/docs/en/mcp/setup.md): Configure DeckFlow MCP in AI clients so agents can run presentation and file workflows from chat, code, or automated agent sessions.
- [MCP Tools](https://app.deckflow.com/docs/en/mcp/tools.md): Draft DeckFlow MCP tool catalog for AI agents. Tool names and schemas below are proposed documentation scaffolding, not final implementation contracts.