StarMagicStarMagic
简体中文
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
集成向导
GPT-5.1 - 完整参数文档
StarMagicStarMagic
简体中文
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
文本系列GPTGPT-5.1

GPT-5.1 - 完整参数文档

  • 使用 OpenAI SDK 格式调用 GPT-5.1 系列模型
  • 同步处理模式，实时响应
  • 可用模型：gpt-5.1（基础版）、gpt-5.1-chat（对话优化版）、gpt-5.1-thinking（推理增强版）
  • 文本对话：支持单轮或多轮上下文对话
  • 系统提示词：自定义 AI 角色和行为
  • 多模态输入：支持文本 + 图片混合输入
  • 工具调用：支持 Function Calling
  • 推理输出：gpt-5.1-thinking 模型返回 reasoning_content 字段，展示思维过程
<Note> **BaseURL 说明**：默认 BaseURL 为 `https://api.starmagic.ai`，对文本模型支持更好，支持长连接；`https://api.starmagic.ai` 是多模态主力地址，对文本模型作为备用地址使用。 </Note>

授权

Authorizationstringheader必填

##所有接口均需要使用Bearer Token进行认证## **获取 API Key：** 访问 [API Key 管理页面](https://starmagic.ai/app/api-keys) 获取您的 API Key **使用时在请求头中添加：** ``` Authorization: Bearer YOUR_API_KEY ```

Authorization: Bearer YOUR_API_KEY

请求体

application/json
modelenum<gpt-5.1 | gpt-5.1-chat | gpt-5.1-thinking>必填

用于聊天补全的模型名称 - **gpt-5.1**：基础模型，适用于通用任务 - **gpt-5.1-chat**：对话优化版，针对会话场景进行优化 - **gpt-5.1-thinking**：推理增强版，支持思维链输出（返回 reasoning_content 字段）

"gpt-5.1"
messagesobject[]必填

对话消息列表，支持多轮对话和多模态输入

[
  {
    "role": "user",
    "content": null
  }
]
streamboolean

是否启用流式响应 - `true`：流式响应，实时逐块返回内容 - `false`：等待完整响应后一次性返回

false
max_tokensinteger

生成响应的最大 token 数量

2000
temperaturenumber

采样温度，控制输出的随机性 - 较低值（如 0.2）：输出更确定、更聚焦 - 较高值（如 1.5）：输出更随机、更有创意

1
top_pnumber

核采样参数 - 控制从累积概率最高的 token 中进行采样 - 例如 0.9 表示从累积概率前 90% 的 token 中采样

0.9
frequency_penaltynumber

频率惩罚系数，取值范围 -2.0 到 2.0 - 正值会根据 token 在文本中的出现频率进行惩罚，降低重复内容的概率

0
presence_penaltynumber

存在惩罚系数，取值范围 -2.0 到 2.0 - 正值会根据 token 是否已出现在文本中进行惩罚，鼓励模型讨论新话题

0
stopobject

停止序列，生成内容遇到这些序列时将停止

toolsobject[]

用于 Function Calling 的工具列表

[
  {
    "type": "function",
    "function": {
      "name": "get_weather",
      "description": "获取指定城市的当前天气信息",
      "parameters": {}
    }
  }
]

响应

application/json
成功

响应体

idstring

本次聊天补全的唯一标识符

"chatcmpl-abc123"
modelstring

实际使用的模型名称

"gpt-5.1"
objectenum<chat.completion>

响应对象类型

"chat.completion"
createdinteger

响应创建时间（Unix 时间戳）

1698999496
choicesobject[]

生成的补全选项列表

[
  {
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "你好！有什么我可以帮助你的吗？",
      "reasoning_content": "让我一步一步思考这个问题..."
    },
    "finish_reason": "stop"
  }
]
usageobject

Token 使用量统计

{
  "prompt_tokens": 8,
  "completion_tokens": 292,
  "total_tokens": 300
}
POST/v1/chat/completions
curl --request POST \
  --url https://api.starmagic.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gpt-5.1",
  "messages": [
    {
      "role": "user",
      "content": "请介绍一下你自己"
    }
  ],
  "temperature": 1
}'
响应: 成功
{
  "id": "chatcmpl-abc123",
  "model": "gpt-5.1",
  "object": "chat.completion",
  "created": 1698999496,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": null,
        "content": null,
        "reasoning_content": null
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 292,
    "total_tokens": 300
  }
}