Chat request (With History)

POST

http://localhost:11434/api/chat

Send a chat message with a conversation history. You can use this same approach to start the conversation using multi-shot or chain-of-thought prompting.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://localhost:11434/api/chat' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "gpt-3.5-turbo",
    "messages": [
        {
            "role": "user",
            "content": "What can you do?"
        }
    ]
}'

Response Example

200 - Success - Success

{
  "model": "llama3.2",
  "created_at": "2023-08-04T08:52:19.385406455-07:00",
  "message": {
    "role": "assistant",
    "content": "The"
  },
  "done": false
}

Request

Body Params application/json

model

string

required

Examples:

gpt-3.5-turbogpt-4

messages

array [object {2}]

required

Example:

[{"role":"user","content":"Hello!"},{"role":"assistant","content":"Hello! I am AI assistant."}]

role

enum<string>

required

Allowed values:

userassistant

Example:

user

content

string

required

Examples

Responses

🟢200Success

application/json

A stream of JSON objects is returned:

Body

model

string

required

created_at

string

required

message

object

required

role

string

required

content

string

required

done

boolean

required

🟢200Final response

Chat request (Structured outputs)

Chat request (with images)