Sunflower Chat

Sunflower is Sunbird AI’s large language model, fine-tuned for 20+ Ugandan languages and cultural context. It provides conversational AI through an OpenAI-compatible endpoint: POST /tasks/chat/completions. Because the request and response formats mirror the OpenAI Chat Completions API, you can move between the OpenAI API and the Sunbird API by changing only the base URL and API key.

Deprecated: POST /tasks/sunflower_inference and POST /tasks/sunflower_simple are deprecated and will be removed in a future release. Use POST /tasks/chat/completions instead — a single instruction is just a request with one user message.

Chat Completion

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",
}

payload = {
    "model": "Sunbird/Sunflower-14B",
    "messages": [
        {"role": "user", "content": "Good morning, what is the weather today?"}
    ],
    "temperature": 0.3,
}

response = requests.post(url, headers=headers, json=payload)
print(response.status_code)
print(response.json())

Response

{
  "id": "chatcmpl-8f14e45fceea167a5a36dedd4bea2543",
  "object": "chat.completion",
  "created": 1718000000,
  "model": "Sunbird/Sunflower-14B",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "I'm glad you're up! While I can't provide real-time weather updates, I can help you understand weather forecasts or explain common weather patterns in Uganda."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 22,
    "completion_tokens": 47,
    "total_tokens": 69
  }
}

Using the OpenAI SDK

Because the endpoint is OpenAI-compatible, the official OpenAI Python SDK works out of the box — just point base_url at https://api.sunbird.ai/tasks:

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": "user",
            "content": "translate from english to luganda: i am very hungry they should serve food in time",
        }
    ],
    temperature=0.1,
)

print(completion.choices[0].message.content)
# Ndi muyala nnyo, emmere erina okugabibwa mu budde.

Multi-turn Conversations

Maintain context by sending the running message history. Each message has a role and content:

system: Sets the behavior and persona of the AI. When omitted, a default Sunflower system message is applied.
user: The input from the human user.
assistant: A previous response from the AI (used for history).

payload = {
    "model": "Sunbird/Sunflower-14B",
    "messages": [
        {"role": "system", "content": "You are a helpful multilingual assistant."},
        {"role": "user", "content": "Translate 'hello' to Luganda."},
        {"role": "assistant", "content": "'Hello' is 'Gyebaleko'."},
        {"role": "user", "content": "And to Acholi?"},
    ],
}

Streaming

Set "stream": true to receive Server-Sent Events in OpenAI chat.completion.chunk format, terminated by data: [DONE]. With the OpenAI SDK:

stream = client.chat.completions.create(
    model="Sunbird/Sunflower-14B",
    messages=[{"role": "user", "content": "Tell me about Uganda."}],
    stream=True,
)

for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Supported Parameters

Parameter	Description
`model`	Only `Sunbird/Sunflower-14B`.
`messages`	The conversation history.
`temperature`	0.0–2.0, default 0.3.
`max_tokens`	Maximum tokens to generate.
`top_p`	Nucleus sampling.
`stop`	Stop sequence(s).
`stream`	Stream the response as SSE when `true`.

Getting Started

Guides

Support

Chat Completion

Example Request

Response

Using the OpenAI SDK

Multi-turn Conversations

Streaming

Supported Parameters

​Chat Completion

​Example Request

​Response

​Using the OpenAI SDK

​Multi-turn Conversations

​Streaming

​Supported Parameters

Chat Completion

Example Request

Response

Using the OpenAI SDK

Multi-turn Conversations

Streaming

Supported Parameters