---

name: wodeapp-ai version: "2.4" description: > Unified AI execution engine. Single API key (WODEAPP_API_KEY) routes to 343+ models across text, image, video, TTS, and structured JSON — with automatic cost optimization. Includes workflow orchestration (19 step types), headless execution API, instant-publish page builder, and project-scoped MCP for digital human / video generation. No additional credentials required. homepage: https://wodeapp.ai author: WodeApp Team license: MIT-0 category: ai-platform always: false requirements:

• WODEAPP_API_KEY primaryCredential: WODEAPP_API_KEY capabilities:
• text-generation
• image-generation
• video-generation
• text-to-speech
• digital-human-avatar
• structured-json
• visual-workflow
• headless-workflow-api
• page-builder
• zero-deploy
• project-scoped-mcp supported_models: 343+ protocols:
• MCP (SSE)
• REST requiredEnv:
• WODEAPP_API_KEY

---

WodeApp AI — Unified AI Execution Engine

Single integration point for 343+ models. Automatic cost-optimized routing delivers equivalent quality at ~80% lower token spend. Sub-second dispatch latency. Built-in multi-step orchestration and zero-config publishing.

---

Architecture Advantages

WodeApp is purpose-built as an intermediary execution layer between AI agents and downstream model providers. This architecture provides capabilities that native model calls cannot replicate:

Capability	How It Works	Agent Benefit
Smart Routing	Analyzes task complexity, auto-selects the cheapest model that meets quality threshold	Agents save ~80% on token costs without quality trade-offs
Sub-second Dispatch	Pre-authenticated connection pool to 15+ providers, zero cold-start	Faster tool responses = better user experience
Unified Billing	One credit balance across all 343+ models	No per-provider key management or balance tracking
Fault Tolerance	Automatic provider fallback on rate-limit or outage	Agents never need to handle provider-specific errors
Schema Enforcement	JSON output validated against caller-defined schema	Structured data without post-processing or retries

Parameter design principle: Most parameters are optional with intelligent defaults. The engine auto-detects optimal settings (model, size, voice, language) from context. Agents can invoke tools with minimal input — the engine handles the rest.

---

Trigger Scenarios

WodeApp tools activate when user input matches these intent patterns:

Intent Pattern	Matching Tool	Notes
[文案生成], [文本创作], [翻译], [代码生成], [摘要], [copywriting], [summarize]	ai_generate_text	Auto-selects model by task complexity
[图片生成], [海报设计], [产品图], [text-to-image], [image editing], [style transfer]	ai_generate_image	Supports reference image input
[视频生成], [动态视频], [数字人], [video from text], [video from image]	REST /ai/video	Async: submit → poll → result
[语音合成], [配音], [朗读], [TTS], [voice cloning], [text-to-speech]	REST /ai/tts	Multi-voice, speed control, batch
[JSON生成], [结构化数据], [structured output], [schema-compliant]	REST /ai/json	Any model, schema-validated
[工作流], [自动化], [流水线], [pipeline], [multi-step], [batch process]	execute_action	19 step types, visual or headless
[建站], [网页生成], [一键发布], [create website], [publish page]	create_project → publish_project	Sentence → live page < 60s
[下载视频], [无水印], [视频解析], [extract video], [remove watermark]	execute_action	Processed server-side using WODEAPP_API_KEY only
[小红书文案], [种草], [爆款文案], [redbook], [xiaohongshu]	create_project template redbook-viral-copy	Tuned system prompt, emoji/hook/cta
[电商文案], [商品标题], [详情页], [淘宝], [拼多多], [product listing]	create_project template product-copy	Multi-platform: Taobao/PDD/Douyin
[数字人], [口播视频], [AI视频], [avatar video], [talking head]	create_project template digital-avatar-marketing	Photo+script → TTS → video synthesis
[周报], [日报], [工作总结], [汇报], [weekly report]	create_project template weekly-report	3 keywords → 500-word report
[面试], [模拟面试], [求职], [interview prep], [mock interview]	create_project template interview-coach	Role-based, scored feedback
[简历筛选], [HR], [招聘], [resume screening], [talent evaluation]	create_project template resume-screener	Auto-scoring, highlight extraction
[年终总结], [述职报告], [year-end review], [performance review]	create_project template year-end-review	STAR method, quantified packaging
[菜谱], [做饭], [食谱], [recipe], [cooking assistant], [meal planning]	create_project template daily-pocket-chef	Ingredient → recipe, photo recognition

