Sea Lion AI Worker

A simple Cloudflare Worker that exposes the Sea Lion model (@cf/aisingapore/gemma-sea-lion-v4-27b-it) as a REST API.

Endpoints

Endpoint	Method	Description
/	GET	Starter prompt for AI coding tools
/health	GET	Health check
/chat	POST	Non-streaming chat completion
/stream	POST	Streaming chat completion (plain text)

Usage

Non-Streaming Chat (/chat)

curl -X POST https://your-worker.workers.dev/chat \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {"role": "system", "content": "You are a helpful assistant"},
      {"role": "user", "content": "What is Singapore famous for?"}
    ]
  }'

Simple format:

curl -X POST https://your-worker.workers.dev/chat \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "What is Singapore famous for?",
    "system": "You are a helpful assistant"
  }'

Streaming Chat (/stream)

curl -X POST https://your-worker.workers.dev/stream \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {"role": "system", "content": "You are a helpful assistant"},
      {"role": "user", "content": "Tell me a story"}
    ]
  }'

Starter Prompt for AI Coding Tools

Easy way: Just visit your deployed worker URL (e.g., https://cf-sealion.your-subdomain.workers.dev/) and copy the entire response - it contains a ready-to-use prompt with your actual API URL!

Or copy this prompt manually:

I want to integrate the Sea Lion AI model into my app. Here's the API details:

API Base URL: https://your-worker.workers.dev

ENDPOINTS:

1. POST /chat - Non-streaming chat completion
   Request body:
   {
     "prompt": "Your question here",
     "system": "Optional system prompt"
   }
   OR
   {
     "messages": [
       {"role": "system", "content": "System prompt"},
       {"role": "user", "content": "User message"}
     ]
   }
   Response: { "response": "AI response text" }

2. POST /stream - Streaming chat completion (plain text stream)
   Same request body as /chat
   Response: Plain text stream (no parsing needed!)

EXAMPLE CODE (Non-streaming):

const response = await fetch('https://your-worker.workers.dev/chat', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    prompt: 'Hello!',
    system: 'You are a helpful assistant'
  })
});
const data = await response.json();
console.log(data.response);

EXAMPLE CODE (Streaming):

const response = await fetch('https://your-worker.workers.dev/stream', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    prompt: 'Tell me a story',
    system: 'You are a helpful assistant'
  })
});

const reader = response.body.getReader();
const decoder = new TextDecoder();
let text = '';

while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  text += decoder.decode(value);
  console.log(text); // Plain text, no parsing needed!
}

Please help me build [describe your feature] using this Sea Lion AI API.

Important: Replace https://your-worker.workers.dev with your actual deployed worker URL.

Using in Lovable, Bolt, or other platforms

When building apps in Lovable, Bolt, or other platforms, you can call this API like this:

// Non-streaming
const response = await fetch('https://your-worker.workers.dev/chat', {
	method: 'POST',
	headers: { 'Content-Type': 'application/json' },
	body: JSON.stringify({
		prompt: 'Hello, how are you?',
		system: 'You are a friendly assistant',
	}),
});
const data = await response.json();
console.log(data.response);

// Streaming (returns plain text, no parsing needed!)
const streamResponse = await fetch('https://your-worker.workers.dev/stream', {
	method: 'POST',
	headers: { 'Content-Type': 'application/json' },
	body: JSON.stringify({
		prompt: 'Tell me about AI',
		system: 'You are a helpful assistant',
	}),
});

const reader = streamResponse.body.getReader();
const decoder = new TextDecoder();
let text = '';

while (true) {
	const { done, value } = await reader.read();
	if (done) break;
	text += decoder.decode(value);
	console.log(text);
}

Deploy Your Own

Option 1: One-Click Deploy

Click the button above to deploy directly to Cloudflare Workers.

Option 2: Manual Deploy

1. Clone the repository

   git clone https://github.com/fayazara/cf-sealion.git
   cd cf-sealion

2. Install dependencies

   npm install
   # or
   pnpm install

3. Login to Cloudflare

   npx wrangler login

4. Deploy

   npm run deploy

5. Your worker will be available at https://cf-sealion.<your-subdomain>.workers.dev

Local Development

npm run dev

This starts a local server at http://localhost:8787.

Request Format

Messages Array Format

{
	"messages": [
		{ "role": "system", "content": "System prompt here" },
		{ "role": "user", "content": "User message" },
		{ "role": "assistant", "content": "Previous assistant response" },
		{ "role": "user", "content": "Follow-up question" }
	]
}

Simple Format

{
	"prompt": "Your question here",
	"system": "Optional system prompt"
}

Response Format

Non-Streaming (/chat)

{
	"response": "The AI's response text here"
}

Streaming (/stream)

Returns plain text chunks directly - no JSON parsing needed! Just read the stream and concatenate the text.

About Sea Lion

Sea Lion is a family of Large Language Models developed by AI Singapore, optimized for Southeast Asian languages and context. Learn more at AI Singapore.

License

MIT