Service Channels

Updated at:

Learn about REST API, CLI, and Agent Skill integration methods, and the product planning status of Skill.

Integration Method Comparison

ChannelTypeUse CaseDescription
REST APIRESTYour own backend servicesDashScope HTTP API
CLICommand lineLocal debugging / scriptsbailian-cli with bl parsex to submit and query tasks
Agent SkillSkill packageQoder / Claude Code / CodexIntegrate 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.

APIMethodBusiness PathPurpose
Parse task submissionPOST/api/v2/apps/parse-x/parse/submitSubmit a Parse task
Parse task queryPOST/api/v2/apps/parse-x/parse/resultQuery Parse status, results, or shards
Extract task submissionPOST/api/v2/apps/parse-x/extract/submitSubmit an Extract task
Extract task queryPOST/api/v2/apps/parse-x/extract/resultQuery 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