OMGY AI Developer Documentation

curl -N -X POST "https://api.omgy.ai/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omgy-1-mini",
    "messages": [
      {
        "role": "system",
        "content": "You are a helpful and concise assistant."
      },
      {
        "role": "user",
        "content": "Hello! How can I integrate with the OMGY AI API?"
      }
    ],
    "effort_level": "low",
    "temperature": 0.7,
    "max_output": "auto",
    "stream": true
  }'

import requests
import json
import sys

# Your full OMGY API token (starts with ogpr-)
API_KEY = "YOUR_API_TOKEN"  # e.g. "ogpr-10101010101010101010101010101010-XXXXXXX"

url = "https://api.omgy.ai/v1/chat/completions"
headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# Model: omgy-1-mini (Max Input: 16,384 tokens | Max Output: 32,768 tokens)
payload = {
    "model": "omgy-1-mini",
    "messages": [
        {
            "role": "system",
            "content": "You are a helpful and concise assistant."
        },
        {
            "role": "user",
            "content": "Hello! How can I integrate with the OMGY AI API?"
        }
    ],
    "effort_level": "low",
    "temperature": 0.7,
    "max_output": "auto",   # or a number; above the model limit it is clamped, with a warning
    "stream": True
}

response = requests.post(url, headers=headers, json=payload, stream=True)

# OMGY reports adjusted parameters (e.g. max_output above the model limit) as warnings
if response.headers.get("OMGY-Warning"):
    print("[OMGY warning]", response.headers["OMGY-Warning"], file=sys.stderr)

if response.status_code != 200:
    try:
        print(f"Error {response.status_code}:", response.json())
    except Exception:
        print(f"Error {response.status_code}:", response.text)
    exit(1)

for line in response.iter_lines(decode_unicode=True):
    if line and line.startswith("data: "):
        data_str = line[6:].strip()
        if data_str == "[DONE]":
            break
        try:
            chunk = json.loads(data_str)
            if "error" in chunk:
                print("\nStream Error:", chunk["error"])
                break
            content = chunk.get("content", "")
            print(content, end="", flush=True)
        except Exception:
            pass
print()

// Your full OMGY API token (starts with ogpr-)
const API_KEY = "YOUR_API_TOKEN"; // e.g. "ogpr-10101010101010101010101010101010-XXXXXXX"

// Model: omgy-1-mini (Max Input: 16,384 tokens | Max Output: 32,768 tokens)
const response = await fetch("https://api.omgy.ai/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "omgy-1-mini",
    messages: [
      {
        role: "system",
        content: "You are a helpful and concise assistant."
      },
      {
        role: "user",
        content: "Hello! How can I integrate with the OMGY AI API?"
      }
    ],
    effort_level: "low",
    temperature: 0.7,
    max_output: "auto",
    stream: true
  })
});

// OMGY reports adjusted parameters (e.g. max_output above the model limit) as warnings
const omgyWarning = response.headers.get("OMGY-Warning");
if (omgyWarning) console.warn("[OMGY warning]", omgyWarning);

if (!response.ok) {
  const err = await response.json().catch(() => ({}));
  console.error(`Error ${response.status}:`, err);
  return;
}

const reader = response.body.getReader();
const decoder = new TextDecoder("utf-8");

while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  
  const text = decoder.decode(value);
  const lines = text.split("\n");
  for (const line of lines) {
    if (line.startsWith("data: ")) {
      const dataStr = line.slice(6).trim();
      if (dataStr === "[DONE]") break;
      try {
        const chunk = JSON.parse(dataStr);
        if (chunk.error) {
          console.error("Stream Error:", chunk.error);
          break;
        }
        const content = chunk.content || "";
        process.stdout.write(content);
      } catch (e) {}
    }
  }
}

Authorization: Bearer YOUR_API_TOKEN

Authorization: YOUR_API_TOKEN

{
  "api_token": "YOUR_API_TOKEN",
  "model": "omgy-1-mini",
  "messages": [
    { "role": "user", "content": "Hello!" }
  ]
}

{
  "model": "omgy-1-mini",
  "messages": [
    {
      "role": "system",
      "content": "You are a specialized Python programming mentor. Always respond with concise code snippets and clear explanations."
    },
    {
      "role": "user",
      "content": "How do I reverse a list in Python?"
    }
  ]
}

curl -X POST "https://api.omgy.ai/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omgy-1-mini",
    "messages": [
      { "role": "user", "content": "What is the speed of light?" }
    ],
    "stream": false
  }'

{
  "id": "chatcmpl-a1b2c3d4e5f6g7h8",
  "object": "chat.completion",
  "created": 1740000000,
  "model": "omgy-1-mini",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "The speed of light in vacuum is approximately 299,792,458 meters per second (about 300,000 km/s or 186,282 miles/s)."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 34,
    "total_tokens": 46
  }
}

{
  "id": "chatcmpl-a1b2c3d4e5f6g7h8",
  "object": "chat.completion",
  "model": "omgy-1-mini",
  "choices": [ ... ],
  "usage": { ... },
  "warnings": [
    {
      "code": "max_output_clamped",
      "param": "max_output",
      "message": "'max_output'=50,000 is above the maximum output of OMGY-1-Mini (32,768 tokens); using 32,768."
    }
  ]
}

curl -X GET "https://api.omgy.ai/v1/models" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "object": "list",
  "data": [
    {
      "id": "omgy-1-mini",
      "name": "OMGY-1-Mini",
      "created": 1740000000,
      "context_length": 1000000,
      "max_input_tokens": 16384,
      "max_output_tokens": 32768,
      "owned_by": "omgy-ai",
      "root": "omgy-1-mini",
      "parent": null
    }
  ]
}

curl -X GET "https://api.omgy.ai/v1/chats" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

curl -X GET "https://api.omgy.ai/v1/chats/c8f1e29a-4b7d-41a3-9e5c-0123456789ab" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

curl -X DELETE "https://api.omgy.ai/v1/chats/c8f1e29a-4b7d-41a3-9e5c-0123456789ab" \
  -H "Authorization: Bearer YOUR_API_TOKEN"