AI Chat cURL Quick Start - Ace Data Cloud

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 call AI Chat using cURL to achieve features such as multi-model support, stateful conversations, and preset roles.

Prerequisites

Have an Ace Data Cloud account and obtain an API Token
Terminal environment with cURL installed

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 cURL command example:

curl -X POST https://api.acedata.cloud/aichat/conversations \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o", "question": "什么是人工智能？", "stateful": true}'

Please replace YOUR_API_TOKEN with the actual Token you obtained from the Ace Data Cloud platform.

Response Example

A successful call returns data in JSON format, for example:

{
  "status": "success",
  "data": {
    ...
  }
}

Using jq to Process Response

It is recommended to use the jq tool to format the output:

curl -s -X POST https://api.acedata.cloud/aichat/conversations \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o", "question": "什么是人工智能？", "stateful": true}' | jq .

Error Handling

Common error codes:

Status Code	Description
401	Authentication failed, please check API Token
403	Insufficient balance or no access rights
429	Request rate limit exceeded
500	Internal server error

Next Steps

Go to the Ace Data Cloud Console to obtain an API Token
Check the API Documentation for complete parameter details
Review the Pricing Plans to understand the costs

Tutorials

​Introduction

​Prerequisites

​Basic Usage

​Response Example

​Using jq to Process Response

​Error Handling

​Next Steps