Files & artifacts

將檔案送入任務、擷取 agent 產生的檔案、生成多媒體，並在伺服器端渲染精美的文件。

上傳（檔案輸入）

POST/v1/workspaces/{workspace_id}/uploads —

上傳檔案（multipart）；其擷取出的文字可併入聊天或 agent 任務。

Artifacts（檔案輸出）

Agent 建立的檔案會以 artifacts 形式追蹤：

GET/v1/workspaces/{workspace_id}/artifacts —

列出（以 kind、favorites_only 過濾，支援分頁）。

GET/v1/workspaces/{workspace_id}/artifacts/{artifact_id}/download —

產生一個全新的簽章下載 URL。

POST/v1/workspaces/{workspace_id}/artifacts/preview —

內嵌預覽資料（表格在伺服器端解析；Office → PDF）。

POST/v1/workspaces/{workspace_id}/artifacts/{artifact_id}/convert —

轉換為另一種格式（to）。

生成多媒體

圖片／影片／語音生成為非同步——提交後再輪詢任務：

POST/v1/workspaces/{workspace_id}/generate/image —

prompt → 輪詢

GET/v1/workspaces/{workspace_id}/generate/image/{task_id} —

POST/v1/workspaces/{workspace_id}/generate/video —

prompt、duration_sec、aspect_ratio。

POST/v1/workspaces/{workspace_id}/generate/speech —

text、voice。

GET/v1/workspaces/{workspace_id}/generate/pricing —

目前的單位費率。

渲染文件

POST/v1/workspaces/{workspace_id}/render —

由結構化輸入渲染精美檔案：format（pdf／docx／xlsx／slides／md）加上 sections、slides 或 sheets。支援 CJK（不會出現豆腐字）。

bash

curl https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/render \
  -H "Authorization: Bearer $NEXEVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"format": "pdf", "title": "Q2 Review",
     "sections": [{"heading": "Summary", "markdown_text": "Revenue **up 18%**."}]}'

生成與渲染依 /generate/pricing 顯示的費率計費；檔案交付時費用會從 workspace 餘額結算。