AI Chat — Unified LLM Gateway

AceDataCloud exposes two documented chat surfaces:

Setup: See [authentication](../_shared/authentication.md) for token setup.

Quick Start

Recommended: stateful conversations

curl -X POST https://api.acedata.cloud/aichat2/conversations \
  -H "Authorization: ******ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4.1","question":"Summarize the latest release notes.","stateful":true}'

OpenAI-compatible SDK

from openai import OpenAI

client = OpenAI(
    api_key="your-token-here",
    base_url="https://api.acedata.cloud/openai"
)

response = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "Explain quantum computing"}]
)
print(response.choices[0].message.content)

Currently Documented Model Families

The OpenAPI specs expose a broad, fast-moving model catalog. Representative current models include:

/aichat2/conversations also accepts model_group values chatgpt, claude, gemini, grok, kimi, glm, and deepseek.

Image-generating models are not chat models. Names ending in -image
(e.g. gemini-*-image, gpt-4o-image) are image-generation models and do
not work on any chat surface listed above. Generate images through the
dedicated endpoints instead — Gemini via
POST /v1beta/models/{model}:generateContent, or /nano-banana/images.

OpenAI-Compatible Chat

POST /openai/chat/completions
{
  "model": "gpt-4.1",
  "messages": [{"role": "user", "content": "Write a haiku about observability."}],
  "stream": true,
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_weather",
        "parameters": {"type": "object", "properties": {"location": {"type": "string"}}}
      }
    }
  ]
}

Common parameters:

Stateful / Agentic Conversations

POST /aichat2/conversations generalizes the legacy conversation API with multimodal user content, CRUD-style actions, and server-side conversation state.

POST /aichat2/conversations
{
  "action": "chat",
  "model": "claude-sonnet-4-6",
  "message": [
    {"type": "text", "text": "Describe this image."},
    {"type": "image_url", "image_url": {"url": "https://example.com/photo.jpg"}}
  ],
  "stateful": true,
  "allowed_skills": ["google-search"],
  "allowed_mcp_servers": ["mcp-google-search"]
}

Useful parameters:

Gotchas

• The documented OpenAI-compatible routes live under /openai/, not /v1/.
• POST /aichat2/conversations is the recommended stateful endpoint; POST /aichat/conversations remains for legacy clients.
• message on /aichat2/conversations can be multimodal (text, imageurl, fileurl); plain question still works for simple text prompts.
• action on /aichat2/conversations is not chat-only — it also supports retrieve, retrieve_batch, update, and delete.
• Free-tier model variants such as gpt-5.5:free are documented on /openai/chat/completions.