接口信息

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。

请求头部：

traceparent字段说明

请求参数

 Json Object

返回结果

• 非流式返回

流式返回（SSE，stream=true）

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

finish_reason取值说明

请求示例

 请求体示例

{
    "model": "TeleChat3-438B-A24B",
    "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": "TeleChat3-438B-A24B",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "你好！我是TeleChat大模型，由中电信人工智能科技研发。",
                "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":"TeleChat3-438B-A24B","choices":[{"index":0,"delta":{"role":"assistant","content":""},"finish_reason":null}]}

data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","created":1731691468,"model":"TeleChat3-438B-A24B","choices":[{"index":0,"delta":{"content":"你"},"finish_reason":null}]}

data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","created":1731691468,"model":"TeleChat3-438B-A24B","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","created":1731691468,"model":"TeleChat3-438B-A24B","choices":[],"usage":{"prompt_tokens":15,"completion_tokens":20,"total_tokens":35}}

data: [DONE]

 curl调用示例

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

 Python调用示例

import requests

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

payload = {
    "model": "TeleChat3-438B-A24B",
    "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/telechat3-438b-a24b/v1/chat/completions";
        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", "你好，一句话介绍一下你自己")
            ),
            "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] 结束
        }
    }
}