Skip to main content
POST
/
agent
/
create
Create Agent
curl --request POST \
  --url https://geekai.dev/api/v1/agent/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'name=Test Agent' \
  --form 'desc=A professional customer service assistant, capable of answering product-related inquiries.' \
  --form logo='@example-file' \
  --form model=deepseek-chat \
  --form chat_level=2 \
  --form interneted=0 \
  --form stream=1
{
  "message": "agent created successfully.",
  "data": {
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "status": "initializing",
    "created_at": "2023-11-07T05:31:56Z"
  }
}
Note: For training model settings, refer to the System Supported Model List.
The response data format is fully compatible with OpenAI and varies depending on whether it is a streaming response. Refer to the request examples below:

​
cURL Request Example

curl --location --request POST 'https://geekai.dev/api/v1/agent/create' \
--header 'Authorization: Bearer {YOUR_GEEKAI_API_KEY}' \
--form 'name="Test Agent 100"' \
--form 'desc="Test Agent Bot"' \
--form 'logo=@"/E:/Pictures/geekai/geekai-icon-tr-g.png"' \
--form 'model="gpt"' \
--form 'interneted="1"'

Authorizations

​
Authorization
string
header
required

token

Body

multipart/form-data
​
name
string
required

agent name

Example:

"Test Agent"

​
desc
string
required

agent description

Example:

"A professional customer service assistant, capable of answering product-related inquiries."

agent logo image

​
model
string
default:deepseek-chat

chat model

Example:

"deepseek-chat"

​
chat_level
enum<integer>
default:2

chat level, default is 2，higher temperatures increase creativity, while lower temperatures increase accuracy.

Available options:
0,
1,
2,
3,
4
Example:

2

​
interneted
enum<integer>
default:0

enable internet access, 1 is yes, 0 is no

Available options:
0,
1
​
stream
enum<integer>
default:1

enable stream output, 1 is yes, 0 is no

Available options:
0,
1

Response

successful response

​
message
string
required

response message

Example:

"agent created successfully."

​
data
object
required