图片生成与编辑
使用 OpenAI 兼容图片接口生成或编辑图片。
图片接口支持生成与编辑。具体尺寸、质量、格式和是否支持流式输出由模型与上游渠道决定。
端点
| 方法 | 路径 | 说明 |
|---|---|---|
POST | /v1/images/generations | 生成图片 |
POST | /v1/images/edits | 编辑图片，支持 JSON 或 multipart 表单 |
POST | /v1/edits | 兼容路径，推荐优先使用 /v1/images/edits |
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 图片模型 ID |
prompt | string | 生成必填 | 图片描述 |
n | integer | 否 | 返回图片数量，默认 1 |
size | string | 否 | 图片尺寸，例如 1024x1024。不要使用乘号 × |
quality | string | 否 | 图片质量，例如 standard、hd、auto |
response_format | string | 否 | 返回格式，例如 url 或 b64_json，取决于模型 |
style | any | 否 | OpenAI 图片扩展字段 |
background、moderation | any | 否 | 新版图片模型扩展字段 |
output_format、output_compression | any | 否 | 输出格式与压缩参数 |
partial_images、stream | any | 否 | 支持流式图片模型时使用 |
image、images | file/string/array | 编辑必填 | 待编辑图片。multipart 可用 image、image[] 或 image[n] |
mask | file/string | 否 | 编辑蒙版 |
input_fidelity | any | 否 | 输入保真度，取决于模型 |
watermark | boolean | 否 | 是否加水印，取决于渠道支持 |
生成图片
curl https://api.tensoraxis.com/v1/images/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $TENSORAXIS_API_KEY" \
-d '{
"model": "gpt-image-1",
"prompt": "一张极简风格的未来城市海报",
"size": "1024x1024"
}'编辑图片
multipart 表单适合上传本地文件：
curl https://api.tensoraxis.com/v1/images/edits \
-H "Authorization: Bearer $TENSORAXIS_API_KEY" \
-F model="gpt-image-1" \
-F prompt="把背景改成夜晚城市" \
-F image="@input.png"也可以按模型支持使用 JSON 图片 URL：
{
"model": "gpt-image-1",
"prompt": "把背景改成夜晚城市",
"image": "https://example.com/input.png"
}响应结构
{
"created": 1710000000,
"data": [
{
"url": "https://example.com/result.png",
"b64_json": "",
"revised_prompt": "..."
}
]
}视频生成不是图片接口。Seedance / Doubao 视频模型请使用视频生成里的异步任务请求体。