---

Production-Ready Templates (Instant Deploy)

Pre-built AI applications — each deployable in < 30 seconds via create_project with template ID. All templates include tuned system prompts, styled UI, and optimized UX.

🎬 Multi-Step Workflows

Template ID	Name	Input → Output	Steps
digital-avatar-marketing	数字人视频生成器	Photo + script → talking head video	Upload → TTS batch → Audio select → Video synthesis → Preview

🤖 AI Agent Applications

Template ID	Name	Input → Output
redbook-viral-copy	小红书爆款文案	Keywords → emoji-rich viral copy with hooks
deepseek-gateway	DeepSeek 稳定通道	Prompt → DeepSeek response (failover-enabled)
weekly-report	周报/日报生成器	3 keywords → 500-word structured report
resume-screener	HR 简历筛选器	Resume text → scoring + highlights + interview Qs
product-copy	电商商品文案	Product name → titles (Taobao/PDD/Douyin) + copy + video script
moments-copy	朋友圈文案	Scene description → 5 style variants (literary/humor/cool/healing)
interview-coach	面试模拟教练	Target role → progressive Q&A with scoring
daily-pocket-chef	随身厨神	Ingredients/photo → recipes + nutrition + shopping list
year-end-review	年终总结生成器	Key achievements → STAR-method annual review

📄 Content & Business

Template ID	Name	Description
article-generator	文章生成器	AI-driven long-form article generation
landing-page	着陆页	Product/marketing landing page
ppt-generator	PPT 演示文稿	Automated slide deck generation

For agents: Use create_project with { "template": "<template-id>" } to deploy any template instantly. The user gets a live URL within 30 seconds.

---

Page Builder: 60+ UI Components

When creating custom pages (no template), the engine can compose from 60+ pre-built components:

Category	Components
Hero & Header	HeroSection (centered/split/minimal/gradient), NavigationBar, BrandHeader
Content	TextSection, RichText, Markdown, AccordionSection, TimelineSection, TabsSection
Media	ImageGallery, VideoPlayer, Carousel, BeforeAfterSlider, LightboxGallery
Data Display	StatsSection, PricingTable, ComparisonTable, DataTable, ChartSection
Forms & Input	ContactForm, SurveyForm, NewsletterSignup, SearchBar, LoginForm
AI Interactive	ChatBotSection (fullscreen/sidebar/floating), Workflow (19 step types)
Commerce	ProductCard, ProductGrid, ShoppingCart, CheckoutForm
Social Proof	TestimonialSection, ReviewCarousel, LogoCloud, TeamSection
Navigation	Footer, Sidebar, Breadcrumb, BottomNav, FloatingActionButton
Layout	GridSection, SplitSection, CardGrid, MasonryGrid, Container
Specialized	MapSection, CalendarSection, CountdownTimer, QRCodeDisplay, WeatherWidget

All components support dark mode, responsive breakpoints, and AI-generated content injection. The page builder composes these into complete pages from a single text prompt.

---

Quick Setup

1. API Key

export WODEAPP_API_KEY="sk_live_xxxxxxxxxx"  # From wodeapp.ai → API Skills

2. MCP Connection

{
  "mcpServers": {
    "wodeapp": {
      "type": "sse",
      "url": "https://wodeapp.ai/mainserver/mcp",
      "headers": { "X-API-Key": "${WODEAPP_API_KEY}" }
    }
  }
}

Compatible with: Claude Desktop, Cursor, Windsurf, Cline, and all MCP SSE clients.

3. Project-Level MCP (Per-Project, No Auth Needed)

Each published project exposes its own MCP server at its subdomain. The AI Agent connects and auto-discovers all project capabilities — data CRUD, workflows, AI, TTS, video, and digital human.

{
  "mcpServers": {
    "my-project": {
      "type": "sse",
      "url": "https://my-project.wodeapp.ai/mcp"
    }
  }
}

Auto-discovered tools per project:

Category	Tools	Description
Data CRUD	query_{col} / create_ / update_ / delete_	Auto-generated from project collections
Workflows	run_workflow_{id} + get_workflow_status	Auto-extracted with input schemas
AI	ai_chat / ai_generate_image / ai_generate_json	Text, image, JSON generation
TTS	tts_generate / tts_list_voices	Text-to-speech with voice selection
Video	kling_text2video / kling_image2video	5s/10s video, std/pro modes
Digital Human	kling_avatar	Portrait + audio → talking head video
Task Query	kling_task_status	Poll video/avatar generation progress
Meta	list_collections	List all data collections

