--- type: AI Model id: boogu-image title: Boogu Image API provider: Boogu description: AI-powered text-to-image generation by Boogu. resource: https://www.pixazo.ai/models/boogu-image docs_url: https://www.pixazo.ai/models/boogu-image trending: true latest_version: 1.0 tags: - trends - text-to-image - image-to-image - image-editing - boogu variants: - id: boogu-image-v1 name: Boogu Image v1 version: 1.0 capabilities: - Text to Image - Image to Image (Image Editing) timestamp: 2026-06-21T18:51:47.052Z --- # Boogu Image API > Provider: **Boogu** > Source: https://www.pixazo.ai/models/boogu-image AI-powered text-to-image generation by Boogu. ## Boogu Image v1 ### Text to Image ## Base URL ``` https://gateway.pixazo.ai/boogu-image/v1/boogu-image-request ``` ## Authentication All requests require an API key passed via header. Header Type Required Description Ocp-Apim-Subscription-Key string Yes Your API subscription key ## Boogu Image generate request ## Request Code HTTP Python JavaScript cURL ``` POST https://gateway.pixazo.ai/boogu-image/v1/boogu-image-request Content-Type: application/json Cache-Control: no-cache Ocp-Apim-Subscription-Key: YOUR_API_KEY { "prompt": "A serene Japanese tea garden at dusk with stone lanterns lighting a winding path", "negative_prompt": "", "image_size": "square_hd", "num_inference_steps": 30, "guidance_scale": 4, "cfg_range_start": 0, "cfg_range_end": 1, "num_images": 1, "output_format": "jpeg", "enable_safety_checker": true, "sync_mode": false } ``` ``` import requests url = "https://gateway.pixazo.ai/boogu-image/v1/boogu-image-request" headers = { "Content-Type": "application/json", "Cache-Control": "no-cache", "Ocp-Apim-Subscription-Key": "YOUR_API_KEY" } data = { "prompt": "A serene Japanese tea garden at dusk with stone lanterns lighting a winding path", "negative_prompt": "", "image_size": "square_hd", "num_inference_steps": 30, "guidance_scale": 4, "cfg_range_start": 0, "cfg_range_end": 1, "num_images": 1, "output_format": "jpeg", "enable_safety_checker": true, "sync_mode": false } response = requests.post(url, json=data, headers=headers) print(response.json()) ``` ``` const url = "https://gateway.pixazo.ai/boogu-image/v1/boogu-image-request"; const headers = { "Content-Type": "application/json", "Cache-Control": "no-cache", "Ocp-Apim-Subscription-Key": "YOUR_API_KEY" }; const data = { "prompt": "A serene Japanese tea garden at dusk with stone lanterns lighting a winding path", "negative_prompt": "", "image_size": "square_hd", "num_inference_steps": 30, "guidance_scale": 4, "cfg_range_start": 0, "cfg_range_end": 1, "num_images": 1, "output_format": "jpeg", "enable_safety_checker": true, "sync_mode": false }; fetch(url, { method: "POST", headers: headers, body: JSON.stringify(data) }) .then(response => response.json()) .then(data => console.log(data)); ``` ``` curl -X POST "https://gateway.pixazo.ai/boogu-image/v1/boogu-image-request" \ -H "Content-Type: application/json" \ -H "Cache-Control: no-cache" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ --data-raw '{ "prompt": "A serene Japanese tea garden at dusk with stone lanterns lighting a winding path", "negative_prompt": "", "image_size": "square_hd", "num_inference_steps": 30, "guidance_scale": 4, "cfg_range_start": 0, "cfg_range_end": 1, "num_images": 1, "output_format": "jpeg", "enable_safety_checker": true, "sync_mode": false }' ``` ## Output ``` { "request_id": "boogu-image_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "status": "QUEUED", "polling_url": "https://gateway.pixazo.ai/v2/requests/status/boogu-image_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" } ``` [Try Now](https://api.pixazo.ai/api-details#api=boogu-image&operation=boogu-image-request) ## Webhook (Optional) Add the `X-Webhook-URL` header to your generate request to receive a POST callback instead of polling. ``` X-Webhook-URL: https://your-server.com/webhook/callback ``` ## Request Parameters - Boogu Image generate request Parameter Required Type Default Allowed values / range Description prompt Yes string — — Instruction describing the image to generate. Supports bilingual input (e.g., English and Chinese). negative\_prompt No string "" — Description of elements that should NOT appear in the generated image. image\_size No string or object "square\_hd" "square\_hd", "square", "portrait\_4\_3", "portrait\_16\_9", "landscape\_4\_3", "landscape\_16\_9", or {width, height} Preset aspect ratios: square\_hd, square, portrait\_4\_3, portrait\_16\_9, landscape\_4\_3, landscape\_16\_9. Alternatively, provide a custom object with width and height keys. num\_inference\_steps No integer 30 20–50 Number of denoising steps. Valid range: 20–50. Higher values improve quality at the cost of speed. guidance\_scale No float 4 1–8 How closely the generation follows the prompt. Valid range: 1–8. Higher values increase prompt adherence but may reduce diversity. cfg\_range\_start No float 0 0–1 Start of the timestep fraction over which Classifier-Free Guidance (CFG) is applied. cfg\_range\_end No float 1 0–1 End of the timestep fraction over which Classifier-Free Guidance (CFG) is applied. num\_images No integer 1 1–4 Number of images to generate. Valid range: 1–4. output\_format No string "jpeg" "jpeg", "png" Output image format. Allowed values: jpeg, png. enable\_safety\_checker No boolean true — Enables NSFW content filtering. Set to false to disable. seed No integer — — Random seed for reproducible results. If omitted, a random seed is used. sync\_mode No boolean false — If true, returns the generated image(s) as base64-encoded data URIs inline in the response. If false, returns a request\_id for async polling. ## Example Request ``` { "prompt": "A serene Japanese tea garden at dusk with stone lanterns lighting a winding path", "negative_prompt": "", "image_size": "square_hd", "num_inference_steps": 30, "guidance_scale": 4, "cfg_range_start": 0, "cfg_range_end": 1, "num_images": 1, "output_format": "jpeg", "enable_safety_checker": true, "sync_mode": false } ``` ## Response ``` { "request_id": "boogu-image_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "status": "QUEUED", "polling_url": "https://gateway.pixazo.ai/v2/requests/status/boogu-image_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" } ``` ## Request Headers Header Value Content-Type application/json Cache-Control no-cache Ocp-Apim-Subscription-Key YOUR\_API\_KEY ## Response Handling Common status codes. Code Meaning 202 Accepted — Request queued 400 Bad Request 401 Unauthorized 402 Insufficient Balance 403 Forbidden 429 Too Many Requests 500 Internal Server Error ## Error Responses Queue system errors and model validation errors. ### Queue System Errors ``` // 402 — Insufficient balance { "error": "Insufficient Balance", "message": "Your wallet does not have enough balance." } ``` ``` // 400 — Model not found { "error": "Model not found", "message": "Model 'boogu-image' not found or is disabled" } ``` ### Error via Status/Webhook ``` { "request_id": "boogu-image_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "status": "ERROR", "model_id": "boogu-image", "error": "Description of the error", "output": null } ``` ## Retrieving Results Poll the universal status endpoint to check progress and retrieve results. ### Endpoint ``` GET https://gateway.pixazo.ai/v2/requests/status/{request_id} Ocp-Apim-Subscription-Key: YOUR_API_KEY ``` ## cURL Example ``` curl -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ "https://gateway.pixazo.ai/v2/requests/status/boogu-image_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" ``` ## Response (Completed) ``` { "request_id": "boogu-image_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "status": "COMPLETED", "model_id": "boogu-image", "error": null, "output": { "media_url": ["https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/boogu-image_019dxxxx/output.jpeg"], "media_type": "image/jpeg" }, "created_at": "2026-03-31T10:00:00.000Z", "updated_at": "2026-03-31T10:00:15.000Z", "completed_at": "2026-03-31T10:00:15.000Z" } ``` ## Response Fields Field Type Description request\_id string Unique request identifier status string QUEUED, PROCESSING, COMPLETED, FAILED, or ERROR model\_id string Model that processed the request error string|null Error message if failed output.media\_url array URLs to generated media (R2 CDN) output.media\_type string MIME type of the output created\_at string When request was created completed\_at string When request completed polling\_url string Status URL (initial response only) ## Status Values Status Description QUEUED Request accepted, waiting to be processed PROCESSING Being processed by the model COMPLETED Done — output contains the result FAILED Failed — check error field ERROR System error — not charged ## Status Flow ``` QUEUED → PROCESSING → COMPLETED → FAILED → ERROR ``` ## Typical Workflow 1. **Send a generate request** to the API endpoint 2. **Save the `request_id`** from the response 3. **Poll** every 5-10 seconds: `GET /v2/requests/status/{request_id}` 4. **When `status` is `"COMPLETED"`**, download from `output.media_url` **Tip:** Use `X-Webhook-URL` header to get a callback instead of polling. ### Image to Image (Image Editing) ## Base URL ``` https://gateway.pixazo.ai/boogu-image-edit/v1/boogu-image-edit-request ``` ## Authentication All requests require an API key passed via header. Header Type Required Description Ocp-Apim-Subscription-Key string Yes Your API subscription key ## Boogu Image Edit generate request ## Request Code HTTP Python JavaScript cURL ``` POST https://gateway.pixazo.ai/boogu-image-edit/v1/boogu-image-edit-request Content-Type: application/json Cache-Control: no-cache Ocp-Apim-Subscription-Key: YOUR_API_KEY { "prompt": "Change the background to a snowy mountain landscape at golden hour", "image_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/Image.jpeg", "negative_prompt": "", "num_images": 1, "num_inference_steps": 30, "guidance_scale": 4, "image_guidance_scale": 1, "cfg_range_start": 0, "cfg_range_end": 1, "output_format": "jpeg", "enable_safety_checker": true, "sync_mode": false } ``` ``` import requests url = "https://gateway.pixazo.ai/boogu-image-edit/v1/boogu-image-edit-request" headers = { "Content-Type": "application/json", "Cache-Control": "no-cache", "Ocp-Apim-Subscription-Key": "YOUR_API_KEY" } data = { "prompt": "Change the background to a snowy mountain landscape at golden hour", "image_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/Image.jpeg", "negative_prompt": "", "num_images": 1, "num_inference_steps": 30, "guidance_scale": 4, "image_guidance_scale": 1, "cfg_range_start": 0, "cfg_range_end": 1, "output_format": "jpeg", "enable_safety_checker": true, "sync_mode": false } response = requests.post(url, json=data, headers=headers) print(response.json()) ``` ``` const url = "https://gateway.pixazo.ai/boogu-image-edit/v1/boogu-image-edit-request"; const headers = { "Content-Type": "application/json", "Cache-Control": "no-cache", "Ocp-Apim-Subscription-Key": "YOUR_API_KEY" }; const data = { "prompt": "Change the background to a snowy mountain landscape at golden hour", "image_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/Image.jpeg", "negative_prompt": "", "num_images": 1, "num_inference_steps": 30, "guidance_scale": 4, "image_guidance_scale": 1, "cfg_range_start": 0, "cfg_range_end": 1, "output_format": "jpeg", "enable_safety_checker": true, "sync_mode": false }; fetch(url, { method: "POST", headers: headers, body: JSON.stringify(data) }) .then(response => response.json()) .then(data => console.log(data)); ``` ``` curl -X POST "https://gateway.pixazo.ai/boogu-image-edit/v1/boogu-image-edit-request" \ -H "Content-Type: application/json" \ -H "Cache-Control: no-cache" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ --data-raw '{ "prompt": "Change the background to a snowy mountain landscape at golden hour", "image_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/Image.jpeg", "negative_prompt": "", "num_images": 1, "num_inference_steps": 30, "guidance_scale": 4, "image_guidance_scale": 1, "cfg_range_start": 0, "cfg_range_end": 1, "output_format": "jpeg", "enable_safety_checker": true, "sync_mode": false }' ``` ## Output ``` { "request_id": "boogu-image-edit_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "status": "QUEUED", "polling_url": "https://gateway.pixazo.ai/v2/requests/status/boogu-image-edit_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" } ``` [Try Now](https://api.pixazo.ai/api-details#api=boogu-image-edit&operation=boogu-image-edit-request) ## Webhook (Optional) Add the `X-Webhook-URL` header to your generate request to receive a POST callback instead of polling. ``` X-Webhook-URL: https://your-server.com/webhook/callback ``` ## Request Parameters - Boogu Image Edit generate request Parameter Required Type Default Allowed values / range Description prompt Yes string — — Edit instruction describing how to transform the input image. Must be descriptive and specific for best results. image\_url Yes string — — URL of the input image. Supported formats: JPG, PNG, WebP, GIF, AVIF. negative\_prompt No string "" — Text describing elements that should NOT appear in the edited image. Use to exclude unwanted objects, styles, or artifacts. image\_size No string or object "square\_hd" "square\_hd", "square", "portrait\_4\_3", "portrait\_16\_9", "landscape\_4\_3", "landscape\_16\_9", or custom {width, height} Preset aspect ratios: square\_hd, square, portrait\_4\_3, portrait\_16\_9, landscape\_4\_3, landscape\_16\_9. Alternatively, provide a custom object with width and height integers. num\_images No integer 1 1–4 Number of images to generate. Allowed range: 1–4. num\_inference\_steps No integer 30 20–50 Number of denoising steps during generation. Higher values improve quality at the cost of speed. guidance\_scale No float 4 1–8 Strength of prompt adherence. Higher values make output more aligned with the prompt. image\_guidance\_scale No float 1 1–8 Controls how closely the output follows the input image. Higher values preserve more input structure. cfg\_range\_start No float 0 0–1 Start of the timestep fraction over which Classifier-Free Guidance (CFG) is applied. cfg\_range\_end No float 1 0–1 End of the timestep fraction over which Classifier-Free Guidance (CFG) is applied. output\_format No string "jpeg" "jpeg", "png" Output image format. enable\_safety\_checker No boolean true — Enables NSFW content filtering. Set to false to disable. seed No integer — — Random seed for reproducible results. If omitted, a random seed is used. sync\_mode No boolean false — If true, returns the generated image(s) as base64-encoded data URIs inline in the response. If false, returns a request\_id for asynchronous polling. ## Example Request ``` { "prompt": "Change the background to a snowy mountain landscape at golden hour", "image_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/Image.jpeg", "negative_prompt": "", "num_images": 1, "num_inference_steps": 30, "guidance_scale": 4, "image_guidance_scale": 1, "cfg_range_start": 0, "cfg_range_end": 1, "output_format": "jpeg", "enable_safety_checker": true, "sync_mode": false } ``` ## Response ``` { "request_id": "boogu-image-edit_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "status": "QUEUED", "polling_url": "https://gateway.pixazo.ai/v2/requests/status/boogu-image-edit_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" } ``` ## Request Headers Header Value Content-Type application/json Cache-Control no-cache Ocp-Apim-Subscription-Key YOUR\_API\_KEY ## Response Handling Common status codes. Code Meaning 202 Accepted — Request queued 400 Bad Request 401 Unauthorized 402 Insufficient Balance 403 Forbidden 429 Too Many Requests 500 Internal Server Error ## Error Responses Queue system errors and model validation errors. ### Queue System Errors ``` // 402 — Insufficient balance { "error": "Insufficient Balance", "message": "Your wallet does not have enough balance." } ``` ``` // 400 — Model not found { "error": "Model not found", "message": "Model 'boogu-image-edit' not found or is disabled" } ``` ### Error via Status/Webhook ``` { "request_id": "boogu-image-edit_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "status": "ERROR", "model_id": "boogu-image-edit", "error": "Description of the error", "output": null } ``` ## Retrieving Results Poll the universal status endpoint to check progress and retrieve results. ### Endpoint ``` GET https://gateway.pixazo.ai/v2/requests/status/{request_id} Ocp-Apim-Subscription-Key: YOUR_API_KEY ``` ## cURL Example ``` curl -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ "https://gateway.pixazo.ai/v2/requests/status/boogu-image-edit_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" ``` ## Response (Completed) ``` { "request_id": "boogu-image-edit_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "status": "COMPLETED", "model_id": "boogu-image-edit", "error": null, "output": { "media_url": ["https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/boogu-image-edit_019dxxxx/output.jpeg"], "media_type": "image/jpeg" }, "created_at": "2026-03-31T10:00:00.000Z", "updated_at": "2026-03-31T10:00:15.000Z", "completed_at": "2026-03-31T10:00:15.000Z" } ``` ## Response Fields Field Type Description request\_id string Unique request identifier status string QUEUED, PROCESSING, COMPLETED, FAILED, or ERROR model\_id string Model that processed the request error string|null Error message if failed output.media\_url array URLs to generated media (R2 CDN) output.media\_type string MIME type of the output created\_at string When request was created completed\_at string When request completed polling\_url string Status URL (initial response only) ## Status Values Status Description QUEUED Request accepted, waiting to be processed PROCESSING Being processed by the model COMPLETED Done — output contains the result FAILED Failed — check error field ERROR System error — not charged ## Status Flow ``` QUEUED → PROCESSING → COMPLETED → FAILED → ERROR ``` ## Typical Workflow 1. **Send a generate request** to the API endpoint 2. **Save the `request_id`** from the response 3. **Poll** every 5-10 seconds: `GET /v2/requests/status/{request_id}` 4. **When `status` is `"COMPLETED"`**, download from `output.media_url` **Tip:** Use `X-Webhook-URL` header to get a callback instead of polling.