개발자 센터

API·MCP·SKILL, 한곳에서 연동

모든 API에 용도·파라미터·복사할 수 있는 호출 예시가 있습니다. 내 sk- 키로 호출마다 과금되며, 잔액이 부족하면 과금도 실행도 되지 않습니다.

빠른 시작

3단계로 첫 호출을 성공시키세요.

1
가입 / 로그인
APEX 계정을 무료로 만들고 콘솔에 들어가세요.
가입하기
2
API 키 생성
콘솔의 「API 키」 페이지에서 sk- 키를 생성하면 바로 사용할 수 있습니다.
키 생성

첫 호출 보내기

예시를 복사해 sk- 키만 바꾸면 바로 실행됩니다 — 예시는 무료인 이미지 OCR입니다.

curl -X POST https://api.apex-nodes.com/api/v1/capabilities/ocr \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"image_urls":["https://example.com/poster.jpg"]}'

기본 URL

https://api.apex-nodes.com/api/v1

인증

헤더에 Authorization: Bearer sk-<내 키> 추가키 만들기 →

속도 제한과 쿼터

키별 속도 제한과 계정별 일 / 월 호출 쿼터가 적용되며, 초과 시 429와 Retry-After를 반환합니다.

무료 한도：¥2/일 — 유료 능력은 무료 한도를 먼저 차감하고, 소진된 뒤에야 지갑에서 결제됩니다.

멱등성

선택적으로 Idempotency-Key 헤더를 보내면 재시도해도 중복 과금되지 않습니다.

주요 오류 코드

401 · 키가 유효하지 않거나 없음
402 · 지갑 잔액 부족(쿠폰 우선·현금). 충전 후 다시 시도하세요
429 · 요청 제한. Retry-After에 따라 나중에 다시 시도하세요
409 · 중복된 Idempotency-Key. 중복 과금되지 않았습니다

소셜 데이터

공개 소셜 작품 조회와 검색을 플랫폼별로 정리. 화이트리스트 11개 플랫폼 모두 제공 중입니다(콘텐츠 조회 + 키워드 검색 두 가지 작업).

¥36/천 회

더우인 영상 데이터

공유 링크로 더우인 영상의 재생·좋아요·댓글·공유·작성자 등 공개 데이터를 가져옵니다.

제공 중

API 직접 호출(sk- 키)

IM / Desktop 어시스턴트 내

POST /api/v1/capabilities/social

파라미터

platform 필수 — 플랫폼. douyin 입력
action 필수 — 동작 유형. content 입력
params.url 필수 — 더우인 공유 링크(v.douyin.com 단축 링크 또는 웹 URL)

호출 예시›

curl -X POST https://api.apex-nodes.com/api/v1/capabilities/social \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"platform":"douyin","action":"content","params":{"url":"https://v.douyin.com/xxxxxx/"}}'

¥36/천 회

더우인 작품 검색

키워드로 더우인 공개 작품을 검색합니다. 주제 발굴·벤치마킹·트렌드 파악에 활용합니다.

제공 중

API 직접 호출(sk- 키)

IM / Desktop 어시스턴트 내

POST /api/v1/capabilities/social

파라미터

platform 필수 — 플랫폼. douyin 입력
action 필수 — 동작 유형. search 입력
params.keyword 필수 — 검색 키워드

호출 예시›

curl -X POST https://api.apex-nodes.com/api/v1/capabilities/social \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"platform":"douyin","action":"search","params":{"keyword":"猫咪美食"}}'

미디어 처리

영상 받아쓰기·이미지 OCR 등. 앞으로 같은 종류의 미디어 처리 능력은 모두 여기에 모입니다.

¥0.06/분

영상 받아쓰기

소셜 영상 링크를 그대로 받아쓴 자막으로 변환합니다(오디오 길이로 과금).

제공 중

API 직접 호출(sk- 키)

IM / Desktop 어시스턴트 내

POST /api/v1/capabilities/transcribe

파라미터

url 필수 — 소셜 영상 공유 링크

호출 예시›

curl -X POST https://api.apex-nodes.com/api/v1/capabilities/transcribe \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"url":"https://v.douyin.com/xxxxxx/"}'

무료

이미지 OCR

이미지나 소셜 게시물 속 텍스트를 인식합니다(호출마다 과금).

제공 중

API 직접 호출(sk- 키)

IM / Desktop 어시스턴트 내

POST /api/v1/capabilities/ocr

파라미터

image_urls 필수 — 이미지 URL 배열

호출 예시›

curl -X POST https://api.apex-nodes.com/api/v1/capabilities/ocr \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"image_urls":["https://example.com/poster.jpg"]}'

LLM / 모델 중계

AI 모델 중계: Agnes 이미지 생성·영상 생성은 제공 중이며, OpenAI 호환 챗 컴플리션은 플랫폼 내 어시스턴트에 제공됩니다. sk- 과금 버전은 곧 공개됩니다.