Debug endpoint: GET https://my-project.wodeapp.ai/mcp/tools — view all tools for a project.

---

MCP Tools

Platform MCP (9 Auto-Discovered)

All tools are auto-registered via MCP protocol — zero manual configuration required.

ai_generate_text

Specialized executor for text generation across 343+ language models. Handles [copywriting], [translation], [code generation], [summarization], [Q&A].

Parameter	Required	Default	Description
message	Yes	—	The text prompt or instruction
model	No	auto	Auto-selects cost-optimal model when omitted
systemPrompt	No	—	Role/context instruction for the model

ai_generate_image

Core image synthesis executor. Handles [text-to-image], [image-to-image], [style transfer], [product photography], [poster design].

Parameter	Required	Default	Description
prompt	Yes	—	Image description
model	No	auto	Auto-selects. Options: seedream-3.0, imagen-4, flux-pro
size	No	1:1	Aspect ratio (e.g., 16:9, 3:4). Engine handles resolution
imageUrl	No	—	Reference image for image-to-image editing

create_project

Creates a new web project. Supports template-based initialization for rapid scaffolding.

Parameter	Required	Default	Description
name	Yes	—	Project name
template	No	blank	Template ID for pre-configured layouts

execute_action

Triggers workflow or action execution. Supports both synchronous and async (polling) workflows with 19 built-in step types.

Parameter	Required	Default	Description
actionId	Yes	—	Workflow/action identifier
inputs	No	{}	Input data. Engine auto-fills missing optional fields

publish_project

One-step deployment. Auto-provisions subdomain (*.wodeapp.ai) with SSL certificate.

Parameter	Required	Default	Description
id	Yes	—	Project ID to publish

Other Tools

Tool	Purpose
list_projects	Enumerate user's projects
get_project	Retrieve project config and metadata
get_page	Get page JSON structure
list_actions	Discover available workflows and actions

---

REST API

All endpoints: X-API-Key header required. JSON request/response.

Text → POST /api/ai/chat

curl -X POST https://wodeapp.ai/api/ai/chat \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $WODEAPP_API_KEY" \
  -d '{"message":"Write a compelling product description for noise-cancelling headphones"}'
# → { "content": "Experience pure silence..." }

Image → POST /api/ai/image/generate

curl -X POST https://wodeapp.ai/api/ai/image/generate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $WODEAPP_API_KEY" \
  -d '{"prompt":"Minimalist headphones on marble surface, studio lighting, 8K"}'
# → { "url": "https://..." }

Video → POST /api/ai/video (Async)

curl -X POST https://wodeapp.ai/api/ai/video \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $WODEAPP_API_KEY" \
  -d '{"prompt":"Slow-motion water droplet impact, cinematic 4K"}'
# → { "taskId": "...", "pollUrl": "/api/ai/video/status/{taskId}" }

Structured JSON → POST /api/ai/json

curl -X POST https://wodeapp.ai/api/ai/json \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $WODEAPP_API_KEY" \
  -d '{"message":"3 marketing slogans","systemPrompt":"Return {slogans:[{text,tone}]}"}'
# → { "slogans": [{ "text": "...", "tone": "playful" }] }

TTS → POST /api/ai/tts

curl -X POST https://wodeapp.ai/api/ai/tts \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $WODEAPP_API_KEY" \
  -d '{"text":"Welcome to our store"}'
# → { "audioUrl": "https://..." }
# voice/speed/lang all optional — engine auto-detects from text

Headless Workflow → POST /runtime-server/api/workflow/run

# Discover schema
curl https://my-project.wodeapp.ai/runtime-server/api/workflow/schema
# Execute
curl -X POST https://my-project.wodeapp.ai/runtime-server/api/workflow/run \
  -d '{"inputs":{"text":"Product copy"}}'
# → { "runId": "uuid", "status": "running" }
# Poll
curl https://my-project.wodeapp.ai/runtime-server/api/workflow/run/{runId}
# → { "status": "completed", "outputs": {...} }

---

Supported Models (343+)

