TeleChat3-438B(算法编码：63650300010) — Anthropic 协议

协议类型：Anthropic Messages

---

一、接入点

环境	地址
公网	<https://openapi.teleagi.cn/aipaas/algo/v1/telechat3-438b-a24b/v1/messages>

• 请求方法：POST

---

二、鉴权

采用 x-api-key 请求头鉴权：

x-api-key: <用户申请的API-KEY>

• API Key 鉴权，请在 API Key 管理 页面，获取长效 API Key。

请求头	说明
x-api-key	API Key，必填
session-id	多轮对话场景下传入，不同 session 传入不同 session-id
traceparent	W3C Trace Context 链路追踪头，格式{version}-{trace-id}-{parent-id}-{flags}，见下表

traceparent 字段说明：

字段	示例值	说明
version	00	W3C 版本号，默认00
trace-id	0af7651916cd43dd8448eb211c80319c	32 位十六进制，整条链路唯一 ID
parent-id	b7ad6b7169203331	16 位十六进制，当前请求 span ID
flags	01	默认01 即可

---

三、请求体与返回体

3.1 请求体

顶层字段

字段	类型	必填	说明
model	string	是	固定值TeleChat3-438B-A24B
messages	array	是	消息数组，仅user / assistant 角色
system	string	否	系统提示词，独立于messages
max_tokens	integer	是	生成的最大 token 数（必填）
metadata	object	否	附加元数据（见 3.3）
service_tier	string	否	服务层级（可选）
stop_sequences	array	否	自定义停止序列，最多 4 个字符串
stream	boolean	否	是否流式返回，默认false
temperature	number	否	采样温度，范围0.0~`1.0，默认 1.0`
top_p	number	否	核采样，范围0~`1`
top_k	integer	否	只从概率最高的前 K 个 token 采样
tools	array	否	工具定义数组（见 3.4）
tool_choice	object	否	工具调用策略（见 3.5）
chat_template_kwargs	object	否	深度思考模式参数，传入{"enable_thinking": true} 启用深度思考

注意：max_tokens 为必填项，不传会报错。系统提示词通过顶层 system 字段传递，不放入 messages。

消息对象 messages[]

字段	类型	必填	说明
role	string	是	角色：user / assistant
content	string / array	是	消息内容，支持纯文本或内容块数组（见 3.2）

请求体示例

{
    "model": "TeleChat3-438B-A24B",
    "system": "你是乐于助人的助手。",
    "messages": [
        { "role": "user", "content": "你好，一句话介绍一下你自己" }
    ],
    "max_tokens": 1024,
    "stream": true,
    "temperature": 0.7,
    "top_p": 0.9,
    "stop_sequences": ["\n\nHuman:"],
    "metadata": { "user_id": "user-123" }
}

3.2 输入内容块类型 content[]

类型	结构	说明
文本	{"type":"text","text":"..."}	纯文本
工具调用	{"type":"tool_use","id":"toolu_xxx","name":"get_weather","input":{...}}	助手发起的工具调用（仅assistant）
工具结果	{"type":"tool_result","tool_use_id":"toolu_xxx","content":"...","is_error":false}	工具执行结果（仅user）

3.3 metadata

字段	类型	说明
user_id	string	终端用户唯一标识

3.4 工具定义 tools[]

字段	类型	必填	说明
name	string	是	工具名
description	string	否	工具描述
input_schema	object	是	输入参数的 JSON Schema

3.5 tool_choice

结构	说明
{"type":"auto"}	自动决定是否调用工具
{"type":"any"}	必须调用某个工具
{"type":"tool","name":"<工具名>"}	强制调用指定工具
{"type":"none"}	禁用工具

可叠加 "disable_parallel_tool_use": true 关闭并行工具调用。

3.6 返回体

非流式返回：

{
    "id": "msg_xxxxxxxx",
    "type": "message",
    "role": "assistant",
    "model": "TeleChat3-438B-A24B",
    "content": [
        { "type": "text", "text": "你好！我是TeleChat大模型，由中电信人工智能科技研发。" }
    ],
    "stop_reason": "end_turn",
    "stop_sequence": null,
    "usage": {
        "input_tokens": 15,
        "cache_creation_input_tokens": 0,
        "cache_read_input_tokens": 0,
        "output_tokens": 20
    }
}

返回字段说明：

