Skip to main content
POST
/
v1
/
images
/
generations
Creates an image given a prompt.
curl --request POST \
  --url https://api.galadriel.com/v1/images/generations \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "dall-e-3",
  "n": 1,
  "prompt": "a red apple",
  "quality": "standard",
  "response_format": "url",
  "size": "1024x1024",
  "style": "vivid",
  "user": "user123"
}
'
{
    "created": 1,
    "data": [
        {
            "b64_json": null,
            "revised_prompt": null,
            "url": "https://example.com/image"
        }
    ]
}

{
    "created": 1,
    "data": [
        {
            "b64_json": null,
            "revised_prompt": null,
            "url": "https://example.com/image"
        }
    ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header.

example value: Bearer Galadriel-API-key

Get API key from Galadriel dashboard.

Body

application/json
​
prompt
string
required

text description of the desired image(s).

​
model
string
required

The model to use for image generation.

​
n
integer
default:1

The number of images to generate. Must be between 1 and 10.

Required range: 1 <= x <= 10
​
quality
enum<string>
default:standard

The quality of the image that will be generated.

Available options:
standard,
hd
​
response_format
enum<string>
default:url

The format in which the generated images are returned.

Available options:
url,
b64_json
​
size
enum<string>
default:1024x1024

The size of the generated images.

Available options:
256x256,
512x512,
1024x1024
​
style
enum<string>
default:vivid

The style of the generated images.

Available options:
vivid,
natural
​
user
string | null

A unique identifier representing your end-user

Response

Returns a list of image objects.

​
created
integer
required
​
data
Image · object[]
required