FluxMediaFluxMedia

FluxMedia External API

API Integration Guide

Image API reference for server-side integrations. This page lists only compatible parameters and omits FluxMedia-specific extension parameters.

Base URL

https://gpt2image.superapi.buzz

Authentication

Authorization: Bearer <API_KEY>

Endpoint reference

01POST/v1/images/generationsimage_generation

Text-to-image API

Create image

Generate images from a text prompt using an OpenAI Images generation-compatible request.

application/json

Request example

BASH
curl https://gpt2image.superapi.buzz/v1/images/generations \  -H "Authorization: Bearer $FLUXMEDIA_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "gpt-image-2",    "prompt": "A quiet reading room in the morning sun",    "n": 1,    "size": "1024x1024",    "quality": "medium",    "response_format": "url",    "output_format": "png",    "background": "auto"  }'

Response example

JSON
{  "created": 1713833628,  "data": [    {      "url": "https://gpt2image.superapi.buzz/api/storage/generations/...",      "revised_prompt": "..."    }  ]}

Request parameters

promptRequiredDefault:—Image prompt, up to 32,000 characters.
modelRequiredDefault:—Image model ID available to the current API key.
nOptionalDefault:1Number of images, within the current plan's batch limit.
sizeOptionalDefault:1024x1024Target image size, for example 1024x1024.
qualityOptionalDefault:autoauto, low, medium, or high.
moderationOptionalDefault:autoauto or low, forwarded as an upstream image parameter.
response_formatOptionalDefault:b64_jsonurl or b64_json; defaults to b64_json.
output_formatOptionalDefault:Unset (upstream decides)png, jpeg, or webp.
output_compressionOptionalDefault:Unset (upstream decides)Controls the output image compression level from 0 to 100. Higher values apply stronger compression, typically producing smaller files with more quality loss; 0 means no compression and 100 means maximum compression. It only applies when output_format is jpeg or webp, and exact results may vary by upstream provider.
backgroundOptionalDefault:Unset (upstream decides)transparent, opaque, or auto; support depends on the model.
streamOptionalDefault:falseReturn an event stream when true or when Accept is text/event-stream.

Response fields

createdUnix timestamp in seconds.
data[].b64_json / data[].urlBase64 image or image URL selected by response_format.
data[].revised_promptThe upstream revised prompt, when available.
SSE image_generation.partial_imagePartial image event in streaming mode.
SSE image_generation.completedSignals that one image has completed in streaming mode.

Usage notes

  • response_format selects URL or base64 output; output_format selects the image file format.
  • Supported sizes, transparent backgrounds, and output formats vary by model.
02POST/v1/images/editsimage_edit

Image-to-image API

Edit image

Edit one or more input images from a prompt using an OpenAI Images edit-compatible request.

multipart/form-data 或 application/json

Request example

BASH
curl https://gpt2image.superapi.buzz/v1/images/edits \  -H "Authorization: Bearer $FLUXMEDIA_API_KEY" \  -F "model=gpt-image-2" \  -F "prompt=Replace the sky with a clear sunset" \  -F "image=@./input.png" \  -F "size=1024x1024" \  -F "quality=medium" \  -F "response_format=url"

Response example

JSON
{  "created": 1713833628,  "data": [    {      "url": "https://gpt2image.superapi.buzz/api/storage/generations/...",      "revised_prompt": "..."    }  ]}

Request parameters

promptRequiredDefault:—Edit prompt, up to 32,000 characters.
image / image[] / image_*Required for multipartDefault:—Uploaded image files, up to 16 images.
imagesRequired for JSONDefault:—Image reference array in a JSON request.
maskOptionalDefault:NoneMask image whose transparent area indicates the edit region.
modelRequiredDefault:—Image model ID available to the current API key.
nOptionalDefault:1Number of images, within the current plan's batch limit.
sizeOptionalDefault:1024x1024Target image size, for example 1024x1024.
qualityOptionalDefault:autoauto, low, medium, or high.
moderationOptionalDefault:autoauto or low, forwarded as an upstream edit parameter.
response_formatOptionalDefault:b64_jsonurl or b64_json; defaults to b64_json.
output_formatOptionalDefault:Unset (upstream decides)png, jpeg, or webp.
output_compressionOptionalDefault:Unset (upstream decides)Controls the output image compression level from 0 to 100. Higher values apply stronger compression, typically producing smaller files with more quality loss; 0 means no compression and 100 means maximum compression. It only applies when output_format is jpeg or webp, and exact results may vary by upstream provider.
backgroundOptionalDefault:Unset (upstream decides)transparent, opaque, or auto; support depends on the model.
streamOptionalDefault:falseReturn an event stream when true or when Accept is text/event-stream.

Response fields

createdUnix timestamp in seconds.
data[].b64_json / data[].urlBase64 image or image URL selected by response_format.
data[].revised_promptThe upstream revised prompt, when available.
SSE image_edit.partial_imagePartial image event in streaming mode.
SSE image_edit.completedSignals that one image edit has completed in streaming mode.

Usage notes

  • Use multipart/form-data for direct file uploads; JSON requests pass image references through images.
  • The mask dimensions should match the input image.
03GET/v1/images/{task_id}image_generation

Asynchronous image task

Get image task

Get image generation status and results by task ID.

无请求体

Request example

BASH
curl https://gpt2image.superapi.buzz/v1/images/task_... \  -H "Authorization: Bearer $FLUXMEDIA_API_KEY"

Response example

JSON
{  "id": "task_...",  "object": "image",  "status": "completed",  "created": 1713833628,  "created_at": "2026-05-28T00:00:00.000Z",  "completed": 1713833700,  "completed_at": "2026-05-28T00:01:12.000Z",  "data": [    {      "url": "https://gpt2image.superapi.buzz/api/storage/generations/..."    }  ]}

Request parameters

AuthorizationRequired headerDefault:—Bearer <API_KEY>.
task_idRequired path parameterDefault:—Image task ID corresponding to {task_id} in the request path.

Response fields

idImage task ID.
objectTask object type.
statusprocessing, needs_attention, completed, or failed.
data[].b64_json / data[].urlImage results returned after completion.
created / created_at / completed / completed_atCreation and completion times; completion fields are absent while running.

Usage notes

  • Only tasks created by the user who owns the current API key can be queried.
  • A running task has status processing. A failed task includes the reason in error.message.