POST https://api.genaifactory.ai/v1/start_conversation
Headers
Name
Type
Required
Description
formacloud-api-key
string
Yes
API key for authentication
Request Body
Name
Type
Required
Description
goal
string
Yes
The goal or topic of the conversation
session_id
string
No
An optional session ID (auto-generated if empty)
Example Request
curl --location 'https://api.genaifactory.ai/v1/start_conversation' \
--header 'formacloud-api-key: abc123' \
--header 'Content-Type: application/json' \
--data '{
"goal":"Ask the user what he/she wants, and help them create it.",
"session_id":"shuxuan-test-1"
}'
Response
Returns a JSON object containing session details and the first conversation step.
Field
Type
Description
session_id
string
Unique session identifier
current_step
object
The current step in the conversation
Example Response
{
"current_step": {
"agent_response": {
"action": "AskUser",
"parameters": {
"question": "Hello! I'm here to help you create something amazing. What would you like to create today? I can help with:\n\n1. Creating images from text descriptions\n2. Converting images to short videos\n3. Processing and analyzing images\n4. Creating HTML visualizations\n\nPlease let me know what you have in mind, and I'll help plan and execute it step by step!"
},
"reasoning": "Since this is the start of our interaction and there's no specific request yet in the history, I should first understand what the user wants to create. As a master planner, I need to gather initial requirements before proposing any specific approach.",
"selected_tool": ""
},
"id": 0,
"step_result": null,
"timestamp": "2025-02-21T04:13:24.128311+00:00"
},
"session_id": "shuxuan-test-1"
}