1. Get your API key from API Keys
2. Make your first request:
curl -X POST https://dreamforgex.ai/api/v1/generate \
-H "Authorization: Bearer df_your_api_key" \
-H "Idempotency-Key: 114bdd89-cd2b-4b77-8ad3-857220ed45ed" \
-H "Content-Type: application/json" \
-d '{"prompt": "A beautiful sunset over mountains"}'Use a new UUID in Idempotency-Key for each new generation. Retry the same prompt, model and dimensions with the same UUID to retrieve the original attempt. A pending request returns HTTP 202 with Retry-After; a UUID reused for different inputs returns HTTP 409. Requests without this header receive a new UUID in the response and cannot recover it after a lost response.
All authenticated endpoints require a Bearer token in the Authorization header:
/api/v1/generate AuthGenerate an image from a text prompt
{
"prompt": "A serene mountain landscape at sunset",
"width": 1024,
"height": 1024,
"model": "auto"
}/api/v1/tools/upscale AuthUpscale an image to higher resolution
{
"imageUrl": "https://example.com/image.png",
"scale": 2
}/api/v1/tools/style-transfer AuthApply an artistic style to an image
{
"imageUrl": "https://example.com/image.png",
"style": "watercolor"
}/api/v1/tools/background-remove AuthRemove or replace image background
{
"imageUrl": "https://example.com/image.png",
"replacement": "A tropical beach at sunset"
}/api/v1/prompt/improve AuthImprove a prompt using AI
{
"prompt": "a cat",
"style": "cinematic",
"mood": "dramatic"
}/api/v1/modelsList available generation models
npm install dreamforge-sdkComing Soonpip install dreamforgeComing SoonUse any HTTP client
Available Now