REST API overview

curl -N -X POST https://your-domain.com/api/ai/conversations/CONVERSATION_ID/messages \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o", "content": "Write a haiku about the sea."}'

import { EventSourceParserStream } from 'eventsource-parser/stream';

const res = await fetch(
  `https://your-domain.com/api/ai/conversations/${conversationId}/messages`,
  {
    method: 'POST',
    headers: {
      'X-Api-Key': process.env.AIKEEDO_API_KEY,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ model: 'gpt-4o', content: 'Write a haiku about the sea.' }),
  },
);

const events = res.body
  .pipeThrough(new TextDecoderStream())
  .pipeThrough(new EventSourceParserStream());

for await (const { event, data } of events) {
  if (event === 'text-delta') process.stdout.write(JSON.parse(data).delta ?? '');
  if (event === 'error') throw new Error(data);
}

import json
import os

import requests

url = f"https://your-domain.com/api/ai/conversations/{conversation_id}/messages"
headers = {"X-Api-Key": os.environ["AIKEEDO_API_KEY"]}
payload = {"model": "gpt-4o", "content": "Write a haiku about the sea."}

with requests.post(url, json=payload, headers=headers, stream=True) as res:
    event = None
    for line in res.iter_lines(decode_unicode=True):
        if line.startswith("event: "):
            event = line[len("event: "):]
        elif line.startswith("data: ") and event == "text-delta":
            print(json.loads(line[len("data: "):]).get("delta", ""), end="", flush=True)