API, MCP and SKILL — one place to integrate
Every endpoint ships an intent, parameters and a copy-paste request example. Billed per call with your own sk- key — if your balance is short, nothing is charged and nothing runs.
Quick start
Three steps to your first successful call.
- 1
- 2
Create an API key
Create your sk- key on the console's API keys page — it works immediately.
Create a key - 3
Make your first call
Copy the example and swap in your sk- key — it uses image OCR, which is free.
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"]}'
Base URL
https://api.apex-nodes.com/api/v1Rate limits & quotas
Per-key request rate plus per-account daily / monthly call quotas; exceeding them returns 429 with Retry-After.
Free allowance:¥2/day — paid capabilities draw on the free allowance first; the wallet is only charged once it runs out.
Idempotency
Optionally send an Idempotency-Key header — a retry is never charged twice.
Common error codes
401· Missing or invalid key402· Wallet balance too low (vouchers first, then cash) — top up and retry429· Rate limited — retry later per Retry-After409· Duplicate Idempotency-Key — not charged again
Social data
Fetch and search public social posts, grouped by platform. All 11 whitelisted platforms are live (content lookup + keyword search).
Douyin video data
Pull a Douyin video's public play, like, comment, share and author data from a share link.
POST /api/v1/capabilities/socialParameters
platformRequired — Platform — set to douyinactionRequired — Action — set to contentparams.urlRequired — Douyin share link (a v.douyin.com short link or a web URL)
Request example›
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/"}}'Douyin post search
Search public Douyin posts by keyword for topic research, benchmarking and trend discovery.
POST /api/v1/capabilities/socialParameters
platformRequired — Platform — set to douyinactionRequired — Action — set to searchparams.keywordRequired — Search keyword
Request example›
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":"猫咪美食"}}'Media processing
Video transcription, image OCR and more — future media-processing capabilities all hang here.
Video transcription
Turn one social video link into a verbatim transcript, billed by audio length.
POST /api/v1/capabilities/transcribeParameters
urlRequired — Social video share link
Request example›
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/"}'Image OCR
Read the text in an image or social post, billed per call.
POST /api/v1/capabilities/ocrParameters
image_urlsRequired — Array of image URLs
Request example›
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 / model relay
AI model relay: Agnes text-to-image and text-to-video are live; OpenAI-compatible chat completions serve assistants on the platform, and an sk--billed version is coming soon.
Text to image
Describe it in a sentence and generate an image (made by Agnes).
POST /api/v1/capabilities/agnes-imageParameters
promptRequired — Image promptaspect_ratioOptional — Aspect ratio, e.g. 16:9
Request example›
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"}'Text to video
Describe it in a sentence and generate a short video asynchronously (made by Agnes).
POST /api/v1/capabilities/agnes-videoParameters
promptRequired — Video promptsecondsOptional — Video length in seconds
Request example›
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}'Chat completions (OpenAI-compatible)
Call the platform-hosted LLMs in the OpenAI-compatible chat-completions format — the standard LLM channel for the platform's IM / Desktop assistants, authenticated with an Agent API Key.
POST https://apex-nodes.com/relay/v1/chat/completionsParameters
modelRequired — Model id (list the available models via GET /relay/v1/models, same Agent API Key auth)messagesRequired — OpenAI-format message array (role + content)streamOptional — Stream the response; defaults to false
Request example›
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":"用一句话介绍你自己"}]}'Text-LLM relay (sk- billed)
A text-LLM relay you call directly with an sk- key, billed per call from your wallet — coming soon. Platform assistants can already use platform models through the OpenAI-compatible endpoint.
Websearch relay
A relay endpoint for live web search — already live in production, serving agents on the platform.
Web search
Search the live web for a keyword or question and return page titles, snippets and links. Available to agents on the platform via their Agent API Key (wired in by default for hosted/desktop agents) — not yet opened as an sk- key marketplace SKU.
GET /api/v1/search/searxng/searchParameters
qRequired — Search keyword or question
Request example›
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 integration forms
Beyond direct API calls, these capabilities also plug into your own AI assistant as integrations: SKILL is live, SDK and MCP are coming soon — see the capability shelf.
SDK
Call APEX capabilities as functions from your own code.
MCP
Connect APEX capabilities to any MCP-aware assistant over the MCP protocol.
SKILL
Give your AI assistant a skill it can invoke in one sentence — nothing to wire up.
- Douyin data fetch
- Agnes image & video
Endpoints, prices and the free allowance are read live from the public catalog GET /capabilities/catalog. Billing, rate limiting and auth reuse the platform's shared wallet and sk- key system; a short balance returns 402.