GPT-5.4-Mini API 文档

概述

GPT-5.4-Mini 是 GPT-5.4 系列的轻量级模型，在保持优秀推理和代码能力的同时，具有更低延迟和更低成本，适用于：

• 日常对话
• 智能客服
• 内容生成
• 代码辅助
• 数据处理
• Function Calling
• JSON Structured Output
• 图片理解（Vision）

兼容 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-mini",
  "messages":[
    {
      "role":"user",
      "content":"你好"
    }
  ]
}'

响应示例

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

多轮对话

请求示例

{
  "model":"gpt-5.4-mini",
  "messages":[
    {
      "role":"system",
      "content":"你是一位资深PHP开发工程师"
    },
    {
      "role":"user",
      "content":"写一个Redis连接示例"
    }
  ]
}

图片理解（Vision）

支持 Base64 图片输入。

请求示例

{
  "model":"gpt-5.4-mini",
  "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-mini",
  "choices":[
    {
      "message":{
        "role":"assistant",
        "content":"图片中是一只橘色猫咪躺在沙发上。"
      },
      "finish_reason":"stop"
    }
  ]
}

JSON Mode

请求示例

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

响应示例

{
  "order_id":"ORD20260604001",
  "amount":99.9,
  "status":"paid"
}

Function Calling

请求示例

{
  "model":"gpt-5.4-mini",
  "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_weather_001",
            "type":"function",
            "function":{
              "name":"get_weather",
              "arguments":"{\"city\":\"北京\"}"
            }
          }
        ]
      },
      "finish_reason":"tool_calls"
    }
  ]
}

流式输出

请求示例

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

SSE响应示例

data: {
  "choices":[
    {
      "delta":{
        "content":"Docker"
      }
    }
  ]
}
data: {
  "choices":[
    {
      "delta":{
        "content":" 是一个开源容器平台..."
      }
    }
  ]
}
data: [DONE]

Usage

标准格式

{
  "usage":{
    "prompt_tokens":120,
    "completion_tokens":180,
    "total_tokens":300
  }
}

获取模型列表

Endpoint

GET /v1/models

响应示例

{
  "object":"list",
  "data":[
    {
      "id":"gpt-5.4-mini",
      "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"
  }
}

推荐使用场景

• AI客服系统
• 企业知识库问答
• 内容生成
• PHP/Python代码辅助
• 自动化工作流
• Function Calling Agent
• 高并发低成本应用