Skip to main content
POST
Generates a batch of images from a text caption on a given DALLE model deployment
Choose an exact compatible ID from the model list. Supported parameters and output formats vary by model and connection; this schema does not guarantee every upstream feature. See endpoint availability.

Authorizations

api-key
string
header
required

Your Hicap API key.

Headers

x-hicap-tags
string

One JSON object mapping dimension keys to short string values. Never include secrets or direct personal identifiers. Opaque identity references require approved policy and verified destination handling; see the identity attribution guide.

Body

application/json
prompt
string
required

Describe the image to generate. Prompt limits depend on the selected model.

Minimum string length: 1
Example:

"A corgi in a field"

model
string
required

Exact compatible Hicap model ID from GET /v1/models.

Minimum string length: 1
n
integer

Requested image count. Supported counts depend on the model.

Required range: x >= 1
size
string

A size value supported by the selected image model. Confirm supported values before use.

response_format
string

A response format value supported by the selected image model. Confirm supported values before use.

user
string<string>

A unique identifier representing your end-user, which can help to monitor and detect abuse.

Example:

"user123456"

quality
string

A quality value supported by the selected image model. Confirm supported values before use.

style
string

A style value supported by the selected image model. Confirm supported values before use.

Response

Ok

created
integer<unixtime>
required

The unix timestamp when the operation was created.

Example:

"1676540381"

data
object[]
required

The result data of the operation, if successful