活动

天翼云最新优惠活动,涵盖免费试用,产品折扣等,助您降本增效!
热门活动
  • 安全隔离版OpenClaw NEW OpenClaw云服务器专属“龙虾“套餐低至1.5折起
  • 聚力AI赋能 天翼云大模型专项 大模型特惠专区·Token Plan 轻享包低至9.9元起
  • 青云志云端助力计划 NEW 一站式科研助手,海外资源安全访问平台,助力青年翼展宏图,平步青云
  • 企业出海解决方案 NEW 助力您的业务扬帆出海,通达全球!
  • 天翼云信创专区 NEW “一云多芯、一云多态”,国产化软件全面适配,国产操作系统及硬件芯片支持丰富
  • 云上钜惠 爆款云主机全场特惠,2核4G只要1.8折起!
  • 天翼云奖励推广计划 加入成为云推官,推荐新用户注册下单得现金奖励
免费活动
  • 免费试用中心 HOT 多款云产品免费试用,快来开启云上之旅
  • 天翼云用户体验官 NEW 您的洞察,重塑科技边界

息壤智算

领先开放的智算服务平台,提供算力、平台、数据、模型、应用“五位一体”智算服务体系,构建全流程的AI基础设施能力
星辰TokenHub
  • 模型广场
  • 体验中心
  • 服务接入
星辰MaaS平台
  • 星辰MaaS智能体平台
  • 星辰大模型
大模型
  • glm-5.3-flash
  • GLM-5.2
  • deepseek-v4-pro-0813
  • deepseek-v4-flash-0731-new
  • qwen3.8-flash
AI Store
  • 算力市场
  • 模型市场
  • 应用市场
应用托管
  • 天翼云DramaFlow2.0
  • 应用实例
科研助手
  • 开发机
  • 并行计算
训推服务
  • 模型开发
  • 训练任务
  • 服务部署
智能体引擎
  • 智能体引擎
可信数据空间
  • 可信数据空间
公共算力服务
  • 裸金属
  • 定制裸金属
智算一体机
  • 智算一体机
模型适配专家服务
  • 模型适配专家服务
算力服务商
  • 入驻算力服务商

应用商城

天翼云精选行业优秀合作伙伴及千余款商品,提供一站式云上应用服务
进入甄选商城进入AI Store公有云生态专区智云上海应用生态专区
建站工具
  • 新域名服务
  • SSL证书
  • 翼建站
企业办公
  • 智教云电脑
  • WPS 365 天翼云版
灾备迁移
  • 云管家2.0
  • 翼备份(SaaS版)
  • 琥珀数据压缩归档服务
智慧教育
  • 智擎思政平台(个人版)
  • 智擎研学平台(个人基础版)

定价

协助您快速了解云产品计费模式、价格详情,轻松预估上云成本
价格计算器
  • 动态测算产品价格
定价策略
  • 快速了解计费模式

合作伙伴

天翼云携手合作伙伴,共创云上生态,合作共赢
天翼云生态合作中心
  • 天翼云生态合作中心
天翼云渠道合作伙伴
  • 天翼云代理渠道合作伙伴
天翼云服务合作伙伴
  • 天翼云集成商交付能力认证
天翼云应用合作伙伴
  • 天翼云甄选商城合作伙伴
天翼云技术合作伙伴
  • 天翼云OpenAPI中心
天翼云培训认证
  • 天翼云学堂
天翼信创云专区
  • 信创云专区
  • 适配互认证

开发者

开发者相关功能入口汇聚
技术社区
  • 专栏文章
  • 互动问答
  • 技术视频
资源与工具
  • OpenAPI中心
培训与认证
  • 天翼云学堂
  • 天翼云认证
开源社区
  • 魔乐社区
  • OpenTeleDB

支持与服务

为您提供全方位支持与服务,全流程技术保障,助您轻松上云,安全无忧
文档与工具
  • 文档中心
  • 新手上云
  • 自助服务
  • OpenAPI中心
定价
  • 价格计算器
  • 定价策略
