How to Upload Files

Upload files to Get3W for use as model inputs.

Endpoint

POST https://api.get3w.com/api/v3/files/upload

Request

Upload a file using multipart form data:

cURL

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

Python

import requests

with open("/path/to/image.png", "rb") as f:
    response = requests.post(
        "https://api.get3w.com/api/v3/files/upload",
        headers={"Authorization": "Bearer YOUR_API_KEY"},
        files={"file": f}
    )

url = response.json()["data"]["url"]
print(url)

JavaScript

const fs = require("fs");
const FormData = require("form-data");

const form = new FormData();
form.append("file", fs.createReadStream("/path/to/image.png"));

const response = await fetch("https://api.get3w.com/api/v3/files/upload", {
    method: "POST",
    headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        ...form.getHeaders()
    },
    body: form
});

const { data } = await response.json();
console.log(data.url);

Response

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

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 if needed after expiration.

Next Steps

• How to Submit Task — Use uploaded files as inputs
• LoRA Training — Upload training images