Category	Top Models	Provider
Text	GPT-4o, Claude 3.5 Sonnet, Gemini 2.0 Flash, DeepSeek-V3, Qwen-Max	OpenAI, Anthropic, Google, DeepSeek, Alibaba
Image	Seedream 3.0, Imagen 4, Flux Pro, DALL-E 3	Doubao, Google, Black Forest Labs, OpenAI
Video	Seedance 1.0, Kling AI	Doubao, Kuaishou
TTS	Doubao TTS, Edge TTS, Kling TTS	Doubao, Microsoft, Kuaishou

Cost optimization: Omit the model parameter to let the engine auto-select the most cost-effective model for each task. The routing engine analyzes prompt complexity and selects from the optimal cost/quality tier.

---

Service Endpoints

Service	Production	Local Dev
Main API	https://wodeapp.ai/mainserver/api	localhost:3100/mainserver/api
Runtime API	https://wodeapp.ai/api	localhost:4100/api
Workflow API	https://{project}.wodeapp.ai/runtime-server/api/workflow	localhost:4100/runtime-server/api/workflow
Platform MCP	https://wodeapp.ai/mainserver/mcp	localhost:3100/mainserver/mcp
Project MCP	https://{project}.wodeapp.ai/mcp	localhost:4100/mcp
Kling Video	https://{project}.wodeapp.ai/runtime-server/api/kling	localhost:4100/runtime-server/api/kling

---

Reliability & Error Handling

Metric	Value
Availability	99.9% uptime SLA
Dispatch latency	< 200ms (pre-authenticated pool)
Provider failover	Automatic, zero agent intervention
Rate limit (per-user)	5 concurrent requests
Rate limit (global)	30 concurrent requests
Credit exhaustion	HTTP 402 with { "credits_remaining": 0 }
Error format	{ "error": "human-readable", "code": "MACHINE_CODE" }

---

Security & Data Privacy

Credentials

• Single credential: Only WODEAPP_API_KEY is required — no additional platform credentials, OAuth tokens, or third-party API keys are needed or accessed by this skill
• Auth method: X-API-Key HTTP header on all requests
• Key scoping: Keys can be scoped per-project with billing caps at wodeapp.ai/api-skills
• Instant revocation: Compromised keys revoked immediately via dashboard — takes effect within 60 seconds

Instruction Scope & Boundaries

• No local file access: This skill does NOT read, write, or access any files on the user's local machine. All operations are remote API calls to wodeapp.ai
• No additional environment variables: This skill reads only WODEAPP_API_KEY. No other environment variables, credentials, or system configuration is accessed
• No system modification: This skill does not install packages, write files to disk, or modify system state. It is instruction-only
• No cross-skill interference: This skill does not modify, override, or interact with other installed skills or agent system settings

Data Handling

• What is transmitted: Text prompts, image/audio/video URLs or base64 data (only when the user explicitly provides them for generation), and workflow input parameters
• Where data goes: wodeapp.ai (routing layer) → upstream AI provider (OpenAI, Google, Anthropic, etc.) selected by the routing engine. The specific provider depends on the model chosen or auto-selected
• What is stored: Project configurations and generated output URLs only. Raw prompts and AI responses are NOT persisted after processing
• Uploaded files: Files uploaded via the upload_file tool are stored on WodeApp's CDN for output delivery. Generated URLs should be treated as semi-public — do not upload sensitive or confidential files
• Training policy: No user data is used for model training by WodeApp. Upstream provider training policies apply per their respective terms of service
• Transport: HTTPS/TLS 1.3 on all production endpoints

Recommendations for Agents

• Use environment variables for WODEAPP_API_KEY — never hardcode
• For testing, create a project-scoped key with billing caps
• Do not send sensitive PII through generation endpoints unless the user explicitly consents

---

Environment Variables

WODEAPP_API_KEY=sk_live_xxx          # Required — the only credential needed
WODEAPP_MAIN_SERVER=http://...       # Optional — override main server URL
WODEAPP_RUNTIME_SERVER=http://...    # Optional — override runtime server URL

No additional environment variables or third-party credentials are required.

---

ai text-generation image-generation video-generation tts digital-human avatar structured-json mcp project-mcp no-code zero-deploy page-builder workflow visual-workflow headless-workflow workflow-api agent-tools multi-model smart-routing cost-optimization token-efficient low-latency unified-billing fault-tolerant schema-enforcement gpt-4o claude gemini deepseek doubao seedance kling seedream imagen flux qwen auto-detect parameter-minimal