当前位置：首页 > news >正文

AI 聊天 API 集成指南

news 2026/4/29 7:18:00

随着人工智能技术的发展，集成问答 API 已成为开发者常见的需求。然而，许多市场上的 API，如 OpenAI 的 Chat Completions API，由于需要传递历史上下文和处理 token 限制，集成起来相对复杂。为了解决这些问题，Ace Data Cloud 提供了一种优化的 AI 问答 API，简化了集成过程，支持多轮对话，并自动处理 token 限制，极大提升了开发效率。

本文将详细介绍如何集成 Ace Data Cloud 的 AI 问答 API。

环境准备/前置条件

在开始之前，请确保您已经完成以下步骤：

注册并登录 Ace Data Cloud。
申请使用 AI 问答 API 服务。

详细步骤

申请 API 服务

访问 AI Q&A API 页面，点击“获取”按钮。如果您没有登录，将自动跳转至登录页面。首次申请将获得免费的 API 使用配额。

基本用法

基本用法非常简单，只需传递一个question字段和指定模型即可。例如，填入问题：“你叫什么名字？”如下图所示：

在请求头中设置：

accept: 返回结果的格式，这里填入application/json。
authorization: 调用 API 的密钥。

请求体中设置：

model: 模型选择，如 GPT 3.5 或 GPT 4。
question: 需要提问的内容。

测试成功后，您将收到如下 JSON 格式的响应：

{ "answer": "我是一种由 OpenAI 开发的 AI 语言模型，没有个人名称。不过，你可以叫我 GPT 或只称呼我为聊天机器人。今天我能为你做些什么？" }

如果不需要支持多轮对话，这个 API 可以大大简化您的集成工作。

多轮对话

若要实现多轮对话，需要在请求中添加一个参数stateful，并将其值设置为true。每次后续请求都需要携带该参数。第一请求设置stateful参数如下：

curl -X POST 'https://api.acedata.cloud/aichat/conversations' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "model": "gpt-3.5", "question": "你叫什么名字？", "stateful": true }'

您将收到一个包含id的响应：

{ "answer": "我是一种由 OpenAI 开发的 AI 语言模型，没有个人名称。你可以叫我 OpenAI 或 ChatGPT。今天我能为你做些什么？", "id": "7cdb293b-2267-4979-a1ec-48d9ad149916" }

在第二次请求中，将id字段传入，继续进行对话：

curl -X POST 'https://api.acedata.cloud/aichat/conversations' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "model": "gpt-3.5", "stateful": true, "id": "7cdb293b-2267-4979-a1ec-48d9ad149916", "question": "我刚才问的是什么？" }'

响应将基于上下文进行回答。

流式响应

该接口也支持流式响应，非常适合 Web 集成。若要实现流式响应，只需将请求头中的accept参数修改为application/x-ndjson。以下是 Python 的示例代码：

import requests url = "https://api.acedata.cloud/aichat/conversations" headers = { "accept": "application/x-ndjson", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "model": "gpt-3.5", "stateful": True, "question": "你好" } response = requests.post(url, json=payload, headers=headers, stream=True) for line in response.iter_lines(): print(line.decode())

模型预设

您可以使用preset字段为模型设置预设内容，例如：

curl -X POST 'https://api.acedata.cloud/aichat/conversations' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "model": "gpt-3.5", "stateful": true, "question": "你能帮我什么？", "preset": "你是一位专业艺术家" }'

图像识别

该 API 还支持通过传递图像链接进行图像识别，如下所示：

curl -X POST 'https://api.acedata.cloud/aichat/conversations' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "model": "gpt-4-vision", "question": "图片中有多少个苹果？", "references": ["https://cdn.acedata.cloud/ht05g0.png"] }'