Create conversation chat

POST

/task.v1.TaskService/CreateChat

When request.stream=false, returns CreateChatResponse as application/json. When request.stream=true, returns text/event-stream. Each frame is written as event: plus data: ; the JSON payload follows task.v1.ConversationStreamEvent and the terminal frame is the literal string [DONE].

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

stream=false returns CreateChatResponse. stream=true returns text/event-stream frames documented by task.v1.ConversationStreamEvent, terminated by data: [DONE].

Body

🟢206

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.modellink.ai/task.v1.TaskService/CreateChat' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "string",
    "project_id": "string",
    "messages": [
        {
            "role": "string",
            "content": "string",
            "reasoning_content": "string",
            "tool_calls": [
                {
                    "id": "string",
                    "function": {
                        "name": "string",
                        "arguments": "string"
                    },
                    "type": "string"
                }
            ],
            "tool_call_id": "string"
        }
    ],
    "thinking": {
        "type": "string"
    },
    "reasoning": {
        "effort": "string"
    },
    "max_tokens": 0,
    "max_completion_tokens": 0,
    "stop": [
        "string"
    ],
    "history_id": "string",
    "stream": true,
    "temperature": 0,
    "top_p": 0,
    "tools": [
        {
            "type": "string",
            "name": "string",
            "description": "string",
            "parameters_json_schema": {},
            "strict": true
        }
    ],
    "tool_choice": {
        "type": "string",
        "function": {
            "name": "string"
        }
    },
    "max_tool_calls": 0
}'

Response Example

200 - Example 1

{
    "choices": [
        {
            "message": {
                "role": "string",
                "content": "string",
                "reasoning_content": "string"
            }
        }
    ],
    "usage": {
        "input_tokens": 0,
        "output_tokens": 0,
        "total_tokens": 0
    },
    "task_id": "string",
    "history_id": "string"
}

Modified at 2026-04-08 10:53:04

Create conversation responses

Query