Skip to main content
Represents a streamed chunk object of a Messages response returned by model, based on the provided input.
event: message_start
data: {
  "type": "message_start",
  "message": {
    "id": "msg_4b71d12c86d94e719c7e3984a7bb7941",
    "type": "message",
    "role": "assistant",
    "content": [],
    "stop_reason": null,
    "stop_sequence": null,
    "usage": { "input_tokens": 0, "output_tokens": 0, "cache_read_input_tokens": 0 }
  }
}

event: content_block_start
data: {
  "type": "content_block_start",
  "index": 0,
  "content_block": { "type": "text", "text": "" }
}

event: content_block_delta
data: {
  "type": "content_block_delta",
  "index": 0,
  "delta": { "type": "text_delta", "text": "Hello" }
}

event: content_block_delta
data: {
  "type": "content_block_delta",
  "index": 0,
  "delta": { "type": "text_delta", "text": ", how can I help?" }
}

event: content_block_stop
data: { "type": "content_block_stop", "index": 0 }

event: message_delta
data: {
  "type": "message_delta",
  "delta": { "stop_reason": "end_turn", "stop_sequence": null },
  "usage": { "output_tokens": 11 }
}

event: message_stop
data: { "type": "message_stop" }

event: message_start chunk object

type
string
required
Always message_start.
message
object
required
Initial response envelope for this streamed message.

event: content_block_start chunk object

type
string
required
Always content_block_start.
index
integer
required
Index of the content block in the response content array.
content_block
object
required
Initial content block payload.

event: content_block_delta chunk object

type
string
required
Always content_block_delta.
index
integer
required
Index of the content block being updated.
delta
object
required
Incremental delta payload.

event: content_block_stop chunk object

type
string
required
Always content_block_stop.
index
integer
required
Index of the block that has finished streaming.

event: message_delta chunk object

type
string
required
Always message_delta.
delta
object
required
Final message-level delta.
usage
object | null
Usage delta object that may be emitted near stream completion.

event: message_stop chunk object

type
string
required
Always message_stop. Indicates stream completion.

event: error chunk object

type
string
required
Always error.
error
object
required
Error payload object.
request_id
string | null
Request identifier for debugging and support.