---
title: "Upload an image as a project asset"
method: POST
path: "/v1/video-projects/{projectId}/assets/upload"
tags: ["Video Projects"]
---

# Upload an image as a project asset

`POST /v1/video-projects/{projectId}/assets/upload`

## Request

- Base URL: `https://api.neume.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.neume.io/v1/video-projects/{projectId}/assets/upload`
- Auth: none declared

## Path parameters

- `projectId` string, required

## Response `201`

- VideoProjectAssetDto
  - `videoProjectAssetId` string, required: Asset ID
  - `type` string, required: Asset type: IMAGE | VIDEO | AUDIO
  - `name` string: Asset name
  - `prompt` string: Prompt
  - `status` 'PENDING' | 'STARTING' | 'QUEUED' | 'PROCESSING' | 'COMPLETED' | 'FAILED', required: Generation status
  - `activeVersionId` string: Active version ID
  - `videoGenType` string: Video generation type
  - `sourceAssetId` string: Source image asset ID
  - `endFrameAssetId` string: End frame asset ID
  - `sourceImageUrl` string: Source image signed URL
  - `endFrameUrl` string: End frame signed URL
  - `motionVideoUrl` string: Motion video signed URL
  - `sourceImagePath` string: Source image S3 path
  - `endFramePath` string: End frame S3 path
  - `motionVideoPath` string: Motion video S3 path
  - `versions` VideoProjectAssetVersionDto[], required: Versions
    - `videoProjectAssetVersionId` string, required: Version ID
    - `versionNumber` number, required: Version number
    - `url` string, required: Asset URL (image, video, or audio)
    - `thumbnailUrl` string: Thumbnail URL (video assets)
    - `duration` number: Duration in seconds (video/audio)
    - `prompt` string: Prompt used for this version
    - `parentVersionId` string: Parent version ID
    - `source` string, required: Source: upload | generate | ai-edit
    - `createdAt` string, date-time, required: Creation date
  - `createdAt` string, date-time, required: Creation date

---

[API](https://skmtc.dev/neume/apis/neume-api.md) · [All operations](https://skmtc.dev/neume/apis/neume-api/llms.txt) · [OpenAPI document](https://skmtc.dev/neume/apis/neume-api/revisions/ddfaa546b0be?raw)