POST
文生图
POST /v1/images/generations — 根据文本生成图片
文生图
根据文字描述(Prompt)生成图片,兼容 OpenAI API 格式。
POST
https://api000.com/v1/images/generations
接口信息
| HTTP 方法 | POST |
| 接口路径 | /v1/images/generations |
| 完整地址 | https://api000.com/v1/images/generations |
| 认证方式 | Bearer Token |
请求头
| Header 参数 | 必填 | 示例 |
|---|---|---|
Content-Type |
是 | application/json |
Authorization |
是 | Bearer sk-xxxxxxxxxxxxxxxx |
Accept |
否 | application/json |
Authorization必须填写,格式为:Bearer 空格 API Key。例如:Bearer sk-xxxxxxxxxxxxxxxx。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model |
string | 必填 | 绘图模型 ID,如 gpt-image-2、gpt-image-2-all |
prompt |
string | 必填 | 图片文字描述(Prompt),最长 4000 字符 |
n |
integer | 可选 | 生成数量,默认 1,最多 10 张 |
size |
string | 可选 | 图片尺寸,如 1024x1024 |
quality |
string | 可选 | "auto"(默认)、"low"、"medium" 或 "high" |
style |
string | 可选 | "natural" 或 "vivid"(DALL-E 3) |
response_format |
string | 可选 | "url"(默认)或 "b64_json"(Base64 数据) |
请求示例
cURL
curl https://api000.com/v1/images/generations \
-H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "一只在宇宙中漂浮的橙色猫咪,背景是紫色星云,写实摄影风格",
"size": "1024x1024",
"quality": "low",
"n": 1
}'
Python
from openai import OpenAI
import httpx
client = OpenAI(
base_url="https://api000.com/v1",
api_key="sk-xxxxxxxxxxxxxxxx"
)
response = client.images.generate(
model="gpt-image-2",
prompt="A cute orange cat floating in space with purple nebula background, photorealistic",
size="1024x1024",
quality="low",
n=1
)
image_url = response.data[0].url
print(f"图片URL: {image_url}")
# 可选:下载图片到本地
img_data = httpx.get(image_url).content
with open("output.png", "wb") as f:
f.write(img_data)
print("已保存为 output.png")
Node.js
import OpenAI from "openai";
import fs from "fs";
import https from "https";
const client = new OpenAI({
baseURL: "https://api000.com/v1",
apiKey: "sk-xxxxxxxxxxxxxxxx",
});
const response = await client.images.generate({
model: "gpt-image-2",
prompt: "A futuristic cityscape at night with neon lights, cyberpunk style",
size: "1792x1024",
quality: "low",
n: 1,
});
console.log("图片URL:", response.data[0].url);
响应示例
{
"created": 1677652288,
"data": [
{
"url": "https://cdn.example.com/images/generated/xxx.png",
"revised_prompt": "A cute orange cat with bright fur floating in deep space..."
}
]
}
支持的尺寸
| 模型 | 支持尺寸 |
|---|---|
gpt-image-2 |
1024x1024(通用基础正方形)、1536×1024(横向矩形)、1024×1536(纵向矩形)、1792×1024(宽屏横向)、1024×1792(长竖版,短视频常用)、2048×2048(2k正方形)、2048×1152(2k横向画幅)、3840×2160(4K横向16:9)、2160×3840(4K纵向9:16) |
gpt-image-2-all |
1024x1024、1536x1024、1024x1536,以及符合要求的任意 宽x高(宽高均为 16 的倍数,比例 1:3~3:1,最大 3840x2160) |
Prompt 技巧
- 指定风格:photorealistic(写实)、oil painting(油画)、anime style(动漫风)
- 指定构图:wide shot(全景)、close-up(特写)、bird's eye view(俯视)
- 指定光照:golden hour(黄金时段)、dramatic lighting(戏剧性光线)
- 指定细节:8K resolution、highly detailed、sharp focus