基础服务
  • 售前咨询
  • 在线支持
  • 在线支持
  • 工单服务
  • 服务保障
  • 会员中心
增值服务
  • 红心服务
  • 首保服务
  • 客户支持计划
  • 专家技术服务
  • 备案管家
我要反馈
  • 建议与反馈
  • 用户体验官
信息公告
  • 客户公告

了解天翼云

天翼云秉承央企使命,致力于成为数字经济主力军,投身科技强国伟大事业,为用户提供安全、普惠云服务
品牌介绍
  • 关于天翼云
  • 智算云
  • 新闻资讯
  • 天翼云APP
基础设施
  • 全球基础设施
  • 信任中心
最佳实践
  • 精选案例
  • 超级探访
  • 云杂志
  • 分析师和白皮书
  • 天翼云·创新直播间
市场活动
  • 2026智能云生态大会
  • 2025智能云生态大会
  • 2024智算云生态大会
  • 2023云生态大会
  • 2022云生态大会
  • 天翼云中国行
天翼云
  • 活动
  • 息壤智算
  • 产品
  • 解决方案
  • 应用商城
  • 定价
  • 合作伙伴
  • 开发者
  • 支持与服务
  • 了解天翼云
      • 文档
      • 控制中心
      • 备案
      • 管理中心
      文档中心

      星辰MaaS模型服务平台

      星辰MaaS模型服务平台

      • 星辰MaaS模型服务平台

      无数据

        • 产品介绍
        • 产品定义
        • 产品优势
        • 术语解释
        • 模型使用限制
        • 计费说明
        • 模型推理计费规则
        • 模型训推计费规则
        • 欠费说明
        • 账单和发票
        • 快速入门
        • 准备工作
        • 快速入门
        • 用户指南
        • 模型广场
        • 体验中心
        • 模型推理
        • 数据管理
        • 公共数据集
        • 我的数据集
        • 模型训练
        • 模型调优
        • 我的模型
        • 模型部署
        • 服务部署
        • 模型量化
        • 系统管理
        • API Key
        • 操作日志
        • 常见问题
        • 常见问题
        • 最佳实践
        • 零门槛CV大模型训推
        • API参考
        • 开发指南
        • 开发指南
        • 异步调用结果获取
        • 大模型异步调用结果回查
        • 状态码说明
        • 星辰语音大模型-TTS
        • 能力介绍
        • 接口文档
        • 超多方言实时语音识别
        • 能力介绍
        • 接口文档
        • 通用问答版大模型-36B
        • 能力介绍
        • 接口文档
        • 对话大模型
        • 能力介绍
        • 接口文档
        • 文生图大模型
        • 能力介绍
        • 接口文档
        • 图生图大模型
        • 能力介绍
        • 接口文档
        • 星辰多模态生成大模型
        • 接口文档
        • 星辰多模态理解大模型
        • 接口文档
        • 星辰语义大模型4-29B-A4B
        • 接口文档
        • 星辰语义大模型3-438B-A24B
        • 接口文档
        • 文档下载
        • 相关协议
        • 星辰MaaS模型推理服务协议
        • 星辰MaaS模型推理服务用户信息处理规则
        • 生成式人工智能服务备案信息参考
        • 星辰MaaS模型定制开发服务协议
          无相关产品

          本页目录

          帮助中心 星辰MaaS模型服务平台 API参考 星辰语义大模型4-29B-A4B 接口文档
          接口文档
          更新时间 2026-09-26 00:42:46
          • 新浪微博
          • 微信
            扫码分享
          • 复制链接
          最近更新时间: 2026-09-26 00:42:46
          分享文章
          • 新浪微博
          • 微信
            扫码分享
          • 复制链接

          接口信息

          API Path 

          /aipaas/algo/v1/telechat-29b/v1/chat/completions

          请求协议

          HTTPS POST

          服务鉴权

          本算法采用OpenAI协议鉴权(Bearer Token)。

          在请求头中携带API Key:`Authorization: Bearer <用户申请的API-KEY>。请在API Key页面获取长效API Key。

          请求头部:

          头部标签必填说明类型数据字典限制头部内容示例
          Content-Type是application/json[string]--application/jsonapplication/json
          traceparent否W3C Trace Context链路追踪头,格式:{version}-{trace-id}-{parent-id}-{flags}[string]---00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01
          session-id否多轮对话场景下传入,不同session传入不同session-id,非多轮对话场景请不要设置此字段设备管理-设备uuid[string]----
          Authorization是Bearer Token鉴权,格式:Bearer <用户申请的API-KEY>[string]---Bearer sk-xxxx

          traceparent字段说明

          字段示例值说明
          version00W3C版本号,默认00
          trace-id0af7651916cd43dd8448eb211c80319c32位十六进制,整条链路唯一ID
          parent-idb7ad6b716920333116位十六进制,当前请求span ID
          flags01默认01即可

          请求参数

           Json Object

          参数名说明必填类型

          model

          固定值 XingChen4-29B-A4B

          是[string]

          messages

          消息数组,按对话顺序排列

          是

          [array]

          messages>>role

          角色

          是

          [string]

          messages>>content

          消息内容,支持纯文本或内容块数组

          是

          [string/array]

          messages>>name

          参与者名称,用于区分同名角色

          否

          [string]

          messages>>tool_calls

          助手消息触发的工具调用(仅assistant)

          否

          [array]

          messages>>tool_call_id

          关联的工具调用ID(tool角色必填)

          否

          [string]

          frequency_penalty

          频率惩罚,范围-2.0~2.0,默认0

          否[number]

          logprobs

          是否返回每个输出token的对数概率,默认false

          否[boolean]

          top_logprobs

          每个token返回概率最高的前N个备选,0~20,需logprobs=true否[integer]

          max_tokens

          已弃用,请改用max_completion_tokens否[integer]
          max_completion_tokens生成的最大token数(含推理token)否[integer]
          n生成的候选回复数,默认1否[integer]
          presence_penalty存在惩罚,范围-2.0~2.0,默认0否[number]
          response_format输出格式约束否[object]
          response_format>>typetext:默认文本输出;json_object:JSON对象输出(提示词中需包含「json」字样);json_schema:按JSON Schema约束输出否[string]
          response_format>>json_schemaJSON Schema约束定义(type为json_schema时使用)否[object]
          response_format>>json_schema>>nameSchema名称否[string]
          response_format>>json_schema>>descriptionSchema描述否[string]
          response_format>>json_schema>>schemaJSON Schema定义否[object]
          seed随机种子,用于可复现采样否[integer]
          stop停止序列,最多4个否[string/array]
          stream是否流式返回,默认false否[boolean]
          stream_options流式附加选项否[object]
          stream_options>>include_usage为true时,流式末尾额外返回一个仅含usage的chunk否[boolean]
          temperature采样温度,范围0~2,默认1否[number]
          top_p核采样,范围0~1,默认1否[number]
          tools工具定义数组否[array]
          tools>>type工具类型,当前为function是[string]
          tools>>function函数定义是[object]
          tools>>function>>name函数名是[string]
          tools>>function>>description函数描述否[string]
          tools>>function>>parametersJSON Schema形式的参数定义否[object]
          tool_choice工具调用策略:none(不调用)/auto(自动决定)/required(必须调用),或指定具体函数否[string/object]
          parallel_tool_calls是否允许并行调用多个工具,默认true否[boolean]
          chat_template_kwargs深度思考模式参数,传入 {"enable_thinking": true} 启用深度思考否[object]
          chat_template_kwargs>>enable_thinking传入true启用深度思考否[boolean]

          返回结果

          • 非流式返回

          参数名说明必填类型

          id

          本次完成的唯一ID

          是[string]

          object

          固定为chat.completion

          是[string]

          created

          创建时间(Unix秒级时间戳)

          是[integer]

          model

          实际使用的模型

          是[string]

          choices

          候选回复列表

          是[array]

          choices>>index

          候选序号

          是

          [integer]

          choices>>message

          回复消息对象

          是

          [object]

          choices>>message>>role

          固定为assistant

          是

          [string]

          choices>>message>>content

          回复内容

          是

          [string]

          choices>>message>>reasoning

          深度思考

          否

          [string]

          choices>>message>>refusal

          拒绝回答时的说明

          否

          [string/null]

          choices>>message>>tool_calls

          工具调用列表(触发工具时返回)

          否

          [array]

          choices>>message>>tool_calls>>id

          工具调用ID

          否

          [string]

          choices>>message>>tool_calls>>type

          类型,为function

          否

          [string]

          choices>>message>>tool_calls>>function

          函数调用信息

          否

          [object]

          choices>>message>>tool_calls>>function>>name

          函数名

          否

          [string]

          choices>>message>>tool_calls>>function>>arguments

          函数参数(JSON字符串)

          否

          [string]

          choices>>finish_reason

          结束原因

          是

          [string]

          choices>>logprobs

          输出token的对数概率(开启logprobs时返回)

          否

          [object]

          usage

          token用量

          是

          [object]

          usage>>prompt_tokens

          输入token数

          是

          [integer]

          usage>>completion_tokens

          输出token数

          是

          [integer]

          usage>>total_tokens

          总token数

          是

          [integer]

          usage>>prompt_tokens_details>>cached_tokens

          命中的缓存token数

          否

          [integer]

          流式返回(SSE,stream=true)

          每个chunk的object为chat.completion.chunk,choices[].delta增量返回内容:

          参数名说明必填类型数据字典限制示例

          id

          完成ID

          是

          [string]

          ---

          object

          固定为chat.completion.chunk

          是

          [string]

          ---

          created

          创建时间

          是

          [integer]

          ---

          model

          模型

          是

          [string]

          ---

          choices

          候选列表

          是

          [array]

          ---

          choices>>index

          候选序号

          是

          [integer]

          ---

          choices>>delta

          增量内容,字段与消息一致(如content、tool_calls)

          是

          [object]

          ---

          choices>>finish_reason

          结束时返回原因

          否

          [string/null]

          ---

          choices>>logprobs

          增量logprobs(可选)

          否

          [object]

          ---
          usage仅当stream_options.include_usage=true时,在最后一个chunk返回否[object]---

          finish_reason取值说明

          返回码说明
          stop正常结束(命中停止序列)
          length达到token上限
          content_filter内容被安全策略拦截
          tool_calls模型发起工具调用

          请求示例

           请求体示例

          {
              "model": "XingChen4-29B-A4B",
              "messages": [
                  { "role": "system", "content": "你是乐于助人的助手。" },
                  { "role": "user", "content": "你好,一句话介绍一下你自己" }
              ],
              "stream": true,
              "stream_options": { "include_usage": true },
              "temperature": 0.7,
              "max_completion_tokens": 1024,
              "top_p": 0.9,
              "frequency_penalty": 0,
              "presence_penalty": 0,
              "seed": 42,
              "response_format": { "type": "text" }
          }

           非流式返回示例

          {
              "id": "chatcmpl-xxxxxxxx",
              "object": "chat.completion",
              "created": 1731691468,
              "model": "XingChen4-29B-A4B",
              "choices": [
                  {
                      "index": 0,
                      "message": {
                          "role": "assistant",
                          "content": "你好!我是星辰大模型,由中电信人工智能科技研发。",
                          "refusal": null
                      },
                      "finish_reason": "stop",
                      "logprobs": null
                  }
              ],
              "usage": {
                  "prompt_tokens": 15,
                  "completion_tokens": 20,
                  "total_tokens": 35,
                  "prompt_tokens_details": { "cached_tokens": 0 },
                  "completion_tokens_details": { "reasoning_tokens": 0 }
              },
              "service_tier": "default",
              "system_fingerprint": "fp_xxxxxxxx"
          }

           流式返回示例(SSE)

          data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","created":1731691468,"model":"XingChen4-29B-A4B","choices":[{"index":0,"delta":{"role":"assistant","content":""},"finish_reason":null}]}
          
          data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","created":1731691468,"model":"XingChen4-29B-A4B","choices":[{"index":0,"delta":{"content":"你"},"finish_reason":null}]}
          
          data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","created":1731691468,"model":"XingChen4-29B-A4B","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}
          
          data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","created":1731691468,"model":"XingChen4-29B-A4B","choices":[],"usage":{"prompt_tokens":15,"completion_tokens":20,"total_tokens":35}}
          
          data: [DONE]

           curl调用示例

          curl --location 'https://openapi.teleagi.cn/aipaas/algo/v1/telechat-29b/v1/chat/completions' \
          --header 'Content-Type: application/json' \
          --header 'Authorization: Bearer <用户申请的API-KEY>' \
          --data '{
              "model": "XingChen4-29B-A4B",
              "messages": [
                  { "role": "user", "content": "你好,一句话介绍一下你自己" }
              ],
              "stream": true
          }

           Python调用示例

          import requests
          
          url = "https://openapi.teleagi.cn/aipaas/algo/v1/telechat-29b/v1/chat/completions"
          api_key = "<用户申请的API-KEY>"
          
          payload = {
              "model": "XingChen4-29B-A4B",
              "messages": [{"role": "user", "content": "你好,一句话介绍一下你自己"}],
              "stream": True,
          }
          
          resp = requests.post(
              url,
              headers={
                  "Content-Type": "application/json",
                  "Authorization": f"Bearer {api_key}",
              },
              json=payload,
              stream=True,
          )
          
          # 流式解析 SSE
          for line in resp.iter_lines(decode_unicode=True):
              if line and line.startswith("data:"):
                  data = line[len("data:"):].strip()
                  if data == "[DONE]":
                      break
                  print(data)

           Java调用示例(OkHttp + Jackson)

          import okhttp3.*;
          import com.fasterxml.jackson.databind.ObjectMapper;
          
          public class ChatCompletionsExample {
          
              public static void main(String[] args) throws Exception {
                  String url = "https://openapi.teleagi.cn/aipaas/algo/v1/telechat-29b/v1/chat/completions";
                  String apiKey = "<用户申请的API-KEY>";
          
                  ObjectMapper mapper = new ObjectMapper();
                  String json = mapper.writeValueAsString(java.util.Map.of(
                      "model", "XingChen4-29B-A4B",
                      "messages", java.util.List.of(
                          java.util.Map.of("role", "user", "content", "你好,一句话介绍一下你自己")
                      ),
                      "stream", true
                  ));
          
                  OkHttpClient client = new OkHttpClient();
                  Request request = new Request.Builder()
                          .url(url)
                          .addHeader("Content-Type", "application/json")
                          .addHeader("Authorization", "Bearer " + apiKey)
                          .post(RequestBody.create(json, MediaType.get("application/json")))
                          .build();
          
                  try (Response response = client.newCall(request).execute()) {
                      // 非流式:直接打印 body
                      System.out.println(response.body().string());
                      // 流式:通过 ResponseBody.source() 逐行读取 SSE,遇 [DONE] 结束
                  }
              }
          }
          文档反馈

          建议您登录后反馈,可在建议与反馈里查看问题处理进度

          鼠标选中文档,精准反馈问题

          选中存在疑惑的内容,即可快速反馈问题,我们会跟进处理

          知道了

          上一篇 :  星辰语义大模型4-29B-A4B
          下一篇 :  星辰语义大模型3-438B-A24B
          搜索 关闭
          ©2026 天翼云科技有限公司版权所有 增值电信业务经营许可证A2.B1.B2-20090001
          公司地址:北京市东城区青龙胡同甲1号、3号2幢2层205-32室
          备案 京公网安备11010802043424号 京ICP备 2021034386号
          ©2026天翼云科技有限公司版权所有
          京ICP备 2021034386号
          备案 京公网安备11010802043424号
          增值电信业务经营许可证A2.B1.B2-20090001
          用户协议 隐私政策 法律声明