DF-Imagen API Documentation

URLs

(Both of these endoints have the same options, and support all the features of the other.)

All requests require an API key via the key query parameter:

key=df-imagen_<your_key_here>

Keep your key secret. Do not share publicly.

Method: GET (via URL query parameters)
Description: Generates an AI image using the Flux model. Each generation takes ~10 seconds. The response is the generated image itself, not JSON.

Parameter	Required	Description
key	Yes	Your API key (`df-imagen_<your_key>`)
prompt	Yes	Text description of the image
width	No	Image width in pixels (default 512)
height	No	Image height in pixels (default 512)

https://imagen.dreamframe.workers.dev/?key=df-imagen_3f9a8c1d2b&prompt=delicious%20salad%20with%20lettuce,%20and%20onions

https://imagen.dreamframe.workers.dev/?key=df-imagen_3f9a8c1d2b&prompt=delicious%20salad&width=1024&height=768

Note: The response will be the image file itself. Once downloaded, it will no longer be accessible via the same request.

Code	Meaning
401	Invalid or missing API key
400	Bad request / missing parameters
500	Internal server error

Retry Errors:

If you receive an internal server error/unknown error, try changing the prompt by adding or removing a character or more.
If the error persists after changing the prompt, contact support.

⚠️ Avoid repeated retries in a short time to prevent overloading the server.

Parameter	Description
width	Override image width (default 512)
height	Override image height (default 512)