GPT-5.5 API 文档

概述

GPT-5.5 是一款支持自然语言对话、推理分析、代码生成、图片理解（Vision）、Function Calling、JSON 输出和流式响应的多模态大语言模型。

接口兼容 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

请求参数

基础参数

reasoning_effort

控制模型推理深度。

支持值：

low
medium
high

示例：

{
  "model": "gpt-5.5",
  "reasoning_effort": "high",
  "messages": [
    {
      "role": "user",
      "content": "证明勾股定理"
    }
  ]
}

基础对话

请求示例

curl https://api.yisu.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "model":"gpt-5.5",
  "messages":[
    {
      "role":"user",
      "content":"你好，请介绍一下自己"
    }
  ]
}'

响应示例

{
  "id": "chatcmpl_abc123",
  "object": "chat.completion",
  "created": 1780470861,
  "model": "gpt-5.5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好，我是 GPT-5.5，一个大型多模态人工智能模型。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 18,
    "total_tokens": 30
  }
}

多轮对话

请求示例

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

图片理解（Vision）

支持 Base64 图片输入。

请求示例

{
  "model": "gpt-5.5",
  "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.5",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "图片中是一只橘猫坐在窗边。"
      },
      "finish_reason": "stop"
    }
  ]
}

JSON Mode

请求示例

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

响应示例

{
  "name": "Tom",
  "age": 20,
  "city": "Los Angeles"
}

Function Calling

请求示例

{
  "model": "gpt-5.5",
  "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"
    }
  ]
}

流式输出（SSE）

请求示例

{
  "model": "gpt-5.5",
  "stream": true,
  "messages": [
    {
      "role": "user",
      "content": "讲一个程序员笑话"
    }
  ]
}

SSE响应示例

data: {
  "id":"chatcmpl_stream001",
  "choices":[
    {
      "delta":{
        "content":"从前"
      }
    }
  ]
}
data: {
  "choices":[
    {
      "delta":{
        "content":"有一个程序员..."
      }
    }
  ]
}
data: [DONE]

Usage

标准格式

{
  "usage": {
    "prompt_tokens": 120,
    "completion_tokens": 360,
    "total_tokens": 480
  }
}

获取模型列表

Endpoint

GET /v1/models

响应示例

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

错误响应

认证失败

{
  "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"
  }
}