How to Upload Files (API)

POST https://api.wavespeed.ai/api/v3/media/upload/binary

curl --fail-with-body --connect-timeout 10 --max-time 300 --request POST 'https://api.wavespeed.ai/api/v3/media/upload/binary' \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--form 'file=@"/path/to/your/image.png"'

{
  "code": 200,
  "message": "success",
  "data": {
    "type": "image",
    "download_url": "https://...",
    "filename": "image.png",
    "size": 1024000
  }
}

import os
import requests
 
api_key = os.environ["WAVESPEED_API_KEY"]
 
def upload_file(file_path):
    with open(file_path, 'rb') as f:
        response = requests.post(
            "https://api.wavespeed.ai/api/v3/media/upload/binary",
            headers={"Authorization": f"Bearer {api_key}"},
            files={"file": f},
            timeout=(10, 300),
        )
    response.raise_for_status()
    body = response.json()
    if body.get("code") != 200:
        raise RuntimeError(body.get("message", "Upload failed"))
    return body["data"]
 
# Upload an image
result = upload_file("/path/to/image.png")
print(f"Type: {result['type']}")
print(f"URL: {result['download_url']}")
print(f"Size: {result['size']} bytes")
 
# Use the URL in a model request
image_url = result['download_url']

async function uploadFile(file) {
    const apiKey = process.env.WAVESPEED_API_KEY;
    if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
    const formData = new FormData();
    formData.append('file', file);
 
    const response = await fetch('https://api.wavespeed.ai/api/v3/media/upload/binary', {
        method: 'POST',
        headers: {
            'Authorization': `Bearer ${apiKey}`
        },
        body: formData,
        signal: AbortSignal.timeout(300_000)
    });
 
    const body = await response.json();
    if (!response.ok || body.code !== 200) {
        throw new Error(body.message || `Upload failed with HTTP ${response.status}`);
    }
    return body.data;
}