Skip to main content
Core concepts

File uploads

Upload images, video, or audio for use as model input.

Use a presigned upload URL when your input media is not already available through a public HTTPS URL.

#1. Create an upload URL

bash
UPLOAD=$(curl --silent --show-error --fail-with-body \
  --request POST \
  --url https://api.higgsfield.ai/files/generate-upload-url \
  --header "Authorization: Key ${HF_API_KEY_ID}:${HF_API_KEY_SECRET}" \
  --header "Content-Type: application/json" \
  --data '{"content_type":"image/jpeg"}')

echo "$UPLOAD" | jq

The upload URL expires after one hour.

#2. Upload the file

Send the file to upload_url with every header returned in upload_headers.

bash
curl --request PUT \
  --url "$(echo "$UPLOAD" | jq --raw-output '.upload_url')" \
  --header "Content-Type: $(echo "$UPLOAD" | jq --raw-output '.upload_headers["Content-Type"]')" \
  --header "x-amz-tagging: $(echo "$UPLOAD" | jq --raw-output '.upload_headers["x-amz-tagging"]')" \
  --upload-file ./input.jpg

Do not send Higgsfield API credentials to the presigned storage URL.

#3. Use the public URL

Pass public_url in the model parameter that accepts an input URL, such as image_url, video_url, or audio_url.

#Supported content types

  • image/jpeg, image/jpg, image/png, image/webp, image/gif
  • audio/wav, audio/x-wav
  • video/mp4

The content type used for the upload must match the value used to create the presigned URL.

Was this page helpful?
Navigation