GPT-5.4 API 文档

概述

GPT-5.4 是一款支持文本生成、代码编写、推理分析、图片理解（Vision）、Function Calling 和 Structured Output 的大型语言模型。

兼容 OpenAI Chat Completions API。

Base URL

https://api.yisu.com

认证方式

所有请求均需携带 API Key：

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Chat Completions

Endpoint

POST /v1/chat/completions

请求参数

基础对话

请求示例

curl https://api.yisu.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "model":"gpt-5.4",
  "messages":[
    {
      "role":"user",
      "content":"你好"
    }
  ]
}'

响应示例

{
  "id": "chatcmpl_abc123",
  "object": "chat.completion",
  "created": 1780470861,
  "model": "gpt-5.4",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好！有什么可以帮助你的吗？"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 12,
    "total_tokens": 20
  }
}

多轮对话

请求示例

{
  "model":"gpt-5.4",
  "messages":[
    {
      "role":"system",
      "content":"你是一名资深运维工程师"
    },
    {
      "role":"user",
      "content":"CentOS如何安装Nginx？"
    }
  ]
}

图片理解（Vision）

支持 Base64 图片输入。

请求示例

{
  "model":"gpt-5.4",
  "messages":[
    {
      "role":"user",
      "content":[
        {
          "type":"text",
          "text":"描述图片内容"
        },
        {
          "type":"image",
          "image":"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
        }
      ]
    }
  ]
}

响应示例

{
  "id":"chatcmpl_vision001",
  "object":"chat.completion",
  "created":1780470861,
  "model":"gpt-5.4",
  "choices":[
    {
      "message":{
        "role":"assistant",
        "content":"图片中是一只橘猫坐在沙发上。"
      },
      "finish_reason":"stop"
    }
  ]
}

JSON 输出模式

请求示例

{
  "model":"gpt-5.4",
  "messages":[
    {
      "role":"user",
      "content":"返回一个用户对象"
    }
  ],
  "response_format":{
    "type":"json_object"
  }
}

响应示例

{
  "name":"Tom",
  "age":25,
  "email":"tom@example.com"
}

Function Calling

请求示例

{
  "model":"gpt-5.4",
  "messages":[
    {
      "role":"user",
      "content":"上海天气怎么样？"
    }
  ],
  "tools":[
    {
      "type":"function",
      "function":{
        "name":"get_weather",
        "description":"获取天气信息",
        "parameters":{
          "type":"object",
          "properties":{
            "city":{
              "type":"string"
            }
          },
          "required":["city"]
        }
      }
    }
  ]
}

响应示例

{
  "choices":[
    {
      "message":{
        "role":"assistant",
        "tool_calls":[
          {
            "id":"call_001",
            "type":"function",
            "function":{
              "name":"get_weather",
              "arguments":"{\"city\":\"上海\"}"
            }
          }
        ]
      },
      "finish_reason":"tool_calls"
    }
  ]
}

流式输出

请求示例

{
  "model":"gpt-5.4",
  "stream":true,
  "messages":[
    {
      "role":"user",
      "content":"介绍一下Linux"
    }
  ]
}

SSE响应

data: {
  "choices":[
    {
      "delta":{
        "content":"Linux"
      }
    }
  ]
}
data: {
  "choices":[
    {
      "delta":{
        "content":" 是一个开源操作系统..."
      }
    }
  ]
}
data: [DONE]

Usage

标准格式

{
  "usage": {
    "prompt_tokens": 120,
    "completion_tokens": 280,
    "total_tokens": 400
  }
}

获取模型列表

Endpoint

GET /v1/models

响应示例

{
  "object":"list",
  "data":[
    {
      "id":"gpt-5.4",
      "object":"model",
      "created":1780000000,
      "owned_by":"system"
    }
  ]
}

错误响应

API Key无效

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

请求频率超限

{
  "error":{
    "message":"Rate limit exceeded.",
    "type":"rate_limit_error",
    "code":"rate_limit_exceeded"
  }
}

参数错误

{
  "error":{
    "message":"Invalid request.",
    "type":"invalid_request_error",
    "code":"invalid_request"
  }
}