Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Alibaba Cloud DashScope Qwen API (OpenAI-Compatible), or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fdashscope.aliyuncs.com%2Fdashscope-aliyuncs-com" | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fdashscope.aliyuncs.com%2Fdashscope-aliyuncs-com" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Alibaba Cloud DashScope Qwen API (OpenAI-Compatible) API.
Generate chat completions with Qwen models
Create text embeddings for semantic search
Upload files for processing or batch tasks
List and retrieve uploaded file metadata
Delete uploaded files
Patterns agents use Alibaba Cloud DashScope Qwen API (OpenAI-Compatible) API for, with concrete tasks.
★ Qwen chat integration
Products adding a chat assistant can reach Qwen through the OpenAI-compatible interface. The chat completions operation accepts the familiar request shape, so existing client code can target Qwen with a changed base URL and key.
Send a chat completion request to a Qwen model and return the assistant's reply
Embeddings for retrieval
Semantic search and retrieval pipelines need vector embeddings. The embeddings operation turns text into vectors with Qwen embedding models, so a pipeline can index documents for similarity search.
Create embeddings for a batch of documents and return the vectors for indexing
Agent-driven document workflow
An agent handling documents can upload inputs and reason over them. Through Jentic, an agent uploads a file, then runs chat or embeddings against its content, and removes the file when finished.
Upload a file, run a chat completion referencing it, then delete the file when done
6 endpoints — jentic publishes the only available openapi specification for alibaba cloud dashscope qwen api (openai-compatible), keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/chat/completions
Create a chat completion
/embeddings
Create text embeddings
/files
List uploaded files
/files
Upload a file
/files/{file_id}
Get file metadata
What agents get from Jentic-routed access to this vendor.
Setup
DashScope follows the OpenAI-compatible shape but splits across three regional hosts and needs a bearer key. With Jentic One you install once, import the operations from the API Directory, and keep the key in a single place.
Permission scoping
The operations are chat, embeddings, and file management, so you can scope an agent to inference only and keep file deletion out of its reach.
Credential isolation
Your DashScope API key is stored encrypted by your own Jentic One instance and injected when a call runs, so it never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents find the right Qwen operation through Jentic's intent search, matching a request like generating a chat completion to the matching DashScope endpoint.
Alternatives and complements available in the Jentic catalogue.
Specific to using Alibaba Cloud DashScope Qwen API (OpenAI-Compatible) API through Jentic.
How does the DashScope Qwen API authenticate?
Requests carry a DashScope API key as a bearer token, matching the OpenAI-compatible convention. Jentic One stores the key and injects it at execution time.
Can I limit what my agent can do with the DashScope API?
Yes. You import only the operations an agent needs, so a chat agent can run completions and embeddings while file deletion stays out of scope.
Which regional host should I use for DashScope?
DashScope is reachable from mainland China, international, and US hosts; pick the regional base URL that matches your account and data-residency needs.
Is this really OpenAI-compatible?
Yes. The chat completions and embeddings operations follow the OpenAI request and response shapes, so existing OpenAI client code can target DashScope by changing the base URL and key.
Why is there no official OpenAPI spec for DashScope's Qwen API?
Alibaba Cloud documents the OpenAI-compatible interface in prose rather than a machine-readable spec. Jentic generated this OpenAPI description from that documentation and keeps it validated so agents can call it reliably.
GET STARTED
/files/{file_id}
Delete a file
/chat/completions
Create a chat completion
/embeddings
Create text embeddings
/files
List uploaded files
/files
Upload a file
/files/{file_id}
Get file metadata
/files/{file_id}
Delete a file
Know of an official OpenAPI document? Contribute it →
For Agents
Lets an AI agent call Alibaba Cloud's Qwen models for chat completions and embeddings and manage uploaded files through an OpenAI-compatible endpoint.
Use for: I want to generate a chat completion with Qwen, Create embeddings for these documents, Upload a file for a batch job, List the files I have uploaded to DashScope
Not supported: Does not fine-tune models, host inference endpoints, or manage Alibaba Cloud accounts: use it for Qwen chat completions, embeddings, and file management only.
Jentic publishes the only available OpenAPI specification for Alibaba Cloud DashScope Qwen API (OpenAI-Compatible), keeping it validated and agent-ready. The service exposes Alibaba Cloud's Qwen (Tongyi Qianwen) models through an OpenAI-compatible interface for chat completions, text embeddings, and file management, authenticated with a bearer API key. It is available from mainland China, international, and US regional hosts.
This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.
Base layer of spec validity and structural soundness.
Aggregated quality score from linter diagnostics, weighted by severity.
Percentage of `$ref` references that resolve successfully.
Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).
Structural correctness score based on schema issues using logarithmic dampening.
Clarity, completeness, and ingestion readiness for developers and tooling.
How richly the API is illustrated with examples.
Percentage of examples that conform to their schemas.
Percentage of operations with complete response definitions (success, client error, server error).
Health of API ingestion, bundling, and resolution within Jentic pipelines.
Semantic breadth, depth, and agent comprehension for AI systems.
Coverage of descriptions across API elements.
Coverage of RFC 9457 Problem Details for error responses.
Coverage, uniqueness, and casing consistency of operationIds for AI inference.
Coverage of summaries across operations/tags/info.
Functional utility, complexity comfort, and AI orchestration readiness.
Agent comfort level based on API operational and structural complexity.
Trust, risk posture, and security compliance.
Average quality of security schemes based on authentication method strength (weakest link for OAuth2).
Findability, semantic richness, and reasoning readiness.
Clarity and depth of descriptions across API elements.
Score it yourself
Every API in the directory is allowlisted, so you can re-score it with no key required.
npx @jentic/api-scorecard-cli score <openapi-url>