Skip to content

文本系列总览

xmsmartlink Docs 的文本能力提供统一入口,覆盖 OpenAI Chat Completions、OpenAI Responses、Gemini 兼容格式以及 Claude 兼容格式。你可以根据现有 SDK、上游协议偏好和业务输出形态,选择最适合的调用方式,而不必为不同模型体系分别维护完全不同的接入流程。

如果你正在接入已有 OpenAI 应用,通常可以优先从 POST /v1/chat/completions 开始;如果你希望使用更统一的新一代输出结构,可以考虑 POST /v1/responses;如果你已经围绕 Gemini 或 Claude 官方格式构建了应用,则可以直接使用对应兼容入口完成迁移。

覆盖范围

  • OpenAI Chat Completions 兼容调用:适合大多数聊天、多轮对话和文本生成应用
  • OpenAI Responses 兼容调用:适合统一处理生成结果、工具调用和后续扩展能力
  • Gemini 兼容调用:兼容 generateContent 请求结构,便于接入 Google 生态调用方式
  • Claude 兼容调用:兼容 messages 请求格式,便于迁移 Anthropic 风格的对话应用

推荐入口

  • POST /v1/chat/completions
  • POST /v1/responses
  • POST /v1beta/models/{model}:generateContent
  • POST /v1/messages

选择建议:

  • 已有 OpenAI 聊天应用:优先使用 POST /v1/chat/completions
  • 希望采用更统一的响应对象:优先使用 POST /v1/responses
  • 已有 Gemini SDK 或提示词结构:优先使用 POST /v1beta/models/{model}:generateContent
  • 已有 Claude Messages 集成:优先使用 POST /v1/messages

适用场景

  • 通用问答与智能助手
  • 多轮客服对话
  • 文案生成与改写
  • 长文本总结与信息抽取
  • 结构化字段整理
  • 已有 OpenAI、Gemini、Claude 应用的低成本迁移

参考接口文档

如果你已经确定要使用的模型或协议格式,建议直接在 OpenAPI 文档中查看对应接口的请求示例、参数定义和响应结构。