Create Task (Generation)

Generate professional presentation slides (PPTX) using complex documents, text prompts, or URLs.

Interface Specification

Create an asynchronous slide generation task. The value for type must be generation.

POST /tools/tasks

Request Headers

Header	Type	Required	Description
`Authorization`	`String`	Yes	`Bearer <YOUR_API_KEY>` — Your developer API key.
`Content-Type`	`String`	Yes	Must be `multipart/form-data`.

POST Request Body Parameters (Form Data)

Parameter	Type	Required	Description
`spaceId`	`String`	No	Target workspace Space ID.
`files`	`File`	No	Reference document files (PDF, Word, or Markdown). Supports multiple files.
`type`	`String`	Yes	Task type. Fixed value: `generation`.
`name`	`String`	No	Task display name, e.g., `"AI Document Generation Task"`.
`params`	`String (JSON)`	Yes	JSON string containing task parameters. Detailed fields below.

Task Parameters (params)

Inner properties supported inside the params JSON string:

Field	Type	Required	Description
`inputText`	`String`	No	Topic description, webpage URL, or raw text to build slide structures.
`enableSearch`	`Boolean`	No	Enable web search to research and enrich content details. Default: `false`.
`advancedModel`	`Boolean`	No	Use reasoning AI models for better logic and creative slides. Default: `false`.
`fastMode`	`Boolean`	No	Prioritize faster execution speed over layout optimizations. Default: `false`.
`intent`	`String`	No	Custom goal context or intention.
`audience`	`String`	No	Target audience details to guide layouts and copywriting style.
`pageCount`	`Integer`	No	Target number of slides to generate.
`author`	`String`	No	PPTX author metadata.
`notifyURL`	`String`	No	Webhook callback address triggered on task status changes.

Request Headers Authentication

Authorization string required

Bearer token passed as Authorization header:

Body Parameters multipart/form-data

spaceId string

Workspace Space ID.

files file

Upload local source documents.

No file chosen

type string required

Task type, fixed value: generation.

name string

AI Task Name.

notifyURL string

Webhook callback URL to receive status notifications.

params json string required

Generation parameters JSON string.

API Overview Query Generation Task

curl --location 'https://app.deckflow.com/api/tools/tasks' \ --header 'Authorization: Bearer YOUR_API_KEY' \ --form 'spaceId="space-default"' \ --form 'files=@"/path/to/presentation.pptx"' \ --form 'type="generation"' \ --form 'name="AI Document Generation Task"' \ --form 'params="{\"inputText\":\"Write an analysis report on the development trends of the renewable energy industry, highlighting the market shares of solar and wind energy.\",\"enableSearch\":true,\"advancedModel\":false,\"fastMode\":false,\"pageCount\":10}"'

import requests url = "https://app.deckflow.com/api/tools/tasks" headers = { "Authorization": "Bearer YOUR_API_KEY" } files = [ ("files", ("presentation.pptx", open("presentation.pptx", "rb"), "application/octet-stream")) ] data = { "spaceId": "space-default", "type": "generation", "name": "AI Document Generation Task", "params": '{"inputText":"Write an analysis report on the development trends of the renewable energy industry, highlighting the market shares of solar and wind energy.","enableSearch":true,"advancedModel":false,"fastMode":false,"pageCount":10}' } response = requests.post(url, headers=headers, files=files, data=data) print(response.json())

{{ "id": "task-uuid-string", "spaceId": "space-default", "name": "AI Document Generation Task", "type": "generation", "status": "pending", "preview": null, "createdAt": "2026-06-06T08:52:00.000Z", "updatedAt": "2026-06-06T08:52:00.000Z" }}