FluxMediaFluxMedia

FluxMedia External API

API 接入文档

面向服务端集成的图像接口参考。这里仅展示通用兼容参数，不包含 FluxMedia 站点扩展参数。

Base URL

https://gpt2image.superapi.buzz

鉴权

Authorization: Bearer <API_KEY>

接口详情

01POST/v1/images/generationsimage_generation

外部文生图 API

创建图片

根据文本提示词生成图片，兼容 OpenAI Images generation 请求形态。

application/json

请求示例

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"  }'

响应示例

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

请求参数

prompt必填默认值:—图片提示词，最多 32000 字符。
model必填默认值:—图片模型 ID；可用模型以当前 API 密钥可见范围为准。
n可选默认值:1生成数量，须在当前套餐允许的批量范围内。
size可选默认值:1024x1024目标图片尺寸，例如 1024x1024。
quality可选默认值:autoauto、low、medium 或 high。
moderation可选默认值:autoauto 或 low，作为上游图像生成参数传递。
response_format可选默认值:b64_jsonurl 或 b64_json；默认返回 b64_json。
output_format可选默认值:未指定（上游决定）png、jpeg 或 webp。
output_compression可选默认值:未指定（上游决定）控制输出图片的压缩级别，取值 0 到 100：数值越大，压缩力度越大，通常文件越小、画质损失越明显；0 表示不压缩，100 表示最大压缩。仅在 output_format 为 jpeg 或 webp 时生效，不同上游的实际压缩结果可能略有差异。
background可选默认值:未指定（上游决定）transparent、opaque 或 auto；透明能力取决于模型。
stream可选默认值:false设为 true 或请求 Accept: text/event-stream 时返回事件流。

响应字段

createdUnix 秒时间戳。
data[].b64_json / data[].url按 response_format 返回 base64 图片或图片 URL。
data[].revised_prompt上游返回的改写提示词；没有改写时可能缺省。
SSE image_generation.partial_image流式模式下返回的局部图片事件。
SSE image_generation.completed流式模式下表示单张图片已完成。

使用说明

  • response_format 控制返回 URL 或 base64，output_format 控制图片文件格式。
  • 不同模型对尺寸、透明背景和输出格式的支持范围可能不同。
02POST/v1/images/editsimage_edit

外部图生图 API

编辑图片

根据提示词编辑一张或多张输入图片，兼容 OpenAI Images edit 请求形态。

multipart/form-data 或 application/json

请求示例

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"

响应示例

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

请求参数

prompt必填默认值:—编辑提示词，最多 32000 字符。
image / image[] / image_*multipart 必填默认值:—上传图片文件，最多 16 张。
imagesJSON 必填默认值:—JSON 请求中的图片引用数组。
mask可选默认值:无遮罩图片；透明区域表示需要编辑的范围。
model必填默认值:—图片模型 ID；可用模型以当前 API 密钥可见范围为准。
n可选默认值:1生成数量，须在当前套餐允许的批量范围内。
size可选默认值:1024x1024目标图片尺寸，例如 1024x1024。
quality可选默认值:autoauto、low、medium 或 high。
moderation可选默认值:autoauto 或 low，作为上游图像编辑参数传递。
response_format可选默认值:b64_jsonurl 或 b64_json；默认返回 b64_json。
output_format可选默认值:未指定（上游决定）png、jpeg 或 webp。
output_compression可选默认值:未指定（上游决定）控制输出图片的压缩级别，取值 0 到 100：数值越大，压缩力度越大，通常文件越小、画质损失越明显；0 表示不压缩，100 表示最大压缩。仅在 output_format 为 jpeg 或 webp 时生效，不同上游的实际压缩结果可能略有差异。
background可选默认值:未指定（上游决定）transparent、opaque 或 auto；透明能力取决于模型。
stream可选默认值:false设为 true 或请求 Accept: text/event-stream 时返回事件流。

响应字段

createdUnix 秒时间戳。
data[].b64_json / data[].url按 response_format 返回 base64 图片或图片 URL。
data[].revised_prompt上游返回的改写提示词；没有改写时可能缺省。
SSE image_edit.partial_image流式模式下返回的局部图片事件。
SSE image_edit.completed流式模式下表示单张图片编辑已完成。

使用说明

  • multipart/form-data 适合直接上传文件；JSON 请求使用 images 传入图片引用。
  • mask 的尺寸与输入图片应保持一致。
03GET/v1/images/{task_id}image_generation

外部异步图片任务

查询图片任务

按任务 ID 查询图片生成状态和结果。

无请求体

请求示例

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

响应示例

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/..."    }  ]}

请求参数

Authorization必填 header默认值:—Bearer <API_KEY>。
task_id必填路径参数默认值:—图片任务 ID，与请求路径中的 {task_id} 对应。

响应字段

id图片任务 ID。
object任务对象类型。
statusprocessing、needs_attention、completed 或 failed。
data[].b64_json / data[].url任务完成后返回的图片结果。
created / created_at / completed / completed_at任务创建与完成时间；未完成时不返回完成时间。

使用说明

  • 只能查询当前 API 密钥所属用户创建的任务。
  • 任务仍在执行时 status 为 processing，失败时 error.message 会给出原因。