Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.darkbloom.dev/llms.txt

Use this file to discover all available pages before exploring further.

POST /v1/images/generations generates images from a text prompt. The endpoint follows the OpenAI Images API format — you send a prompt and receive a response containing the generated image. Providers serving image generation run the image backend on Apple Silicon alongside the text inference process.

​
Request parameters

​
prompt
string
required
A text description of the image you want to generate.
​
n
number
default:"1"
The number of images to generate. Currently 1 is recommended.
​
size
string
default:"1024x1024"
The dimensions of the generated image. Supported values depend on the provider’s image backend configuration.

​
Examples

curl https://api.darkbloom.dev/v1/images/generations \
  -H "Authorization: Bearer eigeninference-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A neon-lit Apple Silicon chip floating in a dark ocean, cinematic, dramatic lighting",
    "n": 1,
    "size": "1024x1024"
  }'

​
Response

{
  "created": 1714500000,
  "data": [
    {
      "url": "https://..."
    }
  ]
}
​
created
number
Unix timestamp for when the image was generated.
​
data
object[]
Array of generated image objects.
Image generation is served by providers that have opted into running the image backend. Availability may be more limited than text inference. If no image providers are online, the request will queue and retry before returning an error.