Files & artifacts

将文件传入任务、获取 agent 产出的文件、生成媒体，并在服务端渲染精致的文档。

上传（输入文件）

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

上传一个文件（multipart）；其提取出的文本可并入聊天或 agent 任务。

Artifact（输出文件）

Agent 创建的文件会作为 artifact 被追踪：

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 所示费率计费；费用在文件交付时从工作区余额结算。