Skip to Content
API 参考（模型）OpenAI图像生成与编辑

Images API

操作方法与路径内容类型
生成POST /v1/images/generationsJSON
编辑POST /v1/images/editsmultipart 表单

两者均使用 https://api.fenno.ai 主机和 Bearer 鉴权。所选图像模型必须支持对应操作。

生成参数

model 和 prompt 确定模型与任务；size、quality、n、输出格式及其他选项依模型而定。不要未经核实就套用其他图像模型的参数值。

安装 openai，设置 FENNO_API_KEY 和 FENNO_IMAGE_MODEL：

import os
from openai import OpenAI
 
client = OpenAI(
    base_url="https://api.fenno.ai/v1",
    api_key=os.environ["FENNO_API_KEY"],
    timeout=60.0,
    max_retries=0,
)
 
generated = client.images.generate(
    model=os.environ["FENNO_IMAGE_MODEL"],
    prompt="A lighthouse on a rocky coast, watercolor, no text.",
)
print("Returned images:", len(generated.data))

编辑参数

发送受支持的 image 文件、model 和 prompt。只有所选模型支持时才能使用 mask 等编辑选项；蒙版尺寸、透明度语义和文件限制可能不同。

with open("input.png", "rb") as image:
    edited = client.images.edit(
        model=os.environ["FENNO_IMAGE_MODEL"],
        image=image,
        prompt="Keep the subject and replace the background with a beach.",
    )
print("Returned images:", len(edited.data))

multipart 上传不能手动添加 JSON 内容类型，应让 HTTP 客户端生成表单边界。

响应与错误

data[] 根据模型和受支持格式返回 url 或 b64_json。usage、修订后的提示词等字段并不是所有模型都有。缺少 URL 时应先检查 base64 结果，不要直接认定失败。

遇到 400 时检查图片格式、请求大小、尺寸、提示词与可选参数；404 也可能表示路径错误或模型不可用。反复重试不能让不支持编辑的模型获得编辑能力。

结果处理见图像生成与编辑指南，错误结构见错误参考。

Embeddings模型查询