字段	类型	说明
id	string	消息唯一 ID
type	string	固定为message
role	string	固定为assistant
content	array	内容块数组
content[].type	string	内容块类型：text（文本）/ tool_use（工具调用）
content[].text	string	模型回复文本
content[].id	string	工具调用 ID（tool_use 类型）
content[].name	string	工具名（tool_use 类型）
content[].input	object	工具参数（tool_use 类型）
model	string	实际使用的模型
stop_reason	string	结束原因（见下表）
stop_sequence	string / null	命中的停止序列
usage.input_tokens	integer	输入 token 数
usage.cache_creation_input_tokens	integer	写入缓存的 token 数
usage.cache_read_input_tokens	integer	命中缓存的 token 数
usage.output_tokens	integer	输出 token 数
service_tier	string	服务层级（可选，顶层字段）

stop_reason 取值：

值	说明
end_turn	正常结束
max_tokens	达到max_tokens 上限
stop_sequence	命中停止序列
tool_use	模型发起工具调用

流式返回（SSE，stream=true）：

流式返回按 event: / data: 成对出现：

event: message_start
data: {"type":"message_start","message":{"id":"msg_xxx","type":"message","role":"assistant","model":"TeleChat3-438B-A24B","content":[],"stop_reason":null,"stop_sequence":null,"usage":{"input_tokens":15,"output_tokens":1}}}

event: content_block_start
data: {"type":"content_block_start","index":0,"content_block":{"type":"text","text":""}}

event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"你好"}}

event: content_block_stop
data: {"type":"content_block_stop","index":0}

event: message_delta
data: {"type":"message_delta","delta":{"stop_reason":"end_turn","stop_sequence":null},"usage":{"output_tokens":20}}

event: message_stop
data: {"type":"message_stop"}

流式事件类型：

事件	说明
message_start	消息开始，携带完整message 元信息
content_block_start	内容块开始，携带index 与 content_block
content_block_delta	内容块增量更新
content_block_stop	内容块结束
message_delta	消息级更新（stop_reason、usage）
message_stop	消息结束
ping	心跳
error	错误

content_block_delta 的 delta 类型：

delta 类型	说明
text_delta	文本增量{"type":"text_delta","text":"..."}
input_json_delta	工具参数增量{"type":"input_json_delta","partial_json":"..."}

---

四、调用示例

curl

curl --location '<https://openapi.teleagi.cn/aipaas/algo/v1/telechat3-438b-a24b/v1/messages>' \
--header 'x-api-key: <用户申请的API-KEY>' \
--data '{
    "model": "TeleChat3-438B-A24B",
    "messages": [
        { "role": "user", "content": "你好，一句话介绍一下你自己" }
    ],
    "stream": true,
    "max_tokens": 1024
}'

Python

import requests

url = "<https://openapi.teleagi.cn/aipaas/algo/v1/telechat3-438b-a24b/v1/messages>"
api_key = "<用户申请的API-KEY>"

payload = {
    "model": "TeleChat3-438B-A24B",
    "messages": [{"role": "user", "content": "你好，一句话介绍一下你自己"}],
    "stream": True,
    "max_tokens": 1024,
}

resp = requests.post(
    url,
    headers={
        "x-api-key": api_key,
    },
    json=payload,
    stream=True,
)

# 流式解析 SSE（按 event / data 成对处理）
for line in resp.iter_lines(decode_unicode=True):
    if not line:
        continue
    print(line)

Java（使用 OkHttp + Jackson）

import okhttp3.*;
import com.fasterxml.jackson.databind.ObjectMapper;

public class MessagesExample {

    public static void main(String[] args) throws Exception {
        String url = "<https://openapi.teleagi.cn/aipaas/algo/v1/telechat3-438b-a24b/v1/messages>";
        String apiKey = "<用户申请的API-KEY>";

        ObjectMapper mapper = new ObjectMapper();
        String json = mapper.writeValueAsString(java.util.Map.of(
            "model", "TeleChat3-438B-A24B",
            "messages", java.util.List.of(
                java.util.Map.of("role", "user", "content", "你好，一句话介绍一下你自己")
            ),
            "max_tokens", 1024,
            "stream", true
        ));

        OkHttpClient client = new OkHttpClient();
        Request request = new Request.Builder()
                .url(url)
                .addHeader("x-api-key", 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
        }
    }
}