接口详情

http调用

请求方式：POST

请求路径：https://ai.ctaigw.cn/v1/messages

说明

归属中国大陆区域的模型，HTTP 请求地址： https://ai.ctaigw.cn/v1/messages
归属全球区域的模型，根据算力所属区域，HTTP请求地址存在差异，具体模型的请求地址详见控制台-模型广场-模型详情页-调用示例。
美洲： https://ai.ctaigw.com/us/v1/messages ，欧洲：https://ai.ctaigw.com/eu/v1/messages，亚洲：https://ai.ctaigw.com/as/v1/messages
您需要先获取与配置 APP Key。若通过OpenAI SDK进行调用，需要安装SDK。

请求头

参数	必填	说明
Content‑Type	是	固定application/json
x-api-key	是	${YOUR_APP_KEY}

请求参数

参数	类型	必填	说明
model	string	是	可使用模型调用名称或模型id
system	string	否	系统提示词，用于设定助手角色、行为规则
stream	boolean	否	默认false。 true开启流式输出，边生成边返回，长文本建议开启，降低超时风险
messages	array	是	对话上下文数组，按对话顺序排列
messages[].role	string	是	角色：system/user/assistant
messages[].content	string	是	对话文本内容；文本模式下使用字符串；多模态才使用 array 格式
messages[].content[].type	string	是	输入模态类型，取值范围如下： text、image、video
messages[].content[].text	string	是	输入的文本。当type为text时，是必选参数。
messages[].content[].source	object	是	输入的图片信息。当type为image_url、video时是必选参数。
messages[].content[].source.type	string	是	取值：url
messages[].content[].source.url	string	是	图片/视频url
temperature	float	否	取值[0,2)，控制随机性；越高越发散，越低越确定；建议和 top_p 只设置其中一个
top_p	float	否	取值(0,1.0]，核采样；控制生成多样性
top_k	integer	否	只从概率最高的前 K 个 token 中采样。Anthropic 特有参数，OpenAI Chat 协议无此字段。
thinking	object	否	深度思考配置
thinking.type	string	是	可选值：enabled（开启思考模式）、disabled（关闭思考模式）。
response_format	object	否	取值范围：{"type":"text"} 、{"type":"json_object"} {"type":"json_object"}代表开启结构化 JSON 输出

非流式响应参数

参数	类型	说明
id	string	请求唯一 ID
type	string	固定为 message
role	string	固定为 assistant
model	string	使用模型名称
content	array	内容数组不同场景，参数不同
stop_reason	string	停止原因。可选值：end_turn（正常结束）、max_tokens（达到 Token 上限）、tool_use（工具调用）。
usage	object	token 消耗统计
usage.input_tokens	integer	输入 token
usage.output_tokens	integer	输出 token
usage.cache_creation_input_tokens	integer	缓存创建消耗的输入 Token 数量
usage.cache_read_input_tokens	integer	缓存读取消耗的输入 Token 数量

content-文本场景

参数	类型	说明
type	string	固定为text
text	string	模型生成的文本回复

content-思考场景

参数	类型	说明
type	string	固定为thinking
thinking	string	模型在生成最终回复前的思考过程

流式响应参数

事件类型为message_start

参数	字段类型	说明
type	string	流第一个事件，标记消息开始，固定值message_start
message	object	初始消息对象； content 为空数组； usage 仅包含input_tokens、output_tokens
message.id	string	会话id
message.type	string	值为message
message.role	string	值为assistant
message.model	string	模型名称
message.usage	object	用量统计
message.usage.input_tokens	integer	输入token数
message.usage.output_tokens	integer	输出token数

事件类型为content_block_start

参数	字段类型	说明
type	string	每个内容块开始时发送，标记新内容块的索引和类型，固定值content_block_start
index	integer	内容块索引，从 0 开始，对应该消息 content 数组中的位置
content_block	object	内容块初始对象
content_block.type	string	type 支持thinking
content_block.thinking	string	思考过程文本。
content_block.signature	string	内容块签名，服务端对该完整 content‑block 输出内容生成的摘要 / 校验签名。

事件类型为content_block_delta

参数	字段类型	说明
type	string	内容块增量推送，同一内容块可多次下发，固定值content_block_delta
index	integer	归属的内容块索引
delta	object	增量数据对象
delta.type	string	增量数据对象类型 - text_delta：文本增量，携带text - thinking_delta：思考链增量，携带thinking - signature_delta：签名增量，signature固定空字符 - input_json_delta：工具入参增量，携带partial_json
delta.text	string	增量文本片段，可能为空字符串；业务把多次 text 拼接得到完整回答

