Skip to main content

​
Introduction

AI Chat is an AI chat service provided by Ace Data Cloud, offering multi-model AI conversation capabilities. Through the unified API of Ace Data Cloud, you can quickly integrate AI Chat using JavaScript to achieve multi-model support, stateful conversations, preset roles, and more.

​
Prerequisites

  • Have an Ace Data Cloud account and obtain an API Token
  • Node.js 18+ or a modern browser environment

​
Basic Usage

The main endpoint for calling the AI Chat API is: 
POST https://api.acedata.cloud/aichat/conversations
This example uses the gpt-4o model.
Available models include: gpt-4o, gpt-4, deepseek-r1, grok-3. Complete JavaScript code example: 
const response = await fetch("https://api.acedata.cloud/aichat/conversations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "gpt-4o",
  "question": "什么是人工智能？",
  "stateful": true
}),
});

const result = await response.json();
console.log(result);
Please replace YOUR_API_TOKEN with the actual token you obtained from the Ace Data Cloud platform.

​
Response Handling

It is recommended to check the response status code and handle errors: 
if (response.ok) {
  const result = await response.json();
  console.log("Call succeeded:", result);
} else {
  console.error(`Call failed, status code: ${response.status}`);
  const error = await response.text();
  console.error(error);
}

​
Node.js Wrapper

It is recommended to wrap it into a reusable function: 
async function callAIChat(data) {
  const response = await fetch("https://api.acedata.cloud/aichat/conversations", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.ACE_API_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(data),
  });
  if (!response.ok) throw new Error(`API error: ${response.status}`);
  return response.json();
}

​
Error Handling

Common error codes:
Status CodeDescription
401Authentication failed, please check API Token
403Insufficient balance or no access
429Request rate limit exceeded
500Internal server error

​
Next Steps