Skip to main content
Streaming allows you to receive Incredible’s response incrementally as it’s generated, rather than waiting for the complete response. This provides a better user experience for longer responses and enables real-time interactions.

​
Streaming with Tools

When using function calling with streaming, tool parameters are streamed as partial JSON: 

curl -X POST "https://api.incredible.one/v1/chat-completion" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "small-1",
    "stream":true,
    "messages": [{"role": "user", "content": "What is the weather in San Francisco?"}],
    "functions": [{
      "name": "get_weather",
      "description": "Get the current weather in a given location",
      "parameters": {
        "type": "object",
        "properties": {
          "location": {"type": "string", "description": "City and state, e.g. San Francisco, CA"}
        },
        "required": ["location"]
      }
    }]
  }'
Example response 
data: {"content": {"type": "thinking_chunk", "content": "The"}}

data: {"content": {"type": "thinking_chunk", "content": " user"}}

...

data: {"content": {"type": "thinking_chunk", "content": " parameter"}}

data: {"content": {"type": "thinking_chunk", "content": "."}}

data: {"content": {"type": "end_of_thinking", "id": "d044ba7c-a973-4c6e-adc4-10241ad03cb3"}}

data: {"content": {"type": "text_chunk", "content": "I"}}

data: {"content": {"type": "text_chunk", "content": "'ll"}}

...

data: {"content": {"type": "text_chunk", "content": " you"}}

data: {"content": {"type": "text_chunk", "content": ".\n"}}

data: {"content": {"type": "starting_function_call"}}

data: {"content": {"type": "token_usage", "input_tokens": 5061, "output_tokens": 232}}

data: {"content": {"type": "function_call", "function_call_id": "9db3163e-c088-483d-bd89-1af8f9996ba5", "function_calls": [{"name": "get_weather", "input": {"location": "San Francisco, CA"}}], "action_description": "Getting San Francisco weather"}}

data: {"content": "[DONE]"}
When working with streaming responses, the API returns content in multiple text_chunks. To get the full message, you need to combine these chunks together in the order they arrive. Each chunk is part of the overall text, so only after concatenation do you get the complete response.

​
User Experience

  • Progressive rendering: Display content as it streams in for better perceived performance
  • Loading indicators: Show appropriate loading states during streaming