How to Upload Files

Upload images, videos, and audio files for use as inputs to Get3W models.

Overview

Many models require file inputs (e.g., an image for image-to-video conversion). Get3W provides a file upload API that returns a URL you can use in subsequent API calls.

Upload via API

curl -X POST "https://api.get3w.com/api/v3/files/upload" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/image.png"

Response:

{
  "code": 200,
  "message": "success",
  "data": {
    "url": "https://cdn.get3w.com/uploads/abc123.png"
  }
}

Upload via Python SDK

import get3w

url = get3w.upload("/path/to/image.png")
print(url)

Upload via JavaScript SDK

const url = await client.upload("/path/to/image.png");
console.log(url);

Using Uploaded Files

Pass the returned URL as an input parameter:

curl -X POST "https://api.get3w.com/api/v3/get3w/wan-2.1-i2v-720p" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://cdn.get3w.com/uploads/abc123.png",
    "prompt": "A person walking through a field"
  }'

Supported Formats

Type	Formats	Max Size
Image	PNG, JPEG, WebP, GIF	20 MB
Video	MP4, WebM, MOV	100 MB
Audio	MP3, WAV, FLAC, M4A	50 MB

File Retention

Uploaded files are retained for 7 days. Re-upload files if needed after expiration.

Next Steps

• LoRA Training & Usage — Upload training images
• How to Create Video from Image — Use uploaded images