事件类型为content_block_stop

参数	字段类型	说明
type	string	标记单个内容块传输结束，固定值content_block_stop
index	integer	结束的内容块索引

事件类型为message_delta

参数	字段类型	说明
type	string	全部内容块结束后推送，消息级更新，固定值message_delta
delta	object	包含stop_reason、stop_sequence，取值同非流式响应
usage	object	token 消耗统计
usage.input_tokens	integer	输入 token
usage.output_tokens	integer	输出 token
usage.cache_creation_input_tokens	integer	缓存创建消耗的输入 Token 数量
usage.cache_read_input_tokens	integer	缓存读取消耗的输入 Token 数量

事件类型为message_stop

参数	字段类型	说明
type	string	流式最后事件，标记整条消息完成，固定值message_stop

请求/响应示例

非流式请求

请求

curl -X POST "https://ai.ctaigw.cn/v1/messages" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $DASHSCOPE_API_KEY" \
  -d '{
    "model": "qwen3.7-max",
    "max_tokens": 1024,
    "system": "You are a helpful assistant",
    "messages": [
        {
            "role": "user",
            "content": "简单介绍下天翼云星辰TokenHub产品"
        }
    ],
    "thinking": {"type": "disabled"}
}'

响应

{
  "id": "msg_xxxx-xxx-xxxx",
  "type": "message",
  "role": "assistant",
  "model": "qwen3.7-max",
  "content": [
    {
      "type": "thinking",
      "thinking": "让我分析一下这个问题...",
      "signature": ""
    },
    {
      "type": "text",
      "text": "你好！我是通义千问..."
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 22,
    "output_tokens": 223,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  }
}

流式请求

请求

curl -X POST "https://ai.ctaigw.cn/v1/messages" \
  -H "Content-Type: application/json" \
  -H "x-api-key: ${YOUR_API_KEY}" \
  --no-buffer \
  -d '{
    "model": "qwen3.7-max",
    "max_tokens": 1024,
    "stream": true,
    "messages": [
        {
            "role": "user",
            "content": "简单介绍下天翼云星辰TokenHub产品"
        }
    ],
    "thinking": {"type": "disabled"}
}'

响应

{"type":"message_start","message":{"id":"msg_xxx","type":"message","role":"assistant","model":"qwen3.8-max","content":[],"usage":{"input_tokens":15,"output_tokens":0}}}
{"type":"content_block_start","index":0,"content_block":{"type":"thinking","thinking":"","signature":""}}
{"type":"content_block_delta","index":0,"delta":{"type":"thinking_delta","thinking":"Here's a thinking process:\n\n1. **Analyze User Input:**\n   - **Topic:** 天翼云星辰TokenHub产品\n   - **Request:** 简单介绍下天翼云星辰TokenHub产品"}}
{"type":"content_block_delta","index":0,"delta":{"type":"signature_delta","signature":""}}
{"type":"content_block_stop","index":0}
{"type":"content_block_start","index":1,"content_block":{"type":"text","text":""}}
{"type":"content_block_delta","index":1,"delta":{"type":"text_delta","text":"天翼云星辰TokenHub.."}}
{"type":"content_block_stop","index":1}
{"type":"message_delta","delta":{"stop_reason":"end_turn","stop_sequence":null},"usage":{"input_tokens":15,"output_tokens":1078,"cache_creation_input_tokens":0,"cache_read_input_tokens":0}}
{"type":"message_stop"}

息壤智算

应用商城

定价

合作伙伴

开发者

支持与服务

了解天翼云

星辰TokenHub运营服务平台

星辰TokenHub运营服务平台

接口详情

http调用

请求头

请求参数

非流式响应参数

content-文本场景

content-思考场景

流式响应参数

事件类型为message_start

事件类型为content_block_start

事件类型为content_block_delta

事件类型为content_block_stop

事件类型为message_delta

事件类型为message_stop

请求/响应示例

非流式请求

请求

响应

流式请求

请求

响应

活动

息壤智算

应用商城

定价

合作伙伴

开发者

支持与服务

了解天翼云

星辰TokenHub运营服务平台

星辰TokenHub运营服务平台

接口详情

http调用

请求头

请求参数

非流式响应参数

content-文本场景

content-思考场景

流式响应参数

事件类型为message_start

事件类型为content_block_start

事件类型为content_block_delta

事件类型为content_block_stop

事件类型为message_delta

事件类型为message_stop

请求/响应示例

非流式请求

请求

响应

流式请求

请求

响应