Skip to main content
The NanoClip API turns source video and audio into structured media intelligence for clipping, analysis, search, cleanup, and editing workflows. (Audio sources are transcript-only.)
Recommended
>_

​
Use with Claude Code

Paste a ready-to-run NanoClip plus HyperFrames prompt into your agent.

Quickstart

Upload a video or audio file, start analysis, and poll for results on production.

Authentication

Send API keys and use scopes.

Analysis jobs

Understand upload, transcript, vision, and retake-removal outputs.

Limits

Review request, project, command, and upload limits.

​
Base URL

​
Typical flow

  1. Create an upload project.
  2. PUT the bytes to the signed upload URL.
  3. Complete the upload so NanoClip can validate and register the source.
  4. Start one or more analysis commands.
  5. Poll the command result endpoint until its status is completed or failed.

​
Status values

Projects and analyses have separate status vocabularies, each declared as an enum in the OpenAPI spec. Project status (ProjectStatus): Analysis status (AnalysisResultStatus on result responses; start responses use the same words minus failed — a failed analysis is re-dispatched or rejected, never acknowledged as started):

​
Current endpoint style

The public API uses stable analysis endpoints:
  • GET /v1/me
  • POST /v1/projects/upload
  • POST /v1/projects/{project_id}/upload/complete
  • POST /v1/projects/{project_id}/transcript
  • GET /v1/projects/{project_id}/transcript
  • POST /v1/projects/{project_id}/vision
  • GET /v1/projects/{project_id}/vision
  • POST /v1/projects/{project_id}/retake-removal
  • GET /v1/projects/{project_id}/retake-removal