Service Channels
Learn about REST API, CLI, and Agent Skill integration methods, and the product planning status of Skill.
Integration Method Comparison
| Channel | Type | Use Case | Description |
|---|---|---|---|
| REST API | REST | Your own backend services | DashScope HTTP API |
| CLI | Command line | Local debugging / scripts | bailian-cli with bl parsex to submit and query tasks |
| Agent Skill | Skill package | Qoder / Claude Code / Codex | Integrate as a skill package, automatically loaded by AI coding tools |
REST API
All document parsing and information extraction capabilities are provided through the DashScope API at:
https://{workspaceId}.cn-beijing.maas.aliyuncs.com/api/v2/apps/parse-x
Authentication uses the Alibaba Cloud Model Studio API-KEY:
Authorization: Bearer <DASHSCOPE_API_KEY>
API Keys are created on the Console API Key page. The system automatically routes to the corresponding workspace based on the API Key.
| API | Method | Business Path | Purpose |
|---|---|---|---|
| Parse task submission | POST | /api/v2/apps/parse-x/parse/submit | Submit a Parse task |
| Parse task query | POST | /api/v2/apps/parse-x/parse/result | Query Parse status, results, or shards |
| Extract task submission | POST | /api/v2/apps/parse-x/extract/submit | Submit an Extract task |
| Extract task query | POST | /api/v2/apps/parse-x/extract/result | Query Extract status and results |
For the complete API list, see the API Reference.
CLI
The Bailian CLI wraps ParseX parsing and field extraction into commands. See Installation for setup and Use the CLI for steps and examples.
bl parsex parse submit --workspace-id <workspace-id> --file-url "https://example.com/document.pdf" --output-file-format markdown --output json
bl parsex parse result --workspace-id <workspace-id> --biz-id <parse-biz-id> --follow --output json
See the ParseX command reference for full parameters.
Agent Skill
Run the install command in a terminal. Make sure you have Node.js (≥18) and skills (≥1.5.12) installed.
Supported agents: qoder, qwen-code, claude-code, openclaw, codex, cursor, gemini-cli, github-copilot
Project-level installation:
npx skills add "https://agenthub.aliyun-inc.com/api/skill-sources/alibabacloud-parse-x" --yes
Global installation:
npx skills add "https://agenthub.aliyun-inc.com/api/skill-sources/alibabacloud-parse-x" --yes -g