GPT 图像 · Responses

POST https://www.vibeapi.cn/v1/responses
Authorization: Bearer <API_KEY>
Content-Type: application/json

{
  "model": "gpt-6-astra",
  "input": "a red apple on a wooden table",
  "stream": true,
  "tools": [{ "type": "image_generation" }]
}

{
  "model": "gpt-6-astra",
  "instructions": "You are a helpful image generation assistant.",
  "input": [
    { "role": "user", "content": [{ "type": "input_text", "text": "Draw a watercolor winter landscape" }] }
  ],
  "stream": true,
  "tools": [
    {
      "type": "image_generation",
      "quality": "high",
      "size": "1536x1024",
      "output_format": "webp",
      "output_compression": 50,
      "moderation": "low",
      "partial_images": 2
    }
  ]
}

"input": "a red apple on a wooden table"

"input": [
  {
    "role": "user",
    "content": [
      { "type": "input_text",  "text": "把这张图改成水彩风格" },
      { "type": "input_image", "image_url": "https://.../photo.jpg" }
    ]
  }
]

{ "type": "image_generation", "quality": "low" }     // 快，草稿
{ "type": "image_generation", "quality": "high" }    // 慢，成片

{ "type": "image_generation", "output_format": "webp", "output_compression": 50 }

{ "type": "image_generation", "moderation": "low" }

{ "type": "image_generation", "action": "generate" }  // 总是新建图片
{ "type": "image_generation", "action": "edit" }      // 强制编辑上下文中的图片；无图则报错

{ "type": "image_generation", "partial_images": 2 }

{
  "id": "resp_0bb33694b11513cf016a3d4bb1d4a0819b918d29bc82aa4358",
  "object": "response",
  "status": "completed",
  "model": "gpt-6-astra",
  "output": [
    {
      "id": "ig_0bb33694b11513cf016a3d4bbb4b54819b9ba7731790d4d87d",
      "type": "image_generation_call",
      "status": "generating",
      "action": "generate",
      "background": "opaque",
      "output_format": "png",
      "quality": "medium",
      "result": "iVBORw0KGgoAAAANSU...<3493728 字节 base64>",
      "revised_prompt": "Oil painting still life...<407 字符>",
      "size": "1400x1123"
    },
    { "type": "message", "role": "assistant", "content": [{ "type": "output_text", "text": "" }] }
  ],
  "reasoning": { "effort": "medium" },
  "service_tier": "default",
  "store": false
}

resp = client.responses.create(
    model="gpt-6-astra",
    input="An oil painting still life of fruit and wine, Rembrandt lighting",
    tools=[{"type": "image_generation", "quality": "medium"}],
)
for item in resp.output:
    if item.type == "image_generation_call":
        with open("out.png", "wb") as f:
            f.write(base64.b64decode(item.result))
        print("revised_prompt:", item.revised_prompt)
        print("实际尺寸:", item.size)   # 实际尺寸由上游裁定，与请求不同

data: {"type":"response.created","response":{"id":"resp_04a3…","status":"in_progress"}}
data: {"type":"response.in_progress","response":{...}}
data: {"type":"response.output_item.added","item":{"id":"ig_04a3…","type":"image_generation_call","status":"in_progress"},"output_index":0,"sequence_number":2}
data: {"type":"response.image_generation_call.in_progress","item_id":"ig_04a3…","output_index":0,"sequence_number":3}
data: {"type":"response.image_generation_call.generating","item_id":"ig_04a3…","output_index":0,"sequence_number":4}
data: {"type":"response.image_generation_call.partial_image","background":"opaque","item_id":"ig_04a3…","output_format":"webp","output_index":0,"partial_image_b64":"iVBORw0KGgo…<460KB>"}
data: {"type":"keepalive","sequence_number":6}
data: {"type":"response.image_generation_call.partial_image","background":"opaque","output_format":"webp","output_index":0,"partial_image_b64":"UklGRpzTAwB…<380KB>"}
data: {"type":"response.output_item.done","item":{"id":"ig_04a3…","type":"image_generation_call","status":"generating","action":"generate","output_format":"webp","quality":"high","revised_prompt":"…","size":"1024x1536"}}
data: {"type":"response.output_item.added","item":{"id":"msg_04a3…","type":"message","role":"assistant","content":[]},"output_index":1}
data: {"type":"response.content_part.added", ...}
data: {"type":"response.output_text.done","text":""}
data: {"type":"response.content_part.done", ...}
data: {"type":"response.output_item.done","item":{"id":"msg_04a3…","type":"message","status":"completed"}}
data: {"type":"response.completed","response":{"id":"resp_04a3…","status":"completed","output":[…]}}