무료

텍스트로 이미지

한 문장으로 설명해 이미지를 생성합니다(Agnes 제공).

제공 중

API 직접 호출(sk- 키)

IM / Desktop 어시스턴트 내

POST /api/v1/capabilities/agnes-image

파라미터

prompt 필수 — 이미지 생성 프롬프트
aspect_ratio 선택 — 화면 비율(예: 16:9)

호출 예시›

curl -X POST https://api.apex-nodes.com/api/v1/capabilities/agnes-image \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"prompt":"霓虹城市夜景里奔跑的柴犬,电影质感","aspect_ratio":"16:9"}'

무료

텍스트로 영상

한 문장으로 설명해 짧은 영상을 비동기로 생성합니다(Agnes 제공).

제공 중

API 직접 호출(sk- 키)

IM / Desktop 어시스턴트 내

POST /api/v1/capabilities/agnes-video

파라미터

prompt 필수 — 영상 생성 프롬프트
seconds 선택 — 영상 길이(초)

호출 예시›

curl -X POST https://api.apex-nodes.com/api/v1/capabilities/agnes-video \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"prompt":"海浪拍打礁石的慢动作特写","seconds":5}'

Agent 전용(sk- 과금 대상 아님)

챗 컴플리션(OpenAI 호환)

OpenAI 호환 챗 컴플리션 형식으로 플랫폼이 호스팅하는 LLM을 호출합니다 — 플랫폼 IM / Desktop 어시스턴트의 표준 LLM 채널이며 Agent API Key로 인증합니다.

제공 중

IM / Desktop 어시스턴트 내

POST https://apex-nodes.com/relay/v1/chat/completions

파라미터

model 필수 — 모델 ID(사용 가능한 모델은 GET /relay/v1/models로 조회, 동일하게 Agent API Key 인증)
messages 필수 — OpenAI 형식의 메시지 배열(role + content)
stream 선택 — 스트리밍 응답 여부, 기본값 false

호출 예시›

curl -X POST https://apex-nodes.com/relay/v1/chat/completions \
  -H "Authorization: Bearer <agent-api-key>" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"用一句话介绍你自己"}]}'

준비 중

텍스트 LLM 중계(sk- 과금 버전)

sk- 키로 직접 호출하고 지갑에서 호출당 과금하는 텍스트 LLM 중계는 곧 공개됩니다. 플랫폼 내 AI 어시스턴트는 이미 OpenAI 호환 엔드포인트로 플랫폼 모델을 사용할 수 있습니다.

Websearch 중계

웹 검색을 위한 중계 엔드포인트. 이미 프로덕션 환경에서 운영 중이며, 플랫폼 내 Agent에 제공됩니다.

Agent 전용(sk- 과금 대상 아님)

웹 검색

키워드나 질문으로 웹을 검색해 페이지 제목·요약·링크를 반환합니다. 플랫폼 내 Agent가 Agent API Key로 자동 호출합니다(데스크톱/클라우드 agent는 기본 연동). 아직 sk- 키로 직접 호출하는 마켓 SKU로는 공개되지 않았습니다.

제공 중

IM / Desktop 어시스턴트 내

GET /api/v1/search/searxng/search

파라미터

q 필수 — 검색 키워드 또는 질문

호출 예시›

curl -X GET "https://api.apex-nodes.com/api/v1/search/searxng/search?q=%E6%9C%80%E6%96%B0%E6%AC%BE%E6%8A%98%E5%8F%A0%E5%B1%8F%E6%89%8B%E6%9C%BA%E8%AF%84%E6%B5%8B" \
  -H "Authorization: Bearer <agent-api-key>"

MCP / SKILL 통합 형태

API 직접 호출 외에도 이 능력들은 통합 형태로 나만의 AI 어시스턴트에 장착할 수 있습니다: SKILL은 제공 중, SDK·MCP는 곧 공개 — 자세한 내용은 능력 쇼케이스에서.

능력 쇼케이스 보기

준비 중

SDK

내 코드에서 APEX 능력을 함수처럼 호출합니다.

준비 중

MCP

MCP 프로토콜로 APEX 능력을 MCP 지원 어시스턴트에 연결합니다.

제공 중

SKILL

내 AI 어시스턴트에 스킬을 추가해 한 문장으로 호출합니다. 연결 작업이 필요 없습니다.

더우인 데이터 가져오기
Agnes 이미지·영상 생성

API·가격·무료 한도는 공개 카탈로그 GET /capabilities/catalog 에서 실시간으로 가져옵니다. 과금·요청 제한·인증은 플랫폼 공통 지갑과 sk- 키 체계를 재사용하며, 잔액이 부족하면 402를 반환합니다.