# Wodeapp AI

> 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.

- Skill: `dvcrn/wodeapp-ai` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add dvcrn/wodeapp-ai`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/wodeapp-ai/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/wodeapp-ai

---


# 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

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

### 2. MCP Connection

```json
{
  "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.

```json
{
  "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`
```bash
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`
```bash
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)
```bash
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`
```bash
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`
```bash
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`
```bash
# 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

```bash
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`