Files & artifacts

작업에 파일을 보내고, agent가 생성한 파일을 검색하고, 미디어를 생성하고, 서버 측에서 세련된 문서를 렌더링합니다.

Uploads(파일 입력)

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

파일을 업로드합니다(multipart). 추출된 텍스트는 chat 또는 agent 작업에 포함될 수 있습니다.

Artifacts(파일 출력)

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에 표시된 요율로 과금되며, 파일이 전달될 때 워크스페이스 잔액에서 정산됩니다.