Imagefrom$0.0050 / image

Soul (Higgsfield)

Generates images from text · up to 1080p · up to 4 per request

text-to-image

curl -X POST https://api.open.sume.com/v1/image-router/generate \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"higgsfield-soul","prompt":"A studio product photo on a white sweep","aspect_ratio":"1:1","resolution":"720p","num_images":1}'

1. Calling the API

Soul (Higgsfield) has the model id higgsfield-soul. Send a JSON body to POST https://api.open.sume.com/v1/image-router/generate.

Parameter	Type	Required	Default	Description
model	string	Yes	—	"higgsfield-soul"
prompt	string	Yes	—	What the image shows.
aspect_ratio	string	No	1:1	Frame shape. Options: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3.
resolution	string	No	720p	Output resolution. Options: 720p, 1080p.
num_images	integer	No	1	Images per request, 1–4.

2. Authentication

Send your open.sume.com key as a bearer token from server code only. Keys minted on open.sume.com bill this balance in dollars and call the model API only.

Authorization: Bearer $SUME_API_KEY

3. Queue

A submit answers 202 with the job, its status_url and result_url. Poll the status until it is completed, failed or canceled; failed and canceled jobs are refunded.

GET https://api.open.sume.com/v1/jobs/<job_id>/status
GET https://api.open.sume.com/v1/jobs/<job_id>/result
POST https://api.open.sume.com/v1/jobs/<job_id>/cancel

Pricing

Dollars per unit at each option: the serving route's cost × 1.25, rounded up to $0.0001. The estimate above is the exact charge.

Option	Price
720p	$0.0050 / image
1080p	$0.0075 / image

More models by Higgsfield

Price, resolution and duration show each model's full range.