AI Services/Agent

Start Chat

Start or continue an Agent chat with X-Api-Key. This endpoint does not accept Authorization: Bearer <API Key>.

Omit sessionId to create a new session; messages must then include one role=user message. Pass sessionId to continue a session, submit a tool approval, or resume a waiting run. A session that is already running returns business code 18120; use the resume endpoint instead.

A successful response is an AI SDK UI Message SSE stream and is not wrapped in { code, data }. After a new session title is generated, the stream includes data-title. When human approval is required, the stream includes data-approval-cost.

POST

/

api

/

ai

/

agent

/

chat

Start Chat

curl --request POST \
  --url https://aitoearn.cn/api/ai/agent/chat \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '{}'

import requests

url = "https://aitoearn.cn/api/ai/agent/chat"

payload = {}
headers = {
    "X-Api-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://aitoearn.cn/api/ai/agent/chat', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://aitoearn.cn/api/ai/agent/chat"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Api-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "id": "AgentController_chat_example",
  "object": "response"
}

Authorizations

X-Api-Key

string

header

required

Need to get API Key from AiToEarn. Click to go to "API Key Obtaining Tutorial".

Body

application/json

sessionId

string

Session ID. Omit it to create a new session.

messages

object[]

User messages or tool-approval responses submitted in this request. Required for a new session.

Hide child attributes

messages.role

enum<string>

required

Message role. user is a user message, and tool is a tool-approval response.

Available options:

user,

tool

messages.content

any

required

A user message can be a string or an array of text/file parts. A tool message must be an array of tool-approval-response objects.

model

string

default:auto

Model. Pass auto or a specific model ID. The default is auto.

effort

enum<string>

Reasoning effort. The request fails when the model does not support the selected effort.

Available options:

none,

low,

medium,

high,

xhigh,

max

timezone

string

User IANA time zone, for example Asia/Shanghai.

Response

Native third-party protocol response or SSE data, not wrapped in the AiToEarn common response envelope.

Native third-party protocol response, not wrapped in the AiToEarn common response envelope.

Start Chat

curl --request POST \
  --url https://aitoearn.cn/api/ai/agent/chat \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '{}'

import requests

url = "https://aitoearn.cn/api/ai/agent/chat"

payload = {}
headers = {
    "X-Api-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://aitoearn.cn/api/ai/agent/chat', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://aitoearn.cn/api/ai/agent/chat"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Api-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "id": "AgentController_chat_example",
  "object": "response"
}