Ωmega
OMEGA FOR DEVELOPERS

Build on Omega

누구나 만든 AI AGENT를 당신의 서비스에서 발견·임베드·대화하게 하세요. RAG 엔진은 우리가, 연동은 한 줄로.

QuickstartOpenAPI 스펙 다운로드

Quickstart (1분)

공개 AI AGENT 디렉터리를 조회합니다. 인증 없이 바로 호출 가능합니다.

curl
curl https://omega.itshin.com/api/agents/directory
JavaScript
const res = await fetch('https://omega.itshin.com/api/agents/directory');
const { agents } = await res.json();
console.log(agents[0].name, agents[0].handle);

API Reference

전체 스펙은 OpenAPI 3.1 다운로드 문서를 참고하세요.

인터랙티브 API 문서 열기 →
GET/api/agents/directory공개 AI AGENT 목록(이름·핸들·소개·통계)
GET/api/agents/by-handle/{handle}핸들로 AI AGENT 상세 조회

콘텐츠 생성 API NEW

AI AGENT 대화뿐 아니라 웹툰·웹소설·음악(악보 포함)·스티커·뉴스·악보를 같은 API 키로 생성합니다. Omega가 엔진을 개선하면 별도 작업 없이 품질이 자동 반영돼요.

POST/v1/content/webtoon대화/프롬프트 → 웹툰(그림체·말풍선)
POST/v1/content/webnovel프롬프트 → 웹소설 시리즈(연재)
POST/v1/content/music가사/프롬프트 → 음악(withScore로 악보까지)
POST/v1/content/sticker프롬프트 → 투명 스티커 9종(움직이는 스티커 옵션)
POST/v1/content/news주제 → 뉴스 기사(이미지 포함)
POST/v1/content/score업로드 음원 → 악보(MusicXML+MIDI+썸네일)
GET/v1/content/{type}/{id}생성 상태·결과 조회(폴링)
예: 음악 + 악보 생성
curl -X POST https://api.omega.itshin.com/v1/content/music \
  -H "Authorization: Bearer omega_..." \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "봄날의 설렘을 담은 발라드",
    "agentHandle": "netclaus",
    "options": { "genre": "발라드", "withScore": true, "scoreType": 3 }
  }'
응답(비동기 — queued)
{ "ok": true, "type": "music", "id": "ab12…", "status": "queued",
  "links": { "detail": "https://omega.itshin.com/music/ab12…",
             "og": "https://api.omega.itshin.com/content/music/ab12…/og" } }

타입별 options — webtoon: style·title·panels(4~40) / webnovel: genre·episodes(5·10·30·50)·illustrate / music: genre·lyrics·title·withScore·scoreType(1·2·3) / sticker: style(cute·line·pop)·animated(false·proc·ai) / news: category·lang / score: audio_base64·scoreType

완료 알림 — 대부분 비동기(queued)예요. content.ready 웹훅(HMAC-SHA256 서명)을 등록하거나 GET /v1/content/{type}/{id}로 폴링하세요.

과금 — 타입별 크레딧을 파트너 잔액에서 차감(부족 시 402). 카드+자동충전을 켜두면 끊김 없이 이어집니다. 키별 사용 리밋으로 상한도 걸 수 있어요.

Widget / Embed

스크립트 한 줄로 어떤 사이트에든 우하단 대화 버튼을 띄웁니다. data-agent에 핸들을 넣으세요.

HTML (한 줄 삽입)
<script src="https://omega.itshin.com/widget.js"
  data-agent="netclaus"
  data-label={tx('AI와 대화하기')}></script>

옵션: data-label(버튼 문구), data-accent(색상 hex).

SDK

경량 JS SDK로 v1 API를 호출하세요.

npm
npm install @omega/sdk
사용
import { Omega } from '@omega/sdk';
const omega = new Omega('omega_live_...');
const { agents } = await omega.agents.list();
const agent = await omega.agents.get('netclaus');

Use Cases

  • 크리에이터 사이트에 "내 AI에게 물어보기" 버튼 삽입
  • AI 검색엔진(ChatGPT·Perplexity)에서 AI AGENT 발견 → 인용 (llms.txt·ai-plugin.json 제공)
  • 커뮤니티 앱에서 디렉터리 API로 AI AGENT 추천

API Key & Webhook

인증이 필요한 v1 API는 발급한 키로 호출합니다.

인증 호출
curl https://api.omega.itshin.com/v1/agents \
  -H "Authorization: Bearer omega_..."

API Key·Webhook은 로그인 후 발급할 수 있어요.

Open Core 원칙

개방: API·위젯·문서·구조화 데이터(llms.txt, openapi.json, ai-plugin.json). 비공개: AI 모델·프롬프트·벡터DB·사용자 데이터.

API Key 발급·Webhook(이벤트 푸시)·SDK는 순차 공개 예정입니다. 문의: netclaus@gmail.com