cURL 调用

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

前置条件

1. 已开通云开发环境
2. 已购买 Token 资源包并启用模型开关（见 接入大模型）
3. 已创建 API Key（获取地址）

API 端点

https://<ENV_ID>.api.tcloudbasegateway.com/v1/ai/<PROVIDER>/chat/completions

参数	说明	示例
ENV_ID	环境 ID	your-env-id
PROVIDER	模型提供商	cloudbase

认证

在请求头中添加 API Key：

Authorization: Bearer <YOUR_API_KEY>

文本生成

非流式调用

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

响应示例：

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "deepseek-v4-flash",
  "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/cloudbase/chat/completions' \
  -H 'Authorization: Bearer <YOUR_API_KEY>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: text/event-stream' \
  -d '{
    "model": "deepseek-v4-flash",
    "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]

请求参数

参数	类型	必填	说明
model	string	是	模型名称
messages	array	是	消息列表
stream	boolean	否	是否流式返回，默认 false
temperature	number	否	采样温度，范围 0-2
top_p	number	否	核采样，范围 0-1
max_tokens	number	否	最大生成 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/cloudbase/chat/completions' \
  -H 'Authorization: Bearer <YOUR_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {"role": "system", "content": "你是一个诗词专家"},
      {"role": "user", "content": "李白最著名的诗是什么？"},
      {"role": "assistant", "content": "李白最著名的诗之一是《静夜思》..."},
      {"role": "user", "content": "这首诗的创作背景是什么？"}
    ]
  }'

错误处理

常见错误码

状态码	说明	解决方案
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/cloudbase/chat/completions"
headers = {
    "Authorization": "Bearer <YOUR_API_KEY>",
    "Content-Type": "application/json"
}
data = {
    "model": "deepseek-v4-flash",
    "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/cloudbase/chat/completions",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer <YOUR_API_KEY>",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      model: "deepseek-v4-flash",
      messages: [{ role: "user", content: "你好" }]
    })
  }
);

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