跳到主要内容

cURL 调用

通过 HTTP API 直接调用 CloudBase AI 大模型，适用于后端服务、脚本、任意编程语言。

前置条件​

  1. 已开通云开发环境
  2. 已配置大模型（见 大模型配置指南）
  3. 已创建 API Key（获取地址）

API 端点​

https://<ENV_ID>.api.tcloudbasegateway.com/v1/ai/<PROVIDER>/v1/chat/completions
参数说明示例
ENV_ID环境 IDyour-env-id
PROVIDER模型提供商hunyuan、deepseek

认证​

在请求头中添加 API Key：

Authorization: Bearer <YOUR_API_KEY>

文本生成​

非流式调用​

curl -X POST 'https://<ENV_ID>.api.tcloudbasegateway.com/v1/ai/hunyuan/v1/chat/completions' \
  -H 'Authorization: Bearer <YOUR_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "hunyuan-turbos-latest",
    "messages": [
      {"role": "user", "content": "介绍一下李白"}
    ],
    "stream": false
  }'

响应示例：

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "hunyuan-turbos-latest",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "李白（701年—762年），字太白，号青莲居士..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 150,
    "total_tokens": 160
  }
}

流式调用​

curl -X POST 'https://<ENV_ID>.api.tcloudbasegateway.com/v1/ai/deepseek/v1/chat/completions' \
  -H 'Authorization: Bearer <YOUR_API_KEY>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: text/event-stream' \
  -d '{
    "model": "deepseek-r1-0528",
    "messages": [
      {"role": "user", "content": "介绍一下你自己"}
    ],
    "stream": true
  }'

响应格式（SSE）：

data: {"id":"chatcmpl-xxx","choices":[{"delta":{"content":"我"},"index":0}]}

data: {"id":"chatcmpl-xxx","choices":[{"delta":{"content":"是"},"index":0}]}

data: {"id":"chatcmpl-xxx","choices":[{"delta":{"content":"DeepSeek"},"index":0}]}

data: [DONE]

请求参数​

参数类型必填说明
modelstring是模型名称
messagesarray是消息列表
streamboolean否是否流式返回，默认 false
temperaturenumber否采样温度，范围 0-2
top_pnumber否核采样，范围 0-1
max_tokensnumber否最大生成 token 数

messages 格式​

[
  {"role": "system", "content": "你是一个有帮助的助手"},
  {"role": "user", "content": "用户问题"},
  {"role": "assistant", "content": "助手回复"},
  {"role": "user", "content": "后续问题"}
]
role说明
system系统提示，设定助手行为
user用户消息
assistant助手回复

多轮对话​

curl -X POST 'https://<ENV_ID>.api.tcloudbasegateway.com/v1/ai/hunyuan/v1/chat/completions' \
  -H 'Authorization: Bearer <YOUR_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "hunyuan-turbos-latest",
    "messages": [
      {"role": "system", "content": "你是一个诗词专家"},
      {"role": "user", "content": "李白最著名的诗是什么？"},
      {"role": "assistant", "content": "李白最著名的诗之一是《静夜思》..."},
      {"role": "user", "content": "这首诗的创作背景是什么？"}
    ]
  }'

支持的模型​

腾讯混元（hunyuan-exp）​

模型名称说明
hunyuan-turbos-latest混元 Turbo S，秒回模型，吐字速度快
hunyuan-t1-latest混元深度推理模型
hunyuan-2.0-thinking-20251109混元 2.0 思考模型
hunyuan-2.0-instruct-20251111混元 2.0 指令模型

DeepSeek​

模型名称说明
deepseek-r1-0528推理模型，专为数学、代码生成和复杂逻辑推理任务设计
deepseek-v3-0324对话模型，增强推理和中文能力
deepseek-v3.2最新版对话模型

错误处理​

常见错误码​

状态码说明解决方案
401认证失败检查 API Key 是否正确
403权限不足检查环境配置和模型权限
429请求过多降低请求频率
500服务器错误稍后重试

错误响应示例​

{
  "error": {
    "message": "Invalid API key",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

编程语言示例​

Python​

import requests

url = "https://<ENV_ID>.api.tcloudbasegateway.com/v1/ai/hunyuan/v1/chat/completions"
headers = {
    "Authorization": "Bearer <YOUR_API_KEY>",
    "Content-Type": "application/json"
}
data = {
    "model": "hunyuan-turbos-latest",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": False
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result["choices"][0]["message"]["content"])

Node.js​

const response = await fetch(
  "https://<ENV_ID>.api.tcloudbasegateway.com/v1/ai/hunyuan/v1/chat/completions",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer <YOUR_API_KEY>",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      model: "hunyuan-turbos-latest",
      messages: [{ role: "user", content: "你好" }]
    })
  }
);

const result = await response.json();
console.log(result.choices[0].message.content);

相关文档​