应用集成总览

疾旋Token 采用全协议标准设计，不仅原生兼容业界经典的 OpenAI Chat Completions 协议，还深度支持 OpenAI Responses API、Anthropic Messages 以及 Gemini Native generateContent 原生协议。

无论您使用的是命令行开发工具、AI 原生 IDE、智能体编排框架，还是现代化桌面/Web 聊天客户端，均可直连疾旋Token 享受低延迟、高并发的旗舰级大模型推理算力。

🔑 核心通用接入三要素

绝大多数支持自定义 API 的工具与软件，仅需填入以下三项核心参数即可完成接入：

API Base URL = https://token.astrumflow.com/v1
API Key      = sk-your-astrumflow-token-key
Model Name   = GPT-5.6-sol (或 GPT-5.6-terra, GPT-5.6-luna 等)

🌐 常用四大 API 协议对比与详解

不同的 AI 应用和开发工具通常采用不同的接口协议规范。疾旋Token 支持以下四大主流 API 协议标准：

1. OpenAI Chat Completions 协议 (/v1/chat/completions)

这是目前整个 AI 行业最通用、生态支持最广泛的标准对话接口协议。

• 适用场景与工具：Cursor、Windsurf、Cline、Roo Code、Cherry Studio、Chatbox、NextChat、Dify、FastGPT、LangChain、LlamaIndex 等。
• 协议核心特征：
  • 以 messages 数组组织多轮上下文对话，支持 system（系统人设）、user（用户输入）、assistant（AI 回复）和 tool（工具执行结果）四种标准角色。
  • 支持 stream: true 基于 SSE (Server-Sent Events) 的毫秒级流式打字输出。
  • 支持 tools 与 tool_choice 标准函数/工具调用（Function Calling）。
  • 支持 response_format 进行严格的 JSON 结构化输出。

curl https://token.astrumflow.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-astrumflow-token-key" \
  -d '{
    "model": "GPT-5.6-terra",
    "messages": [
      {"role": "system", "content": "你是一位资深全栈工程师。"},
      {"role": "user", "content": "请用 TypeScript 写一个防抖函数。"}
    ],
    "stream": false
  }'

2. OpenAI Responses API 协议 (/v1/responses)

这是 OpenAI 面向新一代全自主智能体与交互式编程助手设计的现代交互协议（如 Codex 原生驱动协议）。

• 适用场景与工具：OpenAI Codex CLI、Codex++、新一代自主 Agent 运行时与多模态自动化工作流。
• 协议核心特征：
  • 统一的 Input 结构：统一接收字符串、多模态消息列表或结构化任务指令，避免了传统消息嵌套过深的问题。
  • 内置 Agent 状态与回路：深度原生集成 Bash 命令执行、文件读写、Web 检索与 Computer Use 等工具循环。
  • 更细粒度的事件流：针对代码生成、思维链展开和工具执行反馈提供更结构化的增量事件流。

curl https://token.astrumflow.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-astrumflow-token-key" \
  -d '{
    "model": "GPT-5.6-sol",
    "input": "检查当前代码库并修复 auth 鉴权模块中的潜在漏洞",
    "tools": [
      {
        "type": "function",
        "name": "run_shell_command",
        "description": "在沙箱环境中执行终端命令"
      }
    ]
  }'

3. Anthropic Messages 协议 (/v1/messages)

这是 Anthropic Claude 系列模型的原生专属协议，在复杂的代码重构、结构化思考与长程多工具调度中被广泛应用。

• 适用场景与工具：Claude Code CLI、Claude Desktop 客户端、CC Switch (Claude 模式) 以及支持 Anthropic 原生驱动模式的 IDE 插件。
• 协议核心特征：
  • 顶层独立 System：系统级人设与指令作为独立的顶级字段 system 传入，不与上下文 messages 混杂。
  • 严格的角色交替：messages 数组中的 user 与 assistant 角色必须严格交替出现。
  • 原生 Extended Thinking 深度思考：支持传入 thinking: { type: "enabled", budget_tokens: 2048 } 显式控制模型的思维链深度。
  • 多块 Content Blocks：单条消息支持富文本块集合（包含 text 块、thinking 思考块与 tool_use / tool_result 工具交互块）。

curl https://token.astrumflow.com/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-your-astrumflow-token-key" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "GPT-5.6-sol",
    "max_tokens": 4096,
    "system": "你是一位专注于代码安全与性能优化的架构师。",
    "messages": [
      {"role": "user", "content": "请分析高并发场景下的连接池泄漏原因并提供排查方案。"}
    ]
  }'

4. Google Gemini Native generateContent 协议 (/v1beta/models/...)

这是 Google 为 Gemini 模型家族制定的官方原生接口协议。

• 适用场景与工具：Gemini CLI、Google GenAI 官方 SDK、Google AI Studio 生态工具及需要处理数百万超长上下文的场景。
• 协议核心特征：
  • 基于 Contents / Parts 架构：对话上下文以 contents: [{ role: "user" | "model", parts: [...] }] 组织，每个 part 可以是文本、内联图片/音视频或函数调用。
  • System Instruction 独立指令：使用专用的 systemInstruction 字段注入系统级指导原则。
  • 超长百万级上下文原生吞吐：针对百万级上下文窗口进行原生优化，支持在单次请求中投喂大型代码仓库或完整文档集。
  • 多样化鉴权：支持通过 HTTP 请求头 x-goog-api-key 或 URL 查询参数 ?key=sk-... 传递密钥。

curl "https://token.astrumflow.com/v1beta/models/GPT-5.6-sol:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: sk-your-astrumflow-token-key" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {"text": "分析以下代码结构并提供重构建议。"}
        ]
      }
    ],
    "generationConfig": {
      "temperature": 0.7,
      "maxOutputTokens": 4096
    }
  }'

🛠️ 主流应用集成指南导航

点击下方卡片即可直接查看针对具体工具与客户端的详细配置教程：