curl --request POST \
--url https://api.weryai.com/v1/generation/deep_research \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"mode": "DEEP_RESEARCH",
"input": "Analyze the latest trends in AI-powered code generation tools",
"thinking_summaries": "auto",
"collaborative_planning": true,
"visualization": "auto",
"tools": [
{
"type": "GOOGLE_SEARCH"
},
{
"type": "FILE_SEARCH",
"file_search_store_names": [
"my-corpus-store"
]
}
],
"webhook_url": "https://your-server.com/webhook"
}
'{
"status": 0,
"desc": "success",
"message": "success",
"data": {
"interaction_id": "dr_interaction_abc123",
"task_id": "task_abc123",
"status": "processing"
}
}Submit Deep Research Task
Submit a Deep Research task. Supports multi-round research sessions, file-based context input, and configurable AI agent tools.
curl --request POST \
--url https://api.weryai.com/v1/generation/deep_research \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"mode": "DEEP_RESEARCH",
"input": "Analyze the latest trends in AI-powered code generation tools",
"thinking_summaries": "auto",
"collaborative_planning": true,
"visualization": "auto",
"tools": [
{
"type": "GOOGLE_SEARCH"
},
{
"type": "FILE_SEARCH",
"file_search_store_names": [
"my-corpus-store"
]
}
],
"webhook_url": "https://your-server.com/webhook"
}
'{
"status": 0,
"desc": "success",
"message": "success",
"data": {
"interaction_id": "dr_interaction_abc123",
"task_id": "task_abc123",
"status": "processing"
}
}Authorizations
Authenticate using Bearer token. Get your API Key from the WeryAI Console.
Example: Authorization: Bearer sk-xxxxxxxxxxxxxxxx
Body
Request parameters for submitting a Deep Research task. At least one of input or input_resource must be provided. Exactly one of mode or model must be specified — they are mutually exclusive.
Research run mode. Mutually exclusive with model — provide one or the other, not both.
DEEP_RESEARCH, DEEP_RESEARCH_MAX "DEEP_RESEARCH"
Model key for the research task. Mutually exclusive with mode — provide one or the other, not both. When model is specified, the task runs synchronously and the result is returned directly in the response data.deep_research_outputs field.
| Model Name | Model Key |
|---|---|
| Gemini-2.5-Pro | GEMINI_25_PRO |
| Gemini-2.5-Flash | GEMINI_25_FLASH |
| Gemini-3.1-Flash-Lite | GEMINI_3_1_FLASH_LITE |
| Gemini-3.1-Pro | GEMINI_3_1_PRO |
"GEMINI_25_PRO"
Interaction ID from a previous research or execution session, used to continue a multi-round conversation.
"dr_interaction_abc123"
Controls how the model exposes its reasoning chain. Set to auto to let the model decide.
"auto"
When true, the task enters the research/planning phase before execution.
true
Plain text input for the research task. At least one of input or input_resource must be provided.
"Analyze the latest trends in AI-powered code generation tools"
Structured input list supporting text, image, and document items. At least one of input or input_resource must be provided.
Show child attributes
Show child attributes
Controls whether the agent may generate charts or diagrams. Set to auto to let the model decide.
"auto"
List of agent tools to enable for this task.
Show child attributes
Show child attributes
Callback URL where results will be sent when the task completes.
"https://your-server.com/webhook"
Caller ID (for business association)