A serene winter landscape in delicate watercolor style: a winding river made entirely of
overlapping white owl feathers flowing through snow-dusted pine trees, under a pale dawn sky
with soft pink and blue washes. Fine ink linework defines the pines, feather barbs, snowy banks,
and distant hills. Peaceful, airy composition, gentle mist, subtle shadows on snow, elegant
natural fantasy illustration.

{ "type": "input_image", "image_url": "https://your-bucket.example.com/photo.jpg" }

import base64
b64 = base64.b64encode(open("photo.jpg", "rb").read).decode
part = {"type": "input_image", "image_url": f"data:image/jpeg;base64,{b64}"}

def create_file(path):
    return client.files.create(file=open(path, "rb"), purpose="vision").id

fid = create_file("photo.jpg")
part = {"type": "input_image", "file_id": fid}

img_id  = create_file("sunlit_lounge.png")
mask_id = create_file("mask.png")   # 透明区即重绘区，须包含 alpha 通道

resp = client.responses.create(
    model="gpt-6-astra",
    input=[{"role": "user", "content": [
        {"type": "input_text",  "text": "在泳池里加一只火烈鸟"},
        {"type": "input_image", "file_id": img_id},
    ]}],
    tools=[{"type": "image_generation", "quality": "high",
            "input_image_mask": {"file_id": mask_id}}],
)

# 第一轮：生成
r1_b64 = generate_and_get_b64("一只灰色虎斑猫抱着戴橙色围巾的水獭，童书插画风格")

# 第二轮：将第一轮的图作为参考图传入，继续编辑
stream = client.responses.create(
    model="gpt-6-astra",
    input=[{"role": "user", "content": [
        {"type": "input_text",  "text": "现在把它变成写实摄影风格，浅景深"},
        {"type": "input_image", "image_url": f"data:image/png;base64,{r1_b64}"},
    ]}],
    tools=[{"type": "image_generation"}],
    stream=True,
)

stream = client.responses.create(
    model="gpt-6-astra",
    instructions="You are a helpful image generation assistant. Generate ALL images the user requests.",
    input="Generate 3 separate images: 1) a solid purple star, 2) a solid blue square, 3) a solid green triangle, each centered on white.",
    tools=[{"type": "image_generation", "quality": "low"}],
    stream=True,
)

finals = {}
for event in stream:
    if event.type == "response.image_generation_call.partial_image":
        finals[event.output_index] = event.partial_image_b64   # 按 output_index 分组
for idx, b64 in finals.items:
    with open(f"out_{idx}.png", "wb") as f:
        f.write(base64.b64decode(b64))
print(f"共 {len(finals)} 张")   # 实测 3 张

resp = client.responses.create(
    model="gpt-6-astra",
    input=[{"role": "user", "content": [
        {"type": "input_text",  "text": "请用中文详细描述这张图片：主要物体、颜色、风格、氛围。"},
        {"type": "input_image", "image_url": "https://your-bucket.example.com/product.png", "detail": "high"},
    ]}],
)
print(resp.output_text)

resp = client.chat.completions.create(
    model="gpt-6-astra",
    messages=[{"role": "user", "content": [
        {"type": "text", "text": "Describe this image: main objects, color palette, mood."},
        {"type": "image_url", "image_url": {"url": "https://.../photo.jpg", "detail": "low"}},
    ]}],
)
print(resp.choices[0].message.content)

A festive vertical New Year greeting poster. Render the SAME greeting in four languages
on four separate, clearly legible lines:
Chinese '新年快乐', English 'Happy New Year',
Japanese 'あけましておめでとう', Korean '새해 복 많이 받으세요'.
Warm red and gold palette, hanging paper lanterns, gold foil accents, elegant typography.

{
  "error": {
    "type": "image_generation_user_error",
    "code": "moderation_blocked",
    "moderation_details": {
      "moderation_stage": "input",
      "categories": ["harassment"]
    }
  }
}

import openai
try:
    client.images.generate(model="gpt-image-2", prompt="...")
except openai.BadRequestError as e:
    if e.code == "moderation_blocked":
        details = (e.body or {}).get("moderation_details", {})
        print("拦截阶段:", details.get("moderation_stage"), "类别:", details.get("categories"))
        # 提示用户修改后重试；此类用户错误不应自动重试
    else:
        raise

type*               "image_generation"
quality             low | medium | high | auto     （本网关会改写，以响应为准）
size                1024x1024 | 1536x1024 | 1024x1536 | … | auto （同上）
output_format       png | jpeg | webp
output_compression  0–100                          （jpeg / webp）
moderation          auto | low
action              auto | generate | edit
partial_images      0–3
input_image_mask    { "file_id": "..." }