> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aioagi.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# 最新：GPT 5.5

> 了解 GPT-5.5 在 AIOAGI 中的定位、适用场景、迁移建议和 OpenAI 兼容接口调用方法。

`GPT-5.5` 是 GPT 系列面向复杂生产工作流的新一代模型。它适合代码开发、工具调用、多步骤智能体、长上下文检索、产品需求拆解、企业知识助手和高质量客服等场景。

AIOAGI 将 GPT、Claude、DeepSeek、Gemini、Qwen 和 Vibe Coding 等模型聚合到统一平台。你可以使用 AIOAGI API Key，通过 OpenAI 兼容接口调用 `gpt-5.5`。模型是否可用、价格、上下文长度、限流策略和多模态能力可能变化，请以 **控制台** 和 **开发者指南** 为准。

<Warning>
  上线生产前，请先确认你的 API Key 所属 Token 组支持 `gpt-5.5`。不同 Token 组可用模型和额度可能不同。
</Warning>

## 适合场景

<CardGroup cols={2}>
  <Card title="复杂代码任务" icon="code">
    适合代码生成、代码审查、仓库理解、重构计划、测试补全和多步骤修复。
  </Card>

  <Card title="工具型智能体" icon="wrench">
    适合需要调用多个工具、检索资料、执行业务流程和持续推进任务的 Agent。
  </Card>

  <Card title="企业知识助手" icon="book-open">
    适合长上下文问答、RAG 总结、制度解释、资料比对和结构化分析。
  </Card>

  <Card title="高质量用户对话" icon="messages-square">
    适合客服、销售助理、产品咨询和需要更稳定表达质量的中文/英文对话。
  </Card>
</CardGroup>

如果你的任务只是简单分类、短文本改写或低成本批处理，可以先评估更轻量的 GPT 模型。`GPT-5.5` 更适合质量优先、推理链更长或工具面更复杂的业务。

## 能力特点

* **推理效率更高**：在复杂任务中通常能用更少推理 token 达到较强结果，适合多步骤和工具密集工作流。
* **任务执行更稳**：更适合从明确目标、成功标准和约束条件出发，生成可执行计划或最终结果。
* **工具使用更精确**：适合较大的工具集合、多轮业务流程和长时间运行的智能体任务。
* **表达更直接**：默认风格更简洁、任务导向。面向用户的产品可以显式指定语气、格式和解释深度。
* **多模态能力需核对**：图像输入和视觉细节能力以 AIOAGI 控制台、开发者指南和当前 Token 组开放情况为准。

## AIOAGI 使用方法

<Steps>
  <Step title="创建 API Key">
    登录 AIOAGI 控制台，在 **令牌** 或 **API Key** 页面创建密钥。确认账户余额和 Token 组额度充足。
  </Step>

  <Step title="确认模型权限">
    在控制台或开发者指南中查看当前 Token 组是否支持 `gpt-5.5`。如果模型名、价格或支持策略有变化，以控制台展示为准。
  </Step>

  <Step title="配置 OpenAI 兼容端点">
    在服务端保存 API Key 和 base URL。常用端点为 `https://api.aiearth.dev/v1`，也可以按网络情况使用 `https://api.aiearth.vip/v1`。
  </Step>

  <Step title="发起聊天补全请求">
    将请求中的 `model` 设置为 `gpt-5.5`，并使用 `POST /chat/completions` 发起调用。
  </Step>
</Steps>

## curl 示例

```bash theme={null}
export AIO_API_KEY="sk-your-api-key"
export AIO_BASE_URL="https://api.aiearth.dev/v1"

curl "$AIO_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $AIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {
        "role": "system",
        "content": "你是 AIOAGI 上的企业开发助手，回答要准确、简洁，并给出可执行步骤。"
      },
      {
        "role": "user",
        "content": "请把一个客服知识库问答系统拆成开发计划。"
      }
    ]
  }'
```

## Python 示例

```python theme={null}
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AIO_API_KEY"],
    base_url=os.environ.get("AIO_BASE_URL", "https://api.aiearth.dev/v1"),
)

response = client.chat.completions.create(
    model="gpt-5.5",
    messages=[
        {
            "role": "system",
            "content": "你是 AIOAGI 上的企业开发助手，回答要准确、简洁，并给出可执行步骤。",
        },
        {
            "role": "user",
            "content": "请把一个客服知识库问答系统拆成开发计划。",
        },
    ],
)

print(response.choices[0].message.content)
```

<Info>
  GPT-5.5 的原生能力文档建议在推理、工具调用和多轮状态管理场景中优先使用 Responses API。如果你需要这些高级能力，请先在 AIOAGI 控制台或开发者指南确认当前端点和 Token 组是否支持对应接口与参数。未确认前，生产接入优先使用 OpenAI 兼容接口。
</Info>

## 提示词建议

GPT-5.5 更适合目标明确的提示词。你可以减少冗长流程说明，把重点放在结果、约束和验收标准上。

推荐写法：

```text theme={null}
目标：为现有客户工单系统设计一个自动分类和回复草稿生成方案。
成功标准：
1. 给出模块拆分和数据流。
2. 说明需要调用的接口和权限。
3. 标出上线前必须验证的风险。
输出格式：先给方案摘要，再给实施步骤，最后给风险清单。
```

使用建议：

* 写清楚预期结果、成功标准、允许的副作用和输出格式。
* 避免把每一步推理过程都写死，除非你的业务必须按固定流程执行。
* 对客服、销售和运营场景，明确语气、长度和是否需要解释依据。
* 对代码任务，提供仓库背景、改动范围、测试要求和验收标准。
* 如果接口支持结构化输出，优先使用结构化参数，不要只靠自然语言描述 JSON schema。

## 迁移建议

如果你已经在 AIOAGI 中使用 `gpt-5.2`、`gpt-5.4` 或其他 GPT 模型，不建议直接把所有生产流量一次性切换到 `gpt-5.5`。

1. 先保留原有模型作为基线。
2. 选择真实业务样例做 A/B 测试。
3. 对比准确率、工具调用成功率、输出长度、延迟和成本。
4. 从最小可用提示词开始调优，不要直接搬迁所有旧提示词规则。
5. 灰度切换高价值场景，并持续记录失败样例。

<Tip>
  如果你遇到 `模型不存在`、`401 Unauthorized`、额度不足或 Token 组不支持模型等问题，请先到控制台核对 API Key、Token 组和模型列表，再查看 [常见问题](/faq)。
</Tip>
