图像
https://api.tokenbay.me/v1/images/generations图片生成与图片编辑接口
图像路由当前走 OpenAI 平台编排链。
图像生成
/v1/images/generations请求
字段modelstringRequired可用图像生成模型 ID。
promptstringRequired图片生成提示词。
sizestringOptional输出尺寸；支持值取决于模型，例如 1024x1024、1024x1536、1536x1024、auto。
qualitystringOptional质量档位；支持值取决于模型，例如 auto、standard、hd、high、medium、low。
backgroundstringOptional背景设置；适用于支持透明或背景控制的模型，例如 auto、transparent、opaque。
nintegerOptional生成张数；支持上限取决于模型。
moderationstringOptional内容审核强度；支持情况按上游而定。
output_compressionintegerOptional输出压缩质量；通常用于 jpeg/webp。
response_format / output_formatstringOptional返回 URL、base64 或指定图片格式，如 png、jpeg、webp；支持情况按上游而定。
userstringOptional客户端侧用户标识；不要放入敏感数据。
响应
字段通常返回图片 URL 或 base64 数据；具体字段和格式由上游图像模型决定。
createdintegerOptional创建时间戳。
data[]array<object>Optional图片结果数组，可能包含 url、b64_json、revised_prompt 等字段。
图像编辑
/v1/images/edits请求
字段TokenBay 使用 model 进行路由，并读取 stream 处理响应方式。JSON 图片引用和 multipart 上传会转发给兼容的上游；multipart 的 Content-Type、boundary 和请求体字节保持不变。
modelstringRequired用于 TokenBay 路由的图像编辑模型。模型必须在已配置的 OpenAI 兼容图像编辑渠道中可用；可用性以控制台或 Models API 的实时结果为准。
image / imagesfile | file[] | array<object>Required
待编辑图片。multipart 请求使用 image 或重复的 image[] / image[n] 文件字段；JSON 请求在上游支持时使用 images[]，每项可包含 image_url 或 file_id。具体格式和限制由所选上游模型决定。
images[].image_urlstringOptional上游支持时使用的完整图片 URL 或 data URL。
images[].file_idstringOptional上游支持时使用的已上传文件 ID。
promptstringRequired描述所需编辑效果的提示词；长度和内容限制由所选上游模型决定。
maskfile | objectOptional
可选的局部重绘蒙版。multipart 使用文件，JSON 在上游支持时使用包含 image_url 或 file_id 的对象；格式、尺寸、透明语义和大小限制由所选上游模型决定。
mask.image_urlstringOptional上游支持时使用的蒙版 URL 或 data URL。
mask.file_idstringOptional上游支持时使用的已上传蒙版文件 ID。
sizestringOptional请求的输出尺寸。可选值由所选上游模型决定，例如 auto 或模型支持的宽高值；TokenBay 不对该值做统一校验。
streambooleanOptional设为 true 请求流式响应。上游原生 SSE 会透传；上游成功返回完整 JSON 时，网关会将其包装为 text/event-stream。
响应
字段非流式成功响应通常采用 OpenAI 兼容的图像响应结构。TokenBay 不新增或重命名字段，其他字段仍由上游定义；stream=true 时返回 SSE，事件内容取决于上游模型和渠道。
createdintegerOptional上游返回时提供的 Unix 时间戳。
backgroundstringOptional上游图像模型返回的背景模式（如有）。
output_formatstringOptional上游图像模型返回的输出图片格式（如有）。
qualitystringOptional上游图像模型返回的输出质量（如有）。
sizestringOptional上游图像模型返回的实际输出尺寸；请求 auto 时，返回值可能与输入尺寸不同。
data[]array<object>Optional
非流式成功响应中的编辑结果数组；数组结构和返回字段仍由上游定义。
data[].b64_jsonstringOptionalBase64 编码的图片数据。
data[].urlstringOptional上游返回的图片 URL。
data[].revised_promptstringOptional上游返回的修订后提示词。
usageobjectOptional
上游提供的用量信息；TokenBay 不自行生成或标准化该对象。
usage.input_tokensintegerOptional上游返回时的输入 token 数。
usage.output_tokensintegerOptional上游返回时的输出 token 数。
usage.total_tokensintegerOptional上游返回时的总 token 数。
usage.input_tokens_details.image_tokensintegerOptional上游返回时的输入图片 token 数。
usage.input_tokens_details.text_tokensintegerOptional上游返回时的输入文本 token 数。
usage.output_tokens_details.image_tokensintegerOptional上游返回时的输出图片 token 数。
usage.output_tokens_details.text_tokensintegerOptional上游返回时的输出文本 token 数。
当前模型列表显示 gpt-image-1.5 和 gpt-image-2 支持 /v1/images/edits，但两者支持的请求参数并不完全相同；其他已配置的 OpenAI 兼容图像编辑模型也可能可用，Gemini 图像模型不由此端点处理。
模型可用性会随账号和渠道配置变化，请以控制台或 Models API 的实时结果为准。
n 不是网关统一支持的图像编辑参数。当前 gpt-image-2 图像编辑验证中，传入 n 可能被拒绝；对 gpt-image-2 请不要传 n，只有在所选模型和渠道明确支持时才使用。
流式能力同样取决于模型和渠道。当前公开的 GPT Image 2 模型资料标注不支持 streaming，因此除非已配置渠道明确支持，不要对 gpt-image-2 发送 stream=true。
quality、input_fidelity、output_format、output_compression、partial_images 等其他 multipart 字段会被转发，但网关不会统一校验；支持情况、可选值、默认值和效果由实际调度的上游模型与渠道决定。
JSON 图片编辑请求（如 images[].image_url 或 images[].file_id）会转发给兼容的上游，但具体请求结构由上游定义；标准文件上传请使用 multipart/form-data。