接口信息

API Path 

/aipaas/mllm/v1/telemm30b/completions

请求协议

HTTPS POST

请求头部：

请求参数

 Json Object

返回结果

成功返回：

• 流式返回（stream=true）：

• 非流式返回（stream=false）：

失败返回

代码示例

流式请求-纯文本

{
    "traceId": "uuid-001",
    "timestamp": 1694280000000,
    "model": "TeleAI/TeleMM",
    "messages": [
        {
            "role": "user",
            "content": "你好，请介绍一下你自己"
        }
    ],
    "stream": true,
    "stream_options": {
        "include_usage": true
    },
    "max_completion_tokens": 1024,
    "temperature": 0.7,
    "top_p": 0.9
}

流式返回示例

data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","created":1694280000,"model":"TeleAI/TeleMM","choices":[{"index":0,"delta":{"role":"assistant","content":""},"finish_reason":null}]}

data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","created":1694280000,"model":"TeleAI/TeleMM","choices":[{"index":0,"delta":{"content":"你"},"finish_reason":null}]}

data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","created":1694280000,"model":"TeleAI/TeleMM","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","created":1694280000,"model":"TeleAI/TeleMM","choices":[],"usage":{"prompt_tokens":10,"completion_tokens":20,"total_tokens":30}}

data: [DONE]

 流式请求-多模态

{
    "traceId": "uuid-002",
    "timestamp": 1694280000000,
    "model": "TeleAI/TeleMM",
    "messages": [
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "请描述这张图片"
                },
                {
                    "type": "image_url",
                    "image_url": {
                        "url": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
                    }
                }
            ]
        }
    ],
    "stream": true
}

 非流式请求

{
    "traceId": "uuid-003",
    "timestamp": 1694280000000,
    "model": "TeleAI/TeleMM",
    "messages": [
        {
            "role": "user",
            "content": "你好，一句话介绍一下你自己"
        }
    ],
    "stream": false,
    "max_completion_tokens": 1024
}

 非流式返回示例

{
    "id": "chatcmpl-xxx",
    "created": 1694280000,
    "model": "TeleAI/TeleMM",
    "object": "chat.completion",
    "choices": [
        {
            "finish_reason": "stop",
            "index": 0,
            "logprobs": null,
            "message": {
                "role": "assistant",
                "content": "你好！我是TeleMM多模态理解大模型，由中电信人工智能科技研发。",
                "reasoning": "",
                "reasoning_content": "",
                "refusal": null
            }
        }
    ],
    "usage": {
        "completion_tokens": 20,
        "prompt_tokens": 10,
        "total_tokens": 30,
        "completion_tokens_details": {
            "reasoning_tokens": 0
        }
    }
}

非流式请求-多模态

{
    "traceId": "uuid-004",
    "timestamp": 1694280000000,
    "model": "TeleAI/TeleMM",
    "messages": [
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "这张图片里有什么？"
                },
                {
                    "type": "image_url",
                    "image_url": {
                        "url": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
                    }
                }
            ]
        }
    ],
    "stream": false
}

多轮对话

{
    "traceId": "uuid-005",
    "timestamp": 1694280000000,
    "model": "TeleAI/TeleMM",
    "messages": [
        {
            "role": "user",
            "content": "你好"
        },
        {
            "role": "assistant",
            "content": "你好！有什么可以帮你的？"
        },
        {
            "role": "user",
            "content": "介绍一下你自己"
        }
    ],
    "stream": false
}

 工具调用

{
    "traceId": "uuid-006",
    "timestamp": 1694280000000,
    "model": "TeleAI/TeleMM",
    "messages": [
        {
            "role": "user",
            "content": "北京今天天气怎么样？"
        }
    ],
    "tools": [
        {
            "type": "function",
            "function": {
                "name": "get_weather",
                "description": "获取指定城市的天气信息",
                "parameters": {
                    "type": "object",
                    "properties": {
                        "city": {
                            "type": "string",
                            "description": "城市名称"
                        }
                    },
                    "required": ["city"]
                }
            }
        }
    ],
    "tool_choice": "auto",
    "stream": false
}

 Java调用示例

import java.io.*;
import java.net.HttpURLConnection;
import java.net.URL;

public class TeleMMExample {
    public static void main(String[] args) throws Exception {
        String url = "https://openapi.teleagi.cn/aipaas/mllm/v1/telemm30b/completions";
        String json = "{"
            + "\"traceId\": \"uuid-001\","
            + "\"model\": \"TeleAI/TeleMM\","
            + "\"messages\": [{\"role\": \"user\", \"content\": \"你好\"}],"
            + "\"stream\": true"
            + "}";

        HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();
        conn.setRequestMethod("POST");
        conn.setRequestProperty("Content-Type", "application/json");
        conn.setRequestProperty("X-APP-ID", "你的AppID");
        conn.setRequestProperty("Device-Uuid", "你的设备uuid");
        conn.setRequestProperty("Authorization", "Bearer 你的鉴权信息");
        conn.setDoOutput(true);

        try (OutputStream os = conn.getOutputStream()) {
            os.write(json.getBytes("UTF-8"));
        }

        // 读取SSE流
        try (BufferedReader br = new BufferedReader(new InputStreamReader(conn.getInputStream(), "UTF-8"))) {
            String line;
            while ((line = br.readLine()) != null) {
                if (line.startsWith("data:")) {
                    String data = line.substring(5).trim();
                    if ("[DONE]".equals(data)) break;
                    System.out.println(data);
                }
            }
        }
    }
}

Python调用示例

import requests

url = "https://openapi.teleagi.cn/aipaas/mllm/v1/telemm30b/completions"
headers = {
    "Content-Type": "application/json",
    "X-APP-ID": "你的AppID",
    "Device-Uuid": "你的设备uuid",
    "Authorization": "Bearer 你的鉴权信息",
}
payload = {
    "traceId": "uuid-001",
    "model": "TeleAI/TeleMM",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": True,
}

resp = requests.post(url, headers=headers, 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)

状态码说明