GPT-5.4-Image-2 API 文档

概述

GPT-5.4-Image-2 是一款支持文生图、图生图、图片编辑和图片理解的多模态模型。

接口兼容 OpenAI Chat Completions API。

Base URL

https://api.yisu.com

认证

所有请求均需携带 API Key。

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

创建图片

Endpoint

POST /v1/chat/completions

请求参数

Request Body

支持尺寸

1024x1024
1024x1536
1536x1024
auto

支持质量

low
medium
high
auto

文生图

请求示例

curl https://api.yisu.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "model":"gpt-5.4-image-2",
  "messages":[
    {
      "role":"user",
      "content":"生成一只坐在月球上的橘猫，超写实风格"
    }
  ]
}'

响应示例

{
  "id": "chatcmpl_img_A1B2C3",
  "object": "chat.completion",
  "created": 1780470861,
  "model": "gpt-5.4-image-2",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": [
          {
            "type": "image_base64",
            "image_base64": "iVBORw0KGgoAAAANSUhEUgAA..."
          }
        ]
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 42,
    "completion_tokens": 1560,
    "total_tokens": 1602
  }
}

图片编辑（Base64）

支持上传 Base64 图片进行编辑。

请求示例

{
  "model": "gpt-5.4-image-2",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "给这只猫戴上墨镜"
        },
        {
          "type": "image",
          "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
        }
      ]
    }
  ]
}

响应示例

{
  "id": "chatcmpl_img_edit_001",
  "object": "chat.completion",
  "created": 1780470861,
  "model": "gpt-5.4-image-2",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": [
          {
            "type": "image_base64",
            "image_base64": "iVBORw0KGgoAAAANSUhEUgAA..."
          }
        ]
      },
      "finish_reason": "stop"
    }
  ]
}

多图编辑

支持同时上传多张图片。

请求示例

{
  "model": "gpt-5.4-image-2",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "将两张图片中的人物合并到同一个场景中"
        },
        {
          "type": "image",
          "image": "data:image/png;base64,IMAGE_BASE64_1"
        },
        {
          "type": "image",
          "image": "data:image/png;base64,IMAGE_BASE64_2"
        }
      ]
    }
  ]
}

图片理解

分析图片内容。

请求示例

{
  "model": "gpt-5.4-image-2",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "请描述这张图片"
        },
        {
          "type": "image",
          "image": "data:image/jpeg;base64,/9j/4AAQSk..."
        }
      ]
    }
  ]
}

响应示例

{
  "id": "chatcmpl_vision_001",
  "object": "chat.completion",
  "created": 1780470861,
  "model": "gpt-5.4-image-2",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "图片中是一只橘猫坐在窗台上，阳光从左侧照射进来。"
      },
      "finish_reason": "stop"
    }
  ]
}

流式输出

请求示例

{
  "model":"gpt-5.4-image-2",
  "stream":true,
  "messages":[
    {
      "role":"user",
      "content":"生成一辆未来概念跑车"
    }
  ]
}

SSE响应示例

data: {
  "choices":[
    {
      "delta":{
        "content":"正在生成图片..."
      }
    }
  ]
}
data: {
  "choices":[
    {
      "delta":{
        "image_base64":"iVBORw0KGgoAAAANSUhEUgAA..."
      }
    }
  ]
}
data: [DONE]

Usage 字段

标准格式

{
  "usage": {
    "prompt_tokens": 135,
    "completion_tokens": 1800,
    "total_tokens": 1935
  }
}

扩展格式

{
  "usage": {
    "prompt_tokens": 135,
    "completion_tokens": 1800,
    "total_tokens": 1935,
    "prompt_tokens_details": {
      "cached_tokens": 0,
      "audio_tokens": 0
    },
    "completion_tokens_details": {
      "reasoning_tokens": 0,
      "audio_tokens": 0,
      "accepted_prediction_tokens": 0,
      "rejected_prediction_tokens": 0
    }
  }
}

错误响应

认证失败

{
  "error": {
    "message": "Invalid API key.",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

请求参数错误

{
  "error": {
    "message": "Invalid image format.",
    "type": "invalid_request_error",
    "code": "invalid_image"
  }
}

支持格式

输入图片

PNG
JPEG
WEBP
GIF

Base64格式

data:image/png;base64,...
data:image/jpeg;base64,...
data:image/webp;base64,...