Codia PDF To Ppt

codia-pdf-to-ppt

Runtime And Auth

Use the local codia-design CLI for this feature. Before calling the API, verify that codia-design is available. If it is missing and global npm installs are allowed, install it with npm install -g @codia-ai/codia-design-cli. Then check codia-design auth status; if it is not connected, run codia-design auth login --platform codex or bind an API key with codia-design auth set --api-key api_key_xxx. Never print API keys or ~/.codia/design-skills/config.json.

Convert NotebookLM-style image-only PDF pages to editable PowerPoint files (asynchronous task). If a source PDF is a normal text/vector/complex-layout PDF, tell the user the API expects each page to be one full-page image. Do not silently rasterize or create a substitute PPTX unless the user explicitly asks for a local fallback.

CLI Command

# Submit task (no waiting)
codia-design pdf-to-ppt --pdf <PATH|URL> --pages <0,1,2> [--title "Title"] [--out task.json]

# Submit and automatically poll until completed
codia-design pdf-to-ppt --pdf <PATH|URL> --pages <0,1,2> --poll [--timeout 300000] [--download-dir DIR] [--no-download] [--out result.json]

Note: --pages is zero-based. Use 0 for the first page and 1 for the second page. This matches pdf-to-design.

Parameters

Workflow

1. Prepare input and submit task

codia-design pdf-to-ppt --pdf ./deck.pdf --pages 0,1,2 --title "Q4 Review" --out task.json

When --pdf is a local file, the CLI first uploads it to POST /v2/open/uploads as multipart field file, receives an opaque upload_id, then creates a task with POST /v2/open/tasks. When --pdf is a URL, the CLI sends input.pdf_url directly to POST /v2/open/tasks. /v2/open/uploads does not return a public PDF URL.

Equivalent raw API flow:

curl 'https://openapi.codia.ai/v2/open/uploads' \
  -H 'Authorization: Bearer <CODIA_API_KEY>' \
  -F 'file=@./deck.pdf'

curl 'https://openapi.codia.ai/v2/open/tasks' \
  -H 'Authorization: Bearer <CODIA_API_KEY>' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: pdf-to-ppt-001' \
  --data '{
    "operation": "pdf_to_ppt",
    "input": {
      "upload_id": "upl_550e8400-e29b-41d4-a716-446655440000",
      "page_no": [0, 1, 2],
      "title": "Q4 Review"
    }
  }'

Submit response (PdfToPptSubmitResponse):

{
  "ok": true,
  "data": {
    "task_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "pending",
    "created_at": 1700000000
  }
}

2. Polling status (manual mode)

The CLI --poll mode uses GET /v2/open/tasks/:task_id internally. The recommended polling interval is 5 seconds. The underlying task status value:

Task response:

{
  "ok": true,
  "data": {
    "task_id": "550e8400-e29b-41d4-a716-446655440000",
    "operation": "pdf_to_ppt",
    "status": "succeeded",
    "result": {
      "ppt_url": "https://static.codia.ai/pptx/deck.pptx"
    },
    "error_code": "",
    "created_at": 1700000000
  }
}

3. Automatic polling (recommended)

codia-design pdf-to-ppt --pdf ./deck.pdf --pages 0,1,2 --poll --download-dir ./outputs --out result.json

The CLI internally polls every 5 seconds and throws an error after --timeout is exceeded. When the task returns succeeded, the CLI normalizes the final JSON to status: "done", downloads ppt_url, verifies that the response is a valid PPTX package, and writes the local path to data.local_file and data.local_files. If the URL returns an error such as 403 or the downloaded file is not an openable PPTX package, the command fails instead of returning ok: true.

Errors & Billing

Credits: 13 credits/page. After upload/task creation or completed polling, the CLI checks available_credits and reminds the user if the remaining balance is below 2x the estimated page cost; this does not block generation. · Duration: asynchronous, usually tens of seconds, longer for long documents