API 参考
图像生成
Images API 用于生成与编辑图像，接口与 OpenAI images 格式兼容。本篇聚焦通用调用方式，模型能力与效果对比详见媒体生成章节。
支持模型
| 模型 | 定位 |
|---|---|
| 当前可用的图像生成模型以模型广场（控制台「模型服务」）在售型号为准 | |
图像生成与编辑都通过 /v1/images/generations 与 /v1/images/edits 调用，只需替换 model 参数（以模型广场在售型号为准）。
图像生成接口
POST https://api.yomiapi.com/v1/images/generations请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型 id（以模型广场在售型号为准） |
prompt | string | 是 | 图像描述提示词 |
n | integer | 否 | 生成图像数量，默认 1 |
size | string | 否 | 输出尺寸，如 1024x1024,支持取值以模型为准 |
quality | string | 否 | 质量档位，可选取值以模型为准 |
response_format | string | 否 | 返回格式,url 或 b64_json，具体以模型返回为准 |
Python 示例
import base64
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.yomiapi.com/v1"
)
response = client.images.generate(
model="your-image-model-id",
prompt="一只可爱的橘猫在阳光下睡觉",
size="1024x1024",
n=1
)
with open("cat.png", "wb") as f:
f.write(base64.b64decode(response.data[0].b64_json))cURL 示例
curl https://api.yomiapi.com/v1/images/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "your-image-model-id",
"prompt": "一只可爱的橘猫在阳光下睡觉",
"size": "1024x1024",
"n": 1
}'图像编辑接口
POST https://api.yomiapi.com/v1/images/edits编辑接口以 multipart/form-data 上传原图，按提示词修改图像。平台不提供 /v1/images/variations(图像变体)接口。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型 id |
image | file | 是 | 原始图像文件 |
prompt | string | 是 | 编辑指令 |
mask | file | 否 | 遮罩图，指定允许修改的区域 |
n | integer | 否 | 生成数量 |
size | string | 否 | 输出尺寸 |
Python 示例
response = client.images.edit(
model="your-image-model-id",
image=open("input.png", "rb"),
prompt="把背景替换为黄昏的海滩"
)
with open("edited.png", "wb") as f:
f.write(base64.b64decode(response.data[0].b64_json))提示词建议
- 详细描述: 写清主体、风格、光照、构图，信息越完整结果越可控。
- 指定风格: 如「油画风格」「3D 渲染」「极简主义」，避免模型自由发挥偏离预期。
- 画面要求: 用「专业摄影」「浅景深」「高清」等修饰词约束画面质感。
示例提示词:
一只金色的拉布拉多犬在海滩上奔跑,
阳光照射下毛发闪闪发光,
背景是蓝色的大海和天空,
专业摄影,高清,浅景深计费与错误处理
图像模型的计费方式与单价以模型广场与充值页显示为准。
生成失败常见于提示词触发内容策略或参数不合法(400),可调整提示词与参数后重试;401、429、500 等通用错误码的含义与处理见「API 概述与认证」。模型特性、效果对比与更多玩法详见媒体生成章节。