Billing and retention
Understand charging, refunds, estimation, and output retention.
Higgsfield charges successful generation requests to your account balance. The exact cost depends on the selected model and parameters.
#Balance expiration
Funds added to your account balance expire one year after they are added. Plan purchases and usage with this expiration period in mind.
#Estimate a request
Use the estimate endpoint with the same model parameters before submitting generation:
curl --request POST \
--url https://api.higgsfield.ai/estimate/xai/grok-imagine-image-2.0 \
--header "Authorization: Key ${HF_API_KEY_ID}:${HF_API_KEY_SECRET}" \
--header "Content-Type: application/json" \
--data '{
"prompt": "Editorial portrait in soft daylight"
}'
{
"usd": "0.094"
}
Note
The values above illustrate the response format. Use the estimate returned for your authenticated account as the authoritative amount.
#Failed and moderated requests
Requests ending as failed or nsfw are not charged. If an amount was reserved when the request was accepted, it is refunded automatically.
#Canceled requests
A request can be canceled only before processing starts. A successfully canceled queued request is refunded.
#Output retention
Request files are kept for seven days after the request finishes, then deleted. The status response and the webhook include expires_at, the time of deletion. Download completed files to your own storage for long-term retention.
To keep data for less time, send the Hf-Expires-After header (one hour or more) or ask Higgsfield to set a retention period for your account. To remove a finished request immediately, call DELETE /requests/{request_id}. Billing records are kept in both cases. See Data retention and deletion.