Summarization

Summarization is now handled by the Sunflower conversational AI through the OpenAI-compatible POST /tasks/chat/completions endpoint. Instead of a dedicated summarization route, you send the text you want condensed along with a summarization instruction prompt.

The legacy /tasks/summarise endpoint is deprecated. Use /tasks/chat/completions with a summarization instruction, as shown below.

How it Works

You drive summarization through the messages array:

A system message defines the summarization behavior (length, tone, and any anonymization requirements).
A user message carries the text to be summarized.

This approach is flexible — adjust the instruction to control summary length, language, format (bullets vs. prose), and whether to anonymize personal identifiable information (PII).

Example Request

import requests

url = "https://api.sunbird.ai/tasks/chat/completions"

headers = {
    "accept": "application/json",
    "Authorization": "Bearer <your-access-token>",
    "Content-Type": "application/json",
}

text = (
    "John Doe, who lives in Kampala, reported that the water supply was cut off "
    "yesterday at 2 PM. He called the utility company but got no response."
)

payload = {
    "model": "Sunbird/Sunflower-14B",
    "messages": [
        {
            "role": "system",
            "content": (
                "You are a summarization assistant. Produce a concise summary of "
                "the user's text. Anonymize any personal identifiable information "
                "(names, exact locations, contact details)."
            ),
        },
        {"role": "user", "content": text},
    ],
    "temperature": 0.3,
}

response = requests.post(url, headers=headers, json=payload)
print(response.json()["choices"][0]["message"]["content"])

from openai import OpenAI

client = OpenAI(
    api_key="<your-access-token>",
    base_url="https://api.sunbird.ai/tasks",
)

completion = client.chat.completions.create(
    model="Sunbird/Sunflower-14B",
    messages=[
        {
            "role": "system",
            "content": (
                "You are a summarization assistant. Produce a concise summary of "
                "the user's text. Anonymize any personal identifiable information."
            ),
        },
        {"role": "user", "content": "John Doe, who lives in Kampala, reported that the water supply was cut off yesterday at 2 PM."},
    ],
    temperature=0.3,
)

print(completion.choices[0].message.content)

Response

The summary is returned in the standard chat completion format:

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "Sunbird/Sunflower-14B",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "A resident of Kampala reported a water supply interruption yesterday afternoon and was unable to reach the utility company."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 58, "completion_tokens": 24, "total_tokens": 82 }
}

Tune the system instruction to control the output — for example, “Summarize in three bullet points in Luganda” or “Give a one-sentence summary.” See the Sunflower Chat guide for the full set of supported parameters.

Getting Started

Guides

Support

How it Works

Example Request

Response

​How it Works

​Example Request

​Response

How it Works

Example Request

Response