diff --git a/skills/bailian-docs-llm-wiki/SKILL.md b/skills/bailian-docs-llm-wiki/SKILL.md index 9be23cd..4500083 100644 --- a/skills/bailian-docs-llm-wiki/SKILL.md +++ b/skills/bailian-docs-llm-wiki/SKILL.md @@ -147,21 +147,22 @@ description: >- | **按家族筛选**：按 primaryCapability / providers / itemCount / maxContextWindow 找家族 | `models/families.jsonl`（一行一家族，含 items[] 摘要） | | 模型家族总览 / 按能力分桶浏览 | `models/index.md` | | 主题页 / API 文档（按功能领域查找） | `wiki/index.md`（完整索引入口） | -| API Key 鉴权 | `wiki/concepts/api-key.md` | -| Token 计量 | `wiki/concepts/token.md` | +| Token | `wiki/concepts/token.md` | | OpenAI 兼容接口 | `wiki/concepts/openai-compatible-interface.md` | -| 检索增强生成（RAG） | `wiki/concepts/rag.md` | -| 函数调用（Function Calling） | `wiki/concepts/function-calling.md` | | 流式输出 | `wiki/concepts/streaming.md` | +| DashScope SDK | `wiki/concepts/dashscope-sdk.md` | | 异步调用 | `wiki/concepts/async-invocation.md` | | 业务空间 | `wiki/concepts/workspace.md` | +| API Key | `wiki/concepts/api-key.md` | +| 检索增强生成 | `wiki/concepts/rag.md` | | 多模态 | `wiki/concepts/multimodal.md` | -| DashScope SDK | `wiki/concepts/dashscope-sdk.md` | -| 多模态内容生成 API 对比 | `wiki/comparisons/multimodal-generation-comparison.md` | -| 模型优化方案对比：微调、压缩与高速推理 | `wiki/comparisons/model-optimization-comparison.md` | -| 应用评测与模型评测对比 | `wiki/comparisons/app-vs-model-evaluation.md` | -| 应用监控与模型监控对比 | `wiki/comparisons/app-vs-model-monitoring.md` | -| 知识库与记忆库对比 | `wiki/comparisons/knowledge-vs-memory.md` | +| 函数调用 | `wiki/concepts/function-calling.md` | +| 图像生成、视频生成与 3D 生成对比 | `wiki/comparisons/multimodal-generation-comparison.md` | +| 应用评测与模型评测对比 | `wiki/comparisons/app-eval-vs-model-eval.md` | +| 应用监控与模型监控对比 | `wiki/comparisons/app-monitoring-vs-model-monitoring.md` | +| 知识库与记忆库对比 | `wiki/comparisons/knowledge-base-vs-memory-library.md` | +| 模型微调、压缩与部署对比 | `wiki/comparisons/fine-tuning-vs-compression-vs-deployment.md` | +| Qwen API、应用调用与托管智能体 API 对比 | `wiki/comparisons/qwen-api-vs-app-call-vs-agents-api.md` | > 实际文件名以 `wiki/index.md` 为准；上表若有出入应回到索引页查找。 diff --git a/skills/bailian-docs-llm-wiki/llms.txt b/skills/bailian-docs-llm-wiki/llms.txt index e613dc1..9d85b80 100644 --- a/skills/bailian-docs-llm-wiki/llms.txt +++ b/skills/bailian-docs-llm-wiki/llms.txt @@ -5,99 +5,117 @@ ## 模型使用指南 - **开始使用** - - [选择模型](raw/model-user-guide/get-started-with-models/models.md) - [什么是阿里云百炼](raw/model-user-guide/get-started-with-models/what-is-model-studio.md) - [首次调用千问API](raw/model-user-guide/get-started-with-models/first-api-call-to-qwen.md) + - [选择模型](raw/model-user-guide/get-started-with-models/models.md) - [Base URL总览](raw/model-user-guide/get-started-with-models/base-url.md) - - [限流](raw/model-user-guide/get-started-with-models/rate-limit.md) - [选择地域、服务部署范围和接入域名](raw/model-user-guide/get-started-with-models/regions.md) -- **模型体验** - - [视觉理解](raw/model-user-guide/model-experience/vision-model.md) - - [文本生成](raw/model-user-guide/model-experience/text-generation-model.md) - - [图片生成与编辑](raw/model-user-guide/model-experience/image-model.md) - - [视频生成与编辑](raw/model-user-guide/model-experience/video-generate-edit-model.md) - - [语音合成](raw/model-user-guide/model-experience/tts-model.md) - - [Tripo 3D模型生成](raw/model-user-guide/model-experience/tripo-3d-generation-guide.md) - - [音乐生成](raw/model-user-guide/model-experience/fun-music.md) - - [语音识别](raw/model-user-guide/model-experience/asr-model.md) - - [向量与重排序](raw/model-user-guide/model-experience/embedding-rerank-model.md) - - [语音转语音](raw/model-user-guide/model-experience/s2s-model.md) - - [全模态](raw/model-user-guide/model-experience/omni.md) -- **Token Plan（团队版）** - - **最佳实践** - - [工具调用](raw/model-user-guide/token-plan-guide/token-plan-best-practice/token-plan-tool.md) - - [接入多模态生成模型](raw/model-user-guide/token-plan-guide/token-plan-best-practice/token-plan-multimodal-gen.md) - - **Coding Plan** - - [Coding Plan概述](raw/model-user-guide/token-plan-guide/coding-plan-guide/coding-plan.md) - - [联网搜索](raw/model-user-guide/token-plan-guide/coding-plan-guide/web-search-for-coding-plan.md) - - [添加视觉理解能力](raw/model-user-guide/token-plan-guide/coding-plan-guide/add-vision-skill.md) - - [常见问题](raw/model-user-guide/token-plan-guide/coding-plan-guide/coding-plan-faq.md) - - [Token Plan（团队版）概述](raw/model-user-guide/token-plan-guide/token-plan-overview.md) - - [快速开始](raw/model-user-guide/token-plan-guide/token-plan-quickstart.md) - - [团队管理](raw/model-user-guide/token-plan-guide/token-plan-team.md) - - [常见问题](raw/model-user-guide/token-plan-guide/token-plan-faq.md) + - [限流](raw/model-user-guide/get-started-with-models/rate-limit.md) +- **产品计费** + - [新人免费额度](raw/model-user-guide/test-1/new-free-quota.md) + - [模型训练与部署计费](raw/model-user-guide/test-1/model-training-and-deployment-billing.md) + - [节省计划与资源包](raw/model-user-guide/test-1/savings-plan-and-resource-package.md) + - [账单查询与成本管理](raw/model-user-guide/test-1/bill-query-and-cost-management.md) + - [模型调用价格](raw/model-user-guide/test-1/model-pricing.md) - **接入客户端/开发工具** - [OpenClaw](raw/model-user-guide/use-chat-client-or-development-tool/openclaw.md) - [Hermes Agent](raw/model-user-guide/use-chat-client-or-development-tool/hermes-agent.md) - - [Claude Code](raw/model-user-guide/use-chat-client-or-development-tool/claude-code.md) - [OpenCode](raw/model-user-guide/use-chat-client-or-development-tool/opencode.md) + - [Claude Code](raw/model-user-guide/use-chat-client-or-development-tool/claude-code.md) - [Cursor](raw/model-user-guide/use-chat-client-or-development-tool/cursor.md) - [Codex](raw/model-user-guide/use-chat-client-or-development-tool/codex.md) - - [QwenPaw](raw/model-user-guide/use-chat-client-or-development-tool/qwenpaw.md) - [Qwen Code](raw/model-user-guide/use-chat-client-or-development-tool/qwen-code.md) - [Cherry Studio](raw/model-user-guide/use-chat-client-or-development-tool/cherry-studio.md) + - [QwenPaw](raw/model-user-guide/use-chat-client-or-development-tool/qwenpaw.md) - [Chatbox](raw/model-user-guide/use-chat-client-or-development-tool/chatbox.md) - [Cline](raw/model-user-guide/use-chat-client-or-development-tool/cline.md) - - [Qoder](raw/model-user-guide/use-chat-client-or-development-tool/qoder-agent.md) - [Qoder CN（原 Lingma）](raw/model-user-guide/use-chat-client-or-development-tool/lingma-agent.md) + - [Qoder](raw/model-user-guide/use-chat-client-or-development-tool/qoder-agent.md) - [Kilo CLI](raw/model-user-guide/use-chat-client-or-development-tool/kilo-cli.md) - [使用Postman或cURL调用图像/视频生成API](raw/model-user-guide/use-chat-client-or-development-tool/first-call-to-image-and-video-api.md) - [Dify](raw/model-user-guide/use-chat-client-or-development-tool/dify.md) - [更多工具](raw/model-user-guide/use-chat-client-or-development-tool/more-tools.md) -- **产品计费** - - [新人免费额度](raw/model-user-guide/test-1/new-free-quota.md) - - [模型训练与部署计费](raw/model-user-guide/test-1/model-training-and-deployment-billing.md) - - [账单查询与成本管理](raw/model-user-guide/test-1/bill-query-and-cost-management.md) - - [节省计划与资源包](raw/model-user-guide/test-1/savings-plan-and-resource-package.md) - - [模型调用价格](raw/model-user-guide/test-1/model-pricing.md) +- **Token Plan（团队版）** + - **最佳实践** + - [接入多模态生成模型](raw/model-user-guide/token-plan-guide/token-plan-best-practice/token-plan-multimodal-gen.md) + - [工具调用](raw/model-user-guide/token-plan-guide/token-plan-best-practice/token-plan-tool.md) + - **Coding Plan** + - [Coding Plan概述](raw/model-user-guide/token-plan-guide/coding-plan-guide/coding-plan.md) + - [联网搜索](raw/model-user-guide/token-plan-guide/coding-plan-guide/web-search-for-coding-plan.md) + - [添加视觉理解能力](raw/model-user-guide/token-plan-guide/coding-plan-guide/add-vision-skill.md) + - [常见问题](raw/model-user-guide/token-plan-guide/coding-plan-guide/coding-plan-faq.md) + - [Token Plan（团队版）概述](raw/model-user-guide/token-plan-guide/token-plan-overview.md) + - [团队管理](raw/model-user-guide/token-plan-guide/token-plan-team.md) + - [快速开始](raw/model-user-guide/token-plan-guide/token-plan-quickstart.md) + - [常见问题](raw/model-user-guide/token-plan-guide/token-plan-faq.md) +- **模型体验** + - [视觉理解](raw/model-user-guide/model-experience/vision-model.md) + - [文本生成](raw/model-user-guide/model-experience/text-generation-model.md) + - [图片生成与编辑](raw/model-user-guide/model-experience/image-model.md) + - [视频生成与编辑](raw/model-user-guide/model-experience/video-generate-edit-model.md) + - [Tripo 3D模型生成](raw/model-user-guide/model-experience/tripo-3d-generation-guide.md) + - [音乐生成](raw/model-user-guide/model-experience/fun-music.md) + - [语音合成](raw/model-user-guide/model-experience/tts-model.md) + - [语音识别](raw/model-user-guide/model-experience/asr-model.md) + - [语音转语音](raw/model-user-guide/model-experience/s2s-model.md) + - [向量与重排序](raw/model-user-guide/model-experience/embedding-rerank-model.md) + - [全模态](raw/model-user-guide/model-experience/omni.md) - **模型推理** - [TPM 预留](raw/model-user-guide/model-high-speed-inference/tpm-reservation.md) - **模型调优** - **千问模型调优** - - [在控制台进行模型调优](raw/model-user-guide/fine-tuning/fine-tune-text-generation-model/model-training-on-console.md) - [模型调优简介](raw/model-user-guide/fine-tuning/fine-tune-text-generation-model/model-training-overview.md) + - [在控制台进行模型调优](raw/model-user-guide/fine-tuning/fine-tune-text-generation-model/model-training-on-console.md) - [使用 API 或命令行进行模型调优](raw/model-user-guide/fine-tuning/fine-tune-text-generation-model/fine-tuning-api-guide.md) - [0 代码强化大模型安全合规能力](raw/model-user-guide/fine-tuning/fine-tune-text-generation-model/enhance-the-security-compliance-of-large-models.md) - **语音合成模型调优** - [CosyVoice模型调优](raw/model-user-guide/fine-tuning/fine-tune-speech-synthesis-model/fine-tune-speech-synthesis-model-by-api.md) - [微调图像生成模型](raw/model-user-guide/fine-tuning/wan-image-generation-finetune-guide.md) - [微调视频生成模型](raw/model-user-guide/fine-tuning/wan-video-generation-finetune-guide.md) -- **模型评测** - - [模型评测](raw/model-user-guide/model-evaluation-introduction/model-evaluation-overview.md) - **模型部署** + - [模型部署](raw/model-user-guide/model-deployment-1/model-deployment-introduction.md) - [预置吞吐长输入与缓存](raw/model-user-guide/model-deployment-1/ptu-long-input-and-cache.md) - [模型导入](raw/model-user-guide/model-deployment-1/model-import.md) - - [模型部署](raw/model-user-guide/model-deployment-1/model-deployment-introduction.md) - [使用 API或命令行进行模型部署](raw/model-user-guide/model-deployment-1/model-deployment-quick-start.md) - **模型压缩** - [模型压缩](raw/model-user-guide/model-compression/model-compression-introduction.md) +- **模型评测** + - [模型评测](raw/model-user-guide/model-evaluation-introduction/model-evaluation-overview.md) - **用量统计与性能监控** - [模型用量](raw/model-user-guide/model-monitoring/model-usage-statistics.md) - [模型监控](raw/model-user-guide/model-monitoring/model-telemetry.md) +- **模型数据** + - [训练集与评测集](raw/model-user-guide/model-data-overview/training-set-and-evaluation-set.md) + - [数据清洗或增强](raw/model-user-guide/model-data-overview/data-processing.md) +- **安全合规** + - **传输安全** + - [获取RSA的公钥](raw/model-user-guide/security-and-compliance/transmission-security/model-interface-aes-encryption.md) + - [以加密的方式接入模型推理功能](raw/model-user-guide/security-and-compliance/transmission-security/encrypted-access-to-model-inference.md) + - [通过终端节点私网访问阿里云百炼模型或应用 API](raw/model-user-guide/security-and-compliance/transmission-security/access-model-studio-through-privatelink.md) + - **安全存储** + - [配置终端节点并发起连接](raw/model-user-guide/security-and-compliance/secure-storage/configure-an-endpoint-and-initiate-a-connection.md) + - [配置可用区IP](raw/model-user-guide/security-and-compliance/secure-storage/configure-zone-ip.md) + - [配置MSE云原生网关](raw/model-user-guide/security-and-compliance/secure-storage/configure-mse.md) + - [配置私有网络中的资源](raw/model-user-guide/security-and-compliance/secure-storage/configure-resources-in-private-network.md) + - [权限管理](raw/model-user-guide/security-and-compliance/permission-management-overview.md) + - [输⼊输出AI安全护栏](raw/model-user-guide/security-and-compliance/content-security.md) + - [模型备案信息公示](raw/model-user-guide/security-and-compliance/model-filing-information-publicity.md) + - [合规资质与隐私说明](raw/model-user-guide/security-and-compliance/privacy-notice.md) + - [千问大模型应用上架及合规备案](raw/model-user-guide/security-and-compliance/compliance-and-launch-filing-guide-for-ai-apps-powered-by-the-tongyi-model.md) - **实践教程** - **三方模型调用教程** - - [DeepSeek-硅基流动](raw/model-user-guide/use-cases/third-party-model-integration-tutorial/siliconflow-deepseek-api.md) - [DeepSeek-阿里云](raw/model-user-guide/use-cases/third-party-model-integration-tutorial/deepseek-api.md) + - [DeepSeek-硅基流动](raw/model-user-guide/use-cases/third-party-model-integration-tutorial/siliconflow-deepseek-api.md) - [DeepSeek](raw/model-user-guide/use-cases/third-party-model-integration-tutorial/deepseek-api-by-vanchin.md) - - [Kimi](raw/model-user-guide/use-cases/third-party-model-integration-tutorial/kimi-api.md) - [Kimi-月之暗面](raw/model-user-guide/use-cases/third-party-model-integration-tutorial/kimi-api-by-moonshot-ai.md) + - [Kimi](raw/model-user-guide/use-cases/third-party-model-integration-tutorial/kimi-api.md) - [GLM](raw/model-user-guide/use-cases/third-party-model-integration-tutorial/glm.md) - [GLM-智谱](raw/model-user-guide/use-cases/third-party-model-integration-tutorial/glm-zhipu.md) - [MiniMax](raw/model-user-guide/use-cases/third-party-model-integration-tutorial/minimax-api.md) - [MiniMax](raw/model-user-guide/use-cases/third-party-model-integration-tutorial/minimax-api-by-minimax.md) - [Vidu视频生成Prompt指南](raw/model-user-guide/use-cases/third-party-model-integration-tutorial/vidu-video-generation-prompt-guide.md) - - [MiMo-小米](raw/model-user-guide/use-cases/third-party-model-integration-tutorial/mimo.md) - [Stepfun-阶跃星辰](raw/model-user-guide/use-cases/third-party-model-integration-tutorial/stepfun.md) + - [MiMo-小米](raw/model-user-guide/use-cases/third-party-model-integration-tutorial/mimo.md) - [文生文Prompt指南](raw/model-user-guide/use-cases/prompt-engineering-guide.md) - [文生图Prompt指南](raw/model-user-guide/use-cases/text-to-image-prompt.md) - [基于LlamaIndex构建RAG应用](raw/model-user-guide/use-cases/build-rag-applications-based-on-llamaindex.md) @@ -106,27 +124,9 @@ - [借助大模型将文档转换为视频](raw/model-user-guide/use-cases/use-llm-to-convert-document-to-video.md) - [限流应对最佳实践 ](raw/model-user-guide/use-cases/rate-limiting-best-practices.md) - [显式缓存最佳实践](raw/model-user-guide/use-cases/explicit-cache-guide.md) -- **模型数据** - - [训练集与评测集](raw/model-user-guide/model-data-overview/training-set-and-evaluation-set.md) - - [数据清洗或增强](raw/model-user-guide/model-data-overview/data-processing.md) - **服务支持** - - [相关协议](raw/model-user-guide/support/related-agreements.md) - [常见问题](raw/model-user-guide/support/faq-about-alibaba-cloud-model-studio.md) -- **安全合规** - - **传输安全** - - [获取RSA的公钥](raw/model-user-guide/security-and-compliance/transmission-security/model-interface-aes-encryption.md) - - [以加密的方式接入模型推理功能](raw/model-user-guide/security-and-compliance/transmission-security/encrypted-access-to-model-inference.md) - - [通过终端节点私网访问阿里云百炼模型或应用 API](raw/model-user-guide/security-and-compliance/transmission-security/access-model-studio-through-privatelink.md) - - **安全存储** - - [配置终端节点并发起连接](raw/model-user-guide/security-and-compliance/secure-storage/configure-an-endpoint-and-initiate-a-connection.md) - - [配置可用区IP](raw/model-user-guide/security-and-compliance/secure-storage/configure-zone-ip.md) - - [配置MSE云原生网关](raw/model-user-guide/security-and-compliance/secure-storage/configure-mse.md) - - [配置私有网络中的资源](raw/model-user-guide/security-and-compliance/secure-storage/configure-resources-in-private-network.md) - - [权限管理](raw/model-user-guide/security-and-compliance/permission-management-overview.md) - - [模型备案信息公示](raw/model-user-guide/security-and-compliance/model-filing-information-publicity.md) - - [输⼊输出AI安全护栏](raw/model-user-guide/security-and-compliance/content-security.md) - - [千问大模型应用上架及合规备案](raw/model-user-guide/security-and-compliance/compliance-and-launch-filing-guide-for-ai-apps-powered-by-the-tongyi-model.md) - - [合规资质与隐私说明](raw/model-user-guide/security-and-compliance/privacy-notice.md) + - [相关协议](raw/model-user-guide/support/related-agreements.md) - **产品动态** - [模型平台功能更新](raw/model-user-guide/release-notes/model-release-notes.md) - [模型上下架与更新](raw/model-user-guide/release-notes/newly-released-models.md) @@ -138,48 +138,48 @@ - [应用功能动态](raw/application-user-guide/start-using/application-release-notes.md) - **记忆库** - [记忆库](raw/application-user-guide/memory-library-overview/memory-library.md) - - [长期记忆 API](raw/application-user-guide/memory-library-overview/long-term-memory-2-0.md) - [为 OpenClaw 配置长期记忆插件](raw/application-user-guide/memory-library-overview/modelstudio-memory-for-openclaw.md) + - [长期记忆 API](raw/application-user-guide/memory-library-overview/long-term-memory-2-0.md) - **Prompt** - [Prompt模板概述](raw/application-user-guide/prompt/prompt-template.md) - [自定义Prompt模板](raw/application-user-guide/prompt/prompt-custom-template.md) - [使用Prompt样例库优化模型输出](raw/application-user-guide/prompt/prompt-sample-optimization.md) - [Prompt自动优化](raw/application-user-guide/prompt/optimize-prompt.md) - [基于大模型输入输出样例的Prompt自动优化](raw/application-user-guide/prompt/prompt-feedback-optimization.md) +- **数据连接** + - [数据连接](raw/application-user-guide/data-connection-overview/data-connection.md) - **应用开发** - [应用类型介绍](raw/application-user-guide/llm-application/application-introduction.md) - - [智能体应用](raw/application-user-guide/llm-application/single-agent-application.md) - [新版智能体应用（Agent 2.0）](raw/application-user-guide/llm-application/new-single-agent-application.md) + - [智能体应用](raw/application-user-guide/llm-application/single-agent-application.md) - [高代码应用](raw/application-user-guide/llm-application/rich-code-application.md) - [文件问答](raw/application-user-guide/llm-application/file-q-a.md) - [工作流应用](raw/application-user-guide/llm-application/workflow-application.md) -- **数据连接** - - [数据连接](raw/application-user-guide/data-connection-overview/data-connection.md) - **知识库（RAG）** - [知识库](raw/application-user-guide/knowledge-base/rag-knowledge-base.md) - [RAG效果优化](raw/application-user-guide/knowledge-base/rag-optimization.md) - [知识库日志与监控](raw/application-user-guide/knowledge-base/rag-knowledge-base-log-monitoring.md) - [知识库配额与限制](raw/application-user-guide/knowledge-base/rag-knowledge-base-specifications.md) - - [知识库API指南](raw/application-user-guide/knowledge-base/rag-knowledge-base-api-guide.md) - [知识检索](raw/application-user-guide/knowledge-base/rag-knowledge-retrieval.md) + - [知识库API指南](raw/application-user-guide/knowledge-base/rag-knowledge-base-api-guide.md) - [知识库计费说明](raw/application-user-guide/knowledge-base/billing-for-knowledge-base.md) - [知识问答](raw/application-user-guide/knowledge-base/rag-knowledge-qa.md) +- **Skill** + - [Skill](raw/application-user-guide/skill/introduction-to-skill.md) - **MCP** - [模型上下文协议（MCP）](raw/application-user-guide/model-context-protocol/mcp-introduction.md) - [官方 MCP 服务](raw/application-user-guide/model-context-protocol/official-and-third-party-mcp.md) - [自定义 MCP 服务](raw/application-user-guide/model-context-protocol/custom-mcp.md) - [外部调用](raw/application-user-guide/model-context-protocol/mcp-external-calls.md) - [MCP 常见问题](raw/application-user-guide/model-context-protocol/mcp-faq.md) -- **Skill** - - [Skill](raw/application-user-guide/skill/introduction-to-skill.md) -- **插件** - - [插件概述](raw/application-user-guide/plug-in/plug-in-overview.md) - - [官方和第三方插件](raw/application-user-guide/plug-in/plugins.md) - - [自定义插件](raw/application-user-guide/plug-in/custom-plug-ins.md) - **应用发布与分享** - [分享智能体应用](raw/application-user-guide/application-publishing-and-sharing/share-an-application.md) - [使用智能体或工作流作为组件](raw/application-user-guide/application-publishing-and-sharing/use-agent-or-workflow-as-component.md) - [UI设计器](raw/application-user-guide/application-publishing-and-sharing/ui-designer.md) +- **插件** + - [插件概述](raw/application-user-guide/plug-in/plug-in-overview.md) + - [官方和第三方插件](raw/application-user-guide/plug-in/plugins.md) + - [自定义插件](raw/application-user-guide/plug-in/custom-plug-ins.md) - **应用调用** - [调用工作流应用](raw/application-user-guide/bailian-application-calling/invoke-workflow-application.md) - [应用的自定义参数传递](raw/application-user-guide/bailian-application-calling/pass-through-of-application-parameters.md) @@ -195,12 +195,14 @@ - [评测集](raw/application-user-guide/application-evaluation/application-evaluation-dataset.md) - **应用观测** - [应用观测](raw/application-user-guide/application-monitoring/application-observation.md) +- **权限管理** + - [权限管理](raw/application-user-guide/application-permission-management/application-permission-management-overview.md) - **应用广场** - **官方应用-通义音频播客生成** - **API参考** - **API目录** - - [PodcastTaskSubmit - 播客任务提交](raw/application-user-guide/application-gallery/official-application-aipodcast/api-reference-aipodcast/api-aipodcast-2025-02-28-dir/api-aipodcast-2025-02-28-podcasttasksubmit.md) - [PodcastTaskResultQuery - 播客任务结果查询](raw/application-user-guide/application-gallery/official-application-aipodcast/api-reference-aipodcast/api-aipodcast-2025-02-28-dir/api-aipodcast-2025-02-28-podcasttaskresultquery.md) + - [PodcastTaskSubmit - 播客任务提交](raw/application-user-guide/application-gallery/official-application-aipodcast/api-reference-aipodcast/api-aipodcast-2025-02-28-dir/api-aipodcast-2025-02-28-podcasttasksubmit.md) - [API概览](raw/application-user-guide/application-gallery/official-application-aipodcast/api-reference-aipodcast/api-aipodcast-2025-02-28-overview.md) - [服务接入点](raw/application-user-guide/application-gallery/official-application-aipodcast/api-reference-aipodcast/api-aipodcast-2025-02-28-endpoint.md) - [授权信息](raw/application-user-guide/application-gallery/official-application-aipodcast/api-reference-aipodcast/api-aipodcast-2025-02-28-ram.md) @@ -217,8 +219,8 @@ - **官方应用-多模态交互开发套件** - **使用指南** - [应用创建](raw/application-user-guide/application-gallery/multimodal-products/multimodal-guidelines/multimodal-app-creation.md) - - [应用体验与发布](raw/application-user-guide/application-gallery/multimodal-products/multimodal-guidelines/multimodal-app-experience-and-publishing.md) - [应用配置](raw/application-user-guide/application-gallery/multimodal-products/multimodal-guidelines/multimodal-app-configuration.md) + - [应用体验与发布](raw/application-user-guide/application-gallery/multimodal-products/multimodal-guidelines/multimodal-app-experience-and-publishing.md) - [百炼应用推荐模板](raw/application-user-guide/application-gallery/multimodal-products/multimodal-guidelines/agent-template.md) - [指令列表](raw/application-user-guide/application-gallery/multimodal-products/multimodal-guidelines/instruction-list.md) - [多语言对话](raw/application-user-guide/application-gallery/multimodal-products/multimodal-guidelines/multi-language-dialogue.md) @@ -226,8 +228,8 @@ - [三方Agent接入](raw/application-user-guide/application-gallery/multimodal-products/multimodal-guidelines/multimodal-integration-a2a.md) - [音色列表](raw/application-user-guide/application-gallery/multimodal-products/multimodal-guidelines/multimodal-timbre-list.md) - **SDK安装** - - [服务端Python SDK](raw/application-user-guide/application-gallery/multimodal-products/multimodal-sdk/multimodal-sdk-python.md) - [服务端Java SDK](raw/application-user-guide/application-gallery/multimodal-products/multimodal-sdk/multimodal-sdk-java.md) + - [服务端Python SDK](raw/application-user-guide/application-gallery/multimodal-products/multimodal-sdk/multimodal-sdk-python.md) - [服务端 Go SDK](raw/application-user-guide/application-gallery/multimodal-products/multimodal-sdk/server-go-sdk.md) - [移动端Android SDK](raw/application-user-guide/application-gallery/multimodal-products/multimodal-sdk/multimodal-sdk-android.md) - [移动端iOS SDK](raw/application-user-guide/application-gallery/multimodal-products/multimodal-sdk/multimodal-sdk-ios.md) @@ -236,14 +238,14 @@ - [Linux C++ SDK](raw/application-user-guide/application-gallery/multimodal-products/multimodal-sdk/multimodal-sdk-linux.md) - [RTOS C SDK（License模式）](raw/application-user-guide/application-gallery/multimodal-products/multimodal-sdk/mmi-rtos-sdk.md) - **API参考** - - [实时多模态交互协议（WebSocket）](raw/application-user-guide/application-gallery/multimodal-products/multimodal-api-references/multimodal-interaction-protocol.md) - - [调用官方Agent](raw/application-user-guide/application-gallery/multimodal-products/multimodal-api-references/official-agent.md) - [HTTP协议](raw/application-user-guide/application-gallery/multimodal-products/multimodal-api-references/multimodal-http-protocol.md) + - [调用官方Agent](raw/application-user-guide/application-gallery/multimodal-products/multimodal-api-references/official-agent.md) + - [实时多模态交互协议（WebSocket）](raw/application-user-guide/application-gallery/multimodal-products/multimodal-api-references/multimodal-interaction-protocol.md) + - [调用插件](raw/application-user-guide/application-gallery/multimodal-products/multimodal-api-references/call-plugins.md) - [调用三方语音模型](raw/application-user-guide/application-gallery/multimodal-products/multimodal-api-references/third-party-voice-integration.md) - [管理热词](raw/application-user-guide/application-gallery/multimodal-products/multimodal-api-references/management-hot-words.md) - - [调用插件](raw/application-user-guide/application-gallery/multimodal-products/multimodal-api-references/call-plugins.md) - - [多模态交互套件-错误码](raw/application-user-guide/application-gallery/multimodal-products/multimodal-api-references/multimodal-error-code.md) - [多模态对话结果 extra_info 说明](raw/application-user-guide/application-gallery/multimodal-products/multimodal-api-references/extra-info-description.md) + - [多模态交互套件-错误码](raw/application-user-guide/application-gallery/multimodal-products/multimodal-api-references/multimodal-error-code.md) - [长期记忆开放接口](raw/application-user-guide/application-gallery/multimodal-products/multimodal-api-references/long-term-memory-api.md) - **最佳实践** - **接入百炼及三方Agent** @@ -258,8 +260,8 @@ - [语音请求直通图像生成Agent(websocket)](raw/application-user-guide/application-gallery/multimodal-products/multimodal-best-practices/generateimgagent/audio-to-generateimgagent.md) - **接入听悟智能纪要Agent** - [录音纪要Agent使用教程](raw/application-user-guide/application-gallery/multimodal-products/multimodal-best-practices/fast-integrate-tingwu-meeting-agent/recording-summary-agent-tutorial.md) - - [快速集成智能纪要Agent](raw/application-user-guide/application-gallery/multimodal-products/multimodal-best-practices/fast-integrate-tingwu-meeting-agent/fast-integrate-offline-tingwu-meeting-agent.md) - [实时转写能力集成](raw/application-user-guide/application-gallery/multimodal-products/multimodal-best-practices/fast-integrate-tingwu-meeting-agent/realtime-tingwu-meeting-agent-integration.md) + - [快速集成智能纪要Agent](raw/application-user-guide/application-gallery/multimodal-products/multimodal-best-practices/fast-integrate-tingwu-meeting-agent/fast-integrate-offline-tingwu-meeting-agent.md) - [接入多模态备忘录Agent](raw/application-user-guide/application-gallery/multimodal-products/multimodal-best-practices/multimodal-memo-agent.md) - [接入音乐电台Agent](raw/application-user-guide/application-gallery/multimodal-products/multimodal-best-practices/music-agent.md) - [接入视频通话Agent](raw/application-user-guide/application-gallery/multimodal-products/multimodal-best-practices/live-api-integration.md) @@ -272,6 +274,17 @@ - [产品计费](raw/application-user-guide/application-gallery/multimodal-products/product-billing.md) - [多模态交互开发套件常见问题](raw/application-user-guide/application-gallery/multimodal-products/multimodal-products-faq.md) - **官方应用-全妙轻应用系列** + - **计费说明（全妙轻应用）** + - [电商文案智能可控生成计费](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-billing-document/e-commerce-copy-intelligent-controllable-generation-billing.md) + - [影视互娱剧本创作计费](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-billing-document/film-and-television-mutual-entertainment-script-creation-billing.md) + - [电商零售推广文案写作计费](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-billing-document/e-commerce-retail-promotion-copywriting-billing.md) + - [影视传媒视频理解计费](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-billing-document/film-and-television-media-video-understanding-billing.md) + - [车机网络热点信息互动问答计费文档](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-billing-document/car-machine-network-hot-information-interactive-question-and-answer-billing.md) + - [泛企业VOC挖掘计费](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-billing-document/pan-enterprise-voc-mining-billing.md) + - [网络内容安全审核计费](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-billing-document/network-content-security-audit-billing.md) + - [泛企业线索挖掘计费](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-billing-document/pan-enterprise-lead-mining-billing.md) + - [作文批改计费](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-billing-document/composition-correction-billing.md) + - [视频智能拆条计费](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-billing-document/video-smart-strip-billing.md) - **使用指南** - [电商文案智能可控生成](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-guidelines-for-use/intelligent-and-controllable-generation-of-e-commerce-copywriting.md) - [传媒/零售文章风格与格式学习](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-guidelines-for-use/media-retail-article-style-and-format-learning.md) @@ -282,22 +295,11 @@ - [泛企业线索挖掘](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-guidelines-for-use/pan-enterprise-clue-mining.md) - [网络内容安全审核](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-guidelines-for-use/network-content-security-audit.md) - [作文批改助手](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-guidelines-for-use/composition-correction-assistant.md) - - **计费说明（全妙轻应用）** - - [电商零售推广文案写作计费](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-billing-document/e-commerce-retail-promotion-copywriting-billing.md) - - [影视互娱剧本创作计费](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-billing-document/film-and-television-mutual-entertainment-script-creation-billing.md) - - [电商文案智能可控生成计费](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-billing-document/e-commerce-copy-intelligent-controllable-generation-billing.md) - - [影视传媒视频理解计费](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-billing-document/film-and-television-media-video-understanding-billing.md) - - [泛企业VOC挖掘计费](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-billing-document/pan-enterprise-voc-mining-billing.md) - - [泛企业线索挖掘计费](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-billing-document/pan-enterprise-lead-mining-billing.md) - - [车机网络热点信息互动问答计费文档](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-billing-document/car-machine-network-hot-information-interactive-question-and-answer-billing.md) - - [网络内容安全审核计费](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-billing-document/network-content-security-audit-billing.md) - - [作文批改计费](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-billing-document/composition-correction-billing.md) - - [视频智能拆条计费](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-billing-document/video-smart-strip-billing.md) - **开发文档** - **最佳实践** - [应用视频理解和一键成片的最佳实践](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/light-application-best-practices/best-practices-for-applying-video-understanding-and-one-click-film.md) - - [阿里云百炼工作流集成视频理解最佳实践](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/light-application-best-practices/best-practices-for-workflow-integration-video-understanding.md) - [挖掘VOC信息和数据分析的最佳实践](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/light-application-best-practices/best-practices-for-mining-voc-information-and-data-analysis.md) + - [阿里云百炼工作流集成视频理解最佳实践](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/light-application-best-practices/best-practices-for-workflow-integration-video-understanding.md) - **API参考** - **数据结构** - [ModelUsage](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-struct-dir/api-quanmiaolightapp-2024-08-01-struct-modelusage.md) @@ -313,10 +315,10 @@ - **传媒/零售文章风格与格式学习** - [RunStyleWriting - 传媒/零售文章风格与格式学习](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-media-retail-article-style-and-format-learning/api-quanmiaolightapp-2024-08-01-runstylewriting.md) - **影视传媒视频理解** + - [SubmitVideoAnalysisTask - 视频理解-提交异步任务](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-film-and-television-media-video-understanding/api-quanmiaolightapp-2024-08-01-submitvideoanalysistask.md) - [GetVideoAnalysisTask - 视频理解-获取异步任务状态和结果](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-film-and-television-media-video-understanding/api-quanmiaolightapp-2024-08-01-getvideoanalysistask.md) - [GetVideoAnalysisConfig - 视频理解-获取配置](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-film-and-television-media-video-understanding/api-quanmiaolightapp-2024-08-01-getvideoanalysisconfig.md) - [UpdateVideoAnalysisConfig - 视频理解-更新配置](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-film-and-television-media-video-understanding/api-quanmiaolightapp-2024-08-01-updatevideoanalysisconfig.md) - - [SubmitVideoAnalysisTask - 视频理解-提交异步任务](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-film-and-television-media-video-understanding/api-quanmiaolightapp-2024-08-01-submitvideoanalysistask.md) - [RunVideoAnalysis - 视频理解-在线任务](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-film-and-television-media-video-understanding/api-quanmiaolightapp-2024-08-01-runvideoanalysis.md) - [UpdateVideoAnalysisTask - 视频理解-修改异步任务状态](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-film-and-television-media-video-understanding/api-quanmiaolightapp-2024-08-01-updatevideoanalysistask.md) - [UpdateVideoAnalysisTasks - 视频理解-批量取消任务](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-film-and-television-media-video-understanding/api-quanmiaolightapp-2024-08-01-updatevideoanalysistasks.md) @@ -324,23 +326,23 @@ - [SubmitVideoDetectShotTask - 智能拆条-提交异步任务](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-film-and-television-media-intelligent-strip/api-quanmiaolightapp-2024-08-01-submitvideodetectshottask.md) - [GetVideoDetectShotTask - 智能拆条-获取异步任务状态和结果](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-film-and-television-media-intelligent-strip/api-quanmiaolightapp-2024-08-01-getvideodetectshottask.md) - [UpdateVideoDetectShotTask - 智能拆条-修改异步任务状态](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-film-and-television-media-intelligent-strip/api-quanmiaolightapp-2024-08-01-updatevideodetectshottask.md) - - [GetVideoDetectShotConfig - 智能拆条-获取配置](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-film-and-television-media-intelligent-strip/api-quanmiaolightapp-2024-08-01-getvideodetectshotconfig.md) - [UpdateVideoDetectShotConfig - 智能拆条-更新配置](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-film-and-television-media-intelligent-strip/api-quanmiaolightapp-2024-08-01-updatevideodetectshotconfig.md) + - [GetVideoDetectShotConfig - 智能拆条-获取配置](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-film-and-television-media-intelligent-strip/api-quanmiaolightapp-2024-08-01-getvideodetectshotconfig.md) - [RunVideoDetectShot - 智能拆条-在线任务](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-film-and-television-media-intelligent-strip/api-quanmiaolightapp-2024-08-01-runvideodetectshot.md) - - **泛企业VOC挖掘** - - [RunEnterpriseVocAnalysis - 在线企业VOC分析](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-pan-enterprise-voc-mining/api-quanmiaolightapp-2024-08-01-runenterprisevocanalysis.md) - **车机网络热点信息互动问答** - [RunHotTopicChat - 播报单（热榜）问答](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-car-machine-network-hot-information-interactive-question-and-answer/api-quanmiaolightapp-2024-08-01-runhottopicchat.md) - [RunHotTopicSummary - 播报单热点自定义摘要生成](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-car-machine-network-hot-information-interactive-question-and-answer/api-quanmiaolightapp-2024-08-01-runhottopicsummary.md) - **泛企业线索挖掘** - [GenerateOutputFormat - 获取输出格式示例](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-pan-enterprise-clue-mining/api-quanmiaolightapp-2024-08-01-generateoutputformat.md) - [RunTagMiningAnalysis - 标签挖掘分析](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-pan-enterprise-clue-mining/api-quanmiaolightapp-2024-08-01-runtagmininganalysis.md) + - **泛企业VOC挖掘** + - [RunEnterpriseVocAnalysis - 在线企业VOC分析](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-pan-enterprise-voc-mining/api-quanmiaolightapp-2024-08-01-runenterprisevocanalysis.md) - **网络内容安全审核** - [RunNetworkContentAudit - 网络内容安全审核](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-network-content-security-audit/api-quanmiaolightapp-2024-08-01-runnetworkcontentaudit.md) - **作文批改** - - [SubmitEssayCorrectionTask - 提交作文批改任务](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-composition-correction/api-quanmiaolightapp-2024-08-01-submitessaycorrectiontask.md) - [RunEssayCorrection - 作文批改](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-composition-correction/api-quanmiaolightapp-2024-08-01-runessaycorrection.md) - [RunOcrParse - 图片OCR解析](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-composition-correction/api-quanmiaolightapp-2024-08-01-runocrparse.md) + - [SubmitEssayCorrectionTask - 提交作文批改任务](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-composition-correction/api-quanmiaolightapp-2024-08-01-submitessaycorrectiontask.md) - [GetEssayCorrectionTask - 获取作文批改任务结果](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-composition-correction/api-quanmiaolightapp-2024-08-01-getessaycorrectiontask.md) - **其他** - [GenerateBroadcastNews - 播报单（热榜）热点推荐](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-other/api-quanmiaolightapp-2024-08-01-generatebroadcastnews.md) @@ -352,8 +354,8 @@ - [ExportAnalysisTagDetailByTaskId - 根据任务ID导出分析明细](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-other/api-quanmiaolightapp-2024-08-01-exportanalysistagdetailbytaskid.md) - [CancelAsyncTask - 根据任务ID取消异步任务的执行](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-other/api-quanmiaolightapp-2024-08-01-cancelasynctask.md) - [GetEnterpriseVocAnalysisTask - 获取企业VOC分析任务结果](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-other/api-quanmiaolightapp-2024-08-01-getenterprisevocanalysistask.md) - - [ListAnalysisTagDetailByTaskId - 获取挖掘结果明细列表](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-other/api-quanmiaolightapp-2024-08-01-listanalysistagdetailbytaskid.md) - [SubmitEnterpriseVocAnalysisTask - 提交企业VOC挖掘异步任务](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-other/api-quanmiaolightapp-2024-08-01-submitenterprisevocanalysistask.md) + - [ListAnalysisTagDetailByTaskId - 获取挖掘结果明细列表](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-other/api-quanmiaolightapp-2024-08-01-listanalysistagdetailbytaskid.md) - [BatchCancelTasks - 批量取消异步任务](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-other/api-quanmiaolightapp-2024-08-01-batchcanceltasks.md) - [BatchQueryTaskStatus - 批量查询异步任务状态](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-other/api-quanmiaolightapp-2024-08-01-batchquerytaskstatus.md) - [GetTaskExecutionStatistics - 查询任务执行情况统计](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-dir/api-quanmiaolightapp-2024-08-01-dir-other/api-quanmiaolightapp-2024-08-01-gettaskexecutionstatistics.md) @@ -368,84 +370,93 @@ - [如何开通通义晓蜜CCAI-对话分析AIO](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/tongyi-xiaomi-ccai-aio-user-guide/activate-dialogue-analysis-aio.md) - [如何对应用进行编辑、删除等管理,如何进行API调用、如何查看调用量](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/tongyi-xiaomi-ccai-aio-user-guide/application-management.md) - [如何进行基于对话分析Agent方式创建应用](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/tongyi-xiaomi-ccai-aio-user-guide/create-an-application-based-on-dialogue-analysis-agent.md) - - [如何基于自定义方式创建应用](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/tongyi-xiaomi-ccai-aio-user-guide/create-an-application-based-on-a-custom-method.md) - - [知识库的使用](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/tongyi-xiaomi-ccai-aio-user-guide/using-the-knowledge-base.md) - [热词组配置管理与使用](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/tongyi-xiaomi-ccai-aio-user-guide/hot-phrase-management.md) + - [知识库的使用](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/tongyi-xiaomi-ccai-aio-user-guide/using-the-knowledge-base.md) + - [如何基于自定义方式创建应用](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/tongyi-xiaomi-ccai-aio-user-guide/create-an-application-based-on-a-custom-method.md) - **API参考** - **API目录** - **热词管理** - [CreateVocab - 创建热词](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/api-reference-2/api-contactcenterai-2024-06-03-dir/api-contactcenterai-2024-06-03-dir-hot-word-management/api-contactcenterai-2024-06-03-createvocab.md) - [UpdateVocab - 修改热词](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/api-reference-2/api-contactcenterai-2024-06-03-dir/api-contactcenterai-2024-06-03-dir-hot-word-management/api-contactcenterai-2024-06-03-updatevocab.md) - - [DeleteVocab - 删除热词](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/api-reference-2/api-contactcenterai-2024-06-03-dir/api-contactcenterai-2024-06-03-dir-hot-word-management/api-contactcenterai-2024-06-03-deletevocab.md) - [ListVocab - 获取热词列表](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/api-reference-2/api-contactcenterai-2024-06-03-dir/api-contactcenterai-2024-06-03-dir-hot-word-management/api-contactcenterai-2024-06-03-listvocab.md) - [GetVocab - 获取热词](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/api-reference-2/api-contactcenterai-2024-06-03-dir/api-contactcenterai-2024-06-03-dir-hot-word-management/api-contactcenterai-2024-06-03-getvocab.md) + - [DeleteVocab - 删除热词](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/api-reference-2/api-contactcenterai-2024-06-03-dir/api-contactcenterai-2024-06-03-dir-hot-word-management/api-contactcenterai-2024-06-03-deletevocab.md) - **不推荐或白名单开放** - [AnalyzeAudioSync - 语音文件实时分析](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/api-reference-2/api-contactcenterai-2024-06-03-dir/api-contactcenterai-2024-06-03-dir-not-recommended-or-whitelisted-open/api-contactcenterai-2024-06-03-analyzeaudiosync.md) - [RunCompletion - 通过模版ID调用通义晓蜜CCAI-对话分析AIO应用](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/api-reference-2/api-contactcenterai-2024-06-03-dir/api-contactcenterai-2024-06-03-runcompletion.md) - [RunCompletionMessage - 使用原生Prompt调用通义晓蜜CCAI-对话分析AIO应用](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/api-reference-2/api-contactcenterai-2024-06-03-dir/api-contactcenterai-2024-06-03-runcompletionmessage.md) - [AnalyzeConversation - 通过任务类型调用通义晓蜜CCAI-对话分析AIO应用](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/api-reference-2/api-contactcenterai-2024-06-03-dir/api-contactcenterai-2024-06-03-analyzeconversation.md) - - [CreateTask - 通过上传离线任务数据进行通义晓蜜CCAI-对话分析](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/api-reference-2/api-contactcenterai-2024-06-03-dir/api-contactcenterai-2024-06-03-createtask.md) - [GetTaskResult - 通过任务ID获取离线任务分析结果](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/api-reference-2/api-contactcenterai-2024-06-03-dir/api-contactcenterai-2024-06-03-gettaskresult.md) - [AnalyzeImage - 图片内容分析](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/api-reference-2/api-contactcenterai-2024-06-03-dir/api-contactcenterai-2024-06-03-analyzeimage.md) + - [CreateTask - 通过上传离线任务数据进行通义晓蜜CCAI-对话分析](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/api-reference-2/api-contactcenterai-2024-06-03-dir/api-contactcenterai-2024-06-03-createtask.md) - [GeneralAnalyzeImage - 通用图片分析](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/api-reference-2/api-contactcenterai-2024-06-03-dir/api-contactcenterai-2024-06-03-generalanalyzeimage.md) - [API概览](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/api-reference-2/api-contactcenterai-2024-06-03-overview.md) - [服务接入点](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/api-reference-2/api-contactcenterai-2024-06-03-endpoint.md) - [版本说明](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/api-reference-2/api-contactcenterai-2024-06-03-changeset.md) - - **最佳实践** - - [客服服务质检最佳实践](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/best-practices/customer-service-quality-inspection-best-practices.md) - - [字段信息抽取最佳实践](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/best-practices/best-practices-for-automatic-work-order-generation.md) - - [摘要生成（含摘要/标题/关键词）最佳实践](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/best-practices/summary-best-practices.md) - **接口调用示例** - - [通过模板ID调用通义晓蜜CCAI-对话分析AIO应用](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/call-tyxm-ccai-aio-api/use-template-id-to-call-tongyi-xiaomi-ccai-aio.md) - [通过原生Prompt调用通义晓蜜CCAI-对话分析AIO应用](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/call-tyxm-ccai-aio-api/use-native-prompt-to-call-tongyi-xiaomi-ccai-aio.md) + - [通过模板ID调用通义晓蜜CCAI-对话分析AIO应用](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/call-tyxm-ccai-aio-api/use-template-id-to-call-tongyi-xiaomi-ccai-aio.md) - [通过任务类型调用通义晓蜜CCAI-对话分析AIO应用](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/call-tyxm-ccai-aio-api/call-tongyi-xiaomi-ccai-dialogue-analysis-aio-application-through-task-type.md) - [通过上传离线任务数据进行通义晓蜜CCAI-对话分析](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/call-tyxm-ccai-aio-api/tongyi-xiaomi-ccai-dialogue-analysis-by-uploading-offline-task-data.md) - [ROA风格请求体&签名机制](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/call-tyxm-ccai-aio-api/roa-style-request-body-signature-mechanism.md) - [通过通义晓蜜CCAI-对话分析AIO应用进行图片分析](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/call-tyxm-ccai-aio-api/picture-analysis-through-tongyi-xiaomi-ccai-dialogue-analysis-aio-application.md) - [通义晓蜜CCAI-对话分析RAM子账号使用方式和授权操作](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/call-tyxm-ccai-aio-api/use-and-authorize-ram-users-for-ccai-dialogue-analysis.md) + - **最佳实践** + - [客服服务质检最佳实践](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/best-practices/customer-service-quality-inspection-best-practices.md) + - [字段信息抽取最佳实践](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/best-practices/best-practices-for-automatic-work-order-generation.md) + - [摘要生成（含摘要/标题/关键词）最佳实践](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/best-practices/summary-best-practices.md) - [通义晓蜜CCAI更新公告](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/tongyi-xiaomi-ccai-update-announcement.md) - [产品概述](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/product-overview-1.md) - [通义晓蜜-CCAI对话分析AIO产品计费](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/ccai-product-billing.md) - [CCAI如何进行集成；查看技术集成方案](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-dialogue-analysis-aio/technology-integration-scheme.md) + - **官方应用-通义晓蜜CCAI-对话Agent** + - **API参考** + - **API目录** + - [SseChat - 问答接口](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-chatbot-agent/api-reference-5/api-bailianchatbot-2024-11-05-dir/api-bailianchatbot-2024-11-05-ssechat.md) + - [API概览](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-chatbot-agent/api-reference-5/api-bailianchatbot-2024-11-05-overview.md) + - [授权信息](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-chatbot-agent/api-reference-5/api-bailianchatbot-2024-11-05-ram.md) + - [产品概述](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-chatbot-agent/product-overview-xiaomi-beebot-agent.md) + - [计费说明（通义晓蜜对话Agent）](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-chatbot-agent/billing-description-tongyi-xiaomi-beebot-agent.md) + - [使用指南](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-chatbot-agent/guidelines-for-use.md) - **官方应用-通义晓蜜CCAI-语音对话机器人** - **API参考** - **API目录** - **MQ消息订阅配置** - [UpdateSubscription - 更新订阅信息](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-mq-message-subscription-configuration/api-bailianvoicebot-2025-01-01-updatesubscription.md) - - [DisableSubscription - 关闭消息订阅](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-mq-message-subscription-configuration/api-bailianvoicebot-2025-01-01-disablesubscription.md) - [GetSubscription - 获取消息订阅配置信息](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-mq-message-subscription-configuration/api-bailianvoicebot-2025-01-01-getsubscription.md) + - [DisableSubscription - 关闭消息订阅](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-mq-message-subscription-configuration/api-bailianvoicebot-2025-01-01-disablesubscription.md) - **变量管理** - - [ListVariable - 获取变量列表](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-variable-management/api-bailianvoicebot-2025-01-01-listvariable.md) - [DeleteVariable - 删除变量](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-variable-management/api-bailianvoicebot-2025-01-01-deletevariable.md) + - [ListVariable - 获取变量列表](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-variable-management/api-bailianvoicebot-2025-01-01-listvariable.md) - [UpdateVariable - 更新变量](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-variable-management/api-bailianvoicebot-2025-01-01-updatevariable.md) - [CreateVariable - 创建变量](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-variable-management/api-bailianvoicebot-2025-01-01-createvariable.md) - - **三方语音配置** - - [ListVoiceEngines - 获取三方语音引擎列表](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-three-way-voice-configuration/api-bailianvoicebot-2025-01-01-listvoiceengines.md) - - [UpdateVoiceAccessProfile - 更新三方语音配置](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-three-way-voice-configuration/api-bailianvoicebot-2025-01-01-updatevoiceaccessprofile.md) - - [ListVoiceAccessProfile - 获取三方语音配置列表](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-three-way-voice-configuration/api-bailianvoicebot-2025-01-01-listvoiceaccessprofile.md) - - [DeleteVoiceAccessProfile - 删除三方语音配置](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-three-way-voice-configuration/api-bailianvoicebot-2025-01-01-deletevoiceaccessprofile.md) - - [CreateVoiceAccessProfile - 创建三方语音配置](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-three-way-voice-configuration/api-bailianvoicebot-2025-01-01-createvoiceaccessprofile.md) - **热词管理** - [UpdateVocabulary - 更新热词](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-hot-word-management/api-bailianvoicebot-2025-01-01-updatevocabulary.md) - [ListVocabulary - 获取热词列表](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-hot-word-management/api-bailianvoicebot-2025-01-01-listvocabulary.md) - - [ImportVocabulary - 导入热词](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-hot-word-management/api-bailianvoicebot-2025-01-01-importvocabulary.md) - - [GetVocabulary - 获取热词信息](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-hot-word-management/api-bailianvoicebot-2025-01-01-getvocabulary.md) - [ExportVocabulary - 导出热词](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-hot-word-management/api-bailianvoicebot-2025-01-01-exportvocabulary.md) + - [GetVocabulary - 获取热词信息](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-hot-word-management/api-bailianvoicebot-2025-01-01-getvocabulary.md) + - [ImportVocabulary - 导入热词](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-hot-word-management/api-bailianvoicebot-2025-01-01-importvocabulary.md) - [DeleteVocabulary - 删除热词](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-hot-word-management/api-bailianvoicebot-2025-01-01-deletevocabulary.md) - [CreateVocabulary - 创建热词](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-hot-word-management/api-bailianvoicebot-2025-01-01-createvocabulary.md) + - **三方语音配置** + - [ListVoiceEngines - 获取三方语音引擎列表](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-three-way-voice-configuration/api-bailianvoicebot-2025-01-01-listvoiceengines.md) + - [UpdateVoiceAccessProfile - 更新三方语音配置](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-three-way-voice-configuration/api-bailianvoicebot-2025-01-01-updatevoiceaccessprofile.md) + - [ListVoiceAccessProfile - 获取三方语音配置列表](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-three-way-voice-configuration/api-bailianvoicebot-2025-01-01-listvoiceaccessprofile.md) + - [DeleteVoiceAccessProfile - 删除三方语音配置](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-three-way-voice-configuration/api-bailianvoicebot-2025-01-01-deletevoiceaccessprofile.md) + - [CreateVoiceAccessProfile - 创建三方语音配置](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-three-way-voice-configuration/api-bailianvoicebot-2025-01-01-createvoiceaccessprofile.md) - **克隆音管理** - [ListCloneVoiceModels - 获取克隆音模型列表](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-clone-tone-management/api-bailianvoicebot-2025-01-01-listclonevoicemodels.md) - - [ListCloneVoice - 获取克隆音列表](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-clone-tone-management/api-bailianvoicebot-2025-01-01-listclonevoice.md) - [DeleteCloneVoice - 删除克隆音](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-clone-tone-management/api-bailianvoicebot-2025-01-01-deleteclonevoice.md) + - [ListCloneVoice - 获取克隆音列表](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-clone-tone-management/api-bailianvoicebot-2025-01-01-listclonevoice.md) - [UpdateCloneVoice - 更新克隆音](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-clone-tone-management/api-bailianvoicebot-2025-01-01-updateclonevoice.md) - [CreateCloneVoice - 创建克隆音](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-clone-tone-management/api-bailianvoicebot-2025-01-01-createclonevoice.md) - **应用管理** - [DeleteApplication - 删除语音机器人应用](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-application-management/api-bailianvoicebot-2025-01-01-deleteapplication.md) - [ListNluModels - 获取对话大模型列表](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-application-management/api-bailianvoicebot-2025-01-01-listnlumodels.md) - [PreviewVoice - TTS合成试听](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-application-management/api-bailianvoicebot-2025-01-01-previewvoice.md) + - [ListVoices - 获取音色列表](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-application-management/api-bailianvoicebot-2025-01-01-listvoices.md) - [ListBackgroundMusics - 获取背景音列表](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-application-management/api-bailianvoicebot-2025-01-01-listbackgroundmusics.md) - [ListApplications - 查询语音机器人应用列表](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-application-management/api-bailianvoicebot-2025-01-01-listapplications.md) - - [ListVoices - 获取音色列表](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-application-management/api-bailianvoicebot-2025-01-01-listvoices.md) - [UpdateApplication - 修改语音机器人应用](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-application-management/api-bailianvoicebot-2025-01-01-updateapplication.md) - [CreateApplicationVersion - 创建语音机器人应用版本](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-application-management/api-bailianvoicebot-2025-01-01-createapplicationversion.md) - [CreateApplication - 创建语音机器人应用](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-dir-application-management/api-bailianvoicebot-2025-01-01-createapplication.md) @@ -455,21 +466,12 @@ - [BridgeWebCall - 软电话测试通话](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-bridgewebcall.md) - [GetDataChannelCredential - 获取数据通道凭证](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-getdatachannelcredential.md) - [GenerateFileUploadParams - 获取文件上传参数](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-dir/api-bailianvoicebot-2025-01-01-generatefileuploadparams.md) - - [API概览](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-overview.md) - [授权信息](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-ram.md) + - [API概览](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-overview.md) - [版本说明](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/api-reference-chat6/api-bailianvoicebot-2025-01-01-changeset.md) - [语音对话机器人产品概述](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/product-0verview.md) - [语音对话机器人产品计费说明](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/billing-description-tongyi-xiaomi-ccai-voice-dialogue-robot.md) - [语音对话机器人操作指南](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-voice-dialogue-robot/operation-guide.md) - - **官方应用-通义晓蜜CCAI-对话Agent** - - **API参考** - - **API目录** - - [SseChat - 问答接口](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-chatbot-agent/api-reference-5/api-bailianchatbot-2024-11-05-dir/api-bailianchatbot-2024-11-05-ssechat.md) - - [API概览](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-chatbot-agent/api-reference-5/api-bailianchatbot-2024-11-05-overview.md) - - [授权信息](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-chatbot-agent/api-reference-5/api-bailianchatbot-2024-11-05-ram.md) - - [产品概述](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-chatbot-agent/product-overview-xiaomi-beebot-agent.md) - - [计费说明（通义晓蜜对话Agent）](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-chatbot-agent/billing-description-tongyi-xiaomi-beebot-agent.md) - - [使用指南](raw/application-user-guide/application-gallery/official-application-tongyi-xiaomi-ccai-chatbot-agent/guidelines-for-use.md) - **通义点金** - **API参考** - **API目录** @@ -478,20 +480,20 @@ - [GetAppConfig - 获取配置信息](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-document-library/api-dianjin-2024-06-28-getappconfig.md) - [CreateLibrary - 创建文档库](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-document-library/api-dianjin-2024-06-28-createlibrary.md) - [GetLibraryList - 获取文档库列表](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-document-library/api-dianjin-2024-06-28-getlibrarylist.md) - - [GetLibrary - 获取文档库详情](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-document-library/api-dianjin-2024-06-28-getlibrary.md) - [UploadDocument - 上传文档](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-document-library/api-dianjin-2024-06-28-uploaddocument.md) + - [GetLibrary - 获取文档库详情](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-document-library/api-dianjin-2024-06-28-getlibrary.md) - [GetDocumentUrl - 获取文档的下载链接](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-document-library/api-dianjin-2024-06-28-getdocumenturl.md) - [PreviewDocument - 预览文档](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-document-library/api-dianjin-2024-06-28-previewdocument.md) - [GetFilterDocumentList - 按元信息过滤查询文档列表](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-document-library/api-dianjin-2024-06-28-getfilterdocumentlist.md) - - [DeleteDocument - 删除文档](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-document-library/api-dianjin-2024-06-28-deletedocument.md) - [GetDocumentList - 获取文档列表](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-document-library/api-dianjin-2024-06-28-getdocumentlist.md) - - [CreatePredefinedDocument - 创建预定义文档](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-document-library/api-dianjin-2024-06-28-createpredefineddocument.md) + - [DeleteDocument - 删除文档](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-document-library/api-dianjin-2024-06-28-deletedocument.md) - [UpdateDocument - 更新文档](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-document-library/api-dianjin-2024-06-28-updatedocument.md) - [GetDocumentChunkList - 获取文档块列表](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-document-library/api-dianjin-2024-06-28-getdocumentchunklist.md) + - [CreatePredefinedDocument - 创建预定义文档](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-document-library/api-dianjin-2024-06-28-createpredefineddocument.md) - [GetParseResult - 获取文档解析结果](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-document-library/api-dianjin-2024-06-28-getparseresult.md) - [ReIndex - 重建索引](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-document-library/api-dianjin-2024-06-28-reindex.md) - - [UpdateLibrary - 更新文档库](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-document-library/api-dianjin-2024-06-28-updatelibrary.md) - [RecallDocument - 文档召回](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-document-library/api-dianjin-2024-06-28-recalldocument.md) + - [UpdateLibrary - 更新文档库](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-document-library/api-dianjin-2024-06-28-updatelibrary.md) - [DeleteLibrary - 删除文档库](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-document-library/api-dianjin-2024-06-28-deletelibrary.md) - [RunLibraryChatGeneration - 文档库会话生成](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-document-library/api-dianjin-2024-06-28-runlibrarychatgeneration.md) - [InvokePlugin - 调用插件](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-document-library/api-dianjin-2024-06-28-invokeplugin.md) @@ -501,29 +503,29 @@ - [RunDialogAnalysis - 会话分析结果生成](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-rundialoganalysis.md) - [RunAgent - 运行智能体](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-runagent.md) - [CreateDialog - 创建外呼会话](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-createdialog.md) - - [RealtimeDialogAssist - 实时会话辅助](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-realtimedialogassist.md) - - [RealTimeDialog - 实时会话](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-realtimedialog.md) - [GetDialogDetail - 获取会话详情](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-getdialogdetail.md) + - [RealTimeDialog - 实时会话](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-realtimedialog.md) + - [RealtimeDialogAssist - 实时会话辅助](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-realtimedialogassist.md) - [GetDialogAnalysisResult - 获取会话分析结果](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-getdialoganalysisresult.md) - - [CreateDialogAnalysisTask - 创建会话分析任务](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-createdialoganalysistask.md) - [GetDialogLog - 获取对话日志](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-getdialoglog.md) + - [CreateDialogAnalysisTask - 创建会话分析任务](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-createdialoganalysistask.md) - [RebuildTask - 重建任务](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-rebuildtask.md) - [EvictTask - 取消任务](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-evicttask.md) + - [GetTaskStatus - 获取任务状态](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-gettaskstatus.md) - [CreateDocsSummaryTask - 创建多文档总结任务](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-createdocssummarytask.md) - - [CreatePdfTranslateTask - 创建pdf文档翻译任务](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-createpdftranslatetask.md) - [CreateAnnualDocSummaryTask - 创建按年份总结文档任务](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-createannualdocsummarytask.md) - - [GetTaskStatus - 获取任务状态](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-gettaskstatus.md) + - [CreatePdfTranslateTask - 创建pdf文档翻译任务](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-createpdftranslatetask.md) - [CreateFinReportSummaryTask - 创建财报总结任务](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-createfinreportsummarytask.md) - [GetSummaryTaskResult - 获取财报总结任务结果](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-getsummarytaskresult.md) - [GetTaskResult - 获取结果](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-gettaskresult.md) - [CreateQualityCheckTask - 创建质检任务](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-createqualitychecktask.md) - - [RecognizeIntention - 意图识别](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-recognizeintention.md) - [GetQualityCheckTaskResult - 获取质检结果](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-getqualitychecktaskresult.md) - [GenDocQaResult - 根据文档解析问答QA](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-gendocqaresult.md) + - [RecognizeIntention - 意图识别](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-recognizeintention.md) - [SubmitChatQuestion - 提交问题列表](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-submitchatquestion.md) + - [GetChatQuestionResp - 获取问答结果](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-getchatquestionresp.md) - [UpdateQaLibrary - 更新QA问答库](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-updateqalibrary.md) - [RunChatResultGeneration - 对话结果生成](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-runchatresultgeneration.md) - - [GetChatQuestionResp - 获取问答结果](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-platform-capabilities-application/api-dianjin-2024-06-28-getchatquestionresp.md) - **其他** - [DashscopeAsyncTaskFinishEvent - Dashscope异步任务完成回调事件](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-dir/api-dianjin-2024-06-28-dir-other/api-dianjin-2024-06-28-dashscopeasynctaskfinishevent.md) - [API概览](raw/application-user-guide/application-gallery/tongyi-dianjin/api-reference-3/api-dianjin-2024-06-28-overview.md) @@ -535,10 +537,10 @@ - **API参考** - **API目录** - [文档上传](raw/application-user-guide/application-gallery/tongyi-docmining/docmining-api-reference/docmining-api-directory/document-upload.md) - - [文档内容审核](raw/application-user-guide/application-gallery/tongyi-docmining/docmining-api-reference/docmining-api-directory/document-content-audit.md) - [信息抽取](raw/application-user-guide/application-gallery/tongyi-docmining/docmining-api-reference/docmining-api-directory/document-information-extraction.md) - - [摘要生成](raw/application-user-guide/application-gallery/tongyi-docmining/docmining-api-reference/docmining-api-directory/document-summary-generation.md) + - [文档内容审核](raw/application-user-guide/application-gallery/tongyi-docmining/docmining-api-reference/docmining-api-directory/document-content-audit.md) - [打标分类](raw/application-user-guide/application-gallery/tongyi-docmining/docmining-api-reference/docmining-api-directory/document-tagging.md) + - [摘要生成](raw/application-user-guide/application-gallery/tongyi-docmining/docmining-api-reference/docmining-api-directory/document-summary-generation.md) - [文档删除](raw/application-user-guide/application-gallery/tongyi-docmining/docmining-api-reference/docmining-api-directory/document-delete.md) - [API概览](raw/application-user-guide/application-gallery/tongyi-docmining/docmining-api-reference/docmining-api-overview.md) - [服务接入点](raw/application-user-guide/application-gallery/tongyi-docmining/docmining-api-reference/docmining-service-access-point.md) @@ -551,25 +553,33 @@ - [TextTranslate - 文本翻译接口](raw/application-user-guide/application-gallery/official-application-tongyi-translate/tongyi-translate-api-reference/api-anytrans-2025-07-07-dir/api-anytrans-2025-07-07-dir-text-translation/api-anytrans-2025-07-07-texttranslate.md) - [BatchTranslate - 批量文本翻译](raw/application-user-guide/application-gallery/official-application-tongyi-translate/tongyi-translate-api-reference/api-anytrans-2025-07-07-dir/api-anytrans-2025-07-07-dir-text-translation/api-anytrans-2025-07-07-batchtranslate.md) - [SubmitLongTextTranslateTask - 提交长文本翻译任务](raw/application-user-guide/application-gallery/official-application-tongyi-translate/tongyi-translate-api-reference/api-anytrans-2025-07-07-dir/api-anytrans-2025-07-07-dir-text-translation/api-anytrans-2025-07-07-submitlongtexttranslatetask.md) - - [GetHtmlTranslateTask - 获取html翻译任务结果](raw/application-user-guide/application-gallery/official-application-tongyi-translate/tongyi-translate-api-reference/api-anytrans-2025-07-07-dir/api-anytrans-2025-07-07-dir-text-translation/api-anytrans-2025-07-07-gethtmltranslatetask.md) - [SubmitHtmlTranslateTask - 提交html翻译任务](raw/application-user-guide/application-gallery/official-application-tongyi-translate/tongyi-translate-api-reference/api-anytrans-2025-07-07-dir/api-anytrans-2025-07-07-dir-text-translation/api-anytrans-2025-07-07-submithtmltranslatetask.md) + - [GetHtmlTranslateTask - 获取html翻译任务结果](raw/application-user-guide/application-gallery/official-application-tongyi-translate/tongyi-translate-api-reference/api-anytrans-2025-07-07-dir/api-anytrans-2025-07-07-dir-text-translation/api-anytrans-2025-07-07-gethtmltranslatetask.md) - [TermEdit - 术语库编辑](raw/application-user-guide/application-gallery/official-application-tongyi-translate/tongyi-translate-api-reference/api-anytrans-2025-07-07-dir/api-anytrans-2025-07-07-dir-text-translation/api-anytrans-2025-07-07-termedit.md) - - [GetLongTextTranslateTask - 获取长文本翻译任务结果](raw/application-user-guide/application-gallery/official-application-tongyi-translate/tongyi-translate-api-reference/api-anytrans-2025-07-07-dir/api-anytrans-2025-07-07-dir-text-translation/api-anytrans-2025-07-07-getlongtexttranslatetask.md) - [TermQuery - 术语库查询](raw/application-user-guide/application-gallery/official-application-tongyi-translate/tongyi-translate-api-reference/api-anytrans-2025-07-07-dir/api-anytrans-2025-07-07-dir-text-translation/api-anytrans-2025-07-07-termquery.md) + - [GetLongTextTranslateTask - 获取长文本翻译任务结果](raw/application-user-guide/application-gallery/official-application-tongyi-translate/tongyi-translate-api-reference/api-anytrans-2025-07-07-dir/api-anytrans-2025-07-07-dir-text-translation/api-anytrans-2025-07-07-getlongtexttranslatetask.md) + - **其他** + - [BatchTranslateForHtml - 网页批量翻译](raw/application-user-guide/application-gallery/official-application-tongyi-translate/tongyi-translate-api-reference/api-anytrans-2025-07-07-dir/api-anytrans-2025-07-07-dir-other/api-anytrans-2025-07-07-batchtranslateforhtml.md) - **图片翻译** - - [SubmitImageTranslateTask - 提交图片翻译任务](raw/application-user-guide/application-gallery/official-application-tongyi-translate/tongyi-translate-api-reference/api-anytrans-2025-07-07-dir/api-anytrans-2025-07-07-dir-image-translation/api-anytrans-2025-07-07-submitimagetranslatetask.md) - [GetImageTranslateTask - 获取图片翻译任务结果](raw/application-user-guide/application-gallery/official-application-tongyi-translate/tongyi-translate-api-reference/api-anytrans-2025-07-07-dir/api-anytrans-2025-07-07-dir-image-translation/api-anytrans-2025-07-07-getimagetranslatetask.md) + - [SubmitImageTranslateTask - 提交图片翻译任务](raw/application-user-guide/application-gallery/official-application-tongyi-translate/tongyi-translate-api-reference/api-anytrans-2025-07-07-dir/api-anytrans-2025-07-07-dir-image-translation/api-anytrans-2025-07-07-submitimagetranslatetask.md) - **文档翻译** - [SubmitDocTranslateTask - 文档翻译任务提交](raw/application-user-guide/application-gallery/official-application-tongyi-translate/tongyi-translate-api-reference/api-anytrans-2025-07-07-dir/api-anytrans-2025-07-07-dir-document-translation/api-anytrans-2025-07-07-submitdoctranslatetask.md) - [GetDocTranslateTask - 文档翻译结果获取](raw/application-user-guide/application-gallery/official-application-tongyi-translate/tongyi-translate-api-reference/api-anytrans-2025-07-07-dir/api-anytrans-2025-07-07-dir-document-translation/api-anytrans-2025-07-07-getdoctranslatetask.md) - - **其他** - - [BatchTranslateForHtml - 网页批量翻译](raw/application-user-guide/application-gallery/official-application-tongyi-translate/tongyi-translate-api-reference/api-anytrans-2025-07-07-dir/api-anytrans-2025-07-07-dir-other/api-anytrans-2025-07-07-batchtranslateforhtml.md) - - [API概览](raw/application-user-guide/application-gallery/official-application-tongyi-translate/tongyi-translate-api-reference/api-anytrans-2025-07-07-overview.md) - [服务接入点](raw/application-user-guide/application-gallery/official-application-tongyi-translate/tongyi-translate-api-reference/api-anytrans-2025-07-07-endpoint.md) + - [API概览](raw/application-user-guide/application-gallery/official-application-tongyi-translate/tongyi-translate-api-reference/api-anytrans-2025-07-07-overview.md) - [授权信息](raw/application-user-guide/application-gallery/official-application-tongyi-translate/tongyi-translate-api-reference/api-anytrans-2025-07-07-ram.md) - [版本说明](raw/application-user-guide/application-gallery/official-application-tongyi-translate/tongyi-translate-api-reference/api-anytrans-2025-07-07-changeset.md) - [通义多模态翻译](raw/application-user-guide/application-gallery/official-application-tongyi-translate/official-application-tongyi-translate-overview.md) - [网页翻译JSSDK](raw/application-user-guide/application-gallery/official-application-tongyi-translate/web-page-translation-jssdk.md) + - **官方应用-千问联网检索Agent** + - **API参考** + - [服务接入点](raw/application-user-guide/application-gallery/web-search-agent/web-search-agent-api/service-access-point.md) + - [API概览](raw/application-user-guide/application-gallery/web-search-agent/web-search-agent-api/web-search-agent-api-overview.md) + - [生成对话](raw/application-user-guide/application-gallery/web-search-agent/web-search-agent-api/web-search-agent-api-chat.md) + - [多模态文件操作](raw/application-user-guide/application-gallery/web-search-agent/web-search-agent-api/web-search-agent-api-chat-multimodal-file.md) + - [千问联网检索Agent产品简介](raw/application-user-guide/application-gallery/web-search-agent/web-search-agent-guide.md) + - [错误码-千问联网检索Agent](raw/application-user-guide/application-gallery/web-search-agent/web-search-agent-error-code.md) - **官方应用-通义深度搜索** - **API参考** - **API目录** @@ -583,14 +593,6 @@ - [错误码-通义深度搜索](raw/application-user-guide/application-gallery/tongyi-deepsearch/deepsearch-api-reference/deepsearch-error-code.md) - [通义深度搜索](raw/application-user-guide/application-gallery/tongyi-deepsearch/tongyi-deep-search-introduction.md) - [操作指南](raw/application-user-guide/application-gallery/tongyi-deepsearch/deepsearch-guide.md) - - **官方应用-千问联网检索Agent** - - **API参考** - - [API概览](raw/application-user-guide/application-gallery/web-search-agent/web-search-agent-api/web-search-agent-api-overview.md) - - [服务接入点](raw/application-user-guide/application-gallery/web-search-agent/web-search-agent-api/service-access-point.md) - - [多模态文件操作](raw/application-user-guide/application-gallery/web-search-agent/web-search-agent-api/web-search-agent-api-chat-multimodal-file.md) - - [生成对话](raw/application-user-guide/application-gallery/web-search-agent/web-search-agent-api/web-search-agent-api-chat.md) - - [千问联网检索Agent产品简介](raw/application-user-guide/application-gallery/web-search-agent/web-search-agent-guide.md) - - [错误码-千问联网检索Agent](raw/application-user-guide/application-gallery/web-search-agent/web-search-agent-error-code.md) - **通义 UI Agent** - [通义 UI Agent](raw/application-user-guide/application-gallery/ui-agent/ui-agent-api.md) - **官方应用-全妙解决方案类产品** @@ -603,8 +605,8 @@ - **AI妙笔** - **功能界面** - [妙笔-分布生成创作文章](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/usage-guide/amb/function-interface/step-by-step-generation.md) - - [智能配图](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/usage-guide/amb/function-interface/smart-image-generation.md) - [直接生成](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/usage-guide/amb/function-interface/direct-generation.md) + - [智能配图](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/usage-guide/amb/function-interface/smart-image-generation.md) - [搜索素材](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/usage-guide/amb/function-interface/search-materials.md) - [AI妙笔产品概述](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/usage-guide/amb/product-overview-for-amb.md) - [妙笔首页概览](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/usage-guide/amb/amb-homepage-overview.md) @@ -616,21 +618,21 @@ - [智能审校](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/usage-guide/article-review.md) - [深度写作](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/usage-guide/deep-writing.md) - **文本写作指导** - - **政务公文写作指导** - - [快速写一篇政务稿（prompt一步式撰写）](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/document-writing-best-practices/government-document-writing-best-practices/quick-gov-writing-prompt.md) - - [用已有文章，生成标题摘要等](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/document-writing-best-practices/government-document-writing-best-practices/generate-titles-summaries-gov-text.md) - - [分步式撰写政务稿（精准控制章节内容）](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/document-writing-best-practices/government-document-writing-best-practices/step-by-step-gov-writing.md) - **传媒类文体写作指导** - [快速写一篇传媒稿（prompt一步式撰写）](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/document-writing-best-practices/media-style-writing-best-practices/quick-media-writing-prompt.md) - [没有思路，要谋篇布局](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/document-writing-best-practices/media-style-writing-best-practices/use-amb-to-help-writing.md) - [用已有文章，生成标题摘要等](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/document-writing-best-practices/media-style-writing-best-practices/generate-titles-summaries-media-text.md) + - **政务公文写作指导** + - [快速写一篇政务稿（prompt一步式撰写）](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/document-writing-best-practices/government-document-writing-best-practices/quick-gov-writing-prompt.md) + - [分步式撰写政务稿（精准控制章节内容）](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/document-writing-best-practices/government-document-writing-best-practices/step-by-step-gov-writing.md) + - [用已有文章，生成标题摘要等](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/document-writing-best-practices/government-document-writing-best-practices/generate-titles-summaries-gov-text.md) - [常见FAQ](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/document-writing-best-practices/faq-for-using-quanmiao-series-products.md) - **更新公告** - **功能更新** - [2025年2月26日更新-妙笔](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/update-announcement/miaobi-and-miaoce-function-update/february-26-2025-update-miaobi.md) - [2025年1月24日更新-全妙解决方案类产品](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/update-announcement/miaobi-and-miaoce-function-update/2025-1-24-function-update-announcement-quanmiao-saas.md) - - [2024年3月11更新-AI全妙系列 V2.2.2](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/update-announcement/miaobi-and-miaoce-function-update/update-2024-03-11-ai-quanmiao-v2-2.md) - [2024年3月1更新-AI全妙系列 V2.2.1](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/update-announcement/miaobi-and-miaoce-function-update/update-2024-03-01-ai-quanmiao-v2-2.md) + - [2024年3月11更新-AI全妙系列 V2.2.2](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/update-announcement/miaobi-and-miaoce-function-update/update-2024-03-11-ai-quanmiao-v2-2.md) - [2024年2月28更新-AI全妙系列 V2.2](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/update-announcement/miaobi-and-miaoce-function-update/update-2024-02-28-ai-quanmiao-v2.md) - [2023年12月19更新-AI妙笔V2.1](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/update-announcement/miaobi-and-miaoce-function-update/update-2023-12-19-amb-v2.md) - [计费说明（妙笔）](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/miaobi-billing.md) @@ -643,8 +645,8 @@ - **数据结构** - [GenerateTraceability](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-struct-dir/api-aimiaobi-2023-08-01-struct-generatetraceability.md) - [HottopicNews](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-struct-dir/api-aimiaobi-2023-08-01-hottopicnews.md) - - [OutlineWritingArticle](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-struct-dir/api-aimiaobi-2023-08-01-struct-outlinewritingarticle.md) - [OutlineSearchResult](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-struct-dir/api-aimiaobi-2023-08-01-struct-outlinesearchresult.md) + - [OutlineWritingArticle](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-struct-dir/api-aimiaobi-2023-08-01-struct-outlinewritingarticle.md) - [TopicSelection](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-struct-dir/api-aimiaobi-2023-08-01-struct-topicselection.md) - [WritingOutline](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-struct-dir/api-aimiaobi-2023-08-01-struct-writingoutline.md) - [WritingStyleTemplateDefine](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-struct-dir/api-aimiaobi-2023-08-01-struct-writingstyletemplatedefine.md) @@ -655,9 +657,9 @@ - [GenerateUploadConfig - 生成上传配置](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-common-interface-file-upload-and-download/api-aimiaobi-2023-08-01-generateuploadconfig.md) - **通用接口** - [CreateToken - 获取授权token](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-universal-interface/api-aimiaobi-2023-08-01-createtoken.md) - - [ListVersions - 获取版本信息](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-universal-interface/api-aimiaobi-2023-08-01-listversions.md) - [ListDialogues - 生成历史列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-universal-interface/api-aimiaobi-2023-08-01-listdialogues.md) - [GetProperties - 获取配置信息](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-universal-interface/api-aimiaobi-2023-08-01-getproperties.md) + - [ListVersions - 获取版本信息](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-universal-interface/api-aimiaobi-2023-08-01-listversions.md) - **通用接口-异步任务管理** - [SubmitAsyncTask - 提交异步任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-common-interface-asynchronous-task-management/api-aimiaobi-2023-08-01-submitasynctask.md) - [CancelAsyncTask - 取消异步任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-common-interface-asynchronous-task-management/api-aimiaobi-2023-08-01-cancelasynctask.md) @@ -672,189 +674,189 @@ - **妙笔-创作文章** - [RunAiHelperWriting - AI帮写](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-creative-articles/api-aimiaobi-2023-08-01-runaihelperwriting.md) - [RunWriting - 直接写作](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-creative-articles/api-aimiaobi-2023-08-01-runwriting.md) - - [RunTranslateGeneration - 中英翻译](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-creative-articles/api-aimiaobi-2023-08-01-runtranslategeneration.md) - [RunWritingV2 - 智能写作](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-creative-articles/api-aimiaobi-2023-08-01-runwritingv2.md) - [RunStepByStepWriting - 分步骤写作](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-creative-articles/api-aimiaobi-2023-08-01-runstepbystepwriting.md) + - [RunTranslateGeneration - 中英翻译](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-creative-articles/api-aimiaobi-2023-08-01-runtranslategeneration.md) - [RunTextPolishing - 润色](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-creative-articles/api-aimiaobi-2023-08-01-runtextpolishing.md) - [RunKeywordsExtractionGeneration - 关键词抽取](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-creative-articles/api-aimiaobi-2023-08-01-runkeywordsextractiongeneration.md) - - [RunContinueContent - 内容续写](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-creative-articles/api-aimiaobi-2023-08-01-runcontinuecontent.md) - [RunWriteToneGeneration - 文风改写](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-creative-articles/api-aimiaobi-2023-08-01-runwritetonegeneration.md) + - [RunContinueContent - 内容续写](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-creative-articles/api-aimiaobi-2023-08-01-runcontinuecontent.md) - [RunTitleGeneration - 标题生成](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-creative-articles/api-aimiaobi-2023-08-01-runtitlegeneration.md) - [RunSummaryGenerate - 摘要生成](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-creative-articles/api-aimiaobi-2023-08-01-runsummarygenerate.md) - [RunExpandContent - 内容扩写](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-creative-articles/api-aimiaobi-2023-08-01-runexpandcontent.md) - - [SearchNews - 信息检索](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-creative-articles/api-aimiaobi-2023-08-01-searchnews.md) - [RunAbbreviationContent - 内容缩写](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-creative-articles/api-aimiaobi-2023-08-01-runabbreviationcontent.md) + - [SearchNews - 信息检索](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-creative-articles/api-aimiaobi-2023-08-01-searchnews.md) - [RunQuickWriting - 快速写作](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-creative-articles/api-aimiaobi-2023-08-01-runquickwriting.md) - - [GenerateImageTask - 生成智能配图任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-creative-articles/api-aimiaobi-2023-08-01-generateimagetask.md) - [ListBuildConfigs - 获取系统自定义预设](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-creative-articles/api-aimiaobi-2023-08-01-listbuildconfigs.md) + - [GenerateImageTask - 生成智能配图任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-creative-articles/api-aimiaobi-2023-08-01-generateimagetask.md) - [FeedbackDialogue - 反馈对话](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-creative-articles/api-aimiaobi-2023-08-01-feedbackdialogue.md) - [FetchImageTask - 获取图片任务执行结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-creative-articles/api-aimiaobi-2023-08-01-fetchimagetask.md) - **妙笔-文体仿写** - [ListStyleLearningResult - 获取文体学习分析结果列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-style-imitation-writing/api-aimiaobi-2023-08-01-liststylelearningresult.md) - [RunStyleFeatureAnalysis - 内容特点分析](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-style-imitation-writing/api-aimiaobi-2023-08-01-runstylefeatureanalysis.md) - - [SaveStyleLearningResult - 保存文体学习分析结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-style-imitation-writing/api-aimiaobi-2023-08-01-savestylelearningresult.md) - [DeleteStyleLearningResult - 删除自定义文体](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-style-imitation-writing/api-aimiaobi-2023-08-01-deletestylelearningresult.md) + - [SaveStyleLearningResult - 保存文体学习分析结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-style-imitation-writing/api-aimiaobi-2023-08-01-savestylelearningresult.md) - [GetStyleLearningResult - 获取文体学习分析结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-style-imitation-writing/api-aimiaobi-2023-08-01-getstylelearningresult.md) - [ListWritingStyles - 获取写作文体列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-style-imitation-writing/api-aimiaobi-2023-08-01-listwritingstyles.md) - - **妙笔-视频审校** - - [SubmitVideoAudit - 提交视频审校任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-video-review/api-aimiaobi-2023-08-01-submitvideoaudit.md) - - [QueryVideoAuditResult - 查询视频审校结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-video-review/api-aimiaobi-2023-08-01-queryvideoauditresult.md) - **妙笔-文章审校-规则库管理** - [SubmitAuditNote - 提交自定义规则库](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaobi-article-proofreading-rule-library-management/api-aimiaobi-2023-08-01-submitauditnote.md) - [ConfirmAndPostProcessAuditNote - 确认提交规则库用于审核](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaobi-article-proofreading-rule-library-management/api-aimiaobi-2023-08-01-confirmandpostprocessauditnote.md) - [DownloadAuditNote - 下载规则库](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaobi-article-proofreading-rule-library-management/api-aimiaobi-2023-08-01-downloadauditnote.md) - [DeleteAuditNote - 删除规则库](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaobi-article-proofreading-rule-library-management/api-aimiaobi-2023-08-01-deleteauditnote.md) - [GetAuditNotePostProcessingStatus - 获取规则库后处理进度](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaobi-article-proofreading-rule-library-management/api-aimiaobi-2023-08-01-getauditnotepostprocessingstatus.md) - - [GetAvailableAuditNotes - 查询可用规则库](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaobi-article-proofreading-rule-library-management/api-aimiaobi-2023-08-01-getavailableauditnotes.md) - [GetAuditNoteProcessingStatus - 查询规则库上传状态](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaobi-article-proofreading-rule-library-management/api-aimiaobi-2023-08-01-getauditnoteprocessingstatus.md) + - [GetAvailableAuditNotes - 查询可用规则库](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaobi-article-proofreading-rule-library-management/api-aimiaobi-2023-08-01-getavailableauditnotes.md) + - **妙笔-视频审校** + - [SubmitVideoAudit - 提交视频审校任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-video-review/api-aimiaobi-2023-08-01-submitvideoaudit.md) + - [QueryVideoAuditResult - 查询视频审校结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-video-review/api-aimiaobi-2023-08-01-queryvideoauditresult.md) - **妙笔-文章审校-词库管理** - - [ListAuditTerms - 获取自定义词库记录](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaobi-article-review-thesaurus-management/api-aimiaobi-2023-08-01-listauditterms.md) - [AddAuditTerms - 添加自定义词库记录](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaobi-article-review-thesaurus-management/api-aimiaobi-2023-08-01-addauditterms.md) - - [EditAuditTerms - 编辑自定义词库记录](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaobi-article-review-thesaurus-management/api-aimiaobi-2023-08-01-editauditterms.md) + - [ListAuditTerms - 获取自定义词库记录](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaobi-article-review-thesaurus-management/api-aimiaobi-2023-08-01-listauditterms.md) - [DeleteAuditTerms - 删除指定词库记录](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaobi-article-review-thesaurus-management/api-aimiaobi-2023-08-01-deleteauditterms.md) + - [EditAuditTerms - 编辑自定义词库记录](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaobi-article-review-thesaurus-management/api-aimiaobi-2023-08-01-editauditterms.md) - [SubmitImportTermsTask - 提交导入词库任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaobi-article-review-thesaurus-management/api-aimiaobi-2023-08-01-submitimporttermstask.md) - - [SubmitExportTermsTask - 提交导出词库任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaobi-article-review-thesaurus-management/api-aimiaobi-2023-08-01-submitexporttermstask.md) - [FetchImportTermsTask - 获取导入词库任务结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaobi-article-review-thesaurus-management/api-aimiaobi-2023-08-01-fetchimporttermstask.md) + - [SubmitExportTermsTask - 提交导出词库任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaobi-article-review-thesaurus-management/api-aimiaobi-2023-08-01-submitexporttermstask.md) - [FetchExportTermsTask - 获取导出词库任务结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaobi-article-review-thesaurus-management/api-aimiaobi-2023-08-01-fetchexporttermstask.md) - **妙笔-文章审校-事实性审核** - - [GetFactAuditUrl - 获取事实性审核 URL](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaobi-article-review-factual-review/api-aimiaobi-2023-08-01-getfactauditurl.md) - [SubmitFactAuditUrl - 提交事实性审核 URL](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaobi-article-review-factual-review/api-aimiaobi-2023-08-01-submitfactauditurl.md) + - [GetFactAuditUrl - 获取事实性审核 URL](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaobi-article-review-factual-review/api-aimiaobi-2023-08-01-getfactauditurl.md) - [DeleteFactAuditUrl - 删除事实性审核 URL](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaobi-article-review-factual-review/api-aimiaobi-2023-08-01-deletefactauditurl.md) - **妙笔-文章审校** - [QueryAuditTask - 查询审核结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-article-reviser/api-aimiaobi-2023-08-01-queryaudittask.md) - [SubmitAuditTask - 提交审核任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-article-reviser/api-aimiaobi-2023-08-01-submitaudittask.md) - - [SubmitSmartAudit - 提交智能审校任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-article-reviser/api-aimiaobi-2023-08-01-submitsmartaudit.md) - [CancelAuditTask - 取消审核任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-article-reviser/api-aimiaobi-2023-08-01-cancelaudittask.md) + - [SubmitSmartAudit - 提交智能审校任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-article-reviser/api-aimiaobi-2023-08-01-submitsmartaudit.md) - [GetSmartAuditResult - 查询智能审校结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-article-reviser/api-aimiaobi-2023-08-01-getsmartauditresult.md) - [ListAuditContentErrorTypes - 获取审校维度列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-article-reviser/api-aimiaobi-2023-08-01-listauditcontenterrortypes.md) - [ExportAuditContentResult - 导出智能审校报告](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-article-reviser/api-aimiaobi-2023-08-01-exportauditcontentresult.md) - **妙笔-文档管理** - - [FetchExportWordTask - 获取导出文档任务结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-document-management/api-aimiaobi-2023-08-01-fetchexportwordtask.md) - [GenerateExportWordTask - 生成导出文档任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-document-management/api-aimiaobi-2023-08-01-generateexportwordtask.md) - [CreateGeneratedContent - 保存文档](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-document-management/api-aimiaobi-2023-08-01-creategeneratedcontent.md) + - [FetchExportWordTask - 获取导出文档任务结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-document-management/api-aimiaobi-2023-08-01-fetchexportwordtask.md) - [DeleteGeneratedContent - 删除文档](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-document-management/api-aimiaobi-2023-08-01-deletegeneratedcontent.md) - [UpdateGeneratedContent - 更新文档](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-document-management/api-aimiaobi-2023-08-01-updategeneratedcontent.md) - [GetGeneratedContent - 获取文档](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-document-management/api-aimiaobi-2023-08-01-getgeneratedcontent.md) - - [ListGeneratedContents - 获取文档列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-document-management/api-aimiaobi-2023-08-01-listgeneratedcontents.md) - [ExportGeneratedContent - 导出文档](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-document-management/api-aimiaobi-2023-08-01-exportgeneratedcontent.md) + - [ListGeneratedContents - 获取文档列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-document-management/api-aimiaobi-2023-08-01-listgeneratedcontents.md) - **妙笔-素材库** - [SaveMaterialDocument - 保存素材](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-material-library/api-aimiaobi-2023-08-01-savematerialdocument.md) - [DeleteMaterialById - 删除素材](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-material-library/api-aimiaobi-2023-08-01-deletematerialbyid.md) - [UpdateMaterialDocument - 更新素材](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-material-library/api-aimiaobi-2023-08-01-updatematerialdocument.md) - [GetMaterialById - 获取素材](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-material-library/api-aimiaobi-2023-08-01-getmaterialbyid.md) - [ListMaterialDocuments - 获取素材列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-material-library/api-aimiaobi-2023-08-01-listmaterialdocuments.md) - - **妙笔-素材库-自定义文本** - - [GetCustomText - 获取自定义文本](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-material-library-custom-text/api-aimiaobi-2023-08-01-getcustomtext.md) - - [UpdateCustomText - 更新自定义文本](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-material-library-custom-text/api-aimiaobi-2023-08-01-updatecustomtext.md) - - [ListCustomText - 获取自定义文本列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-material-library-custom-text/api-aimiaobi-2023-08-01-listcustomtext.md) - - [SaveCustomText - 保存自定义文本](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-material-library-custom-text/api-aimiaobi-2023-08-01-savecustomtext.md) - - [DeleteCustomText - 删除自定义文本](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-material-library-custom-text/api-aimiaobi-2023-08-01-deletecustomtext.md) - - [DocumentExtraction - 文档提取](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-material-library-custom-text/api-aimiaobi-2023-08-01-documentextraction.md) - **妙笔-视频混剪** - [GetClipsBuildInResource - 获取智能混剪内置资源](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-video-mixed-cut/api-aimiaobi-2023-08-01-getclipsbuildinresource.md) - - [AsyncCreateClipsTimeLine - 创建剪辑口播时间线](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-video-mixed-cut/api-aimiaobi-2023-08-01-asynccreateclipstimeline.md) - [AsyncEditTimeline - 编辑剪辑口播时间线](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-video-mixed-cut/api-aimiaobi-2023-08-01-asyncedittimeline.md) + - [AsyncCreateClipsTimeLine - 创建剪辑口播时间线](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-video-mixed-cut/api-aimiaobi-2023-08-01-asynccreateclipstimeline.md) - [AsyncUploadVideo - 异步上传视频剪辑素材](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-video-mixed-cut/api-aimiaobi-2023-08-01-asyncuploadvideo.md) - [GetAutoClipsTaskInfo - 获得剪辑任务信息](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-video-mixed-cut/api-aimiaobi-2023-08-01-getautoclipstaskinfo.md) - [AsyncCreateClipsTask - 创建剪辑任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-video-mixed-cut/api-aimiaobi-2023-08-01-asynccreateclipstask.md) - - [ListAutoClipsTask - 智能混剪任务列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-video-mixed-cut/api-aimiaobi-2023-08-01-listautoclipstask.md) - - **公文库检索** - - [ListDocumentRetrieve - 公文库检索](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-public-library-retrieval/api-aimiaobi-2023-08-01-listdocumentretrieve.md) + - [ListAutoClipsTask - 智能混剪任务列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-video-mixed-cut/api-aimiaobi-2023-08-01-listautoclipstask.md) - **妙策-自定义数据源** - [SubmitCustomSourceTopicAnalysis - 提交自定义源话题选题分析任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-tips-custom-data-source/api-aimiaobi-2023-08-01-submitcustomsourcetopicanalysis.md) - [GetCustomSourceTopicAnalysisTask - 获取自定义源话题分析任务结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-tips-custom-data-source/api-aimiaobi-2023-08-01-getcustomsourcetopicanalysistask.md) - [ExportCustomSourceAnalysisTask - 导出自定义源-话题分析任务结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-tips-custom-data-source/api-aimiaobi-2023-08-01-exportcustomsourceanalysistask.md) - - **妙策-自定义话题** - - [DeleteCustomTopicByTopic - 删除自定义热点事件](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-policy-custom-topic/api-aimiaobi-2023-08-01-deletecustomtopicbytopic.md) - - [ListTopicViewPointRecommendEventList - 获取热点事件推荐观点列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-policy-custom-topic/api-aimiaobi-2023-08-01-listtopicviewpointrecommendeventlist.md) - - [ListTopicRecommendEventList - 获取热点推荐事件列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-policy-custom-topic/api-aimiaobi-2023-08-01-listtopicrecommendeventlist.md) - - [RunCustomHotTopicAnalysis - 自定义热点话题分析](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-policy-custom-topic/api-aimiaobi-2023-08-01-runcustomhottopicanalysis.md) - - [RunCustomHotTopicViewPointAnalysis - 自定义选题视角分析](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-policy-custom-topic/api-aimiaobi-2023-08-01-runcustomhottopicviewpointanalysis.md) - - [ListCustomViewPoints - 获取自定义视角列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-policy-custom-topic/api-aimiaobi-2023-08-01-listcustomviewpoints.md) - - [DeleteCustomTopicViewPointById - 删除自定义选题视角](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-policy-custom-topic/api-aimiaobi-2023-08-01-deletecustomtopicviewpointbyid.md) + - **公文库检索** + - [ListDocumentRetrieve - 公文库检索](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-public-library-retrieval/api-aimiaobi-2023-08-01-listdocumentretrieve.md) + - **妙笔-素材库-自定义文本** + - [UpdateCustomText - 更新自定义文本](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-material-library-custom-text/api-aimiaobi-2023-08-01-updatecustomtext.md) + - [GetCustomText - 获取自定义文本](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-material-library-custom-text/api-aimiaobi-2023-08-01-getcustomtext.md) + - [SaveCustomText - 保存自定义文本](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-material-library-custom-text/api-aimiaobi-2023-08-01-savecustomtext.md) + - [ListCustomText - 获取自定义文本列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-material-library-custom-text/api-aimiaobi-2023-08-01-listcustomtext.md) + - [DeleteCustomText - 删除自定义文本](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-material-library-custom-text/api-aimiaobi-2023-08-01-deletecustomtext.md) + - [DocumentExtraction - 文档提取](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-pen-material-library-custom-text/api-aimiaobi-2023-08-01-documentextraction.md) - **妙策-选题热点** - - [ListHotNewsWithType - 获取选题热点列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaozi-hot-topics/api-aimiaobi-2023-08-01-listhotnewswithtype.md) - [RunTopicSelectionMerge - 选题热点融合](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaozi-hot-topics/api-aimiaobi-2023-08-01-runtopicselectionmerge.md) + - [ListHotNewsWithType - 获取选题热点列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaozi-hot-topics/api-aimiaobi-2023-08-01-listhotnewswithtype.md) - [ListHotSources - 获取三方热榜源列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaozi-hot-topics/api-aimiaobi-2023-08-01-listhotsources.md) - - [GetTopicById - 获取热点对象](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaozi-hot-topics/api-aimiaobi-2023-08-01-gettopicbyid.md) - [ListHotTopics - 获取热点话题列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaozi-hot-topics/api-aimiaobi-2023-08-01-listhottopics.md) + - [GetTopicById - 获取热点对象](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaozi-hot-topics/api-aimiaobi-2023-08-01-gettopicbyid.md) - [ListHotViewPoints - 获取热门视角列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaozi-hot-topics/api-aimiaobi-2023-08-01-listhotviewpoints.md) - [ListTimedViewAttitude - 获取时效性视角列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaozi-hot-topics/api-aimiaobi-2023-08-01-listtimedviewattitude.md) - [ListFreshViewPoints - 获取新颖视角列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaozi-hot-topics/api-aimiaobi-2023-08-01-listfreshviewpoints.md) - [ListWebReviewPoints - 获取网友视角列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaozi-hot-topics/api-aimiaobi-2023-08-01-listwebreviewpoints.md) - [ListPlanningProposal - 获取选题策划列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaozi-hot-topics/api-aimiaobi-2023-08-01-listplanningproposal.md) - [ExportHotTopicPlanningProposals - 导出选题策划文档](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaozi-hot-topics/api-aimiaobi-2023-08-01-exporthottopicplanningproposals.md) + - **妙策-自定义话题** + - [DeleteCustomTopicByTopic - 删除自定义热点事件](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-policy-custom-topic/api-aimiaobi-2023-08-01-deletecustomtopicbytopic.md) + - [ListTopicViewPointRecommendEventList - 获取热点事件推荐观点列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-policy-custom-topic/api-aimiaobi-2023-08-01-listtopicviewpointrecommendeventlist.md) + - [ListTopicRecommendEventList - 获取热点推荐事件列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-policy-custom-topic/api-aimiaobi-2023-08-01-listtopicrecommendeventlist.md) + - [RunCustomHotTopicAnalysis - 自定义热点话题分析](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-policy-custom-topic/api-aimiaobi-2023-08-01-runcustomhottopicanalysis.md) + - [RunCustomHotTopicViewPointAnalysis - 自定义选题视角分析](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-policy-custom-topic/api-aimiaobi-2023-08-01-runcustomhottopicviewpointanalysis.md) + - [ListCustomViewPoints - 获取自定义视角列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-policy-custom-topic/api-aimiaobi-2023-08-01-listcustomviewpoints.md) + - [DeleteCustomTopicViewPointById - 删除自定义选题视角](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-policy-custom-topic/api-aimiaobi-2023-08-01-deletecustomtopicviewpointbyid.md) - **妙策-openapi** - [SubmitDocClusterTask - 提交内容聚合任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-tips-openapi/api-aimiaobi-2023-08-01-submitdocclustertask.md) - [GetDocClusterTask - 获取内容聚合任务结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-tips-openapi/api-aimiaobi-2023-08-01-getdocclustertask.md) - [SubmitTopicSelectionPerspectiveAnalysisTask - 提交选题热点分析任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-tips-openapi/api-aimiaobi-2023-08-01-submittopicselectionperspectiveanalysistask.md) - [GetTopicSelectionPerspectiveAnalysisTask - 获取选题视角分析任务结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-tips-openapi/api-aimiaobi-2023-08-01-gettopicselectionperspectiveanalysistask.md) - - [GetCustomTopicSelectionPerspectiveAnalysisTask - 获取自定义选题视角分析任务结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-tips-openapi/api-aimiaobi-2023-08-01-getcustomtopicselectionperspectiveanalysistask.md) - [SubmitCustomTopicSelectionPerspectiveAnalysisTask - 提交自定义热点选题视角分析任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-tips-openapi/api-aimiaobi-2023-08-01-submitcustomtopicselectionperspectiveanalysistask.md) + - [GetCustomTopicSelectionPerspectiveAnalysisTask - 获取自定义选题视角分析任务结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-tips-openapi/api-aimiaobi-2023-08-01-getcustomtopicselectionperspectiveanalysistask.md) + - **妙策-新闻播报** + - [SubmitCustomHotTopicBroadcastJob - 提交自定义播报单任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-policy-news-broadcast/api-aimiaobi-2023-08-01-submitcustomhottopicbroadcastjob.md) + - [GetHotTopicBroadcast - 查询完整播报单（热榜）](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-policy-news-broadcast/api-aimiaobi-2023-08-01-gethottopicbroadcast.md) + - [GetCustomHotTopicBroadcastJob - 获取自定义播报单任务结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-policy-news-broadcast/api-aimiaobi-2023-08-01-getcustomhottopicbroadcastjob.md) - **妙策-企业VOC挖掘** - [ExportAnalysisTagDetailByTaskId - 导出标签挖掘结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaoce-enterprise-voc-mining/api-aimiaobi-2023-08-01-exportanalysistagdetailbytaskid.md) - [ValidateUploadTemplate - 校验VOC上传模板](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaoce-enterprise-voc-mining/api-aimiaobi-2023-08-01-validateuploadtemplate.md) - [SubmitEnterpriseVocAnalysisTask - 提交企业VOC分析任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaoce-enterprise-voc-mining/api-aimiaobi-2023-08-01-submitenterprisevocanalysistask.md) - - [ListAnalysisTagDetailByTaskId - 根据任务ID获取标签分析明细列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaoce-enterprise-voc-mining/api-aimiaobi-2023-08-01-listanalysistagdetailbytaskid.md) - [GetEnterpriseVocAnalysisTask - 获取企业VOC挖掘任务结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaoce-enterprise-voc-mining/api-aimiaobi-2023-08-01-getenterprisevocanalysistask.md) + - [ListAnalysisTagDetailByTaskId - 根据任务ID获取标签分析明细列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaoce-enterprise-voc-mining/api-aimiaobi-2023-08-01-listanalysistagdetailbytaskid.md) - [GetCategoriesByTaskId - 根据任务ID获取分类列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-miaoce-enterprise-voc-mining/api-aimiaobi-2023-08-01-getcategoriesbytaskid.md) - - **妙策-新闻播报** - - [SubmitCustomHotTopicBroadcastJob - 提交自定义播报单任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-policy-news-broadcast/api-aimiaobi-2023-08-01-submitcustomhottopicbroadcastjob.md) - - [GetHotTopicBroadcast - 查询完整播报单（热榜）](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-policy-news-broadcast/api-aimiaobi-2023-08-01-gethottopicbroadcast.md) - - [GetCustomHotTopicBroadcastJob - 获取自定义播报单任务结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-policy-news-broadcast/api-aimiaobi-2023-08-01-getcustomhottopicbroadcastjob.md) - - **妙搜-智能搜索** - - [ListSearchTasks - 查询妙搜搜索生成历史任务列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-search-smart-search/api-aimiaobi-2023-08-01-listsearchtasks.md) - - [ListSearchTaskDialogues - 查询妙搜搜索生成任务详情列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-search-smart-search/api-aimiaobi-2023-08-01-listsearchtaskdialogues.md) - - [ListSearchTaskDialogueDatas - 查询搜索生成任务对话详情中数据列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-search-smart-search/api-aimiaobi-2023-08-01-listsearchtaskdialoguedatas.md) - - [RunSearchGeneration - 妙搜-智能搜索](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-search-smart-search/api-aimiaobi-2023-08-01-runsearchgeneration.md) - - [RunSearchSimilarArticles - 妙搜-文搜文](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-search-smart-search/api-aimiaobi-2023-08-01-runsearchsimilararticles.md) - **妙搜-数据源** - [CreateDataset - 数据源-创建](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-search-data-source/api-aimiaobi-2023-08-01-createdataset.md) - - [GetDataset - 数据源-详情](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-search-data-source/api-aimiaobi-2023-08-01-getdataset.md) - [UpdateDataset - 数据源-修改](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-search-data-source/api-aimiaobi-2023-08-01-updatedataset.md) + - [GetDataset - 数据源-详情](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-search-data-source/api-aimiaobi-2023-08-01-getdataset.md) - [DeleteDataset - 数据源-删除](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-search-data-source/api-aimiaobi-2023-08-01-deletedataset.md) - [ListDatasets - 数据源-列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-search-data-source/api-aimiaobi-2023-08-01-listdatasets.md) - [AddDatasetDocument - 数据源-添加文档到数据集](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-search-data-source/api-aimiaobi-2023-08-01-adddatasetdocument.md) - - [UpdateDatasetDocument - 数据源-修改文档](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-search-data-source/api-aimiaobi-2023-08-01-updatedatasetdocument.md) - [GetDatasetDocument - 数据源-获取文档详情](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-search-data-source/api-aimiaobi-2023-08-01-getdatasetdocument.md) + - [UpdateDatasetDocument - 数据源-修改文档](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-search-data-source/api-aimiaobi-2023-08-01-updatedatasetdocument.md) - [ListDatasetDocuments - 数据源-文档列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-search-data-source/api-aimiaobi-2023-08-01-listdatasetdocuments.md) - [SearchDatasetDocuments - 数据源-搜索文档](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-search-data-source/api-aimiaobi-2023-08-01-searchdatasetdocuments.md) - [DeleteDatasetDocument - 数据源-删除数据集文档](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-search-data-source/api-aimiaobi-2023-08-01-deletedatasetdocument.md) + - **妙搜-智能搜索** + - [ListSearchTasks - 查询妙搜搜索生成历史任务列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-search-smart-search/api-aimiaobi-2023-08-01-listsearchtasks.md) + - [ListSearchTaskDialogues - 查询妙搜搜索生成任务详情列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-search-smart-search/api-aimiaobi-2023-08-01-listsearchtaskdialogues.md) + - [ListSearchTaskDialogueDatas - 查询搜索生成任务对话详情中数据列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-search-smart-search/api-aimiaobi-2023-08-01-listsearchtaskdialoguedatas.md) + - [RunSearchSimilarArticles - 妙搜-文搜文](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-search-smart-search/api-aimiaobi-2023-08-01-runsearchsimilararticles.md) + - [RunSearchGeneration - 妙搜-智能搜索](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-search-smart-search/api-aimiaobi-2023-08-01-runsearchgeneration.md) + - **系统配置-信源管理** + - [SaveDataSourceOrderConfig - 保存信源权重配置](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-system-configuration-source-management/api-aimiaobi-2023-08-01-savedatasourceorderconfig.md) + - [GetDataSourceOrderConfig - 获取信源配置权重数据](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-system-configuration-source-management/api-aimiaobi-2023-08-01-getdatasourceorderconfig.md) - **系统配置-干预配置** - - [ListIntervenes - 列出干预项](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-system-configuration-intervention-configuration/api-aimiaobi-2023-08-01-listintervenes.md) - [ListInterveneCnt - 获得所有干预项的数量](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-system-configuration-intervention-configuration/api-aimiaobi-2023-08-01-listintervenecnt.md) + - [ListIntervenes - 列出干预项](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-system-configuration-intervention-configuration/api-aimiaobi-2023-08-01-listintervenes.md) - [ImportInterveneFile - 同步导入干预项文件](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-system-configuration-intervention-configuration/api-aimiaobi-2023-08-01-importintervenefile.md) - [InsertInterveneGlobalReply - 插入干预全局回复项](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-system-configuration-intervention-configuration/api-aimiaobi-2023-08-01-insertinterveneglobalreply.md) + - [ImportInterveneFileAsync - 异步导入干预项文件](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-system-configuration-intervention-configuration/api-aimiaobi-2023-08-01-importintervenefileasync.md) - [GetInterveneTemplateFileUrl - 获得干预导入模版文件地址](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-system-configuration-intervention-configuration/api-aimiaobi-2023-08-01-getintervenetemplatefileurl.md) - - [GetInterveneGlobalReply - 获得干预全局回复内容](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-system-configuration-intervention-configuration/api-aimiaobi-2023-08-01-getinterveneglobalreply.md) - [ClearIntervenes - 清除所有干预项](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-system-configuration-intervention-configuration/api-aimiaobi-2023-08-01-clearintervenes.md) - - [ImportInterveneFileAsync - 异步导入干预项文件](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-system-configuration-intervention-configuration/api-aimiaobi-2023-08-01-importintervenefileasync.md) + - [GetInterveneGlobalReply - 获得干预全局回复内容](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-system-configuration-intervention-configuration/api-aimiaobi-2023-08-01-getinterveneglobalreply.md) + - [InsertInterveneRule - 插入干预规则](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-system-configuration-intervention-configuration/api-aimiaobi-2023-08-01-insertintervenerule.md) + - [ListInterveneImportTasks - 列出干预项导入任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-system-configuration-intervention-configuration/api-aimiaobi-2023-08-01-listinterveneimporttasks.md) - [ListInterveneRules - 列出干预规则](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-system-configuration-intervention-configuration/api-aimiaobi-2023-08-01-listintervenerules.md) - [GetInterveneRuleDetail - 获得干预规则的详情](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-system-configuration-intervention-configuration/api-aimiaobi-2023-08-01-getinterveneruledetail.md) - - [ListInterveneImportTasks - 列出干预项导入任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-system-configuration-intervention-configuration/api-aimiaobi-2023-08-01-listinterveneimporttasks.md) - - [InsertInterveneRule - 插入干预规则](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-system-configuration-intervention-configuration/api-aimiaobi-2023-08-01-insertintervenerule.md) - [DeleteInterveneRule - 删除干预规则](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-system-configuration-intervention-configuration/api-aimiaobi-2023-08-01-deleteintervenerule.md) - - [ExportIntervenes - 导出干预项内容](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-system-configuration-intervention-configuration/api-aimiaobi-2023-08-01-exportintervenes.md) - [GetInterveneImportTaskInfo - 获得干预项目导入任务信息](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-system-configuration-intervention-configuration/api-aimiaobi-2023-08-01-getinterveneimporttaskinfo.md) - - **系统配置-信源管理** - - [GetDataSourceOrderConfig - 获取信源配置权重数据](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-system-configuration-source-management/api-aimiaobi-2023-08-01-getdatasourceorderconfig.md) - - [SaveDataSourceOrderConfig - 保存信源权重配置](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-system-configuration-source-management/api-aimiaobi-2023-08-01-savedatasourceorderconfig.md) - - **妙读-基础操作类** - - [GetDocInfo - 获取文档信息](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-reading-basic-operation-class/api-aimiaobi-2023-08-01-getdocinfo.md) - - [GetFileContentLength - 获取文件长度](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-reading-basic-operation-class/api-aimiaobi-2023-08-01-getfilecontentlength.md) - - [UploadBook - 书籍上传](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-reading-basic-operation-class/api-aimiaobi-2023-08-01-uploadbook.md) - - [UploadDoc - 文档上传](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-reading-basic-operation-class/api-aimiaobi-2023-08-01-uploaddoc.md) - - [ListDocs - 获取文档列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-reading-basic-operation-class/api-aimiaobi-2023-08-01-listdocs.md) - - [DeleteDocs - 批量删除文档](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-reading-basic-operation-class/api-aimiaobi-2023-08-01-deletedocs.md) + - [ExportIntervenes - 导出干预项内容](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-system-configuration-intervention-configuration/api-aimiaobi-2023-08-01-exportintervenes.md) - **妙读-生成类** - [RunMultiDocIntroduction - 多文档聚合摘要](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-reading-generate-class/api-aimiaobi-2023-08-01-runmultidocintroduction.md) - [RunDocBrainmap - 全文脑图](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-reading-generate-class/api-aimiaobi-2023-08-01-rundocbrainmap.md) - [RunDocIntroduction - 文档导读](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-reading-generate-class/api-aimiaobi-2023-08-01-rundocintroduction.md) - [RunDocSummary - 文档摘要](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-reading-generate-class/api-aimiaobi-2023-08-01-rundocsummary.md) + - [RunBookBrainmap - 书籍脑图](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-reading-generate-class/api-aimiaobi-2023-08-01-runbookbrainmap.md) - [RunDocWashing - 改写](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-reading-generate-class/api-aimiaobi-2023-08-01-rundocwashing.md) - [RunBookIntroduction - 书籍导读（抽取书籍卖点/书籍摘要）](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-reading-generate-class/api-aimiaobi-2023-08-01-runbookintroduction.md) - [RunCommentGeneration - 客户之声预测](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-reading-generate-class/api-aimiaobi-2023-08-01-runcommentgeneration.md) - - [RunBookBrainmap - 书籍脑图](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-reading-generate-class/api-aimiaobi-2023-08-01-runbookbrainmap.md) + - **妙读-基础操作类** + - [GetDocInfo - 获取文档信息](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-reading-basic-operation-class/api-aimiaobi-2023-08-01-getdocinfo.md) + - [GetFileContentLength - 获取文件长度](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-reading-basic-operation-class/api-aimiaobi-2023-08-01-getfilecontentlength.md) + - [UploadBook - 书籍上传](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-reading-basic-operation-class/api-aimiaobi-2023-08-01-uploadbook.md) + - [UploadDoc - 文档上传](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-reading-basic-operation-class/api-aimiaobi-2023-08-01-uploaddoc.md) + - [ListDocs - 获取文档列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-reading-basic-operation-class/api-aimiaobi-2023-08-01-listdocs.md) + - [DeleteDocs - 批量删除文档](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-reading-basic-operation-class/api-aimiaobi-2023-08-01-deletedocs.md) - **妙读-抽取类** - [RunHotword - 抽取关键词](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-reading-extraction-class/api-aimiaobi-2023-08-01-runhotword.md) - **妙读-问答类** @@ -865,74 +867,72 @@ - [RunDocSmartCard - 文档智能卡片](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-reading-other/api-aimiaobi-2023-08-01-rundocsmartcard.md) - [RunBookSmartCard - 书籍智能卡片](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-wonderful-reading-other/api-aimiaobi-2023-08-01-runbooksmartcard.md) - **深度写作** - - [GetDeepWriteTask - 查询深度写作任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-deep-writing/api-aimiaobi-2023-08-01-getdeepwritetask.md) - [SubmitDeepWriteTask - 提交深度写作任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-deep-writing/api-aimiaobi-2023-08-01-submitdeepwritetask.md) + - [GetDeepWriteTask - 查询深度写作任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-deep-writing/api-aimiaobi-2023-08-01-getdeepwritetask.md) - [GetDeepWriteTaskResult - 查询深度写作任务的结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-deep-writing/api-aimiaobi-2023-08-01-getdeepwritetaskresult.md) - [CancelDeepWriteTask - 取消深度写作任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-deep-writing/api-aimiaobi-2023-08-01-canceldeepwritetask.md) - [RunDeepWriting - 查询深度写作事件](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-deep-writing/api-aimiaobi-2023-08-01-rundeepwriting.md) - **PPT生成** - - [InitiatePptCreationV2 - 初始化PPT创建操作](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-ppt-generation/api-aimiaobi-2023-08-01-initiatepptcreationv2.md) - [ListEnterprisePptTemplates - 查询企业专属PPT模板列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-ppt-generation/api-aimiaobi-2023-08-01-listenterpriseppttemplates.md) + - [InitiatePptCreationV2 - 初始化PPT创建操作](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-ppt-generation/api-aimiaobi-2023-08-01-initiatepptcreationv2.md) - [ListPptTemplates - 查询PPT模板列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-ppt-generation/api-aimiaobi-2023-08-01-listppttemplates.md) - [GetPptTemplateSelector - 查询PPT模板筛选器](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-ppt-generation/api-aimiaobi-2023-08-01-getppttemplateselector.md) - - [GetPptArtifactExportResult - 查询PPT导出任务的结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-ppt-generation/api-aimiaobi-2023-08-01-getpptartifactexportresult.md) - [ExportPptArtifact - 导出PPT作品](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-ppt-generation/api-aimiaobi-2023-08-01-exportpptartifact.md) - [GetPptArtifact - 查询PPT作品信息](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-ppt-generation/api-aimiaobi-2023-08-01-getpptartifact.md) - - [RunPptOutlineGeneration - 生成PPT大纲内容](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-ppt-generation/api-aimiaobi-2023-08-01-runpptoutlinegeneration.md) - [ListPptArtifacts - 查询PPT作品列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-ppt-generation/api-aimiaobi-2023-08-01-listpptartifacts.md) + - [RunPptOutlineGeneration - 生成PPT大纲内容](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-ppt-generation/api-aimiaobi-2023-08-01-runpptoutlinegeneration.md) + - [GetPptArtifactExportResult - 查询PPT导出任务的结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-ppt-generation/api-aimiaobi-2023-08-01-getpptartifactexportresult.md) - [InitiatePptCreation - 初始化用来创建PPT的会话](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-ppt-generation/api-aimiaobi-2023-08-01-initiatepptcreation.md) - - [GetPptConfig - 获取PPT组件配置](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-ppt-generation/api-aimiaobi-2023-08-01-getpptconfig.md) - [BindPptArtifact - 绑定PPT作品信息](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-ppt-generation/api-aimiaobi-2023-08-01-bindpptartifact.md) - [DeletePptArtifact - 删除PPT作品](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-ppt-generation/api-aimiaobi-2023-08-01-deletepptartifact.md) + - [GetPptConfig - 获取PPT组件配置](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-ppt-generation/api-aimiaobi-2023-08-01-getpptconfig.md) - **标书生成** - [AsyncUploadTenderDoc - 招标文档解析](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-tender-generation/api-aimiaobi-2023-08-01-asyncuploadtenderdoc.md) + - [EditBiddingDoc - 编辑标书内容](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-tender-generation/api-aimiaobi-2023-08-01-editbiddingdoc.md) - [GetBiddingRemainLimitNum - 获得标书写作剩余额度](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-tender-generation/api-aimiaobi-2023-08-01-getbiddingremainlimitnum.md) - [GetBiddingDocInfo - 获得标书写作结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-tender-generation/api-aimiaobi-2023-08-01-getbiddingdocinfo.md) - - [EditBiddingDoc - 编辑标书内容](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-tender-generation/api-aimiaobi-2023-08-01-editbiddingdoc.md) - - [AsyncWritingBiddingDoc - 标书写作](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-tender-generation/api-aimiaobi-2023-08-01-asyncwritingbiddingdoc.md) - [DownloadBiddingDoc - 下载标书文件](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-tender-generation/api-aimiaobi-2023-08-01-downloadbiddingdoc.md) + - [AsyncWritingBiddingDoc - 标书写作](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-tender-generation/api-aimiaobi-2023-08-01-asyncwritingbiddingdoc.md) - [ListBiddingDoc - 列出标书写作任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-tender-generation/api-aimiaobi-2023-08-01-listbiddingdoc.md) - **其他** - [RunVideoScriptGenerate - AI生成视频剪辑脚本](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-other/api-aimiaobi-2023-08-01-runvideoscriptgenerate.md) - [GetSmartClipTask - 获取智能剪辑任务结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-other/api-aimiaobi-2023-08-01-getsmartcliptask.md) - [SubmitSmartClipTask - 提交智能一键成片任务](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-other/api-aimiaobi-2023-08-01-submitsmartcliptask.md) - - [DeleteDataPermissions - 权限-删除](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-other/api-aimiaobi-2023-08-01-deletedatapermissions.md) - [SaveOrUpdateOssConfig - 配置-云存储-参数配置](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-other/api-aimiaobi-2023-08-01-saveorupdateossconfig.md) + - [DeleteDataPermissions - 权限-删除](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-other/api-aimiaobi-2023-08-01-deletedatapermissions.md) - [CreateDataPermissions - 权限-批量添加](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-other/api-aimiaobi-2023-08-01-createdatapermissions.md) - [ListDataPermissions - 权限-列表](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-other/api-aimiaobi-2023-08-01-listdatapermissions.md) - - [GetPptInfo - 查询PPT任务信息](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-other/api-aimiaobi-2023-08-01-getpptinfo.md) - [GenerateViewPoint - 生成选题视角（已过时，不推荐使用）](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-other/api-aimiaobi-2023-08-01-generateviewpoint.md) - [FetchParseDocumentLayoutTask - 获取排版任务结果](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-other/api-aimiaobi-2023-08-01-fetchparsedocumentlayouttask.md) + - [GetPptInfo - 查询PPT任务信息](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-dir/api-aimiaobi-2023-08-01-dir-other/api-aimiaobi-2023-08-01-getpptinfo.md) - [服务接入点](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-endpoint.md) - [API概览](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-overview.md) - - [版本说明](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-changeset.md) - [授权信息](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-ram.md) + - [版本说明](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-changeset.md) - **最佳实践** - [妙笔API最佳实践](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/miaobi-and-miaoce-best-practices/best-practices-for-miaobi-api.md) - [智能审校最佳实践](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/miaobi-and-miaoce-best-practices/best-practices-for-smart-audit.md) - - [妙策API最佳实践](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/miaobi-and-miaoce-best-practices/best-practices-for-miaoce-api.md) - [妙搜API最佳实践](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/miaobi-and-miaoce-best-practices/best-practices-for-miaosou-api.md) + - [妙策API最佳实践](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/miaobi-and-miaoce-best-practices/best-practices-for-miaoce-api.md) - [妙读最佳实践](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/miaobi-and-miaoce-best-practices/miaodu-best-practices.md) - - [视频混剪最佳实践](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/miaobi-and-miaoce-best-practices/best-practices-for-video-mixing-and-cutting.md) - [PPT生成最佳实践](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/miaobi-and-miaoce-best-practices/ppt-generation-best-practices.md) + - [视频混剪最佳实践](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/miaobi-and-miaoce-best-practices/best-practices-for-video-mixing-and-cutting.md) - **更多** - [全妙服务关联角色](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/quanmiao-more/quanmiao-slr.md) - [妙笔写作信源对接](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/quanmiao-more/miaobi-writing-source-docking.md) - [妙搜数据集管理通过API引入数据源](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/quanmiao-more/miaosou-introduce-data-source-through-api.md) - [全妙iframe嵌入方案](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/quanmiao-more/iframe-embedding-scheme.md) - [全妙Logo定制规范及部署方式](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/quanmiao-more/logo-customization-specification-and-deployment-method.md) - - [全妙PaaS AgentKey 获取指南](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/quanmiao-more/quanmiao-paas-agentkey-get-guide.md) - [全妙云存储（OSS）设置指南](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/quanmiao-more/oss-setup-guide.md) + - [全妙PaaS AgentKey 获取指南](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/quanmiao-more/quanmiao-paas-agentkey-get-guide.md) - [官方应用-通义听悟Agent](raw/application-user-guide/application-gallery/official-application-tingwu-agent.md) - [官方应用-析言GBI](raw/application-user-guide/application-gallery/xiyan-gbi.md) - [通义法睿](raw/application-user-guide/application-gallery/tongyi-farui.md) -- **权限管理** - - [权限管理](raw/application-user-guide/application-permission-management/application-permission-management-overview.md) - **实践教程** - [在网站上增加一个AI助手](raw/application-user-guide/application-use-cases/add-an-ai-assistant-to-your-website-in-10-minutes.md) - - [在企业微信中集成一个 AI 助手](raw/application-user-guide/application-use-cases/add-an-ai-assistant-to-your-work-wechat.md) - - [10分钟让微信公众号成为智能客服](raw/application-user-guide/application-use-cases/add-an-ai-assistant-to-your-wechat-in-10-minutes.md) - [在钉钉上增加一个AI机器人](raw/application-user-guide/application-use-cases/add-an-ai-assistant-to-your-dingtalk.md) + - [10分钟让微信公众号成为智能客服](raw/application-user-guide/application-use-cases/add-an-ai-assistant-to-your-wechat-in-10-minutes.md) + - [在企业微信中集成一个 AI 助手](raw/application-user-guide/application-use-cases/add-an-ai-assistant-to-your-work-wechat.md) - [基于本地知识库构建RAG应用](raw/application-user-guide/application-use-cases/build-rag-application-based-on-local-retrieval.md) - **服务支持** - [常见问题](raw/application-user-guide/application-support/application-faq.md) @@ -941,47 +941,47 @@ ## 模型 API 参考 - **使用 API** - - [安装SDK](raw/model-api-reference/preparations/install-sdk.md) - [获取API Key](raw/model-api-reference/preparations/get-api-key.md) + - [安装SDK](raw/model-api-reference/preparations/install-sdk.md) - [错误码](raw/model-api-reference/preparations/error-code.md) -- **3D模型生成** - - [Tripo-3D模型生成](raw/model-api-reference/3d-generation/tripo-3d-generation-api-reference.md) - **图像生成** - **千问** - [千问-文生图API参考](raw/model-api-reference/image-generation/qwen-image-api-reference/qwen-image-api.md) - - [千问-图像编辑API参考](raw/model-api-reference/image-generation/qwen-image-api-reference/qwen-image-edit-api.md) - [千问-图像翻译API参考](raw/model-api-reference/image-generation/qwen-image-api-reference/qwen-mt-image-api.md) + - [千问-图像编辑API参考](raw/model-api-reference/image-generation/qwen-image-api-reference/qwen-image-edit-api.md) + - **Z-Image** + - [Z-Image API参考](raw/model-api-reference/image-generation/z-image-generation-api-reference/z-image-api-reference.md) - **万相** - - [万相-文生图V1版API参考](raw/model-api-reference/image-generation/wan-image-api-reference/text-to-image-api-reference.md) - [万相-文生图V2版API参考](raw/model-api-reference/image-generation/wan-image-api-reference/text-to-image-v2-api-reference.md) + - [万相-文生图V1版API参考](raw/model-api-reference/image-generation/wan-image-api-reference/text-to-image-api-reference.md) - [万相-图像生成与编辑2.7 API参考](raw/model-api-reference/image-generation/wan-image-api-reference/wan-image-generation-and-editing-api-reference.md) - - [万相-通用图像编辑2.5](raw/model-api-reference/image-generation/wan-image-api-reference/wan2-5-image-edit-api-reference.md) - [万相-图像生成与编辑2.6 API参考](raw/model-api-reference/image-generation/wan-image-api-reference/wan-image-generation-api-reference.md) + - [万相-通用图像编辑2.5](raw/model-api-reference/image-generation/wan-image-api-reference/wan2-5-image-edit-api-reference.md) - [万相-通用图像编辑API参考](raw/model-api-reference/image-generation/wan-image-api-reference/wanx-image-edit-api-reference.md) - [万相-涂鸦作画API参考](raw/model-api-reference/image-generation/wan-image-api-reference/wanx-sketch-to-image-api-reference.md) - [万相-图像局部重绘API参考](raw/model-api-reference/image-generation/wan-image-api-reference/vary-region-api-reference.md) - - **可灵** - - [可灵-图像生成API参考](raw/model-api-reference/image-generation/kling-image-api-reference/kling-image-generation-api-reference.md) - - **Z-Image** - - [Z-Image API参考](raw/model-api-reference/image-generation/z-image-generation-api-reference/z-image-api-reference.md) - **创意工具** - [人像风格重绘API参考](raw/model-api-reference/image-generation/image-creative-tools-api-reference/portrait-style-redraw-api-reference.md) - - [虚拟模特API参考](raw/model-api-reference/image-generation/image-creative-tools-api-reference/virtual-model-api-details.md) - [图像画面扩展API参考](raw/model-api-reference/image-generation/image-creative-tools-api-reference/image-scaling-api.md) - - [创意海报生成API参考](raw/model-api-reference/image-generation/image-creative-tools-api-reference/creative-poster-generation-api.md) + - [虚拟模特API参考](raw/model-api-reference/image-generation/image-creative-tools-api-reference/virtual-model-api-details.md) - [鞋靴模特API参考](raw/model-api-reference/image-generation/image-creative-tools-api-reference/shoe-model-api.md) - [人物实例分割API参考](raw/model-api-reference/image-generation/image-creative-tools-api-reference/image-instance-segmentation-api-reference.md) - - [图像擦除补全API参考](raw/model-api-reference/image-generation/image-creative-tools-api-reference/image-erase-completion-api-reference.md) + - [创意海报生成API参考](raw/model-api-reference/image-generation/image-creative-tools-api-reference/creative-poster-generation-api.md) - [图像背景生成API参考](raw/model-api-reference/image-generation/image-creative-tools-api-reference/wanx-background-generation-api-reference.md) - - [人物写真生成FaceChain](raw/model-api-reference/image-generation/image-creative-tools-api-reference/facechain-portrait-generation.md) + - [图像擦除补全API参考](raw/model-api-reference/image-generation/image-creative-tools-api-reference/image-erase-completion-api-reference.md) - [AI试衣OutfitAnyone](raw/model-api-reference/image-generation/image-creative-tools-api-reference/outfitanyone.md) - [创意文字WordArt锦书](raw/model-api-reference/image-generation/image-creative-tools-api-reference/wordart-quick-start.md) + - [人物写真生成FaceChain](raw/model-api-reference/image-generation/image-creative-tools-api-reference/facechain-portrait-generation.md) + - **可灵** + - [可灵-图像生成API参考](raw/model-api-reference/image-generation/kling-image-api-reference/kling-image-generation-api-reference.md) - [常见问题](raw/model-api-reference/image-generation/image-faq.md) +- **3D模型生成** + - [Tripo-3D模型生成](raw/model-api-reference/3d-generation/tripo-3d-generation-api-reference.md) - **实时多模态** - [客户端事件](raw/model-api-reference/omni-realtime-api/client-events.md) - - [Java SDK](raw/model-api-reference/omni-realtime-api/omni-realtime-java-sdk.md) - - [Python SDK](raw/model-api-reference/omni-realtime-api/omni-realtime-python-sdk.md) - [服务端事件](raw/model-api-reference/omni-realtime-api/server-events.md) + - [Python SDK](raw/model-api-reference/omni-realtime-api/omni-realtime-python-sdk.md) + - [Java SDK](raw/model-api-reference/omni-realtime-api/omni-realtime-java-sdk.md) - [实时多模态交互流程](raw/model-api-reference/omni-realtime-api/omni-realtime-interaction-process.md) - [声音复刻API参考](raw/model-api-reference/omni-realtime-api/qwen-omni-voice-cloning.md) - **更多模型** @@ -993,14 +993,14 @@ - [GUI-Plus API参考](raw/model-api-reference/more-models/gui-plus-interface-interaction-model.md) - **工具包/框架** - [OpenAI Chat接口兼容](raw/model-api-reference/toolkits-and-frameworks/compatibility-of-openai-with-dashscope.md) - - [completions 接口](raw/model-api-reference/toolkits-and-frameworks/completions.md) - [OpenAI Responses接口兼容](raw/model-api-reference/toolkits-and-frameworks/compatibility-with-openai-responses-api.md) - - [OpenAI文件接口兼容](raw/model-api-reference/toolkits-and-frameworks/openai-file-interface.md) + - [completions 接口](raw/model-api-reference/toolkits-and-frameworks/completions.md) - [OpenAI Vision接口兼容](raw/model-api-reference/toolkits-and-frameworks/qwen-vl-compatible-with-openai.md) - - [OpenAI Embedding接口兼容](raw/model-api-reference/toolkits-and-frameworks/embedding-interfaces-compatible-with-openai.md) + - [OpenAI文件接口兼容](raw/model-api-reference/toolkits-and-frameworks/openai-file-interface.md) - [OpenAI兼容-Batch Chat](raw/model-api-reference/toolkits-and-frameworks/openai-compatible-batch-chat.md) - - [OpenAI兼容-Batch（文件输入）](raw/model-api-reference/toolkits-and-frameworks/batch-interfaces-compatible-with-openai.md) + - [OpenAI Embedding接口兼容](raw/model-api-reference/toolkits-and-frameworks/embedding-interfaces-compatible-with-openai.md) - [OpenAI Conversations接口兼容](raw/model-api-reference/toolkits-and-frameworks/openai-compatible-conversations.md) + - [OpenAI兼容-Batch（文件输入）](raw/model-api-reference/toolkits-and-frameworks/batch-interfaces-compatible-with-openai.md) - [在LangChain中使用阿里云百炼](raw/model-api-reference/toolkits-and-frameworks/use-bailian-in-langchain.md) - **模型生产** - [模型调优](raw/model-api-reference/model-production/fine-tuning-jobs-api.md) @@ -1008,11 +1008,16 @@ - **更多** - [生成临时API Key](raw/model-api-reference/more-about-models/generate-temporary-api-key.md) - [异步任务管理 API](raw/model-api-reference/more-about-models/manage-asynchronous-tasks.md) - - [子业务空间的模型调用](raw/model-api-reference/more-about-models/model-calling-in-sub-workspace.md) - [通过HTTP回调URL或MQ接收异步任务完成通知](raw/model-api-reference/more-about-models/async-task-api.md) + - [子业务空间的模型调用](raw/model-api-reference/more-about-models/model-calling-in-sub-workspace.md) - [DashScope SDK连接复用配置](raw/model-api-reference/more-about-models/connection-multiplexing-configuration.md) - [上传本地文件获取临时URL](raw/model-api-reference/more-about-models/get-temporary-file-url.md) - **视频生成** + - **HappyHorse** + - [HappyHorse-文生视频API参考](raw/model-api-reference/video-generation-api/happyhorse-api-reference/happyhorse-text-to-video-api-reference.md) + - [HappyHorse-图生视频-基于首帧API参考](raw/model-api-reference/video-generation-api/happyhorse-api-reference/happyhorse-image-to-video-api-reference.md) + - [HappyHorse-视频编辑API参考](raw/model-api-reference/video-generation-api/happyhorse-api-reference/happyhorse-video-edit-api-reference.md) + - [HappyHorse-参考生视频API参考](raw/model-api-reference/video-generation-api/happyhorse-api-reference/happyhorse-reference-to-video-api-reference.md) - **万相** - **万相-早期视频模型（2.1-2.6）** - [万相-图生视频-基于首帧API参考（2.1-2.6）](raw/model-api-reference/video-generation-api/wan-api-reference/legacy-video-models/legacy-image-to-video-api-reference.md) @@ -1025,32 +1030,35 @@ - [万相2.7-参考生视频API参考](raw/model-api-reference/video-generation-api/wan-api-reference/wan-video-to-video-api-reference.md) - [万相2.7-视频编辑API参考](raw/model-api-reference/video-generation-api/wan-api-reference/wan-video-editing-api-reference.md) - [万相-图生动作API参考](raw/model-api-reference/video-generation-api/wan-api-reference/wan-animate-move-api.md) - - [万相-视频换人API参考](raw/model-api-reference/video-generation-api/wan-api-reference/wan-animate-mix-api.md) - [万相-数字人](raw/model-api-reference/video-generation-api/wan-api-reference/wan-s2v-overview.md) - - **HappyHorse** - - [HappyHorse-图生视频-基于首帧API参考](raw/model-api-reference/video-generation-api/happyhorse-api-reference/happyhorse-image-to-video-api-reference.md) - - [HappyHorse-文生视频API参考](raw/model-api-reference/video-generation-api/happyhorse-api-reference/happyhorse-text-to-video-api-reference.md) - - [HappyHorse-参考生视频API参考](raw/model-api-reference/video-generation-api/happyhorse-api-reference/happyhorse-reference-to-video-api-reference.md) - - [HappyHorse-视频编辑API参考](raw/model-api-reference/video-generation-api/happyhorse-api-reference/happyhorse-video-edit-api-reference.md) + - [万相-视频换人API参考](raw/model-api-reference/video-generation-api/wan-api-reference/wan-animate-mix-api.md) - **人像驱动** - [图生舞蹈视频-舞动人像AnimateAnyone](raw/model-api-reference/video-generation-api/portrait-animation-api-reference/animateanyone-quick-start.md) - [图生唱演视频-悦动人像EMO](raw/model-api-reference/video-generation-api/portrait-animation-api-reference/emo-quick-start.md) - [图生播报视频-灵动人像LivePortrait](raw/model-api-reference/video-generation-api/portrait-animation-api-reference/liveportrait-quick-start.md) - - [图生表情包视频-表情包Emoji](raw/model-api-reference/video-generation-api/portrait-animation-api-reference/emoji-quick-start.md) - [视频口型替换-声动人像VideoRetalk](raw/model-api-reference/video-generation-api/portrait-animation-api-reference/videoretalk.md) - [视频风格重绘API参考](raw/model-api-reference/video-generation-api/portrait-animation-api-reference/video-style-transform-api-reference.md) + - [图生表情包视频-表情包Emoji](raw/model-api-reference/video-generation-api/portrait-animation-api-reference/emoji-quick-start.md) - **爱诗** - - [爱诗-文生视频API参考](raw/model-api-reference/video-generation-api/pixverse-api-reference/pixverse-text-to-video-api-reference.md) - [爱诗-图生视频-基于首帧API参考](raw/model-api-reference/video-generation-api/pixverse-api-reference/pixverse-image-to-video-api-reference.md) + - [爱诗-文生视频API参考](raw/model-api-reference/video-generation-api/pixverse-api-reference/pixverse-text-to-video-api-reference.md) - [爱诗-图生视频-基于首尾帧API参考](raw/model-api-reference/video-generation-api/pixverse-api-reference/pixverse-keyframe-to-video-api-reference.md) - [爱诗-参考生视频API参考](raw/model-api-reference/video-generation-api/pixverse-api-reference/pixverse-reference-to-video-api-reference.md) + - **可灵** + - [可灵-视频生成API文档](raw/model-api-reference/video-generation-api/kling-api-reference/kling-video-generation-api-reference.md) - **Vidu** - [Vidu-图生视频-基于首帧API参考](raw/model-api-reference/video-generation-api/vidu-api-reference/vidu-image-to-video-api-reference.md) - [Vidu-文生视频API参考](raw/model-api-reference/video-generation-api/vidu-api-reference/vidu-text-to-video-api-reference.md) - [Vidu-图生视频-基于首尾帧API参考](raw/model-api-reference/video-generation-api/vidu-api-reference/vidu-keyframe-to-video-api-reference.md) - [Vidu-参考生视频 API 参考](raw/model-api-reference/video-generation-api/vidu-api-reference/vidu-reference-to-video-api-reference.md) - - **可灵** - - [可灵-视频生成API文档](raw/model-api-reference/video-generation-api/kling-api-reference/kling-video-generation-api-reference.md) +- **向量与排序** + - **多模态向量** + - [Multimodal-Embedding API详情](raw/model-api-reference/vector-and-sort/multimodal-vector/multimodal-embedding-api-reference.md) + - **通用文本向量** + - [批处理接口API详情](raw/model-api-reference/vector-and-sort/general-text-vector/text-embedding-batch-api.md) + - [同步接口API详情](raw/model-api-reference/vector-and-sort/general-text-vector/text-embedding-synchronous-api.md) + - **排序模型（Rerank）** + - [文本排序](raw/model-api-reference/vector-and-sort/rerank-model/text-rerank-api.md) - **音频** - **语音识别** - **实时语音识别（Fun-ASR）** @@ -1072,29 +1080,27 @@ - [实时语音识别（Paraformer）客户端事件](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/paraformer-real-time-speech-recognition-api-reference/paraformer-client-events.md) - [实时语音识别（Paraformer）服务端事件](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/paraformer-real-time-speech-recognition-api-reference/paraformer-server-events.md) - [Paraformer实时语音识别Python SDK](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/paraformer-real-time-speech-recognition-api-reference/paraformer-real-time-speech-recognition-python-sdk.md) - - [Paraformer实时语音识别Java SDK](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/paraformer-real-time-speech-recognition-api-reference/paraformer-real-time-speech-recognition-java-sdk.md) - [Paraformer实时语音识别Android SDK](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/paraformer-real-time-speech-recognition-api-reference/android-sdk-for-paraformer-real-time-service.md) + - [Paraformer实时语音识别Java SDK](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/paraformer-real-time-speech-recognition-api-reference/paraformer-real-time-speech-recognition-java-sdk.md) - [Paraformer实时语音识别iOS SDK](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/paraformer-real-time-speech-recognition-api-reference/ios-sdk-for-paraformer-real-time-service.md) - **录音文件识别（Fun-ASR）** - [Fun-ASR录音文件识别HTTP API参考](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-recorded-speech-recognition-api-reference/fun-asr-recorded-speech-recognition-http-api.md) - - [Fun-ASR录音文件识别Java SDK](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-recorded-speech-recognition-api-reference/fun-asr-recorded-speech-recognition-java-sdk.md) - [Fun-ASR录音文件识别Python SDK](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-recorded-speech-recognition-api-reference/funauidio-asr-recorded-speech-recognition-python-sdk.md) + - [Fun-ASR录音文件识别Java SDK](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-recorded-speech-recognition-api-reference/fun-asr-recorded-speech-recognition-java-sdk.md) - [Fun-ASR录音文件识别Android SDK](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-recorded-speech-recognition-api-reference/fun-asr-recorded-speech-recognition-android-sdk.md) - [Fun-ASR录音文件识别iOS SDK](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-recorded-speech-recognition-api-reference/fun-asr-recorded-speech-recognition-ios-sdk.md) - **录音文件识别（Paraformer）** - [Paraformer录音文件识别RESTful API](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/paraformer-recorded-speech-recognition-api-reference/paraformer-recorded-speech-recognition-restful-api.md) - - [Paraformer录音文件识别Java SDK](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/paraformer-recorded-speech-recognition-api-reference/paraformer-recorded-speech-recognition-java-sdk.md) - [Paraformer录音文件识别Python SDK](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/paraformer-recorded-speech-recognition-api-reference/paraformer-recorded-speech-recognition-python-sdk.md) - [Paraformer录音文件识别Android SDK](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/paraformer-recorded-speech-recognition-api-reference/paraformer-recorded-speech-recognition-android-sdk.md) + - [Paraformer录音文件识别Java SDK](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/paraformer-recorded-speech-recognition-api-reference/paraformer-recorded-speech-recognition-java-sdk.md) - [Paraformer录音文件识别iOS SDK](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/paraformer-recorded-speech-recognition-api-reference/paraformer-recorded-speech-recognition-ios-sdk.md) - [最佳实践](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/paraformer-recorded-speech-recognition-api-reference/paraformer-best-practices.md) - **定制热词** - - [定制热词Python SDK参考](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/custom-hot-words/vocabulary-python-sdk.md) - [定制热词HTTP API参考](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/custom-hot-words/vocabulary-http-api.md) + - [定制热词Python SDK参考](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/custom-hot-words/vocabulary-python-sdk.md) - [定制热词Java SDK参考](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/custom-hot-words/vocabulary-java-sdk.md) - [录音文件识别（Qwen-ASR）API参考](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/qwen-asr-api-reference.md) - - **音乐生成** - - [音乐生成Fun-Music API参考](raw/model-api-reference/audio-api-references/music-generation-references/fun-music-api.md) - **语音合成** - **实时语音合成（CosyVoice）** - [CosyVoice WebSocket API参考](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/cosyvoice-large-model-for-speech-synthesis/cosyvoice-websocket-api.md) @@ -1105,14 +1111,14 @@ - [语音合成CosyVoice Android SDK](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/cosyvoice-large-model-for-speech-synthesis/cosyvoice-android-sdk.md) - [语音合成CosyVoice iOS SDK](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/cosyvoice-large-model-for-speech-synthesis/cosyvoice-ios-sdk.md) - **实时语音合成（Qwen-TTS-Realtime）** - - [客户端事件](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/qwen-tts-realtime-api-reference/qwen-tts-realtime-client-events.md) - [Qwen-TTS-Realtime WebSocket API 参考](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/qwen-tts-realtime-api-reference/interactive-process-of-qwen-tts-realtime-synthesis.md) + - [客户端事件](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/qwen-tts-realtime-api-reference/qwen-tts-realtime-client-events.md) - [服务端事件](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/qwen-tts-realtime-api-reference/qwen-tts-realtime-server-events.md) - [Python SDK](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/qwen-tts-realtime-api-reference/qwen-tts-realtime-python-sdk.md) - [Java SDK](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/qwen-tts-realtime-api-reference/qwen-tts-realtime-java-sdk.md) - **实时语音合成（Sambert）** - - [Sambert WebSocket API 参考](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/sambert-speech-synthesis/sambert-websocket-api.md) - [Sambert客户端事件](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/sambert-speech-synthesis/sambert-client-events.md) + - [Sambert WebSocket API 参考](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/sambert-speech-synthesis/sambert-websocket-api.md) - [Sambert服务端事件](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/sambert-speech-synthesis/sambert-server-events.md) - [语音合成Sambert Java SDK](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/sambert-speech-synthesis/sambert-java-sdk.md) - [语音合成Sambert Python SDK](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/sambert-speech-synthesis/sambert-python-sdk.md) @@ -1122,59 +1128,55 @@ - [非实时语音合成CosyVoice HTTP API参考](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/non-realtime-cosyvoice-api/cosyvoice-tts-http-api.md) - [非实时语音合成CosyVoice Java SDK参考](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/non-realtime-cosyvoice-api/cosyvoice-tts-java-sdk.md) - [非实时语音合成CosyVoice Python SDK参考](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/non-realtime-cosyvoice-api/cosyvoice-tts-python-sdk.md) - - **非实时语音合成（MiniMax）** - - [MiniMax同步语音合成API参考](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/minimax-speech-synthesis/minimax-synchronous-speech-synthesis-api.md) - **声音复刻** - [声音复刻Java SDK参考](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/sound-reengraving/voice-clone-design-java-sdk.md) - [声音复刻HTTP API参考](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/sound-reengraving/voice-clone-design-http-api.md) - [声音复刻Python SDK参考](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/sound-reengraving/voice-clone-design-python-sdk.md) + - **非实时语音合成（MiniMax）** + - [MiniMax同步语音合成API参考](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/minimax-speech-synthesis/minimax-synchronous-speech-synthesis-api.md) - [非实时语音合成（Qwen-TTS）API参考](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/qwen-tts-api.md) - [声音设计API参考](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/voice-design-api-references.md) + - **音乐生成** + - [音乐生成Fun-Music API参考](raw/model-api-reference/audio-api-references/music-generation-references/fun-music-api.md) - **语音翻译** - **实时音视频翻译（Qwen-Livetranslate-Realtime）** - [客户端事件](raw/model-api-reference/audio-api-references/speech-translation-api-reference/live-translator-api/live-translator-client-events.md) - - [实时音视频翻译（Qwen-LiveTranslate）Java SDK-API参考](raw/model-api-reference/audio-api-references/speech-translation-api-reference/live-translator-api/qwen-livetranslate-java-sdk.md) - [实时音视频翻译（Qwen-LiveTranslate）Python SDK-API参考](raw/model-api-reference/audio-api-references/speech-translation-api-reference/live-translator-api/qwen-livetranslate-python-sdk.md) - [服务端事件](raw/model-api-reference/audio-api-references/speech-translation-api-reference/live-translator-api/live-translator-server-events.md) + - [实时音视频翻译（Qwen-LiveTranslate）Java SDK-API参考](raw/model-api-reference/audio-api-references/speech-translation-api-reference/live-translator-api/qwen-livetranslate-java-sdk.md) - [音视频翻译-通义千问 API 参考](raw/model-api-reference/audio-api-references/speech-translation-api-reference/qwen3-livetranslate-flash-api.md) -- **向量与排序** - - **通用文本向量** - - [同步接口API详情](raw/model-api-reference/vector-and-sort/general-text-vector/text-embedding-synchronous-api.md) - - [批处理接口API详情](raw/model-api-reference/vector-and-sort/general-text-vector/text-embedding-batch-api.md) - - **排序模型（Rerank）** - - [文本排序](raw/model-api-reference/vector-and-sort/rerank-model/text-rerank-api.md) - - **多模态向量** - - [Multimodal-Embedding API详情](raw/model-api-reference/vector-and-sort/multimodal-vector/multimodal-embedding-api-reference.md) - [文本生成模型API参考](raw/model-api-reference/qwen-api-reference.md) - [文件管理](raw/model-api-reference/file-management-api.md) ## 应用 API 参考 - **Managed Agents** + - [Agent](raw/application-api-reference/managed-agents-api/agent-api.md) - [快速开始](raw/application-api-reference/managed-agents-api/managed-agents-quickstart.md) - [API 总览与认证](raw/application-api-reference/managed-agents-api/managed-agents-api-overview.md) - - [Agent](raw/application-api-reference/managed-agents-api/agent-api.md) - [Environment](raw/application-api-reference/managed-agents-api/environment-api.md) - [Session and Event](raw/application-api-reference/managed-agents-api/session-api.md) - [File](raw/application-api-reference/managed-agents-api/files-api.md) - [Skill](raw/application-api-reference/managed-agents-api/skills-api.md) +- **长期记忆** + - [长期记忆（新）API 参考](raw/application-api-reference/long-term-memory-new/long-term-memory-api-reference.md) - **应用组件** - **API目录** - **数据连接（原应用数据）** - [AddCategory - 新增类目](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-addcategory.md) + - [DeleteCategory - 删除类目](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-deletecategory.md) - [ListCategory - 类目列表](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-listcategory.md) - [ApplyFileUploadLease - 申请文件上传租约](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-applyfileuploadlease.md) - - [DeleteCategory - 删除类目](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-deletecategory.md) - - [AddFilesFromAuthorizedOss - 从已授权OSS Bucket中导入文件](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-addfilesfromauthorizedoss.md) - [AddFile - 添加文件](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-addfile.md) - - [ListFile - 文件列表](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-listfile.md) - [DescribeFile - 查询文件状态](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-describefile.md) + - [AddFilesFromAuthorizedOss - 从已授权OSS Bucket中导入文件](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-addfilesfromauthorizedoss.md) + - [ListFile - 文件列表](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-listfile.md) - [UpdateFileTag - 更新文件标签](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-updatefiletag.md) - - [DeleteFile - 删除文件](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-deletefile.md) - [BatchUpdateFileTag - 批量更新文档标签](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-batchupdatefiletag.md) - - [DeleteFiles - 批量删除文件](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-deletefiles.md) - [GetParseSettings - 获取类目解析设置](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-getparsesettings.md) - [GetAvailableParserTypes - 获取文件支持的解析器类型](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-getavailableparsertypes.md) + - [DeleteFiles - 批量删除文件](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-deletefiles.md) + - [DeleteFile - 删除文件](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-deletefile.md) - [ChangeParseSetting - 修改类目解析设置](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-changeparsesetting.md) - [AddTable - 添加表格](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-addtable.md) - [UpdateTableFromAuthorizedOss - 从已授权OSS Bucket中选择文件更新表格](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-updatetablefromauthorizedoss.md) @@ -1182,14 +1184,14 @@ - [GetConnector - 获取连接器信息](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-getconnector.md) - [UpdateConnector - 编辑连接器](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-updateconnector.md) - **知识库** - - [CreateIndex - 创建知识库](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-knowledge-base/api-bailian-2023-12-29-createindex.md) - [GetIndexJobStatus - 查询知识库创建任务状态](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-knowledge-base/api-bailian-2023-12-29-getindexjobstatus.md) - - [SubmitIndexJob - 提交知识库创建任务](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-knowledge-base/api-bailian-2023-12-29-submitindexjob.md) - [SubmitIndexAddDocumentsJob - 提交知识库追加任务](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-knowledge-base/api-bailian-2023-12-29-submitindexadddocumentsjob.md) - - [ListIndexDocuments - 查询知识库下的文件列表](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-knowledge-base/api-bailian-2023-12-29-listindexdocuments.md) + - [CreateIndex - 创建知识库](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-knowledge-base/api-bailian-2023-12-29-createindex.md) + - [SubmitIndexJob - 提交知识库创建任务](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-knowledge-base/api-bailian-2023-12-29-submitindexjob.md) - [Retrieve - 检索知识库](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-knowledge-base/api-bailian-2023-12-29-retrieve.md) - - [ListIndexFileDetails - 查询知识库下的文件详情](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-knowledge-base/api-bailian-2023-12-29-listindexfiledetails.md) + - [ListIndexDocuments - 查询知识库下的文件列表](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-knowledge-base/api-bailian-2023-12-29-listindexdocuments.md) - [UpdateIndex - 更新知识库](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-knowledge-base/api-bailian-2023-12-29-updateindex.md) + - [ListIndexFileDetails - 查询知识库下的文件详情](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-knowledge-base/api-bailian-2023-12-29-listindexfiledetails.md) - [DeleteIndexDocument - 删除知识库下的文件](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-knowledge-base/api-bailian-2023-12-29-deleteindexdocument.md) - [ListIndices - 查询知识库列表](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-knowledge-base/api-bailian-2023-12-29-listindices.md) - [DeleteIndex - 删除知识库](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-knowledge-base/api-bailian-2023-12-29-deleteindex.md) @@ -1199,17 +1201,17 @@ - [GetIndexMonitor - 获取知识库监控数据](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-knowledge-base/api-bailian-2023-12-29-getindexmonitor.md) - **Prompt工程** - [CreatePromptTemplate - 创建Prompt模板](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-prompt-engineering/api-bailian-2023-12-29-createprompttemplate.md) - - [GetPromptTemplate - 获取Prompt模板](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-prompt-engineering/api-bailian-2023-12-29-getprompttemplate.md) - [UpdatePromptTemplate - 更新Prompt模板](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-prompt-engineering/api-bailian-2023-12-29-updateprompttemplate.md) - [DeletePromptTemplate - 删除Prompt模板](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-prompt-engineering/api-bailian-2023-12-29-deleteprompttemplate.md) + - [GetPromptTemplate - 获取Prompt模板](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-prompt-engineering/api-bailian-2023-12-29-getprompttemplate.md) - [ListPromptTemplates - 获取Prompt模板列表](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-prompt-engineering/api-bailian-2023-12-29-listprompttemplates.md) - **其他** - **长期记忆（旧）** - - [GetMemory - 获取长期记忆体](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-others/api-bailian-2023-12-29-dir-long-term-memory/api-bailian-2023-12-29-getmemory.md) - [CreateMemory - 创建长期记忆体](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-others/api-bailian-2023-12-29-dir-long-term-memory/api-bailian-2023-12-29-creatememory.md) + - [GetMemory - 获取长期记忆体](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-others/api-bailian-2023-12-29-dir-long-term-memory/api-bailian-2023-12-29-getmemory.md) - [UpdateMemory - 更新长期记忆体](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-others/api-bailian-2023-12-29-dir-long-term-memory/api-bailian-2023-12-29-updatememory.md) - - [DeleteMemory - 删除长期记忆体](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-others/api-bailian-2023-12-29-dir-long-term-memory/api-bailian-2023-12-29-deletememory.md) - [ListMemories - 获取长期记忆体列表](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-others/api-bailian-2023-12-29-dir-long-term-memory/api-bailian-2023-12-29-listmemories.md) + - [DeleteMemory - 删除长期记忆体](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-others/api-bailian-2023-12-29-dir-long-term-memory/api-bailian-2023-12-29-deletememory.md) - [CreateMemoryNode - 创建记忆片段](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-others/api-bailian-2023-12-29-dir-long-term-memory/api-bailian-2023-12-29-creatememorynode.md) - [GetMemoryNode - 获取记忆片段](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-others/api-bailian-2023-12-29-dir-long-term-memory/api-bailian-2023-12-29-getmemorynode.md) - [UpdateMemoryNode - 更新记忆片段](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-others/api-bailian-2023-12-29-dir-long-term-memory/api-bailian-2023-12-29-updatememorynode.md) @@ -1220,10 +1222,8 @@ - [ApplyTempStorageLease - 申请临时文件上传许可](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-others/api-bailian-2023-12-29-applytempstoragelease.md) - [API概览](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-overview.md) - [服务接入点](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-endpoint.md) - - [版本说明](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-changeset.md) - [授权信息](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-ram.md) -- **长期记忆** - - [长期记忆（新）API 参考](raw/application-api-reference/long-term-memory-new/long-term-memory-api-reference.md) + - [版本说明](raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-changeset.md) - **应用调用** - **DashScope API** - [新版智能体应用 API 参考](raw/application-api-reference/application-call/application-dashscope-api-reference/new-agent-application-api-reference.md) diff --git a/skills/bailian-docs-llm-wiki/models/index.json b/skills/bailian-docs-llm-wiki/models/index.json index ec76bf1..ad6f0a2 100644 --- a/skills/bailian-docs-llm-wiki/models/index.json +++ b/skills/bailian-docs-llm-wiki/models/index.json @@ -1,5 +1,5 @@ { - "updatedAt": "2026-07-07", + "updatedAt": "2026-07-08", "totalFamilies": 164, "totalModels": 370, "capabilityDistribution": { diff --git a/skills/bailian-docs-llm-wiki/models/index.md b/skills/bailian-docs-llm-wiki/models/index.md index 18deb28..82bc1ac 100644 --- a/skills/bailian-docs-llm-wiki/models/index.md +++ b/skills/bailian-docs-llm-wiki/models/index.md @@ -1,6 +1,6 @@ # 百炼模型市场索引 -> 自动生成 · 共 164 个模型家族 · 370 个主干模型 · 更新于 2026-07-07 +> 自动生成 · 共 164 个模型家族 · 370 个主干模型 · 更新于 2026-07-08 **机器查询走结构化文件**： diff --git a/skills/bailian-docs-llm-wiki/raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-changeparsesetting.md b/skills/bailian-docs-llm-wiki/raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-changeparsesetting.md index b7e53a3..2d53812 100644 --- a/skills/bailian-docs-llm-wiki/raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-changeparsesetting.md +++ b/skills/bailian-docs-llm-wiki/raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-changeparsesetting.md @@ -165,6 +165,8 @@ string - DASH\_QWEN\_VL\_PARSER （Qwen VL 解析） +- DOCMIND\_LLM\_VERSION\_MEDIA（音视频解析） + **枚举值：** diff --git a/skills/bailian-docs-llm-wiki/raw/application-user-guide/application-gallery/multimodal-products/multimodal-sdk/mmi-rtos-sdk.md b/skills/bailian-docs-llm-wiki/raw/application-user-guide/application-gallery/multimodal-products/multimodal-sdk/mmi-rtos-sdk.md index e4b0ff1..c4f0ba5 100644 --- a/skills/bailian-docs-llm-wiki/raw/application-user-guide/application-gallery/multimodal-products/multimodal-sdk/mmi-rtos-sdk.md +++ b/skills/bailian-docs-llm-wiki/raw/application-user-guide/application-gallery/multimodal-products/multimodal-sdk/mmi-rtos-sdk.md @@ -108,7 +108,7 @@ WS53 [SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/fwonme/qwen_sdk_core_ws53_v1.3.0_22bcf3f_830784.tar.gz) -6 +8 杰理 @@ -124,7 +124,7 @@ JL7014 [SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/nxmvis/qwen_sdk_core_jl7014_v1.3.0_22bcf3f_830784.tar.gz) -7 +9 君正 @@ -140,7 +140,7 @@ T41 [SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/qiwwdq/qwen_sdk_core_t41_v1.3.0_22bcf3f_830784.tar.gz) -8 +10 乐鑫 @@ -152,7 +152,7 @@ ESP32S3 [SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/wjeblr/qwen_sdk_core_esp32s3_v1.3.0_22bcf3f_833235.tar.gz) -9 +11 全志 @@ -176,7 +176,7 @@ XR872 [SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/rovsjq/qwen_sdk_core_xr872_v1.3.0_22bcf3f_830785.tar.gz) -10 +12 瑞芯微 @@ -192,7 +192,7 @@ RV1103 [SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/nljzny/qwen_sdk_core_rv1103_v1.3.0_22bcf3f_830785.tar.gz) -11 +13 瑞昱 @@ -204,7 +204,7 @@ RTL8721 [SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/xwyrct/qwen_sdk_core_rtl8721_v1.3.0_22bcf3f_830785.tar.gz) -12 +14 小米 @@ -216,7 +216,7 @@ VELA\_V8A [SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/khbmch/qwen_sdk_core_vela_v8a_v1.3.0_22bcf3f_830785.tar.gz) -13 +15 芯迈微 @@ -224,7 +224,7 @@ XMW718 [SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/psfwlw/qwen_sdk_core_xmw718_v1.3.0_22bcf3f_830785.tar.gz) -14 +16 星宸科技 @@ -236,7 +236,7 @@ SSC309QL [SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/zfuiix/qwen_sdk_core_ssc309ql_v1.3.0_22bcf3f_830785.tar.gz) -15 +17 星翼科技 @@ -244,7 +244,7 @@ XY4100LC [SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/nsxavi/qwen_sdk_core_xy4100lc_v1.3.0_22bcf3f_830778.tar.gz) -16 +18 移芯 @@ -252,7 +252,7 @@ EC718PM [SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/pqjitg/qwen_sdk_core_ec718pm_v1.3.0_22bcf3f_830782.tar.gz) -17 +19 中国移动 @@ -264,7 +264,7 @@ ML307N [SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/afqoaw/qwen_sdk_core_ml307n_v1.3.0_22bcf3f_830780.tar.gz) -18 +20 紫光展锐 diff --git a/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/qwen-tts-api.md b/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/qwen-tts-api.md index bc31f94..18e9d45 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/qwen-tts-api.md +++ b/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/qwen-tts-api.md @@ -17,8 +17,8 @@ import os import dashscope -# 以下为华北2（北京）地域的配置，调用时请将"{WorkspaceId}"替换为真实的业务空间ID，各地域的配置不同。 -dashscope.base_http_api_url = 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1' +# 以下为华北2（北京）地域的配置。 +dashscope.base_http_api_url = 'https://dashscope.aliyuncs.com/api/v1' text = "那我来给大家推荐一款T恤，这款呢真的是超级好看，这个颜色呢很显气质，而且呢也是搭配的绝佳单品，大家可以闭眼入，真的是非常好看，对身材的包容性也很好，不管啥身材的宝宝呢，穿上去都是很好看的。推荐宝宝们下单哦。" # SpeechSynthesizer接口使用方法：dashscope.audio.qwen_tts.SpeechSynthesizer.call(...) @@ -72,8 +72,8 @@ public class Main { System.out.println(JsonUtils.toJson(result)); } public static void main(String[] args) { - // 以下为华北2（北京）地域的配置，调用时请将"{WorkspaceId}"替换为真实的业务空间ID，各地域的配置不同。 - Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1"; + // 以下为华北2（北京）地域的配置。 + Constants.baseHttpApiUrl = "https://dashscope.aliyuncs.com/api/v1"; try { call(); } catch (ApiException | NoApiKeyException | UploadFileException e) { @@ -88,12 +88,12 @@ public class Main { ``` # ======= 重要提示 ======= -# 以下为华北2（北京）地域的配置，调用时请将"{WorkspaceId}"替换为真实的业务空间ID，各地域的配置不同。 +# 以下为华北2（北京）地域的配置。 # 新加坡地域和北京地域的API Key不同。获取API Key：https://help.aliyun.com/zh/model-studio/get-api-key # 若没有配置环境变量，请用阿里云百炼API Key将$DASHSCOPE_API_KEY替换为：sk-xxx。 # === 执行时请删除该注释 === -curl -X POST 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \ +curl -X POST 'https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \ -H "Authorization: Bearer $DASHSCOPE_API_KEY" \ -H 'Content-Type: application/json' \ -d '{ @@ -117,8 +117,8 @@ curl -X POST 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services import os import dashscope - # 以下为华北2（北京）地域的配置，调用时请将"{WorkspaceId}"替换为真实的业务空间ID，各地域的配置不同。 - dashscope.base_http_api_url = 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1' + # 以下为华北2（北京）地域的配置。 + dashscope.base_http_api_url = 'https://dashscope.aliyuncs.com/api/v1' text = "那我来给大家推荐一款T恤，这款呢真的是超级好看，这个颜色呢很显气质，而且呢也是搭配的绝佳单品，大家可以闭眼入，真的是非常好看，对身材的包容性也很好，不管啥身材的宝宝呢，穿上去都是很好看的。推荐宝宝们下单哦。" # SpeechSynthesizer接口使用方法：dashscope.audio.qwen_tts.SpeechSynthesizer.call(...) @@ -176,8 +176,8 @@ public class Main { }); } public static void main(String[] args) { - // 以下为华北2（北京）地域的配置，调用时请将"{WorkspaceId}"替换为真实的业务空间ID，各地域的配置不同。 - Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1"; + // 以下为华北2（北京）地域的配置。 + Constants.baseHttpApiUrl = "https://dashscope.aliyuncs.com/api/v1"; try { streamCall(); } catch (ApiException | NoApiKeyException | UploadFileException e) { @@ -192,12 +192,12 @@ public class Main { ``` # ======= 重要提示 ======= -# 以下为华北2（北京）地域的配置，调用时请将"{WorkspaceId}"替换为真实的业务空间ID，各地域的配置不同。 +# 以下为华北2（北京）地域的配置。 # 新加坡地域和北京地域的API Key不同。获取API Key：https://help.aliyun.com/zh/model-studio/get-api-key # 若没有配置环境变量，请用阿里云百炼API Key将$DASHSCOPE_API_KEY替换为：sk-xxx。 # === 执行时请删除该注释 === -curl -X POST 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \ +curl -X POST 'https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \ -H "Authorization: Bearer $DASHSCOPE_API_KEY" \ -H 'Content-Type: application/json' \ -H 'X-DashScope-SSE: enable' \ @@ -405,6 +405,78 @@ HTTP状态码。遵循 [RFC 9110](https://www.rfc-editor.org/rfc/rfc9110.html#n + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -471,9 +543,13 @@ HTTP状态码。遵循 [RFC 9110](https://www.rfc-editor.org/rfc/rfc9110.html#n 完整音频文件的 URL，有效期 24 小时。 +**说明** + +流式输出说明：流式模式下，API 返回多个 chunk。中间 chunk 的 audio.data 包含 Base64 编码的音频片段，audio.url 为空；最后一个 chunk 的 audio.data 为空字符串，audio.url 包含完整音频文件的 **OSS** 地址。开发者可在最后一个 chunk 中通过 url 字段下载完整音频。非流式模式下，该字段直接返回完整音频文件 URL。 + **data** `_string_` -流式输出时的Base64 音频数据。 +Base64 编码的音频数据。非流式输出和流式输出的中间 chunk 中返回 Base64 编码的音频片段；流式输出的最后一个 chunk 中该字段为空字符串，音频通过同级的 url 字段获取。 **id** `_string_` diff --git a/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/qwen-tts-realtime-api-reference/interactive-process-of-qwen-tts-realtime-synthesis.md b/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/qwen-tts-realtime-api-reference/interactive-process-of-qwen-tts-realtime-synthesis.md index ac25865..9ff74a4 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/qwen-tts-realtime-api-reference/interactive-process-of-qwen-tts-realtime-synthesis.md +++ b/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/qwen-tts-realtime-api-reference/interactive-process-of-qwen-tts-realtime-synthesis.md @@ -12,31 +12,16 @@ WebSocket URL 固定如下，通过查询参数 `model` 指定要调用的模型 ## 华北2（北京） -WebSocket URL：`wss://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api-ws/v1/realtime?model=qwen3-tts-flash-realtime` - -调用时请将`{WorkspaceId}`替换为真实的[Workspace ID](https://help.aliyun.com/zh/model-studio/obtain-the-app-id-and-workspace-id#d3eb3cd37b7fu)。 +WebSocket URL：`wss://dashscope.aliyuncs.com/api-ws/v1/realtime?model=qwen3-tts-flash-realtime` ## 新加坡 -WebSocket URL：`wss://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/realtime?model=qwen3-tts-flash-realtime` - -调用时请将`{WorkspaceId}`替换为真实的[Workspace ID](https://help.aliyun.com/zh/model-studio/obtain-the-app-id-and-workspace-id#d3eb3cd37b7fu)。 +WebSocket URL：`wss://dashscope-intl.aliyuncs.com/api-ws/v1/realtime?model=qwen3-tts-flash-realtime` **重要** URL 必须使用 `wss://` 协议。Authorization 在请求头中设置（参见[请求头](#qwen-ws-header-h2)），模型通过 URL 查询参数 `model` 指定。 -**重要** - -阿里云百炼为华北2（北京）、新加坡地域推出了业务空间专属域名，能够为推理请求提供卓越的性能和更高的稳定性，建议迁移至新域名： - -- 华北2（北京）地域：从 `dashscope.aliyuncs.com` 迁移至 `{WorkspaceId}.cn-beijing.maas.aliyuncs.com` - -- 新加坡地域：从 `dashscope-intl.aliyuncs.com` 迁移至 `{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com` - - -`{WorkspaceId}`需要替换为真实的[Workspace ID](https://help.aliyun.com/zh/model-studio/obtain-the-app-id-and-workspace-id#d3eb3cd37b7fu)。现有域名仍可正常使用。 - ## **请求头** 请求头中需添加如下信息： diff --git a/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/qwen-tts-realtime-api-reference/qwen-tts-realtime-java-sdk.md b/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/qwen-tts-realtime-api-reference/qwen-tts-realtime-java-sdk.md index c9b4436..0e3f150 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/qwen-tts-realtime-api-reference/qwen-tts-realtime-java-sdk.md +++ b/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/qwen-tts-realtime-api-reference/qwen-tts-realtime-java-sdk.md @@ -162,8 +162,8 @@ public class Main { QwenTtsRealtimeParam param = QwenTtsRealtimeParam.builder() // 如需使用指令控制功能，请将model替换为qwen3-tts-instruct-flash-realtime .model("qwen3-tts-flash-realtime") - // 以下为华北2（北京）地域的配置，调用时请将"{WorkspaceId}"替换为真实的业务空间ID，各地域的配置不同。 - .url("wss://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api-ws/v1/realtime") + // 以下为华北2（北京）地域的配置。 + .url("wss://dashscope.aliyuncs.com/api-ws/v1/realtime") // 新加坡和北京地域的API Key不同。获取API Key：https://help.aliyun.com/zh/model-studio/get-api-key .apikey(System.getenv("DASHSCOPE_API_KEY")) .build(); @@ -392,8 +392,8 @@ public class Main { QwenTtsRealtimeParam param = QwenTtsRealtimeParam.builder() // 如需使用指令控制功能，请将model替换为qwen3-tts-instruct-flash-realtime .model("qwen3-tts-flash-realtime") - // 以下为华北2（北京）地域的配置，调用时请将"{WorkspaceId}"替换为真实的业务空间ID，各地域的配置不同。 - .url("wss://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api-ws/v1/realtime") + // 以下为华北2（北京）地域的配置。 + .url("wss://dashscope.aliyuncs.com/api-ws/v1/realtime") // 新加坡和北京地域的API Key不同。获取API Key：https://help.aliyun.com/zh/model-studio/get-api-key .apikey(System.getenv("DASHSCOPE_API_KEY")) .build(); @@ -515,17 +515,6 @@ public class Main { } ``` -**重要** - -阿里云百炼为华北2（北京）、新加坡地域推出了业务空间专属域名，能够为推理请求提供卓越的性能和更高的稳定性，建议迁移至新域名： - -- 华北2（北京）地域：从 `dashscope.aliyuncs.com` 迁移至 `{WorkspaceId}.cn-beijing.maas.aliyuncs.com` - -- 新加坡地域：从 `dashscope-intl.aliyuncs.com` 迁移至 `{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com` - - -`{WorkspaceId}`需要替换为真实的[Workspace ID](https://help.aliyun.com/zh/model-studio/obtain-the-app-id-and-workspace-id#d3eb3cd37b7fu)。现有域名仍可正常使用。 - 访问[github](https://github.com/aliyun/alibabacloud-bailian-speech-demo/tree/master/samples/conversation/omni)下载更多示例代码。 ## **请求参数** @@ -554,11 +543,9 @@ String 是 -华北2（北京）地域：`wss://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api-ws/v1/realtime` - -新加坡地域：`wss://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/realtime` +华北2（北京）地域：`wss://dashscope.aliyuncs.com/api-ws/v1/realtime` -调用时请将`{WorkspaceId}`替换为真实的[Workspace ID](https://help.aliyun.com/zh/model-studio/obtain-the-app-id-and-workspace-id#d3eb3cd37b7fu)。 +新加坡地域：`wss://dashscope-intl.aliyuncs.com/api-ws/v1/realtime` 下述请求参数可以通过`QwenTtsRealtimeConfig`对象的链式方法或setter配置、之后作为参数传入updateSession接口完成配置。 diff --git a/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/qwen-tts-realtime-api-reference/qwen-tts-realtime-python-sdk.md b/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/qwen-tts-realtime-api-reference/qwen-tts-realtime-python-sdk.md index b9cad00..21a3172 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/qwen-tts-realtime-api-reference/qwen-tts-realtime-python-sdk.md +++ b/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/qwen-tts-realtime-api-reference/qwen-tts-realtime-python-sdk.md @@ -89,8 +89,8 @@ if __name__ == '__main__': # 如需使用指令控制功能，请将model替换为qwen3-tts-instruct-flash-realtime model='qwen3-tts-flash-realtime', callback=callback, - # 以下为华北2（北京）地域的配置，调用时请将"{WorkspaceId}"替换为真实的业务空间ID，各地域的配置不同。 - url='wss://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api-ws/v1/realtime' + # 以下为华北2（北京）地域的配置。 + url='wss://dashscope.aliyuncs.com/api-ws/v1/realtime' ) qwen_tts_realtime.connect() @@ -197,8 +197,8 @@ if __name__ == '__main__': # 如需使用指令控制功能，请将model替换为qwen3-tts-instruct-flash-realtime model='qwen3-tts-flash-realtime', callback=callback, - # 以下为华北2（北京）地域的配置，调用时请将"{WorkspaceId}"替换为真实的业务空间ID，各地域的配置不同。 - url='wss://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api-ws/v1/realtime' + # 以下为华北2（北京）地域的配置。 + url='wss://dashscope.aliyuncs.com/api-ws/v1/realtime' ) qwen_tts_realtime.connect() @@ -234,17 +234,6 @@ if __name__ == '__main__': )) ``` -**重要** - -阿里云百炼为华北2（北京）、新加坡地域推出了业务空间专属域名，能够为推理请求提供卓越的性能和更高的稳定性，建议迁移至新域名： - -- 华北2（北京）地域：从 `dashscope.aliyuncs.com` 迁移至 `{WorkspaceId}.cn-beijing.maas.aliyuncs.com` - -- 新加坡地域：从 `dashscope-intl.aliyuncs.com` 迁移至 `{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com` - - -`{WorkspaceId}`需要替换为真实的[Workspace ID](https://help.aliyun.com/zh/model-studio/obtain-the-app-id-and-workspace-id#d3eb3cd37b7fu)。现有域名仍可正常使用。 - 访问[github](https://github.com/aliyun/alibabacloud-bailian-speech-demo/tree/master/samples/conversation/omni)下载更多示例代码。 ## **请求参数** @@ -273,11 +262,9 @@ str 是 -华北2（北京）地域：`wss://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api-ws/v1/realtime` - -新加坡地域：`wss://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/realtime` +华北2（北京）地域：`wss://dashscope.aliyuncs.com/api-ws/v1/realtime` -调用时请将`{WorkspaceId}`替换为真实的[Workspace ID](https://help.aliyun.com/zh/model-studio/obtain-the-app-id-and-workspace-id#d3eb3cd37b7fu)。 +新加坡地域：`wss://dashscope-intl.aliyuncs.com/api-ws/v1/realtime` 下述请求参数可以通过update\_session接口配置。 diff --git a/skills/bailian-docs-llm-wiki/raw/model-user-guide/get-started-with-models/rate-limit.md b/skills/bailian-docs-llm-wiki/raw/model-user-guide/get-started-with-models/rate-limit.md index 4fa36c1..008a62d 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-user-guide/get-started-with-models/rate-limit.md +++ b/skills/bailian-docs-llm-wiki/raw/model-user-guide/get-started-with-models/rate-limit.md @@ -4743,7 +4743,7 @@ glm-5.2 500 -1,000,000 +2,000,000 glm-5.1 diff --git a/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-compression/model-compression-introduction.md b/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-compression/model-compression-introduction.md index eb5b773..7226037 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-compression/model-compression-introduction.md +++ b/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-compression/model-compression-introduction.md @@ -1,110 +1,285 @@ # 模型压缩 -模型压缩使用量化算法将全精度微调模型转换为低精度版本。压缩后的模型在推理时显存占用更低，可以部署到更小规格的部署单元，从而降低部署成本并提升推理吞吐。 +模型压缩通过量化技术将全精度微调模型转为低精度版本，降低部署所需的 MU 规格和成本。本文介绍如何在控制台创建和管理模型压缩任务。 -您可以在百炼控制台 **模型训练 > 模型压缩** 页面创建压缩任务，也可以通过 OpenAPI 调用。压缩产出的模型可直接用于 **模型部署**。 +## 功能概述 -## 一、使用前提 +模型压缩通过量化技术将全精度微调模型转换为低精度版本，在保持模型能力的前提下降低部署所需的 MU 规格，从而减少推理部署成本。百炼平台的模型压缩特指量化，不涉及结构剪枝或知识蒸馏。 -压缩前，请确保满足以下条件： +模型压缩是模型生产链路中的可选环节，完整链路为：[模型调优](https://help.aliyun.com/zh/model-studio/fine-tuning/#73749f1ee5634) → 模型压缩 → [模型部署](https://help.aliyun.com/zh/model-studio/model-deployment-1/#3bc53b23c7shc)。您需要先完成模型微调训练，再对产出的微调模型执行压缩，最后将压缩后的模型部署为推理服务。 -- **源模型准备**：当前工作空间至少有一个支持压缩的自定义微调模型（通过模型调优产出）。具体支持哪些基础模型，请参见下方[支持压缩的模型](#6w2ox667clm6i)。微调流程详见 [模型调优](https://help.aliyun.com/zh/model-studio/fine-tuning/)。 - +**重要** -## 二、支持压缩的模型 +压缩不可逆。压缩后的模型不支持继续微调，也不支持二次压缩。请在压缩前确认量化模板选择。 -当前支持以下基础模型对应的自定义微调模型： +### 支持压缩的模型 -模型系列 +当前支持压缩的模型如下表所示，具体以控制台展示为准。 -模型名称 +**模型系列** -压缩前部署 +**基础模型** -压缩后部署 +**压缩前部署规格** -千问 +**压缩后部署规格** + +Qwen qwen3.5-flash-2026-02-23 -MU1 \* 2 （¥108/小时） +MU1\*2（¥108/小时） + +MU8\*1（¥47/小时） + +以上示例中，压缩后部署成本相比压缩前节省约 56%。 + +### 使用限制 + +- 仅华北2（北京）地域可用。 + +- 仅支持通过百炼平台微调产出的自定义模型，不支持基础模型或第三方模型。 + +- 压缩后的模型不支持继续微调，也不支持二次压缩。 + + +## 创建压缩任务 -MU8 \* 1 （¥47/小时） +### 前提条件 -> 具体支持模型以百炼控制台「模型压缩」页面为准。 +使用模型压缩功能前，请确保当前工作空间中已有通过百炼平台微调训练完成的自定义模型。如果尚未完成模型微调，请先参见[模型调优](https://help.aliyun.com/zh/model-studio/fine-tuning/#73749f1ee5634)完成训练。 -## 三、操作步骤 +### 操作步骤 -1. 登录百炼控制台，在顶部导航栏单击**模型**，在**模型训练**区域单击**模型压缩**。 +1. 登录百炼控制台，在顶部导航栏选择**模型** > **模型训练** > **模型压缩**。 -2. 单击页面右上角 **\+ 创建压缩任务**。 +2. 在模型压缩页面，单击**创建压缩任务**。 -3. 在创建压缩任务页面填写以下信息： +3. 在创建压缩任务页面，配置以下参数： - ![image](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/5061840871/p1076510.png) + ![image](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/5074043871/p1085882.png) - - **基本信息** - - - **任务名称**（必填）、**任务描述**（可选）。 - - - **压缩配置** - - - **选择源模型**：从弹窗中选择当前工作空间内符合条件的自定义微调模型。 - - - **量化产出模型名后缀**：用于拼接产出模型 ID，仅支持小写字母和数字，长度不超过 8 位。 - - - **量化模板**：从所选源模型支持的模板列表中选择。模板名称中包含目标部署规格（如 MU5、MU8），选择模板即决定压缩后可部署的规格。 - - - **校准数据**（所选模板要求校准数据时显示）：校准数据用于统计模型权重和激活值的数值分布，以确定量化时的缩放范围和分块大小。从已发布数据集中按"数据集 → 版本"选择，数据集需先在 **数据管理** 中创建并发布。**OSS 挂载的数据集暂不支持作为校准数据**，仅可使用百炼内置数据集。OpenAPI 调用时通过 `custom_calibration_file_ids` 字段传入。 - -4. 单击 **开始压缩**，任务进入列表。 + **参数** -5. 跟踪任务进度。 + **是否必填** - - 在任务列表中查看运行状态（待开始 / 排队中 / 运行中 / 停止中 / 压缩成功 / 压缩失败 / 已取消）。 - - - 单击任务名进入详情页，在**详情**页签查看任务基本信息，切换到**日志**页签查看运行日志。 - - - 如需取消运行中的任务，在列表中单击 **停止**。 - -6. 任务成功后，在任务列表中单击压缩后的模型名称，跳转到**我的模型**页面，单击**部署**即可上线。支持的部署规格由所选量化模板决定。 + **说明** + + **任务名称** + + 是 + + 最长 50 个字符。建议包含模型简称、量化方式和版本号，便于后续管理。 + + **任务描述** + + 否 + + 最长 200 个字符。 + + **选择源模型** + + 是 + + 单击后弹出模型选择弹窗，仅展示可压缩的微调模型。如果弹窗中无可用模型，请先完成模型微调训练。切换源模型会自动清空已选的量化模板，因为不同模型支持的模板列表不同。 + + **量化产出模型名后缀** + + 是 + + 仅支持小写字母和数字，最长 8 位。输入非法字符时自动过滤。该后缀将拼接到源模型名称后作为压缩后模型的标识。 + + **量化模板** + + 是 + + 以卡片网格形式展示可用模板。须先选择源模型后才能选择模板。模板名中的 MU 编号越大，表示部署规格越小、成本越低。 + + **校准数据** + + 条件选填 + + 仅当所选量化模板包含校准输入参数时显示此字段。最多选择 5 个数据集，不支持 OSS 挂载的数据集。数据集需在[数据管理](https://help.aliyun.com/zh/model-studio/manage-data/#9d2f7039bfo1a)中创建并发布。 + +4. 确认配置无误后，单击**开始压缩**。所有必填字段填写完成后按钮才可点击。创建成功后自动跳转到任务列表页。 - -## 四、压缩要求与限制 **重要** -仅[支持压缩的模型](#6w2ox667clm6i)列表中的自定义微调模型。已量化的模型不支持二次压缩。 +压缩任务创建后不可修改配置。请在单击**开始压缩**前仔细确认量化模板的选择。 + +## 查看压缩任务进度和日志 + +在任务列表页单击任务名称进入详情页。详情页包含**详情**和**日志**两个页签。 + +### 详情页签 + +![image](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/5074043871/p1085884.png) + +**详情**页签展示以下信息： + +- **基本信息**：任务 ID（可复制）、运行状态、创建时间、任务耗时（运行中实时更新）。任务失败时额外显示错误信息。 + +- **压缩配置**：源模型、压缩后模型、量化方法、校准数据等创建时的配置信息。 + + +### 日志页签 -- **部署规格**：压缩产出的模型支持的部署单元规格由所选量化模板决定（模板名称中包含目标规格，如 MU5、MU8 等），部署数量在百炼控制台 **模型部署** 中配置。 +![image](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/5074043871/p1085885.png) + +切换到**日志**页签，查看压缩任务的运行日志。 + +- **显示行数**：可选择显示最近 100、500、2000 或 5000 行日志。 + +- **自动刷新**：开启后每 30 秒自动刷新日志内容。 + +- **日志级别着色**：INFO（绿色）、DEBUG（灰色）、ERROR（红色）、WARN（黄色）。 -- **任务状态**：任务状态包含待开始、排队中、运行中、停止中、压缩成功、压缩失败、已取消。仅「排队中」或「运行中」状态的任务支持取消；终态任务（压缩成功 / 压缩失败 / 已取消）可删除。单击**停止**或**删除**后需在确认弹窗中二次确认。 +- **日志操作**：支持下载全量日志（不受显示行数限制）、折叠或展开子条目、切换暗色或亮色模式、切换是否换行显示。 -- **任务不可逆**：压缩产出的模型不支持继续训练，也不支持二次压缩。如需迭代，请回到上游全精度模型重新训练后再压缩。 + +### 失败排查 + +如果压缩任务失败，建议按以下步骤排查： + +1. 在**详情**页签查看错误信息。 -- **删除任务的影响**：删除任务记录仅删除任务本身，已生成的产出模型保留在 **我的模型** 中。 +2. 切换到**日志**页签，搜索 ERROR 级别日志。 +3. 下载全量日志进行详细分析。 + +4. 如仍无法解决，请提交工单并附上任务 ID 和日志文件。 + + +## 管理压缩任务 + +在控制台选择**模型** > **模型训练** > **模型压缩**进入任务列表页，管理已创建的压缩任务。 + +![image](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/5074043871/p1085886.png) + +### 任务列表 + +任务列表展示以下 7 列信息： + +**列名** + +**说明** + +**任务名称/ID** + +任务名称和任务 ID。单击任务名称可进入详情页。 + +**量化模板** + +创建任务时选择的量化模板名称。 + +**任务状态** + +当前任务的运行状态。 + +**源模型** + +压缩前的微调模型名称。 + +**压缩后模型** + +压缩产出的模型名称。仅任务成功时可点击跳转到模型中心查看。 + +**创建时间** + +任务的创建时间。 + +**操作** + +可执行的操作，包括停止和删除。操作可用性与任务状态相关。 + +支持按**量化模板**、**任务状态**（5 种）、**时间范围**和**任务名称或 ID**进行筛选和搜索。列表支持排序，每页显示 10 条记录。 + +### 任务状态 + +压缩任务共有 7 种状态，生命周期如下： + +- **PENDING**（待开始）：任务已创建，等待调度。 + +- **QUEUING**（排队中）：任务已进入执行队列。 + +- **RUNNING**（运行中）：任务正在执行压缩。 + +- **SUCCEEDED**（压缩成功）：压缩完成，模型已产出。 + +- **FAILED**（压缩失败）：压缩过程中出错。 + +- **CANCELING**（停止中）：用户发起停止，任务正在终止。 + +- **CANCELED**（已取消）：任务已被用户停止。 + + +### 停止和删除任务 + +- **停止任务**：仅 PENDING 和 RUNNING 状态的任务可停止。单击**停止**后需在确认弹窗中二次确认。停止后任务不可恢复。详情页中也提供停止按钮。 + +- **删除任务**：仅终态（SUCCEEDED、FAILED、CANCELED）的任务可删除，QUEUING 状态不可删除。删除任务记录不影响已产出的压缩后模型。 + + +空状态提示：无任务时页面显示引导文案并提供创建入口；有筛选无结果时提示"未找到匹配项"，建议调整筛选条件或清空搜索。 + +## 计费说明 + +- 压缩任务本身限时免费，截止时间以控制台公告为准。 + +- 压缩后的模型在部署阶段按 MU 规格计费。详细的部署计费信息，请参见[模型部署](https://help.aliyun.com/zh/model-studio/model-deployment-1/#3bc53b23c7shc)。 + + +以 qwen3.5-flash-2026-02-23 微调模型为例，压缩前部署规格为 MU1\*2（¥108/小时），压缩后降至 MU8\*1（¥47/小时），部署成本节省约 56%。建议在免费期内对比多个量化模板的压缩效果，选择最优方案后再正式部署。 + +## 常见问题 + +**创建压缩任务时无可选模型怎么办？** + +**创建压缩任务时无可选模型怎么办？** + +选择源模型弹窗中仅展示可压缩的微调模型。如果弹窗中无可选项，说明当前工作空间没有符合条件的微调模型。请先参见[模型调优](https://help.aliyun.com/zh/model-studio/fine-tuning/#73749f1ee5634)完成微调训练，确保训练状态为成功后再创建压缩任务。 + +**压缩后的模型能否继续微调或二次压缩？** + +**压缩后的模型能否继续微调或二次压缩？** + +不能。压缩是单向操作，如需调整请从上游全精度微调模型重新压缩。详见[功能概述](#0b86w6qcjy74k)中的使用限制。 + +**量化与剪枝、蒸馏有什么区别？** + +**量化与剪枝、蒸馏有什么区别？** + +三者是不同的模型优化技术。量化降低参数精度，剪枝移除冗余结构，蒸馏用大模型训练小模型。百炼当前仅支持量化。 + +**量化模板怎么选？** + +**量化模板怎么选？** + +量化模板决定了压缩后模型的部署规格。模板名称中 MU 编号越大，部署规格越小、成本越低，但精度损失可能越大。建议根据业务对成本和精度的权衡来选择模板。如果不确定，可以在免费期内尝试多个模板，部署后用业务测试集验证效果。 + +**校准数据怎么选？** -## 五、计费说明 +**校准数据怎么选？** -当前模型压缩功能限时免费，具体免费截止时间以控制台公告为准。 +校准数据用于提升量化精度，建议选择与目标推理场景语义相近的数据集。例如，如果压缩后的模型用于客服问答场景，建议选择包含客服对话样本的数据集作为校准数据。 -压缩产出的模型部署上线后，按所选部署单元的标准规格计费，计费详情参见 [模型部署](https://help.aliyun.com/zh/model-studio/model-deployment-1/)。 +**压缩后模型精度下降怎么办？** -## 六、常见问题 +**压缩后模型精度下降怎么办？** -**Q1：哪些模型可以压缩？** +量化压缩可能导致一定程度的精度损失。建议在部署后使用业务测试集进行推理验证。如果精度不满足需求，可以尝试更换量化模板重新压缩，或添加校准数据提升量化质量。 -支持[压缩的模型](#6w2ox667clm6i)列表中的自定义微调模型。已量化的模型不支持二次压缩。具体支持模型以控制台为准。 +**免费期结束后怎么收费？** -**Q2：任务可以取消吗？** +**免费期结束后怎么收费？** -「排队中」或「运行中」状态的任务支持取消，取消后状态变为「停止中」再转为「已取消」。终态任务无法取消。 +压缩任务当前限时免费，免费期结束后的计费方式以控制台公告为准。压缩后模型的部署费用不受免费期影响，始终按 MU 规格计费。 -**Q3：压缩后的模型支持继续微调或再压缩吗？** +**如何利用免费期确定最佳压缩方案？** -压缩产出的模型不支持继续训练，也不支持二次压缩。如需迭代，请回到上游全精度模型重新训练。 +**如何利用免费期确定最佳压缩方案？** -**Q4：校准数据可以使用 OSS 挂载的数据集吗？** +建议在免费期内对同一微调模型尝试多个量化模板，分别部署后使用业务测试集验证推理效果。对比不同模板在精度和成本之间的表现，选择最适合业务需求的方案后再正式上线。 -控制台 UI 暂不支持选择 OSS 挂载 / 挂载存储类型的数据集，请使用 **数据管理** 中"内部上传"类型且"已发布"状态的数据集。OpenAPI 调用可通过 `custom_calibration_file_ids` 字段直接传入数据集组 ID，由后端校验。 +如果您需要通过 API 管理压缩任务，请参见[模型压缩 API 参考](https://help.aliyun.com/zh/model-studio/model-compression-api#h1-e183f6b9)。 diff --git a/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-deployment-1/model-deployment-quick-start.md b/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-deployment-1/model-deployment-quick-start.md index d56cbae..411444a 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-deployment-1/model-deployment-quick-start.md +++ b/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-deployment-1/model-deployment-quick-start.md @@ -21,7 +21,7 @@ 使用**模型 ID** 作为输入的`model_name`参数，即可使用 API 部署该模型。 -## 按预置吞吐（PTU）计费 +### 按预置吞吐（PTU）计费 **说明** @@ -44,7 +44,7 @@ curl "https://dashscope.aliyuncs.com/api/v1/deployments" \ }' ``` -#### 按模型单元的使用时长计费 +### 按模型单元的使用时长计费 **说明** @@ -297,8 +297,12 @@ curl --request DELETE 'https://dashscope.aliyuncs.com/api/v1/deployments/qwen3-8 在**模型列表**中找到目标模型，查看**模型部署**列的授权状态。若显示**未授权**，单击**操作**列的**编辑**进行授权。 + 如果提示权限不足，请联系您的组织或 IT 管理员添加相关权限或代为操作。 + 2. API Key 的**归属账号**在**归属业务空间**中拥有操作权限。请前往[百炼控制台](https://bailian.console.aliyun.com/?tab=model#/model-market)，点击左下角的业务空间，切换到对应业务空间，再点击![image](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/1816324671/p1030217.png)检查对应业务空间的模型部署权限设置。 > API 调用报错：`Workspace access denied`。 在左侧导航栏点击**权限管理**，确认用户列表中包含 API Key 的归属账号（类型为**主账号**）。 + + 如果提示权限不足，请联系您的组织或 IT 管理员添加相关权限或代为操作。 diff --git a/skills/bailian-docs-llm-wiki/raw/model-user-guide/release-notes/model-release-notes.md b/skills/bailian-docs-llm-wiki/raw/model-user-guide/release-notes/model-release-notes.md index 3a53a8c..75c8250 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-user-guide/release-notes/model-release-notes.md +++ b/skills/bailian-docs-llm-wiki/raw/model-user-guide/release-notes/model-release-notes.md @@ -23,6 +23,24 @@ ## 2026年 +**7月** + +**日期** + +**功能模块** + +**功能点** + +**功能说明** + +7月6日 + +平台功能 + +部分老旧模型延期下线通知 + +部分老旧模型延期下线通知[了解详情](https://www.aliyun.com/notice/118420) + **6月** **日期** @@ -33,6 +51,30 @@ **功能说明** +6月30日 + +团队版计费 + +团队版新增共享用量包 + +跨坐席共享 Credits 弹性用量包，可抵扣超额用量，[了解详情](https://help.aliyun.com/zh/model-studio/token-plan-overview) + +6月29日 + +Coding Plan + +Pro套餐新客首月特惠 + +Coding Plan Pro 套餐首次订阅可享首月 ¥39.90，[了解详情](https://help.aliyun.com/zh/model-studio/coding-plan) + +6月29日 + +智能体托管 + +智能体托管运行时上线 + +新增智能体托管运行时 API，平台托管会话与工具执行，[了解详情](https://help.aliyun.com/zh/model-studio/managed-agents-api-overview) + 6月29日 平台功能 @@ -49,6 +91,70 @@ qwen-turbo 资源包启动退市通知 qwen-turbo 资源包启动退市通知[了解详情](https://www.aliyun.com/notice/118392) +6月24日 + +接入工具 + +新增 Codex 客户端接入 + +新增 Codex 终端 AI 编程助手接入百炼，[了解详情](https://help.aliyun.com/zh/model-studio/codex) + +6月23日 + +知识库RAG + +知识检索服务上线 + +新增知识检索服务，支持多知识库联合检索与混合排序，[了解详情](https://help.aliyun.com/zh/model-studio/rag-knowledge-retrieval) + +6月23日 + +知识库RAG + +知识问答服务上线 + +新增知识问答服务，基于大模型结合检索生成回答，[了解详情](https://help.aliyun.com/zh/model-studio/rag-knowledge-qa) + +6月15日 + +模型部署 + +PTU 长输入与缓存 + +预置吞吐部署新增长输入与前缀缓存能力，[了解详情](https://help.aliyun.com/zh/model-studio/ptu-long-input-and-cache) + +6月12日 + +地域接入 + +新增地域与部署范围 + +新增美国、德国、日本地域与服务部署范围，[了解详情](https://help.aliyun.com/zh/model-studio/regions/) + +6月11日 + +Coding Plan + +Coding Plan 联网搜索 MCP 升级 + +Coding Plan 联网搜索 MCP 升级 Streamable HTTP 协议，前 2000 次免费，[了解详情](https://help.aliyun.com/zh/model-studio/web-search-for-coding-plan) + +6月10日 + +Skill技能 + +Skill 能力包上线 + +新增 Skill 能力包，智能体可添加官方或自定义技能，[了解详情](https://help.aliyun.com/zh/model-studio/introduction-to-skill) + +6月10日 + +数据连接 + +数据连接模块上线 + +新增数据连接模块，支持 MySQL/语雀/OSS 等数据源，[了解详情](https://help.aliyun.com/zh/model-studio/data-connection) + 6月9日 模型评测 @@ -71,7 +177,7 @@ qwen-turbo 资源包启动退市通知[了解详情](https://www.aliyun.com/noti 模型导入 API 上线 -API 参考新增模型导入目录, 涵盖导入任务与自定义模型对象的完整 API 接口，[了解详情](https://help.aliyun.com/zh/model-studio/custom-models-api/) +API 参考新增模型导入目录, 涵盖导入任务与自定义模型对象的完整 API 接口，[了解详情](https://help.aliyun.com/zh/model-studio/custom-models-api) 6月3日 @@ -145,7 +251,7 @@ Spring AI Alibaba 调用百炼应用文档上线 模型压缩模块上线 -新增模型压缩模块，使用量化算法将全精度微调模型转为低精度版本，降低部署成本，[了解详情](https://help.aliyun.com/zh/model-studio/model-compression-introduction#6w2ox667clm6i) +新增模型压缩模块，使用量化算法将全精度微调模型转为低精度版本，降低部署成本，[了解详情](https://help.aliyun.com/zh/model-studio/model-compression-introduction) 5月21日 @@ -564,6 +670,14 @@ DPO 偏好训练通过引入负反馈，从而降低幻觉，使得模型输出 启用[免费额度用完即停](https://help.aliyun.com/zh/model-studio/new-free-quota#d1cb80ac11i92)功能后，新人免费额度耗尽将无法继续调用（返回错误 code：AllocationQuota.FreeTierOnly），避免产生额外费用。 +7月2日 + +知识检索问答 + +知识检索与问答 API 上线 + +新增知识检索与问答 API，SSE 流式返回三阶段，[了解详情](https://help.aliyun.com/zh/model-studio/knowledge/) + **6月** **日期** diff --git a/skills/bailian-docs-llm-wiki/raw/model-user-guide/test-1/model-pricing.md b/skills/bailian-docs-llm-wiki/raw/model-user-guide/test-1/model-pricing.md index 4186433..2e3e081 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-user-guide/test-1/model-pricing.md +++ b/skills/bailian-docs-llm-wiki/raw/model-user-guide/test-1/model-pricing.md @@ -3926,6 +3926,8 @@ qwen-omni-turbo-2025-03-26 qwen3.5-omni-plus-realtime +> 当前能力等同于qwen3.5-omni-plus-realtime-2026-03-15 + 中国内地 10元 @@ -3954,6 +3956,8 @@ qwen3.5-omni-plus-realtime-2026-03-15 qwen3.5-omni-flash-realtime +> 当前能力等同于qwen3.5-omni-flash-realtime-2026-03-15 + 中国内地 3.3元 @@ -4014,6 +4018,8 @@ qwen3.5-omni-flash-realtime-2026-03-15 qwen3-omni-flash-realtime +> 当前能力等同于qwen3-omni-flash-realtime-2025-12-01 + 中国内地 2.2元 @@ -4068,6 +4074,8 @@ qwen3-omni-flash-realtime-2025-09-15 qwen-omni-turbo-realtime +> 当前能力等同于qwen-omni-turbo-realtime-2025-05-08 + 中国内地 1.6元 @@ -4144,6 +4152,8 @@ qwen-omni-turbo-realtime-2025-05-08 qwen3.5-omni-plus-realtime +> 当前能力等同于qwen3.5-omni-plus-realtime-2026-03-15 + 国际 15.74元 @@ -4168,6 +4178,8 @@ qwen3.5-omni-plus-realtime-2026-03-15 qwen3.5-omni-flash-realtime +> 当前能力等同于qwen3.5-omni-flash-realtime-2026-03-15 + 国际 4.12元 @@ -4220,6 +4232,8 @@ qwen3.5-omni-flash-realtime-2026-03-15 qwen3-omni-flash-realtime +> 当前能力等同于qwen3-omni-flash-realtime-2025-12-01 + 国际 3.816元 @@ -4268,6 +4282,8 @@ qwen3-omni-flash-realtime-2025-09-15 qwen-omni-turbo-realtime +> 当前能力等同于qwen-omni-turbo-realtime-2025-05-08 + 国际 1.982元 @@ -5294,6 +5310,8 @@ qwen3.5-ocr qwen-vl-ocr +> 当前能力等同于qwen-vl-ocr-2025-11-20 + > [Batch调用](https://help.aliyun.com/zh/model-studio/batch-interfaces-compatible-with-openai/)半价 中国内地 @@ -5368,6 +5386,8 @@ qwen-vl-ocr-2024-10-28 qwen-vl-ocr +> 当前能力等同于qwen-vl-ocr-2025-11-20 + 全球 0.3元 @@ -5394,6 +5414,8 @@ qwen-vl-ocr-2025-11-20 qwen-vl-ocr +> 当前能力等同于qwen-vl-ocr-2025-11-20 + 国际 0.514元 @@ -5420,6 +5442,8 @@ qwen-vl-ocr-2025-11-20 qwen-vl-ocr +> 当前能力等同于qwen-vl-ocr-2025-11-20 + 全球 0.3元 @@ -9880,6 +9904,8 @@ stepfun/step-3.7-flash qwen-image-2.0-pro +> 当前能力等同于qwen-image-2.0-pro-2026-04-22 + 中国内地 0.5元/张 @@ -9912,6 +9938,8 @@ qwen-image-2.0-pro-2026-03-03 qwen-image-2.0 +> 当前能力等同于qwen-image-2.0-2026-03-03 + 中国内地 0.2元/张 @@ -9980,6 +10008,8 @@ qwen-image qwen-image-2.0-pro +> 当前能力等同于qwen-image-2.0-pro-2026-04-22 + 国际 0.550443元/张 @@ -10004,6 +10034,8 @@ qwen-image-2.0-pro-2026-03-03 qwen-image-2.0 +> 当前能力等同于qwen-image-2.0-2026-03-03 + 国际 0.256873元/张 @@ -10070,6 +10102,8 @@ qwen-image qwen-image-2.0-pro +> 当前能力等同于qwen-image-2.0-pro-2026-04-22 + 中国内地 0.5元/张 @@ -10102,6 +10136,8 @@ qwen-image-2.0-pro-2026-03-03 qwen-image-2.0 +> 当前能力等同于qwen-image-2.0-2026-03-03 + 中国内地 0.2元/张 @@ -10178,6 +10214,8 @@ qwen-image-edit qwen-image-2.0-pro +> 当前能力等同于qwen-image-2.0-pro-2026-04-22 + 国际 0.550443元/张 @@ -10202,6 +10240,8 @@ qwen-image-2.0-pro-2026-03-03 qwen-image-2.0 +> 当前能力等同于qwen-image-2.0-2026-03-03 + 国际 0.256873元/张 @@ -11198,6 +11238,8 @@ fun-music-v1 qwen3-tts-instruct-flash +> 当前能力等同于qwen3-tts-instruct-flash-2026-01-26 + 中国内地 0.8元 @@ -11386,6 +11428,8 @@ qwen-tts-2025-04-10 qwen3-tts-instruct-flash +> 当前能力等同于qwen3-tts-instruct-flash-2026-01-26 + 国际 0.8元 @@ -11484,6 +11528,8 @@ qwen3-tts-flash-2025-09-18 qwen3-tts-instruct-flash-realtime +> 当前能力等同于qwen3-tts-instruct-flash-realtime-2026-01-22 + 中国内地 1元 @@ -11676,6 +11722,8 @@ qwen-tts-realtime-2025-07-15 qwen3-tts-instruct-flash-realtime +> 当前能力等同于qwen3-tts-instruct-flash-realtime-2026-01-22 + 国际 1元 @@ -11740,6 +11788,8 @@ qwen3-tts-vc-realtime-2025-11-27 qwen3-tts-flash-realtime +> 当前能力等同于qwen3-tts-flash-realtime-2025-11-27 + 国际 0.954101元 @@ -12060,6 +12110,8 @@ qwen3.5-livetranslate-flash-realtime-2026-05-19 qwen3-livetranslate-flash-realtime +> 当前能力等同于qwen3-livetranslate-flash-realtime-2025-09-22 + 中国内地 64元 @@ -12130,6 +12182,8 @@ qwen3.5-livetranslate-flash-realtime-2026-05-19 qwen3-livetranslate-flash-realtime +> 当前能力等同于qwen3-livetranslate-flash-realtime-2025-09-22 + 国际 73.392元 @@ -12404,6 +12458,8 @@ qwen3-asr-flash-2025-09-08 qwen3-asr-flash-realtime +> 当前能力等同于qwen3-asr-flash-realtime-2025-10-27 + 中国内地 0.00033元/秒 @@ -12432,6 +12488,8 @@ qwen3-asr-flash-realtime-2025-10-27 qwen3-asr-flash-realtime +> 当前能力等同于qwen3-asr-flash-realtime-2025-10-27 + 国际 0.00066元/秒 @@ -12468,6 +12526,8 @@ qwen3-asr-flash-realtime-2025-10-27 fun-asr +> 当前能力等同于fun-asr-2025-11-07 + 中国内地 0.00022元/秒 @@ -12516,6 +12576,8 @@ fun-asr-flash-2026-06-15 fun-asr +> 当前能力等同于fun-asr-2025-11-07 + 国际 0.00026元/秒 @@ -12598,6 +12660,8 @@ fun-asr-mtl-realtime-2025-12-10 fun-asr-flash-8k-realtime +> 当前能力等同于fun-asr-flash-8k-realtime-2026-01-28 + 中国内地 0.00022元/秒 diff --git a/skills/bailian-docs-llm-wiki/raw/model-user-guide/test-1/new-free-quota.md b/skills/bailian-docs-llm-wiki/raw/model-user-guide/test-1/new-free-quota.md index a0e82ac..0768bb1 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-user-guide/test-1/new-free-quota.md +++ b/skills/bailian-docs-llm-wiki/raw/model-user-guide/test-1/new-free-quota.md @@ -16,6 +16,15 @@ 自**2025年9月8日11点**起，首次开通阿里云百炼的用户，获赠的新人免费额度有效期调整为 90 天，在此之前已开通的用户不受影响，详情参考[阿里云百炼新人免费额度有效期调整通知](https://help.aliyun.com/zh/model-studio/new-free-quota-validity-adjustment)。 +免费额度过期后自动失效，不支持补发、延期或重置： + +- 额度有效期内是否使用均不会暂停计时； + +- 额度过期后，剩余部分自动作废，不会重新发放或延长； + +- 同一实名认证主体下重新注册账号，无法再次领取新人免费额度。 + + ### 适用范围 免费额度仅抵扣模型**实时推理**（调用）产生的费用，不支持抵扣以下场景： @@ -35,6 +44,15 @@ > 例如：qwen-max的总免费额度为100万Token。主账号消耗了10万Token，RAM子账号消耗了20万Token，qwen-max的剩余免费额度为70万Token。 +不同模型（含同一模型的不同快照版本）的免费额度相互独立，不互通、不共享。 + +- 每个模型均有独立的免费额度（通常为 100 万 Token），不能跨模型合并或转移使用。 + +- 带日期后缀的快照版本（如 `qwen-max-2026-05-17`）与不带日期的最新版本（如 `qwen-max`）视为两个独立模型，各自拥有独立额度。 + +- 当某个模型额度用完后，系统不会自动切换到其他有额度的模型。如需使用其他模型的免费额度，需在代码或工具配置中手动修改 `model` 参数。 + + ## 获取免费额度 访问[阿里云百炼-中国内地版](https://bailian.console.aliyun.com/#/model-market)，阅读并同意协议后，系统将自动开通阿里云百炼并发放**免费推理额度**。 @@ -145,9 +163,9 @@ 1. 在[账单详情](https://billing-cost.console.aliyun.com/finance/expense-report/expense-detail)页面，选择账单月份，**产品名称**选择**大模型服务平台百炼**，单击**搜索**。 -2. 单击账单列表右上角的![image](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/1247144771/p1062109.png)图标，找到**用量信息**，勾选**抵扣用量**，单击**确定**。 +2. 单击账单列表右上角的![image](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/1247144771/p1062109.png)图标，找到**用量信息**，勾选**用量**，单击**确定**。 -3. 找到**费用类型**为**免费额度**的账单项，**抵扣用量**即为免费额度已抵扣的用量。 +3. 找到**费用类型**为**免费额度**的账单项，**用量**即为免费额度已抵扣的用量。 ### 为什么产生了费用？ @@ -193,3 +211,11 @@ ### 为什么看不到免费额度与有效期？ 免费额度列显示**无免费额度**或**免费额度**区域不显示，说明该账号下对应模型的免费额度已到期。 + +### 使用哪种 API Key 才能消耗免费额度？ + +API Key 本身不绑定特定模型，同一个 API Key 可调用所有模型，无需为使用免费额度单独创建新的 API Key。 + +实时调用时，系统将自动优先使用免费额度抵扣，无需手动设置。按消耗优先级依次为：免费额度 > 资源包 > 节省计划 > 按量付费。 + +**Token Plan/Coding Plan 专属 API Key** 不消耗免费额度，使用专属 API Key 调用模型将直接按量付费。如需使用免费额度，请改用通用 API Key（非专属 API Key）。 diff --git a/skills/bailian-docs-llm-wiki/raw/model-user-guide/test-1/savings-plan-and-resource-package.md b/skills/bailian-docs-llm-wiki/raw/model-user-guide/test-1/savings-plan-and-resource-package.md index 9b1e45b..3609d85 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-user-guide/test-1/savings-plan-and-resource-package.md +++ b/skills/bailian-docs-llm-wiki/raw/model-user-guide/test-1/savings-plan-and-resource-package.md @@ -793,7 +793,7 @@ ASR模型按秒计费，TTS模型按字符计费，请前往[百炼控制台](ht **退订说明**： -- 根据[退订规则说明](https://help.aliyun.com/zh/user-center/cancel-subscription/)，预付费商品未发生使用的部分，可按未使用额度费用[申请退款](https://billing-cost.console.aliyun.com/refund/refund?commodityType=RESOURCE_PLANS&refundType=NOREASON_REFUND)；已使用的部分则无法退款。 +- 根据[退订规则](https://help.aliyun.com/zh/user-center/cancel-subscription/)，预付费商品未发生使用的部分，可按未使用额度费用[申请退款](https://billing-cost.console.aliyun.com/refund/refund?commodityType=RESOURCE_PLANS&refundType=NOREASON_REFUND)；已使用的部分则无法退款。 ### **大语言模型推理资源包** @@ -980,3 +980,39 @@ qwen-turbo的实时推理服务（[非思考模式](https://help.aliyun.com/zh/m ### **购买了大语言模型节省计划，能抵扣向量模型（embedding）和排序模型（rerank）吗？** 不能。大语言模型推理节省计划仅适用于文本生成模型，不支持抵扣向量模型和排序模型。如果您的业务同时涉及大语言模型与向量、排序模型（例如 RAG 场景），建议选择[AI 通用型节省计划](#bi9fizb4qqi7x)，或单独购买[向量及排序模型节省计划](#1a5d3540e3749)。 + +### **入门型AI通用节省计划和 AI 通用型节省计划有什么区别？** + +两者的主要区别如下： + +**对比项** + +**AI 通用型节省计划** + +**入门型AI通用节省计划** + +**购买入口** + +通过[AI通用型节省计划购买页](https://common-buy.aliyun.com/?commodityCode=sfm_GenAI_spn_cn)购买 + +通过[AI优惠活动页](https://www.aliyun.com/benefit/scene/ai-discount)的"全模型通享"模块购买 + +**活动限制** + +无首购限制 + +活动价格仅限**首购** + +**适用模型** + +详见[购买指引](#nqdi1bsux4qx0)中的抵扣范围 + +与 AI 通用型节省计划支持的模型范围相同，详见[购买指引](#nqdi1bsux4qx0)中的抵扣范围 + +**折扣方式** + +不同档位对应不同按量付费折扣，档位越高折扣越大 + +按量计费，无按量付费折扣；仅首次购买时有优惠（如原价 20 元只需支付 10 元，具体以购买页为准） + +节省计划账单请参见[节省账单使用明细](https://billing-cost.console.aliyun.com/resource/spn/detail)。 diff --git a/skills/bailian-docs-llm-wiki/raw/model-user-guide/use-cases/model-training-best-practices.md b/skills/bailian-docs-llm-wiki/raw/model-user-guide/use-cases/model-training-best-practices.md index ae0cb6c..9c75653 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-user-guide/use-cases/model-training-best-practices.md +++ b/skills/bailian-docs-llm-wiki/raw/model-user-guide/use-cases/model-training-best-practices.md @@ -36,7 +36,7 @@ 在阿里云百炼，**完成调优的模型必须部署后才能调用和评测**。因此，您需要首先完成模型部署，方可继续评测模型。 -![image](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/1050972771/CAEQSBiBgICa8texgxkiIGU5OGM2ZmE4ZjJjNDRhMWY5MmMwYmQwZmIzZWIyODM04430647_20240626141408.264.svg) +![image](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/3946933871/CAEQSBiBgICa8texgxkiIGU5OGM2ZmE4ZjJjNDRhMWY5MmMwYmQwZmIzZWIyODM04430647_20240626141408.264.svg) ## **前提条件** diff --git a/skills/bailian-docs-llm-wiki/raw/model-user-guide/use-chat-client-or-development-tool/dify.md b/skills/bailian-docs-llm-wiki/raw/model-user-guide/use-chat-client-or-development-tool/dify.md index b13d6a2..68960a1 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-user-guide/use-chat-client-or-development-tool/dify.md +++ b/skills/bailian-docs-llm-wiki/raw/model-user-guide/use-chat-client-or-development-tool/dify.md @@ -128,7 +128,7 @@ A：Dify 没有提供万相模型相关的插件，通过Dify的Chatflow/工作 1. **下载并导入工作流模板** - 下载我们写好的模板：_万相-文生图Demo.yml（ICMS 附件，file\_id=135184，需在线下载）\*\*Wanx - Text-to-Image Demo.yml（ICMS 附件，file\_id=148265，需在线下载）_或 _万相-文生视频Demo.yml（ICMS 附件，file\_id=135439，需在线下载）\*\*Wanx - Text-to-Video Demo.yml（ICMS 附件，file\_id=148266，需在线下载）_，在[工作室](https://cloud.dify.ai/apps)单击**导入DSL文件**并选择下载的模板文件。 + 下载我们写好的模板：[万相-文生图Demo.yml](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250520/uuxncy/%E9%80%9A%E4%B9%89%E4%B8%87%E7%9B%B8-%E6%96%87%E7%94%9F%E5%9B%BEDemo.yml)或 [万相-文生视频Demo.yml](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250522/ksblgi/%E9%80%9A%E4%B9%89%E4%B8%87%E7%9B%B8-%E6%96%87%E7%94%9F%E8%A7%86%E9%A2%91Demo.yml)，在[工作室](https://cloud.dify.ai/apps)单击**导入DSL文件**并选择下载的模板文件。 2. **配置环境变量** diff --git a/skills/bailian-docs-llm-wiki/wiki/api/3d-generation.md b/skills/bailian-docs-llm-wiki/wiki/api/3d-generation.md index 88b916c..e8d93c2 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/3d-generation.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/3d-generation.md @@ -77,3 +77,4 @@ API 仅支持[异步调用](../concepts/async-invocation.md)，包含两个步 + diff --git a/skills/bailian-docs-llm-wiki/wiki/api/application-call.md b/skills/bailian-docs-llm-wiki/wiki/api/application-call.md index 9ccae08..b35b238 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/application-call.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/application-call.md @@ -1,6 +1,6 @@ # application call -阿里云百炼平台提供两套 API 来调用智能体和工作流应用：**OpenAI 兼容的 Responses API** 和 **DashScope API**。两者均支持同步/[异步调用](../concepts/async-invocation.md)、多轮对话、[流式输出](../concepts/streaming.md)等核心能力，开发者可根据生态兼容性和功能需求选择合适的接入方式。调用前需先获取 APP ID（以及子[业务空间](../concepts/workspace.md)场景下的 Workspace ID）和 API Key。 +阿里云百炼平台提供两套 API 来调用智能体和工作流应用：**OpenAI 兼容的 Responses API** 和 **DashScope API**。两者均支持同步/[异步调用](../concepts/async-invocation.md)、多轮对话、[流式输出](../concepts/streaming.md)等核心能力，开发者可根据生态兼容性和功能需求选择合适的接入方式。调用前需先获取 APP ID（以及子[业务空间](../concepts/workspace.md)场景下的 Workspace ID）和 [API Key](../concepts/api-key.md)。 ## 前置准备 @@ -15,7 +15,7 @@ ### 其他前提 -- 已获取 API Key 并配置到环境变量 `DASHSCOPE_API_KEY`。 +- 已获取 [API Key](../concepts/api-key.md) 并配置到环境变量 `DASHSCOPE_API_KEY`。 - 已创建并发布百炼应用（智能体或工作流）。 - 如使用 SDK 调用，需安装对应的 SDK（OpenAI SDK 或 [DashScope SDK](../concepts/dashscope-sdk.md)）。 @@ -79,9 +79,9 @@ Responses API 支持在 `content` 数组中混合多种输入类型： > **注意**：异步任务暂不支持[流式输出](../concepts/streaming.md)（`stream=true`）。 -### 流式输出 +### [流式输出](../concepts/streaming.md) -设置 `stream=true` 可边生成边输出，适用于需要实时展示生成内容的场景。若应用类型为工作流，需在结束节点或流程输出节点中启用「流式输出」开关并重新发布。 +设置 `stream=true` 可边生成边输出，适用于需要实时展示生成内容的场景。若应用类型为工作流，需在结束节点或流程输出节点中启用「[流式输出](../concepts/streaming.md)」开关并重新发布。 ## DashScope API @@ -127,9 +127,9 @@ response = await client.responses.create( - 两套 API 目前均**仅适用于华北2（北京）地域**。 - Responses API 的多轮对话暂不支持基于 `pre_response_id` 或 `conversation_id` 的上下文功能，需每次传递完整对话历史。 -- 异步调用仅 Responses API 支持，且不能与流式输出同时使用。 -- RAM 子账号查看业务空间管理页面需要超级管理员权限（`AliyunBailianFullAccess` 或 `AliyunBailianControlFullAccess`）。 -- API Key 不建议硬编码到代码中，应通过环境变量配置以降低泄露风险。 +- [异步调用](../concepts/async-invocation.md)仅 Responses API 支持，且不能与[流式输出](../concepts/streaming.md)同时使用。 +- RAM 子账号查看[业务空间](../concepts/workspace.md)管理页面需要超级管理员权限（`AliyunBailianFullAccess` 或 `AliyunBailianControlFullAccess`）。 +- [API Key](../concepts/api-key.md) 不建议硬编码到代码中，应通过环境变量配置以降低泄露风险。 ## 来源文档 @@ -140,3 +140,4 @@ response = await client.responses.create( - [应用 DashScope API 参考](../../raw/application-api-reference/application-call/application-dashscope-api-reference/agent-and-workflow-application-api-reference.md) + diff --git a/skills/bailian-docs-llm-wiki/wiki/api/application-component-api-reference.md b/skills/bailian-docs-llm-wiki/wiki/api/application-component-api-reference.md index a360863..80cbeaf 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/application-component-api-reference.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/application-component-api-reference.md @@ -1,153 +1,165 @@ # application component api reference -百炼平台应用组件 API（`bailian/2023-12-29`）提供数据连接、知识库、Prompt 模板等应用构建能力的编程接口。API 采用 ROA 签名风格，覆盖文件管理、知识库全生命周期、Prompt 工程等核心场景，支持通过多语言 SDK 或自签名方式接入。 +百炼平台应用组件 API（`bailian/2023-12-29`）提供了数据连接、知识库、Prompt 模板、长期记忆等核心能力的 OpenAPI 接口，采用 ROA 签名风格。开发者可通过阿里云百炼 SDK 直接调用，也可使用自签名方式对接。所有接口均需传入 `WorkspaceId`（[业务空间](../concepts/workspace.md) ID），RAM 子账号需要先获取对应权限策略并加入[业务空间](../concepts/workspace.md)后才能调用。 -## 接入准备 +## 服务接入点与鉴权 -### 服务接入点 - -百炼应用组件 API 目前支持以下区域，详见[服务接入点](../../raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-endpoint.md)： +当前支持两个地域的接入点： | 地域 | 地域 ID | 公网接入地址 | VPC 接入地址 | -| --- | --- | --- | --- | +|------|---------|-------------|-------------| | 华北2（北京） | cn-beijing | bailian.cn-beijing.aliyuncs.com | bailian-vpc.cn-beijing.aliyuncs.com | | 新加坡 | ap-southeast-1 | bailian.ap-southeast-1.aliyuncs.com | bailian-vpc.ap-southeast-1.aliyuncs.com | -### SDK 与认证 - -推荐使用官方 SDK 调用，避免手动签名。SDK 下载地址：`https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29`。 - -调用前需准备： - -1. **AccessKey**：通过阿里云控制台获取，建议为 RAM 用户创建独立 AccessKey -2. **RAM 授权**：RAM 用户需获取 `AliyunBailianDataFullAccess` 或 `AliyunBailianDataReadOnlyAccess` 策略，并加入目标[业务空间](../concepts/workspace.md) -3. **[业务空间](../concepts/workspace.md) ID（WorkspaceId）**：大部分接口都需要此参数作为路径参数 - -> **注意**：阿里云账号（主账号）拥有全部权限，无需额外授权，但出于安全考虑建议使用 RAM 用户调用。RAM 权限体系的代码为 `sfm`，授权粒度为操作级，详见[授权信息](../../raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-ram.md)。 +调用前需准备 AccessKey，建议使用 RAM 用户而非主账号以降低安全风险。RAM 权限策略的 RamCode 为 `sfm`，授权粒度为操作级。大多数写操作需要 `AliyunBailianDataFullAccess` 策略，部分只读接口（如 DescribeFile、GetIndexJobStatus）也支持 `AliyunBailianDataReadOnlyAccess`。详见[授权信息](../../raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-ram.md)。 ## 数据连接（原应用数据） -数据连接模块负责文件和数据的导入、管理与解析配置，是知识库构建的数据基础。 +数据连接相关 API 用于管理类目、文件、解析设置、表格和连接器，是构建知识库的数据基础。 ### 类目管理 -类目用于分类管理文件，每个[业务空间](../concepts/workspace.md)最多 500 个类目。 +| API | 说明 | 限流 | 幂等性 | +|-----|------|------|--------| +| AddCategory | 在[业务空间](../concepts/workspace.md)中新建类目，每空间最多 500 个 | 5 次/秒 | 否 | +| ListCategory | 查询类目列表，支持分页 | 5 次/秒 | 是 | +| DeleteCategory | 永久删除指定类目 | 5 次/秒 | 是 | -| API | 说明 | HTTP 方法 | -| --- | --- | --- | -| AddCategory | 新增类目 | POST | -| ListCategory | 获取类目列表 | POST | -| DeleteCategory | 永久删除类目 | POST | +> **注意**：当前不支持通过 API 查询或新增数据表，数据表操作请通过控制台完成。 ### 文件管理 -文件上传采用两步流程：先通过 `ApplyFileUploadLease` 获取上传租约，上传文件到临时存储后，再通过 `AddFile` 将文件导入数据连接。也可通过 `AddFilesFromAuthorizedOss` 直接从已授权的 OSS Bucket 导入。 - -| API | 说明 | -| --- | --- | -| ApplyFileUploadLease | 申请文件上传租约（用于知识库文件或会话交互文件） | -| AddFile | 从临时存储导入文件到数据连接 | -| AddFilesFromAuthorizedOss | 从已授权 OSS Bucket 批量导入文件 | -| DescribeFile | 查询单个文件的名称、类型、状态等信息 | -| ListFile | 获取指定类目下的文件列表 | -| UpdateFileTag | 更新单个文件标签 | -| BatchUpdateFileTag | 批量更新文件标签 | -| DeleteFile | 删除单个文件 | -| DeleteFiles | 批量删除文件 | +文件上传采用两步流程：先调用 ApplyFileUploadLease 获取上传租约，使用返回的 URL 上传文件后，再调用 AddFile 将文件导入百炼。也可通过 AddFilesFromAuthorizedOss 直接从已授权的 OSS Bucket 导入。详见[ApplyFileUploadLease - 申请文件上传租约](../../raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-data-connection-original-application-data/api-bailian-2023-12-29-applyfileuploadlease.md)。 + +| API | 说明 | 限流 | +|-----|------|------| +| ApplyFileUploadLease | 申请上传租约（知识库文件或会话交互文件） | 10 次/秒 | +| AddFile | 将临时存储文件导入数据连接 | 10 次/秒 | +| AddFilesFromAuthorizedOss | 从已授权 OSS Bucket 批量导入文件 | 5 次/秒 | +| DescribeFile | 查询文件基本信息（名称、类型、状态等） | 10 次/秒 | +| ListFile | 分页查询指定类目下的文件列表 | 5 次/秒 | +| UpdateFileTag | 更新单个文件的标签 | 5 次/秒 | +| BatchUpdateFileTag | 批量更新文件标签 | 5 次/秒 | +| DeleteFile | 删除单个文件 | 5 次/秒 | +| DeleteFiles | 批量删除文件 | 5 次/秒 | + +AddFile 接口的 `Parser` 参数支持以下解析器类型： +- `DOCMIND`（智能文档解析） +- `DOCMIND_DIGITAL`（电子文档解析） +- `DOCMIND_LLM_VERSION`（大模型文档解析） +- `DASH_QWEN_VL_PARSER`（Qwen VL 解析） +- `DOCMIND_LLM_VERSION_MEDIA`（音视频解析） +- `AUTO_SELECT`（自动选择解析器） ### 解析设置 -控制文件在知识库中的解析方式。 - | API | 说明 | -| --- | --- | +|-----|------| | GetParseSettings | 获取类目的解析设置 | -| GetAvailableParserTypes | 获取文件支持的解析器类型列表 | +| GetAvailableParserTypes | 获取指定文件支持的解析器类型列表 | | ChangeParseSetting | 修改类目的解析设置 | ### 表格与连接器 | API | 说明 | -| --- | --- | -| AddTable | 添加表格数据 | +|-----|------| +| AddTable | 添加表格 | | UpdateTableFromAuthorizedOss | 从已授权 OSS Bucket 更新表格 | -| AddConnector | 新增连接器（当前仅支持文件类型），限流 5 次/秒 | -| GetConnector | 获取连接器信息 | -| UpdateConnector | 编辑连接器配置 | +| AddConnector | 新增连接器 | +| GetConnector | 获取连接器信息（当前仅支持文件连接器） | +| UpdateConnector | 编辑连接器名称和描述 | -## 知识库管理 +连接器的 `StorageType` 支持 `OSS_CUSTOM`（自有 OSS 存储）和 `OSS_PLATFORM`（平台 OSS 存储）。 -知识库是百炼 RAG 能力的核心组件，支持非结构化（文档/音视频）和结构化（数据查询/图片问答）两类知识库。完整的知识库 API 使用指南请参考[API概览](../../raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-overview.md)。 +## Prompt 工程 -### 创建流程 +Prompt 模板 API 支持对 Prompt 模板的完整 CRUD 操作。模板内容支持变量占位符（如 `${theme}`），系统会自动提取变量列表。详见[CreatePromptTemplate - 创建Prompt模板](../../raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-prompt-engineering/api-bailian-2023-12-29-createprompttemplate.md)。 -知识库创建是异步流程，需要按以下步骤操作： +| API | 方法 | 说明 | +|-----|------|------| +| CreatePromptTemplate | POST | 创建模板（暂不支持文生图模板） | +| GetPromptTemplate | GET | 按模板 ID 获取详情 | +| UpdatePromptTemplate | PATCH | 增量更新模板名称或内容 | +| DeletePromptTemplate | DELETE | 按模板 ID 删除 | +| ListPromptTemplates | GET | 分页查询模板列表，支持按名称和类型（System/Custom）过滤 | -1. **CreateIndex** — 初始化知识库，指定名称、类型、切片策略等配置。此接口不具备幂等性，重复调用会创建多个同名知识库 -2. **SubmitIndexJob** — 提交创建任务，开始实际的文档解析和索引构建。高峰期可能耗时数小时 -3. **GetIndexJobStatus** — 轮询任务状态（建议间隔 5 秒以上） +## 知识库 -### 文档追加 +知识库 API 是百炼 RAG 能力的核心，覆盖知识库的创建、数据导入、检索、文件与切片管理全流程。 -对已有知识库追加文件使用 `SubmitIndexAddDocumentsJob`，需先通过 `AddFile` 上传文件。该接口不支持数据查询/图片问答类知识库。 +### 知识库生命周期 -### 检索 +创建知识库的典型流程为：CreateIndex -> SubmitIndexJob -> 轮询 GetIndexJobStatus 直到完成。详见[CreateIndex - 创建知识库](../../raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-knowledge-base/api-bailian-2023-12-29-createindex.md)。 -`Retrieve` 接口用于在指定知识库中检索信息，支持通过百炼 SDK（配合 AccessKey）或 Spring AI Alibaba（配合 API-Key）两种方式调用。该接口响应时间可能较长，建议合理设置超时与重试策略。 +| API | 说明 | 限流 | +|-----|------|------| +| CreateIndex | 创建知识库（非结构化或结构化），不具幂等性 | 10 次/秒 | +| SubmitIndexJob | 提交知识库创建任务，必须在 CreateIndex 后调用 | 10 次/秒 | +| SubmitIndexAddDocumentsJob | 向已有知识库追加文件（不支持数据查询/图片问答类） | 10 次/秒 | +| GetIndexJobStatus | 查询任务状态，调用间隔建议 5 秒以上 | - | +| UpdateIndex | 更新知识库配置（名称、描述、检索参数等） | - | +| ListIndices | 分页查询业务空间下的知识库列表 | 10 次/秒 | +| DeleteIndex | 永久删除知识库（不可逆，不删除源文件） | 10 次/秒 | +| GetIndexMonitor | 获取知识库监控数据 | - | -### 知识库配置与管理 +> **注意**：CreateIndex 仅初始化知识库，必须后续调用 SubmitIndexJob 才能完成创建，否则将得到空知识库。CreateIndex 不具幂等性，重复调用会创建多个同名知识库。 -| API | 说明 | -| --- | --- | -| UpdateIndex | 更新知识库配置（名称、描述、检索参数、规格类型等） | -| ListIndices | 获取[业务空间](../concepts/workspace.md)下的知识库列表 | -| DeleteIndex | 永久删除知识库（不可逆，需先解除应用关联） | -| ListIndexFileDetails | 查询知识库下的文件详情 | -| ListIndexDocuments | 查询知识库下的文件列表 | -| DeleteIndexDocument | 删除知识库中的指定文件 | -| GetIndexMonitor | 获取知识库监控数据 | +UpdateIndex 支持调整检索参数： +- `DenseSimilarityTopK`：向量检索 Top K，范围 [0-100]，默认 100 +- `SparseSimilarityTopK`：关键词检索 Top K，范围 [0-100]，默认 100 +- 两者之和不超过 200 +- `RerankMinScore`：排序最低分数，范围 [0-1] +- `PipelineCommercialType`：知识库规格（standard / enterprise） -### 切片管理 +### 知识库检索 + +Retrieve 接口用于在指定知识库中检索信息，支持通过百炼 SDK（AccessKey 鉴权）或 Spring AI Alibaba（API-Key 鉴权）调用。接口具有幂等性，但因包含复杂检索逻辑，响应时间可能较长，建议合理设置超时和重试策略。详见[Retrieve - 检索知识库](../../raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-knowledge-base/api-bailian-2023-12-29-retrieve.md)。 + +### 文件与切片管理 | API | 说明 | -| --- | --- | -| ListChunks | 查询文本切片列表（文档搜索类按文件查询，数据查询类获取全部） | +|-----|------| +| ListIndexFileDetails | 查询知识库中文件的详细信息，支持按状态和名称过滤 | +| ListIndexDocuments | 查询知识库中文件的概要信息 | +| DeleteIndexDocument | 从知识库中删除指定文件 | +| ListChunks | 查询文件的切片列表（文档搜索类查指定文件，数据查询类查全部） | | UpdateChunk | 修改切片内容和标题（仅支持文档搜索类知识库） | | DeleteChunk | 删除指定切片 | -知识库检索的关键参数包括： -- **DenseSimilarityTopK**：向量检索 Top K，范围 0-100，默认 100 -- **SparseSimilarityTopK**：关键词检索 Top K，范围 0-100，默认 100 -- 两者之和不超过 200 -- **RerankMinScore**：排序最低分数，范围 0-1 +文件导入状态包括：`RUNNING`（构建中）、`FINISH`（成功）、`INSERT_ERROR`（导入失败）、`PARSE_FAILED`（解析失败）、`DOC_PARSING`（解析中）、`DELETED`（已删除）。 -## Prompt 模板管理 +## 长期记忆 -Prompt 模板支持创建、查询、更新、删除和列表操作，用于管理和复用 Prompt 工程成果。 +长期记忆 API 用于管理智能体的记忆能力，包括记忆体（Memory）和记忆片段（MemoryNode）两个层级。 | API | 说明 | -| --- | --- | -| CreatePromptTemplate | 创建 Prompt 模板（暂不支持文生图类型） | -| GetPromptTemplate | 获取指定 Prompt 模板详情 | -| UpdatePromptTemplate | 更新 Prompt 模板内容 | -| DeletePromptTemplate | 删除指定 Prompt 模板 | -| ListPromptTemplates | 获取 Prompt 模板列表 | - -## 其他接口 +|-----|------| +| CreateMemory | 创建长期记忆体 | +| GetMemory | 获取记忆体详情 | +| UpdateMemory | 更新记忆体 | +| DeleteMemory | 删除记忆体 | +| ListMemories | 查询记忆体列表 | +| CreateMemoryNode | 创建记忆片段 | +| GetMemoryNode | 获取记忆片段详情 | +| UpdateMemoryNode | 更新记忆片段 | +| DeleteMemoryNode | 删除记忆片段 | +| ListMemoryNodes | 查询记忆片段列表 | + +## 其他 | API | 说明 | -| --- | --- | +|-----|------| | ApplyTempStorageLease | 申请临时文件上传许可 | | GetAlipayTransferStatus | 查询支付宝打赏状态 | | GetAlipayUrl | 获取支付宝打赏 URL | -## 通用限制与注意事项 +## 通用注意事项 -- **限流**：大部分接口限流为 10 次/秒，连接器相关接口为 5 次/秒。遇到限流请稍后重试 -- **幂等性**：查询类接口（如 GetIndexJobStatus、Retrieve、ListIndices）通常具有幂等性；创建类接口（如 CreateIndex、SubmitIndexJob）不具备幂等性，需注意避免重复调用 -- **异步操作**：知识库创建和追加文档为异步操作，通过 GetIndexJobStatus 轮询状态，GetIndexJobStatus 限流 20 次/分钟 -- **版本演进**：API 持续迭代中，最新变更包括 CreateIndex 入参调整（2026-03-30）、UpdateIndex 新增（2026-01-19）等，详见[版本说明](../../raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-changeset.md) -- **删除操作不可逆**：DeleteIndex、DeleteCategory 等删除操作为永久性删除，请谨慎操作 +- 所有接口均需 `WorkspaceId` 路径参数，获取方式参见业务空间文档 +- 建议使用官方 SDK 调用而非自签名，自签名对接复杂度高（约需 5 个工作日） +- 分页查询使用 `NextToken` / `MaxResults` 模式（部分接口使用 `PageNumber` / `PageSize`） +- 各接口限流频率为 5-15 次/秒不等，触发限流后需等待后重试 +- 版本变更历史可查看[版本说明](../../raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-changeset.md)，近期变更包括 CreateIndex 入参调整、UpdateIndex 新增、GetIndexMonitor 新增等 ## 来源文档 @@ -210,9 +222,3 @@ Prompt 模板支持创建、查询、更新、删除和列表操作，用于管 - [ListMemoryNodes - 获取记忆片段列表](../../raw/application-api-reference/application-component-api-reference/api-bailian-2023-12-29-dir/api-bailian-2023-12-29-dir-others/api-bailian-2023-12-29-dir-long-term-memory/api-bailian-2023-12-29-listmemorynodes.md) - - - - - - diff --git a/skills/bailian-docs-llm-wiki/wiki/api/file-management-api.md b/skills/bailian-docs-llm-wiki/wiki/api/file-management-api.md index e395064..36da301 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/file-management-api.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/file-management-api.md @@ -31,3 +31,4 @@ - [文件管理](../../raw/model-api-reference/file-management-api.md) + diff --git a/skills/bailian-docs-llm-wiki/wiki/api/frameworks.md b/skills/bailian-docs-llm-wiki/wiki/api/frameworks.md index 8eeead4..506708a 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/frameworks.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/frameworks.md @@ -143,3 +143,4 @@ this.chatClient = builder + diff --git a/skills/bailian-docs-llm-wiki/wiki/api/image-generation.md b/skills/bailian-docs-llm-wiki/wiki/api/image-generation.md index e439af6..74559ff 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/image-generation.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/image-generation.md @@ -140,7 +140,7 @@ GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id} - **新加坡**：支持部分模型（千问、万相文生图V2、Z-Image等）。域名：`https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com` - **美国（弗吉尼亚）**：支持部分模型。域名：`https://dashscope-us.aliyuncs.com` -> **注意**：不同地域拥有独立的API Key与请求地址，不可混用，跨地域调用将导致鉴权失败。创意工具类模型（人像风格重绘、虚拟模特、AI试衣等）大多仅在华北2（北京）地域可用。 +> **注意**：不同地域拥有独立的[API Key](../concepts/api-key.md)与请求地址，不可混用，跨地域调用将导致鉴权失败。创意工具类模型（人像风格重绘、虚拟模特、AI试衣等）大多仅在华北2（北京）地域可用。 ## 计费与限流 @@ -154,7 +154,7 @@ GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id} - **图片下载失败**（`BadRequest.InputDownloadFailed`）：输入图片URL无法访问，需确保URL完整且支持公网访问，建议上传至OSS等云存储。 - **任务创建curl执行失败**：Windows环境下`curl`转义规则与Linux/macOS不同，建议使用Postman等工具或按Windows语法调整命令。 -- **鉴权失败**：检查是否使用了正确地域的API Key，不同地域的Key不可混用。 +- **鉴权失败**：检查是否使用了正确地域的[API Key](../concepts/api-key.md)，不同地域的Key不可混用。 - **余额不足**：免费额度用尽后需在阿里云控制台充值，或检查模型是否为"仅免费体验"状态。 ## 来源文档 @@ -186,3 +186,4 @@ GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id} - [创意文字WordArt锦书](../../raw/model-api-reference/image-generation/image-creative-tools-api-reference/wordart-quick-start.md) + diff --git a/skills/bailian-docs-llm-wiki/wiki/api/knowledge.md b/skills/bailian-docs-llm-wiki/wiki/api/knowledge.md index ae6f8d3..a534c11 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/knowledge.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/knowledge.md @@ -1,6 +1,6 @@ # knowledge -百炼平台「知识检索与问答」相关的 HTTP REST API 概览，提供跨知识库语义检索与基于知识库的智能问答两个接口。这两个接口属于 DashScope 应用网关体系，通过 API Key Bearer 鉴权调用，与 `CreateIndex`、`Retrieve` 等 OpenAPI RPC 接口不同。详见 [知识检索与问答](../../raw/application-api-reference/knowledge.md)。 +百炼平台「知识检索与问答」相关的 HTTP REST API 概览，提供跨知识库语义检索与基于知识库的智能问答两个接口。这两个接口属于 DashScope 应用网关体系，通过 [API Key](../concepts/api-key.md) Bearer 鉴权调用，与 `CreateIndex`、`Retrieve` 等 OpenAPI RPC 接口不同。详见 [知识检索与问答](../../raw/application-api-reference/knowledge.md)。 ## 接口列表 @@ -17,7 +17,7 @@ https://{workspaceId}.cn-beijing.maas.aliyuncs.com ``` -其中 `{workspaceId}` 为[业务空间](../concepts/workspace.md) ID。API Key 在控制台 [API Key 页面](https://rag.console.aliyun.com/settings/apikey) 获取，[业务空间](../concepts/workspace.md) ID 在控制台 [业务空间管理](https://bailian.console.aliyun.com/cn-beijing?tab=globalset#/efm/business_management) 获取。 +其中 `{workspaceId}` 为[业务空间](../concepts/workspace.md) ID。[API Key](../concepts/api-key.md) 在控制台 [API Key 页面](https://rag.console.aliyun.com/settings/apikey) 获取，[业务空间](../concepts/workspace.md) ID 在控制台 [业务空间管理](https://bailian.console.aliyun.com/cn-beijing?tab=globalset#/efm/business_management) 获取。 ## 限流 @@ -28,14 +28,14 @@ https://{workspaceId}.cn-beijing.maas.aliyuncs.com 知识检索与问答接口属于 **DashScope 应用网关** 体系，与 OpenAPI（如 `CreateIndex`、`ListIndices`、`Retrieve` 等 RPC 接口）不同： - 调用方式：HTTP REST，而非 RPC 风格 -- 鉴权方式：API Key Bearer -- Base URL：使用业务空间 ID 拼接的专属域名 +- 鉴权方式：[API Key](../concepts/api-key.md) Bearer +- Base URL：使用[业务空间](../concepts/workspace.md) ID 拼接的专属域名 ## 使用建议 - 知识检索接口适合需要自定义生成流程的场景：拿到排序后的切片后，自行拼接 [prompt](../guides/prompt.md) 调用大模型。 - 知识问答接口适合开箱即用的问答场景：服务端自动完成规划、检索、生成，通过 SSE 流式返回三个阶段的结果。 -- 调用前确认 API Key 与业务空间 ID 已正确配置，详见 [知识检索与问答](../../raw/application-api-reference/knowledge.md)。 +- 调用前确认 API Key 与[业务空间](../concepts/workspace.md) ID 已正确配置，详见 [知识检索与问答](../../raw/application-api-reference/knowledge.md)。 ## 来源文档 @@ -47,3 +47,4 @@ https://{workspaceId}.cn-beijing.maas.aliyuncs.com + diff --git a/skills/bailian-docs-llm-wiki/wiki/api/long-term-memory-new.md b/skills/bailian-docs-llm-wiki/wiki/api/long-term-memory-new.md index 5321ab9..40dc0a7 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/long-term-memory-new.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/long-term-memory-new.md @@ -221,3 +221,4 @@ asyncio.run(add_memory_example()) + diff --git a/skills/bailian-docs-llm-wiki/wiki/api/managed-agents-api.md b/skills/bailian-docs-llm-wiki/wiki/api/managed-agents-api.md index dedbd0c..c4851e6 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/managed-agents-api.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/managed-agents-api.md @@ -27,7 +27,7 @@ https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio Authorization: Bearer ``` -API Key 通过百炼控制台获取，一个 Key 可访问其归属工作空间下的全部资源。每次响应携带 `x-request-id` 头，提工单时附上此 ID 可加速定位。 +[API Key](../concepts/api-key.md) 通过百炼控制台获取，一个 Key 可访问其归属工作空间下的全部资源。每次响应携带 `x-request-id` 头，提工单时附上此 ID 可加速定位。 ## 主要 API 端点 @@ -133,3 +133,4 @@ Managed Agents 模块通过 [DashScope SDK](../concepts/dashscope-sdk.md) 接入 - [快速开始](../../raw/application-api-reference/managed-agents-api/managed-agents-quickstart.md) + diff --git a/skills/bailian-docs-llm-wiki/wiki/api/model-production.md b/skills/bailian-docs-llm-wiki/wiki/api/model-production.md index f2c97e0..679f936 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/model-production.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/model-production.md @@ -35,3 +35,4 @@ - [模型部署](../../raw/model-api-reference/model-production/deployments-api.md) + diff --git a/skills/bailian-docs-llm-wiki/wiki/api/more-about-models.md b/skills/bailian-docs-llm-wiki/wiki/api/more-about-models.md index 8277528..0ad5d94 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/more-about-models.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/more-about-models.md @@ -2,9 +2,9 @@ 阿里云百炼在模型调用的核心流程之外，提供了一系列辅助能力，涵盖安全认证、异步任务管理、文件上传、子[业务空间](../concepts/workspace.md)隔离以及高并发场景下的连接优化。本文汇总这些进阶用法的关键要点，帮助开发者在生产环境中安全、高效地使用模型服务。 -## 临时 API Key +## 临时 [API Key](../concepts/api-key.md) -在浏览器或移动端等不可信环境中，直接暴露永久 API Key 存在安全风险。百炼提供了[生成临时API Key](../../raw/model-api-reference/more-about-models/generate-temporary-api-key.md)的接口，通过后端服务生成有限时效的临时凭证。 +在浏览器或移动端等不可信环境中，直接暴露永久 [API Key](../concepts/api-key.md) 存在安全风险。百炼提供了[生成临时API Key](../../raw/model-api-reference/more-about-models/generate-temporary-api-key.md)的接口，通过后端服务生成有限时效的临时凭证。 **请求方式**： @@ -13,7 +13,7 @@ POST https://dashscope.aliyuncs.com/api/v1/tokens?expire_in_seconds= ``` - `expire_in_seconds`：有效期，范围 [1, 1800] 秒，默认 60 秒。 -- 返回的 `token` 字段即为临时 API Key，`expires_at` 为 UNIX 过期时间戳。 +- 返回的 `token` 字段即为临时 [API Key](../concepts/api-key.md)，`expires_at` 为 UNIX 过期时间戳。 - 临时 API Key 继承生成它的永久 API Key 的全部权限，到期后自动失效，无法手动删除。 > **注意**：各地域的 API Key 不同，新加坡地域需将 Endpoint 中的 WorkspaceId 替换为实际值。 @@ -67,7 +67,7 @@ POST https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}/cancel **使用要点**： -- 必须使用子业务空间自身的 API Key 进行调用。 +- 必须使用子[业务空间](../concepts/workspace.md)自身的 API Key 进行调用。 - 调用标准模型（如 `qwen-plus`）前，需为该空间设置模型调用权限。 - 调用在百炼上调优并部署的模型无需额外授权，但仅能由其所在空间的 API Key 调用。 - 支持 OpenAI 兼容方式和 DashScope 方式调用，但调优后模型仅支持 DashScope 方式。 @@ -117,3 +117,4 @@ POST https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}/cancel - [DashScope SDK连接复用配置](../../raw/model-api-reference/more-about-models/connection-multiplexing-configuration.md) + diff --git a/skills/bailian-docs-llm-wiki/wiki/api/more-models.md b/skills/bailian-docs-llm-wiki/wiki/api/more-models.md index bcbd64e..13f1128 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/more-models.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/more-models.md @@ -132,3 +132,4 @@ completion = client.chat.completions.create( + diff --git a/skills/bailian-docs-llm-wiki/wiki/api/more.md b/skills/bailian-docs-llm-wiki/wiki/api/more.md index 9ec9824..5e2a759 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/more.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/more.md @@ -103,7 +103,7 @@ resp = client.retrieve('请传入实际的业务空间ID', retrieve_request) ## 限制与注意事项 -- 临时 API Key 无法手动删除，只能等 TTL 到期自动失效；各地域 API Key 不互通。 +- 临时 [API Key](../concepts/api-key.md) 无法手动删除，只能等 TTL 到期自动失效；各地域 [API Key](../concepts/api-key.md) 不互通。 - 服务关联角色由百炼自动创建并绑定固定系统策略，不可修改、不可授予其他 RAM 身份；删除前必须先解除对应功能的依赖资源，否则相关功能将不可用。 - SearchFilters 子分组之间为 AND 语义且不可更改；多值 / 范围 / 模糊 / 标签查询的值需通过 `json.dumps` 序列化为字符串后传入；标签查询仅支持文档搜索与音视频搜索类知识库。 - 子账号只能操作已加入[业务空间](../concepts/workspace.md)中的知识库，主账号可操作所有[业务空间](../concepts/workspace.md)。 @@ -125,3 +125,4 @@ resp = client.retrieve('请传入实际的业务空间ID', retrieve_request) + diff --git a/skills/bailian-docs-llm-wiki/wiki/api/omni-realtime-api.md b/skills/bailian-docs-llm-wiki/wiki/api/omni-realtime-api.md index 6b5a329..fa0f8fb 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/omni-realtime-api.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/omni-realtime-api.md @@ -227,3 +227,4 @@ Qwen-Omni-Realtime API 是百炼平台提供的实时[多模态](../concepts/mul + diff --git a/skills/bailian-docs-llm-wiki/wiki/api/preparations.md b/skills/bailian-docs-llm-wiki/wiki/api/preparations.md index a217ff3..6c71a35 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/preparations.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/preparations.md @@ -4,14 +4,14 @@ ## 获取与配置 [API Key](../concepts/api-key.md) -[API Key](../concepts/api-key.md) 是调用百炼服务的唯一鉴权凭证。您需要通过百炼控制台创建 API Key，详细步骤参见[获取API Key](../../raw/model-api-reference/preparations/get-api-key.md)。 +[API Key](../concepts/api-key.md) 是调用百炼服务的唯一鉴权凭证。您需要通过百炼控制台创建 [API Key](../concepts/api-key.md)，详细步骤参见[获取API Key](../../raw/model-api-reference/preparations/get-api-key.md)。 -### 创建 API Key +### 创建 [API Key](../concepts/api-key.md) - 操作权限要求：需使用主账号，或具备`管理员`或`API-Key`页面权限的子账号。 - 不同地域的控制台入口不同：华北2（北京）、新加坡、日本（东京）、德国（法兰克福）使用 `bailian.console.aliyun.com`；美国（弗吉尼亚）使用 `modelstudio.console.aliyun.com`。 - 创建时可选择归属[业务空间](../concepts/workspace.md)（建议选默认空间），并配置权限（全部或自定义 IP 白名单 + 模型范围）。 -- 升级后新创建的 API Key 以 `sk-ws` 开头，仅在创建时展示一次明文，关闭弹窗后无法再次查看。请立即复制保存。 +- 升级后新创建的 [API Key](../concepts/api-key.md) 以 `sk-ws` 开头，仅在创建时展示一次明文，关闭弹窗后无法再次查看。请立即复制保存。 ### 权限与时效 @@ -109,3 +109,4 @@ + diff --git a/skills/bailian-docs-llm-wiki/wiki/api/qwen-api-reference.md b/skills/bailian-docs-llm-wiki/wiki/api/qwen-api-reference.md index bd4ec51..1f1b371 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/qwen-api-reference.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/qwen-api-reference.md @@ -42,3 +42,4 @@ + diff --git a/skills/bailian-docs-llm-wiki/wiki/api/toolkits-and-frameworks.md b/skills/bailian-docs-llm-wiki/wiki/api/toolkits-and-frameworks.md index bdf6cba..7c6d08f 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/toolkits-and-frameworks.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/toolkits-and-frameworks.md @@ -210,3 +210,4 @@ + diff --git a/skills/bailian-docs-llm-wiki/wiki/api/vector-and-sort.md b/skills/bailian-docs-llm-wiki/wiki/api/vector-and-sort.md index df5cd01..c2f99f0 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/vector-and-sort.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/vector-and-sort.md @@ -97,3 +97,4 @@ + diff --git a/skills/bailian-docs-llm-wiki/wiki/api/video-generation-api.md b/skills/bailian-docs-llm-wiki/wiki/api/video-generation-api.md index 683ee2d..b476ddb 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/video-generation-api.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/video-generation-api.md @@ -11,7 +11,7 @@ ### 地域与域名 -- 必须保证模型、Endpoint URL、API Key 属于**同一地域**，跨地域调用会失败。 +- 必须保证模型、Endpoint URL、[API Key](../concepts/api-key.md) 属于**同一地域**，跨地域调用会失败。 - 华北2（北京）、新加坡地域推荐使用[业务空间](../concepts/workspace.md)专属域名以获得更好性能与稳定性： - 北京：`https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com` - 新加坡：`https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com` @@ -19,7 +19,7 @@ ### 鉴权 -统一使用 `Authorization: Bearer $DASHSCOPE_API_KEY`，API Key 通过环境变量配置。详见 [获取 API Key](https://help.aliyun.com/zh/model-studio/get-api-key)。 +统一使用 `Authorization: Bearer $DASHSCOPE_API_KEY`，[API Key](../concepts/api-key.md) 通过环境变量配置。详见 [获取 API Key](https://help.aliyun.com/zh/model-studio/get-api-key)。 ## 模型与能力总览 @@ -131,7 +131,7 @@ curl -X GET "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{ta - **异步与超时**：单任务 1–5 分钟，建议轮询间隔 1–5 秒，设置合理超时与重试。 - **输入资源**：图片/视频 URL 必须可公网访问；建议使用百炼同地域 OSS 或公网 CDN，避免因网络不通导致 `InputDownloadError`。 -- **地域一致性**：模型、endpoint、API Key 必须同地域。 +- **地域一致性**：模型、endpoint、[API Key](../concepts/api-key.md) 必须同地域。 - **内容安全**：所有请求经过内容安全审核，违规内容会被拒绝；输入文本与图片均会校验。 - **配额与计费**：按生成视频时长（秒）或次数计费，不同模型单价不同；高并发请关注 QPS 配额，必要时提工单申请。 - **legacy 接口**：文档中 `legacy-*` 系列（如 `legacy-wan-text-to-video`、`legacy-wanx-vace`）为旧版接口，建议迁移至万相 2.7 新接口以获得更好效果与稳定性。 @@ -179,3 +179,4 @@ curl -X GET "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{ta + diff --git a/skills/bailian-docs-llm-wiki/wiki/comparisons/app-eval-vs-model-eval.md b/skills/bailian-docs-llm-wiki/wiki/comparisons/app-eval-vs-model-eval.md new file mode 100644 index 0000000..b3a96d1 --- /dev/null +++ b/skills/bailian-docs-llm-wiki/wiki/comparisons/app-eval-vs-model-eval.md @@ -0,0 +1,70 @@ +# 应用评测与模型评测对比 + +百炼平台提供应用评测和模型评测两套独立的评测体系，分别面向不同的评测对象和使用场景。应用评测聚焦于智能体应用和工作流应用的端到端输出质量，覆盖 RAG 链路的各个环节；模型评测则聚焦于大语言模型本身的推理能力，用于模型选型和基础能力基准测试。理解两者的定位差异，有助于开发者在不同阶段选择合适的评测工具。 + +## 关键维度对比 + +| 对比维度 | 应用评测 | 模型评测 | +|---------|---------|---------| +| **评测对象** | 智能体应用、工作流应用（已发布） | 文本生成类大模型 | +| **核心目标** | 评估应用端到端输出质量，定位 RAG 链路问题 | 评估模型推理能力，辅助模型选型与调优验证 | +| **评测方式** | 自动评测（单应用/多应用横向）、手动评测 | 自定义评测（AI/规则/人工）、基线评测 | +| **评测集来源** | 基于知识库自动生成，或手动上传（xls/xlsx/jsonl） | 手动上传评测数据集（Prompt + Completion），或使用公开基线数据集 | +| **评估机制** | 新版：评估器（LLM/Code）+ 标签；旧版：内置评分模型 | 评测维度（大模型评估/规则评估/人工评估） | +| **自动评分方式** | LLM 评估器（语义理解）、Code 评估器（规则判断） | 裁判模型打分（数值型/分类型）、规则评估（ROUGE/BLEU/Cosine 等） | +| **人工标注** | 旧版手动评测；新版通过标签体系支持 | 人工评估维度（Pass/Fail 标注） | +| **横向对比能力** | 多应用横向评测（最多 8 个应用） | 排行榜（相同维度下对比多个模型） | +| **归因分析** | 支持（模型理解有误/重排不佳/检索无效/切片不完整/未获取知识） | 不支持链路归因，仅提供维度评分明细 | +| **前提条件** | 应用已发布、已配置知识库、已开通应用观测 | 无特殊前提，上传数据集即可 | +| **支持的评分模型** | 评测集生成和评估仅支持 qwen-max、qwen-plus | 裁判模型推荐千问-Max，可选其他模型 | +| **基线能力评测** | 不支持 | 支持（C-Eval、MMLU、ARC、GSM8K、BBH、HellaSwag） | +| **版本管理** | 新版评测集支持版本管理 | 不支持评测集版本管理 | +| **操作入口** | 控制台（应用管理模块） | 控制台（模型管理模块） | +| **API/SDK 支持** | 通过应用调用间接支持 | 不提供公开 API/SDK，仅控制台操作 | +| **地域限制** | 无特殊地域限制 | 基线评测仅北京地域可用 | + +## 评测数据与评分体系对比 + +| 对比项 | 应用评测 | 模型评测 | +|-------|---------|---------| +| **数据集类型** | 旧版：对话分析（xls）、知识问答（jsonl）；新版：智能体/工作流/自定义 | 评测数据集（Prompt + Completion）、推理结果集 | +| **评分输出** | 1-5 分制（正确率 = 得分 >= 4 的占比） | 自定义评分范围（如 0-5）+ 通过阈值 | +| **结果分析** | 总正确率、BadCase 分析、调优建议、RAG 评价 | 综合得分、通过率、分数分布、逐样本明细 | +| **评估器/维度上限** | 每个任务最多 10 个评估器 | 无明确数量限制 | + +## 计费对比 + +| 对比项 | 应用评测 | 模型评测 | +|-------|---------|---------| +| **费用构成** | 评测集生成 [Token](../concepts/token.md) + 评估模型 [Token](../concepts/token.md) | 被评测模型推理 [Token](../concepts/token.md) + 裁判模型评分 Token | +| **免费方式** | 评估器模型当前限时免费 | 规则评估无裁判模型费用；已部署调优模型不额外计费 | +| **成本优化** | 合理控制评测集规模 | 先小规模验证（50-100 条）→ 保存推理结果集复用 → 优先规则评估 | + +## 适用场景建议 + +**选择应用评测的场景：** + +- 已构建完整的 RAG 智能体应用，需要评估端到端回答质量 +- 需要定位问题环节（模型理解、检索、重排、切片、知识库内容） +- 对多个应用版本进行 A/B 对比，验证迭代效果 +- 知识库更新、Prompt 调整、检索策略变更后的回归测试 +- 需要将人工标注经验固化为自动化评估规则（评估器） + +**选择模型评测的场景：** + +- 项目初期进行模型选型，对比多个候选模型的基础能力 +- 使用公开基准数据集（C-Eval、MMLU 等）快速了解模型水平 +- 模型微调后验证调优效果 +- 翻译、摘要、NL2SQL 等有确定性评判标准的任务，优先用规则评估降低成本 +- 需要在排行榜上持续跟踪模型表现 + +**组合使用建议：** + +在实际项目中，两种评测往往互补使用。典型流程是先通过模型评测筛选出基础能力最优的候选模型，再将其集成到应用中，通过应用评测验证端到端效果并持续优化 RAG 链路。模型评测解决"哪个模型更好"的问题，应用评测解决"应用整体表现如何优化"的问题。 + +## 被对比主题页 + +- [application evaluation](../guides/application-evaluation.md) +- [model evaluation introduction](../guides/model-evaluation-introduction.md) + + diff --git a/skills/bailian-docs-llm-wiki/wiki/comparisons/app-monitoring-vs-model-monitoring.md b/skills/bailian-docs-llm-wiki/wiki/comparisons/app-monitoring-vs-model-monitoring.md new file mode 100644 index 0000000..c8136a1 --- /dev/null +++ b/skills/bailian-docs-llm-wiki/wiki/comparisons/app-monitoring-vs-model-monitoring.md @@ -0,0 +1,70 @@ +# 应用监控与模型监控对比 + +百炼平台提供两种互补的可观测性能力：**应用观测**和**模型监控**。应用观测聚焦于应用内部的端到端调用链路追踪，帮助开发者理解智能体应用、工作流应用的执行过程；模型监控则聚焦于模型调用层面的运行状态与成本管理，提供用量统计、性能指标、日志审计和主动告警。两者分别从"应用维度"和"模型维度"保障系统的可观测性，开发者通常需要同时使用。 + +## 关键维度对比 + +| 对比维度 | 应用观测 | 模型监控 | +| --- | --- | --- | +| **监控对象** | 应用（智能体应用、工作流应用、高代码应用） | 模型（大语言模型、视觉模型、语音模型、向量模型等） | +| **核心目标** | 追踪应用内部调用链路，优化运营效果与成本 | 监控模型运行状态与用量，保障稳定性与成本可控 | +| **数据维度** | 按应用 + [业务空间](../concepts/workspace.md) | 按模型 + [业务空间](../concepts/workspace.md) | +| **数据刷新频率** | 分钟级 | 普通监控：小时级；高级监控：分钟级 | +| **数据保留期** | 最长 30 天 | 普通用量最长 30 天，更早需查账单 | +| **支持的应用/模型范围** | 智能体应用、工作流应用、高代码应用（不支持 Assistant API 创建的智能体应用） | 所有模型均支持用量统计；普通监控支持全地域全模型；高级监控限北京、新加坡、弗吉尼亚 | +| **链路追踪** | 支持（CHAIN、AGENT、LLM、RETRIEVER、TOOL 等多节点类型，可展开查看嵌套调用） | 不支持应用级链路追踪，仅记录单次模型调用 | +| **关键指标** | 调用次数/失败率、[Token](../concepts/token.md) 总量（输入/输出）、平均单次请求 [Token](../concepts/token.md) 量、平均首 [Token](../concepts/token.md) 耗时、平均调用时长 | 调用总量/失败量/失败率、平均调用时长、平均首包时长、RPM、TPM、限流错误次数(429)、内容安全错误次数 | +| **监控分类** | 无分类，统一展示性能与调用指标 | 四类：安全、成本、性能、错误 | +| **告警能力** | 不支持 | 支持主动告警（仅北京、新加坡地域），可设置超时、Token 消耗突增等阈值 | +| **日志/历史对话** | 支持查看 Prompt 内容、输出、延时等完整调用记录 | 支持推理日志和历史对话记录（仅北京地域部分模型，需手动开通） | +| **Token 消耗追踪** | 按 Span 节点记录 Token 消耗 | 三层管理：汇总统计、单次调用追踪、阈值告警 | +| **数据筛选** | 按状态、Span Name、输入/输出内容、延时、Token 量、标签等多维筛选；支持 Request ID / Trace ID / Span ID 检索 | 按 API-KEY、推理类型、时间范围、时间精度筛选 | +| **数据标注** | 支持（布尔值/分类/数字/文本四种标签类型，与评测共享） | 不支持 | +| **导入评测集** | 支持将 Span 数据直接加入评测集作为评测样本 | 不支持 | +| **数据导出** | 支持导出为 JSONL 或 EXCEL | 不支持直接导出，需通过费用与成本页面查询 | +| **费用管理** | 不提供费用管理功能 | 提供费用概览、账单趋势、免费额度管理及用完即停开关 | +| **计费** | 功能本身免费，OpenTelemetry 存储费用另计 | 功能本身免费，高级监控可能涉及额外费用 | +| **开通方式** | 控制台手动开通（授权 OpenTelemetry 服务角色 + 开通服务 + 初始化 LogStore） | 系统自动采集（普通监控）；高级监控和日志需手动开通 | +| **API 支持** | 无 API，仅控制台操作 | 无专用 API，仅控制台操作 | +| **地域限制** | 无明确地域限制 | 普通监控无限制；高级监控限北京/新加坡/弗吉尼亚；告警限北京/新加坡；日志限北京 | + +## 适用场景建议 + +### 应用观测适用于 + +- **调试应用内部逻辑**：需要查看智能体应用或工作流应用的完整调用链路，定位某个节点（如检索、模型推理、插件调用）的异常或性能瓶颈。 +- **优化 RAG 效果**：通过 RETRIEVER、REWRITER、RERANKER 等节点的详细数据，分析检索召回质量和排序效果。 +- **构建评测数据集**：将线上真实调用数据标注后导入评测集，用于持续优化应用效果。 +- **应用级性能分析**：关注单个应用的整体调用时长、Token 消耗趋势，评估应用的运营效率。 + +### 模型监控适用于 + +- **模型稳定性保障**：监控模型调用的失败率、限流错误(429)、内容安全错误等，及时发现异常。 +- **成本核算与控制**：按模型、按[业务空间](../concepts/workspace.md)统计 Token/图片/视频的用量与费用，管理免费额度。 +- **主动告警**：对关键模型设置超时、Token 消耗突增等告警规则，防止静默失败。 +- **合规审计**：通过推理日志记录每次模型调用的输入与输出，满足内容审计需求。 +- **多模型对比**：在监控列表中横向对比不同模型的性能与错误率，辅助模型选型。 + +### 建议同时使用的场景 + +当应用上线后需要全面保障服务质量时，建议同时开启两项能力：用应用观测定位"哪个环节出了问题"，用模型监控回答"模型本身是否正常、成本是否可控"。例如，当应用观测发现某次调用的 LLM 节点延时异常时，可切换到模型监控确认该模型是否存在全局性的性能劣化或限流。 + +## 技术选型参考 + +| 选型考量 | 推荐方案 | +| --- | --- | +| 需要追踪应用内部多节点调用链路 | 应用观测 | +| 需要监控模型全局运行状态和失败率 | 模型监控 | +| 需要对异常指标设置主动告警 | 模型监控 | +| 需要将线上数据导入评测集 | 应用观测 | +| 需要按模型维度统计费用和用量 | 模型监控 | +| 需要对调用数据打标签做质量分析 | 应用观测 | +| 需要审计模型调用的输入输出内容 | 模型监控（推理日志） | +| 需要端到端的可观测性保障 | 两者配合使用 | + +## 被对比主题页 + +- [application monitoring](../guides/application-monitoring.md) +- [model monitoring](../guides/model-monitoring.md) + + diff --git a/skills/bailian-docs-llm-wiki/wiki/comparisons/fine-tuning-vs-compression-vs-deployment.md b/skills/bailian-docs-llm-wiki/wiki/comparisons/fine-tuning-vs-compression-vs-deployment.md new file mode 100644 index 0000000..47e2398 --- /dev/null +++ b/skills/bailian-docs-llm-wiki/wiki/comparisons/fine-tuning-vs-compression-vs-deployment.md @@ -0,0 +1,77 @@ +# 模型微调、压缩与部署对比 + +百炼平台提供了完整的模型生产链路：模型微调（Fine-tuning）、模型压缩（Quantization）和模型部署（Deployment）。这三个环节各自承担不同职责，微调负责让模型学会特定领域的知识和指令遵循能力，压缩负责在保持模型能力的前提下降低推理资源需求，部署则将模型上线为可调用的推理服务。理解三者的定位、输入输出和适用场景，有助于开发者根据业务需求设计高效的模型生产流程。 + +## 关键维度对比 + +| 维度 | 模型微调 | 模型压缩 | 模型部署 | +|------|---------|---------|---------| +| **核心目标** | 基于自有数据定制模型能力，提升特定场景表现 | 通过量化降低模型参数精度，减少部署资源需求 | 将模型上线为可调用的推理服务 | +| **在链路中的位置** | 第一步（模型生产起点） | 第二步（可选，位于微调与部署之间） | 第三步（模型上线） | +| **输入** | 基础模型 + 训练数据集（JSONL / ZIP） | 微调产出的自定义模型 | 预置模型、微调模型或压缩后模型 | +| **输出** | 自定义微调模型 | 低精度量化模型 | 在线推理服务（API endpoint） | +| **支持的模型范围** | Qwen3.6/3.5/3/2.5 系列、Qwen-VL、Wan 图像/视频、CosyVoice 语音等 | 仅百炼平台微调产出的自定义模型（以控制台展示为准） | 预置模型（Qwen、DeepSeek、GLM 等）及微调/压缩后的自定义模型 | +| **支持的模态** | 文本生成、视觉理解、图像生成、视频生成、语音合成 | 文本生成（当前已知） | 文本生成、[多模态](../concepts/multimodal.md)、语音合成等 | +| **操作方式** | 控制台 + DashScope API | 仅控制台 | 控制台 + DashScope API | +| **训练/处理方法** | CPT（继续预训练）、SFT（监督微调）、DPO（偏好优化）；全参或 LoRA | 量化模板（MU 编号越大精度损失越大、成本越低） | PTU（预置吞吐）、MU（模型单元）、[Token](../concepts/token.md) 用量三种计费模式 | +| **数据要求** | CPT: 1000 万+ [Token](../concepts/token.md)；SFT: 1000+ 条；DPO: 100+ 组 | 可选校准数据集（最多 5 个，提升量化精度） | 无额外数据要求 | +| **可逆性** | 可基于同一基础模型反复微调 | 不可逆，压缩后不可继续微调或二次压缩 | 可随时上线/下线，删除后不可恢复 | +| **计费方式** | 按训练 [Token](../concepts/token.md) 用量计费（Token 数 x 循环次数 x 单价） | 压缩任务本身限时免费 | PTU 按 TPM 时长计费；MU 按单元数时长计费；Token 用量按调用量计费 | +| **地域限制** | 无特殊限制 | 仅华北2（北京） | 无特殊限制 | + +## 典型链路与场景选择 + +### 链路一：微调后直接部署 + +适用于对推理成本不敏感、追求最优模型效果的场景。微调完成后直接以全精度模型部署，获得最高精度表现。 + +- 典型场景：企业核心业务（如金融风控、医疗问诊）对准确率要求极高 +- 部署方式建议：MU 模型单元（资源独占，性能可控） + +### 链路二：微调后压缩再部署 + +适用于需要平衡模型效果与部署成本的场景。压缩可将部署规格从高配 MU 降至低配 MU，成本节省可达 56% 以上。 + +- 典型场景：流量规模较大的在线服务（如智能客服、内容审核），需要长期运行且对成本敏感 +- 部署方式建议：MU 模型单元（压缩后规格更低，单价更优） +- 注意事项：压缩不可逆，建议在免费期内用业务测试集验证多个量化模板的推理效果后再正式上线 + +### 链路三：仅部署预置模型 + +适用于不需要定制化能力、直接使用平台预置模型的场景。跳过微调和压缩环节，快速上线。 + +- 典型场景：通用问答、内容生成、快速原型验证 +- 部署方式建议：PTU 预置吞吐（高并发保障）或 Token 用量（按需付费、低流量场景） + +## 技术选型参考 + +开发者在选择链路时，建议按以下决策顺序评估： + +1. **是否需要定制模型能力？** 如果预置模型已满足业务需求，直接部署即可，无需微调。 +2. **选择哪种微调方法？** 数据量充足且需要注入领域知识时用 CPT；指令遵循和任务适配用 SFT；安全合规和偏好对齐用 DPO。数据量少或需快速验证时优先选择 LoRA 高效训练。 +3. **是否需要压缩？** 当微调模型的全精度部署成本超出预算时，考虑压缩。注意压缩会带来一定精度损失，且操作不可逆，务必在压缩前保留全精度模型。 +4. **选择哪种部署计费方式？** 流量稳定且需要吞吐保障选 PTU；需要资源独占和灵活配置选 MU；流量波动大或处于验证阶段选 Token 用量按需计费。 + +## 成本优化建议 + +| 优化手段 | 说明 | +|---------|------| +| 高效训练（LoRA） | 微调阶段选择 LoRA 而非全参训练，训练成本更低、收敛更快 | +| 模型压缩 | 对微调模型进行量化，降低部署 MU 规格，长期运行成本显著下降 | +| PTU 前缀缓存 | 多轮对话或重复前缀场景下，命中缓存的 Token 按折扣系数消耗额度 | +| PTU 溢出机制 | 超出额度时自动转按量计费，避免业务中断 | +| Token 用量计费 | 低流量或验证阶段使用，不调用不计费，避免资源闲置浪费 | + +## 来源文档 + +- [fine tuning](../guides/fine-tuning.md) (guides/fine-tuning.md) +- [model compression](../guides/model-compression.md) (guides/model-compression.md) +- [model deployment 1](../guides/model-deployment-1.md) (guides/model-deployment-1.md) + +## 被对比主题页 + +- [fine tuning](../guides/fine-tuning.md) +- [model compression](../guides/model-compression.md) +- [model deployment 1](../guides/model-deployment-1.md) + + diff --git a/skills/bailian-docs-llm-wiki/wiki/comparisons/knowledge-base-vs-memory-library.md b/skills/bailian-docs-llm-wiki/wiki/comparisons/knowledge-base-vs-memory-library.md index 5153a75..cf59bb0 100644 --- a/skills/bailian-docs-llm-wiki/wiki/comparisons/knowledge-base-vs-memory-library.md +++ b/skills/bailian-docs-llm-wiki/wiki/comparisons/knowledge-base-vs-memory-library.md @@ -1,59 +1,62 @@ # 知识库与记忆库对比 -百炼平台同时提供「知识库」与「记忆库」两类持久化数据能力，二者定位不同：知识库面向 **静态/半静态的私有领域知识**，通过 RAG 检索增强生成补充模型的事实性背景；记忆库面向 **跨会话的动态对话上下文**，自动从对话中提取并召回用户偏好与历史信息。本页从输入、输出、模型支持、API、计费、典型场景等维度做技术选型对比，供开发者在 RAG 与长期记忆之间做架构决策参考。 +百炼平台提供了两种面向不同场景的数据增强机制：**知识库**（Knowledge Base）和**记忆库**（Memory Library）。知识库基于 RAG 技术为大模型补充私有文档与结构化数据，解决的是"模型不知道企业内部信息"的问题；记忆库则通过长期记忆 API 自动提取、持久化并召回对话中的关键信息，解决的是"模型在跨会话场景下丢失上下文"的问题。二者定位互补，理解其核心差异有助于开发者在技术选型时做出合理决策。 ## 关键维度对比 -| 维度 | 知识库 | 记忆库 | +| 维度 | 知识库（Knowledge Base） | 记忆库（Memory Library） | | --- | --- | --- | -| 定位 | RAG 检索增强生成，补充私有/最新领域知识 | 长期记忆 API，解决跨会话上下文丢失 | -| 数据来源 | 用户主动导入的文档（PDF/Word/Markdown/Excel/CSV/图片/音视频等） | 从对话中自动提取关键事件与画像，或通过 `custom_content` 直写 | -| 内容形态 | 非结构化文档切片、结构化表格（NL2SQL）、图片向量、音视频时间轴 | 记忆片段（自动去重/动态更新）+ 用户画像（结构化属性） | -| 输入格式 | 文件上传，支持电子文档/文档智能/大模型/Qwen VL/音视频等多种解析 | HTTPS JSON（`messages` 或 `custom_content`），或 OpenClaw 插件零侵入 | -| 输出格式 | 检索返回切片（含 `score`/`text`/`metadata`）；问答返回生成回答 | `SearchMemory` 返回记忆条数（建议 top_k 3–10）注入 Prompt | -| 检索方式 | Query 改写 → 向量+关键词混合检索 → Rerank → 加权返回 | 语义检索召回相关记忆 | -| 支持模型 | 千问 QwQ/Long/Max/Plus/Turbo/Coder/Deep-Research、千问 VL 系列、千问开源版、DeepSeek-R1/V3.1、abab6.5s、Llama3.1、Yi-Large 等，及自定义千问调优版 | 任意模型（记忆能力与生成模型解耦）；OpenClaw Agent 共享同一记忆 | -| 地域限制 | 仅中国站 **华北2（北京）** | DashScope 全球接入（`dashscope.aliyuncs.com`） | -| API 端点 | `bailian.cn-beijing.aliyuncs.com`（ApplyFileUploadLease/AddFile/CreateIndex/SubmitIndexJob/Retrieve 等） | `https://dashscope.aliyuncs.com/api/v2/apps/memory/*`（AddMemory/SearchMemory/ListMemory 等） | -| 鉴权 | AK/SK + `WORKSPACE_ID`，需 `AliyunBailianDataFullAccess` 策略 | `DASHSCOPE_API_KEY`（`sk-` 开头） | -| 绑定数量 | 单服务最多绑定 15 个知识库 | 单账号一个默认记忆库（不可删），可创建多个记忆库 ID | -| 计费方式 | 标准版 0.03 元/小时、1 QPS、≤100 GB；旗舰版 0.2 元/RCU/小时、50–10,000 QPS、≤9,999 GB；SLS 日志按存储/流量另计 | 按记忆写入与检索调用计费（DashScope 体系）；具体以控制台规则为准 | -| 数据生命周期 | 持久存储，可手动删除文件/重建索引 | 默认 180 天（控制台规则可配 7/30/180 天或永不过期）；API 直写且不指定 `project_id` 用默认规则 | -| 接入方式 | 控制台 + 开放 API（仅文档搜索类有完整 API 指南） | API 直连（curl/Python `agentscope-runtime`）+ OpenClaw 插件（`before_agent_start`/`agent_end` 钩子） | -| 典型场景 | 企业文档问答、产品手册、图片问答、音视频搜索、结构化数据 NL2SQL | 用户偏好持久化、跨会话上下文连续、个性化助手、Agent 长期状态 | - -## 适用场景建议 - -**选知识库**： -- 需要让模型回答**特定领域事实**（产品手册、规章制度、技术文档）。 -- 数据是**文件形态**，体量大、更新不频繁，需要切片+索引+Rerank 全流程。 -- 需要 **多模态**（图片问答、音视频搜索、富文本图文）。 -- 需要 NL2SQL 查询结构化业务数据。 -- 对检索质量有可控调参需求（TopK、相似度阈值、Rerank 模式、Meta 过滤）。 - -**选记忆库**： -- 需要**跨会话记住用户**（偏好、习惯、历史事件），而非查询外部文档。 -- 数据**从对话中动态产生**，无法预先导入。 -- Agent 需要"自动捕获/自动召回"零侵入集成（OpenClaw 插件）。 -- 个性化场景，每个 `user_id` 记忆空间相互隔离。 - -**组合使用**： -- 同一智能体可同时挂载知识库与记忆库：知识库提供领域事实底座，记忆库维护用户上下文，二者在 Prompt 层叠加注入。 -- 典型架构：用户提问 → 记忆库召回用户偏好 → 知识库召回领域切片 → 一并拼装到 Prompt → 模型生成个性化且准确的回答。 - -## 技术选型参考 - -| 决策点 | 倾向知识库 | 倾向记忆库 | -| --- | --- | --- | -| 数据是否预先存在 | 是，文档/表格文件 | 否，需从对话提炼 | -| 内容更新频率 | 低，批量导入 | 高，每次对话增量 | -| 是否需要文件解析/切片 | 是 | 否 | -| 是否按用户隔离 | 不强（按知识库/服务隔离） | 是（按 `user_id`） | -| 是否需要 Rerank 调优 | 是 | 否（语义召回即可） | -| 是否多模态 | 是（图/音视频） | 否（文本为主） | -| 接入是否零侵入 | 否，需走文件上传+索引流程 | 是（OpenClaw 插件） | - -简单判断：**事实性问答应答用知识库，用户上下文延续用记忆库**；若两者都需要，组合使用效果最佳。 +| **核心定位** | 为大模型补充私有数据与最新信息，提升特定领域问答准确性 | 解决跨会话上下文丢失问题，使智能体持续理解用户偏好与历史 | +| **底层技术** | RAG（[检索增强生成](../concepts/rag.md)）：向量化 + 关键词混合检索 + Rerank + 生成 | 长期记忆：从对话自动提取关键信息 → 持久化存储 → 语义检索召回 | +| **数据来源** | 企业文档、Excel/CSV、图片、音视频等非结构化/结构化文件，需主动上传 | 对话内容自动提取，或通过 `custom_content` 直接写入 | +| **存储内容** | 文档切片（向量索引 + 原文） | 记忆片段（自动提炼的关键事件/信息）+ 用户画像（结构化属性） | +| **数据粒度** | 文档级 / 切片级（单切片上限 6,000 [Token](../concepts/token.md)） | 记忆条目级（单条关键信息或画像属性） | +| **支持的数据类型** | 文档搜索、数据查询（NL2SQL）、图片问答、音视频搜索 | 文本对话内容、自定义文本内容 | +| **隔离维度** | 按知识库实例隔离，多知识库可按权重组合（最多绑定 15 个） | 按 `user_id` 隔离，同一 user_id 共享记忆空间 | +| **API 端点** | `bailian.cn-beijing.aliyuncs.com`（阿里云百炼 OpenAPI） | `dashscope.aliyuncs.com/api/v2/apps/memory/*`（DashScope） | +| **认证方式** | 阿里云 AccessKey（AK/SK） | DashScope [API Key](../concepts/api-key.md)（`sk-` 开头） | +| **SDK** | `alibabacloud_bailian20231229`（Python） | `agentscope-runtime`（Python） | +| **接入方式** | 控制台配置 + OpenAPI | API 直连 / OpenClaw 记忆插件（零侵入） | +| **向量模型** | `text-embedding-v4`/`v3`（512 维）、`multimodal-embedding-v1`（1024 维）、`qwen3-vl-embedding` | 由服务端自动处理，开发者无需选择 | +| **可用地域** | 仅华北2（北京） | 通过 DashScope 全局接入 | +| **规格与 QPS** | 标准版 1 QPS / 旗舰版 50–10,000 QPS（1–200 RCU） | 无公开 QPS 档位说明 | +| **计费方式** | 标准版 0.03 元/小时；旗舰版 0.2 元/RCU/小时；另含 SLS 日志存储费用 | 按长期记忆 API 调用计费 | +| **数据有效期** | 持久存储，手动删除 | 可配置 7/30/180 天或永不过期（默认 180 天） | +| **典型延迟** | 检索 + 生成链路，与文档量和模型相关 | 记忆写入为异步提取，检索为在线语义匹配 | + +## 适用场景 + +### 选择知识库的场景 + +- **企业知识问答**：需要基于产品手册、内部文档、FAQ 等进行精准问答。 +- **结构化数据查询**：通过 NL2SQL 对 Excel/CSV 数据进行自然语言查询。 +- **[多模态](../concepts/multimodal.md)检索**：需要对图片、音视频内容进行搜索和理解。 +- **高并发生产环境**：需要可控的 QPS 配额和企业级 SLA 保障。 +- **合规与审计**：需要完整的调用日志（SLS 投递）用于审计和问题排查。 + +### 选择记忆库的场景 + +- **个性化智能体**：需要记住用户偏好、习惯和历史交互，提供个性化服务。 +- **跨会话连续性**：用户多次对话之间需要保持上下文连贯（如客服、健康管理、学习助手）。 +- **用户画像积累**：需要从对话中逐步提取并维护结构化的用户属性信息。 +- **快速集成**：通过 OpenClaw 插件实现零代码改造的跨会话记忆能力。 + +### 组合使用 + +知识库与记忆库可以同时接入同一个智能体应用：知识库提供领域知识的检索增强，记忆库提供用户级的个性化上下文。例如，一个医疗健康助手可以通过知识库检索药品说明书和诊疗指南，同时通过记忆库记住用户的过敏史和用药偏好，从而给出既专业又个性化的建议。 + +## 技术选型建议 + +| 决策因素 | 推荐方案 | +| --- | --- | +| 需要基于大量文档做精准问答 | 知识库 | +| 需要跨会话记住用户偏好和历史 | 记忆库 | +| 需要[多模态](../concepts/multimodal.md)内容检索（图片/音视频） | 知识库 | +| 需要零侵入为已有 Agent 添加记忆 | 记忆库（OpenClaw 插件） | +| 需要结构化数据的自然语言查询 | 知识库（数据查询类） | +| 需要同时具备领域知识和用户个性化 | 知识库 + 记忆库组合 | +| 数据来源为企业内部文件 | 知识库 | +| 数据来源为用户对话积累 | 记忆库 | ## 被对比主题页 diff --git a/skills/bailian-docs-llm-wiki/wiki/comparisons/multimodal-generation-comparison.md b/skills/bailian-docs-llm-wiki/wiki/comparisons/multimodal-generation-comparison.md index 05778fc..c3918e8 100644 --- a/skills/bailian-docs-llm-wiki/wiki/comparisons/multimodal-generation-comparison.md +++ b/skills/bailian-docs-llm-wiki/wiki/comparisons/multimodal-generation-comparison.md @@ -1,76 +1,84 @@ -# [多模态](../concepts/multimodal.md)内容生成 API 对比 +# 图像生成、视频生成与 3D 生成对比 -百炼平台提供图像生成、视频生成和 3D 模型生成三大类[多模态](../concepts/multimodal.md)内容生成能力。三者在输入形式、输出产物、模型生态、调用方式和适用场景上存在显著差异。本文从开发者技术选型角度，对这三类 API 进行系统对比，帮助快速定位最适合业务需求的接口。 +百炼平台提供图像生成、视频生成和 3D 生成三大[多模态](../concepts/multimodal.md)内容创作能力，分别面向静态视觉素材、动态影像和三维资产的生产需求。三者在输入方式、输出格式、模型生态、调用模式和计费体系等方面存在显著差异。本文从开发者技术选型的角度，对这三类能力进行系统对比，帮助开发者根据业务场景选择合适的生成方案。 -## 核心维度对比 +## 关键维度对比 -| 维度 | 图像生成 | 视频生成 | 3D 模型生成 | -| --- | --- | --- | --- | -| **输入形式** | 文本 [prompt](../guides/prompt.md)、参考图片、涂鸦草图、待编辑图片 | 文本 [prompt](../guides/prompt.md)、首帧图片、参考图/视频、音频、关键帧序列 | 文本 [prompt](../guides/prompt.md)、单张图片、多图（4 视角） | -| **输出产物** | PNG 图片（512x512 至 4K） | MP4 视频（通常 5-10 秒） | GLB 3D 模型（含 PBR 材质贴图或无贴图基础模型）+ 预览渲染图 | -| **调用模式** | 同步或异步（视模型而定） | 全部异步（创建任务 + 轮询获取） | 全部异步（创建任务 + 轮询获取） | -| **典型响应时间** | 秒级至数十秒 | 1-5 分钟 | 数分钟（建议 15 秒间隔轮询） | -| **主力模型系列** | 千问 Qwen-Image、万相 Wan/Wanx、Z-Image、可灵 Kling | 万相 Wan 2.7、HappyHorse、Pixverse、Vidu、Kling | Tripo H3.1、Tripo P1.0 | -| **模型数量** | 20+ 款（含创意工具） | 10+ 款（含数字人、动作、表情类） | 2 款 | -| **可用地域** | 部分模型限北京地域，核心模型多地域可用 | 部分模型限北京地域 | 仅限华北2（北京） | -| **鉴权方式** | DashScope API Key（Bearer Token） | DashScope API Key（Bearer Token） | DashScope API Key（Bearer Token） | -| **SDK 支持** | HTTP / [DashScope SDK](../concepts/dashscope-sdk.md) | HTTP / OpenAI 兼容 SDK（部分模型） | HTTP | -| **产物有效期** | 即时返回，无过期限制 | 异步结果 URL 有时效 | 下载链接有效期 2 小时，task_id 有效期 24 小时 | -| **批量输出** | 单次可生成 1-9 张（视模型） | 单次生成 1 条视频 | 单次生成 1 个模型 | - -## 能力细分对比 +| 维度 | 图像生成 | 视频生成 | 3D 生成 | +|------|---------|---------|---------| +| **核心模型** | 千问(Qwen-Image)、万相(Wan/Wanx)、Z-Image、可灵(Kling) | 万相(Wan) 2.7、HappyHorse、Pixverse、Vidu、Kling | Tripo (Tripo-H3.1 / Tripo-P1.0) | +| **输入方式** | 文本 [prompt](../guides/prompt.md)、参考图片、涂鸦草图 | 文本 [prompt](../guides/prompt.md)、首帧图片、参考图/视频、关键帧序列、音频 | 文本 [prompt](../guides/prompt.md)、单张图片、多图(4视角) | +| **输出格式** | PNG 图片（512x512 至 4K） | MP4 视频（通常 5-10 秒） | GLB 三维模型（含/不含 PBR 贴图） | +| **调用模式** | 同步调用为主，部分模型支持异步 | 全部异步（创建任务 → 轮询获取） | 全部异步（创建任务 → 轮询获取） | +| **典型响应时间** | 秒级（数秒至十余秒） | 分钟级（1-5 分钟） | 分钟级（需轮询，建议间隔 15 秒） | +| **单次产出数量** | 1-9 张（模型不同） | 1 段视频 | 1 个 3D 模型 + 1 张渲染预览图 | +| **SDK 支持** | HTTP / [DashScope SDK](../concepts/dashscope-sdk.md) / OpenAI 兼容 SDK | HTTP / [DashScope SDK](../concepts/dashscope-sdk.md) / OpenAI 兼容 SDK（部分模型） | HTTP（仅异步） | +| **支持地域** | 部分模型仅限华北2（北京） | 部分模型仅限华北2（北京）或新加坡 | 仅限华北2（北京） | +| **计费方式** | 按张计费，部分模型免费体验 | 按任务/时长计费 | 按任务计费 | +| **产物有效期** | 即时返回，永久可用 | 任务 ID 有效期内下载 | 下载链接有效期 2 小时，task_id 有效期 24 小时 | + +## 能力矩阵对比 | 子能力 | 图像生成 | 视频生成 | 3D 生成 | -| --- | --- | --- | --- | -| 文本直接生成 | 支持（文生图，模型最丰富） | 支持（文生视频） | 支持（文生 3D） | -| 图片驱动生成 | 支持（图生图、图像编辑、风格迁移） | 支持（图生视频、首帧驱动） | 支持（单图/多图生 3D） | -| 多参考输入 | 支持（多图参考生成、组图） | 支持（多参考图/视频驱动） | 支持（4 视角多图，前/左/后/右） | -| 内容编辑 | 支持（局部重绘、扩图、超分、文字替换） | 支持（视频重绘、风格转换、口型替换） | 不支持 | -| 文字渲染 | 支持（中英文字渲染是优势能力） | 不适用 | 不适用 | +|--------|---------|---------|---------| +| 文本驱动生成 | 支持（文生图） | 支持（文生视频） | 支持（文生 3D） | +| 图片驱动生成 | 支持（图生图/图像编辑） | 支持（图生视频/首帧驱动） | 支持（单图/多图生 3D） | +| 内容编辑 | 支持（局部重绘、风格迁移、扩图、超分） | 支持（视频重绘、风格转换、口型替换） | 不支持（需重新生成） | +| 文字渲染 | 支持（千问系列擅长） | 不适用 | 不适用 | +| 图像翻译 | 支持（qwen-mt-image 系列） | 不适用 | 不适用 | | 数字人/动作 | 不适用 | 支持（AnimateAnyone、LivePortrait、EMO、数字人 S2V） | 不适用 | -| 材质与质量控制 | 分辨率、张数可配置 | 分辨率、时长、种子可配置 | 贴图质量（standard/detailed）、几何精度（standard/ultra）、PBR 材质开关 | +| PBR 材质输出 | 不适用 | 不适用 | 支持（可选开关） | -## 计费模式对比 +## 适用场景建议 -| 维度 | 图像生成 | 视频生成 | 3D 生成 | -| --- | --- | --- | --- | -| 计费单位 | 按张计费（部分模型如扩图 0.18 元/张） | 按任务/时长计费 | 按任务计费 | -| 免费体验 | 部分创意工具模型仅提供免费体验额度 | 部分模型提供免费体验 | 需在控制台开通服务 | -| 商业化状态 | 核心模型已商业化，部分垂直工具仅免费体验 | 核心模型已商业化 | 已商业化 | +### 图像生成 -## 适用场景建议 +适合需要快速产出高质量静态视觉素材的场景： + +- **电商运营**：商品背景生成、海报排版、AI 试衣、虚拟模特 +- **内容创作**：插画生成、艺术风格转换、涂鸦转精细图 +- **多语言场景**：图片中文字的精准翻译与排版保持 +- **图像后处理**：局部重绘、画面扩展、超分辨率增强 + +图像生成响应速度最快（秒级），模型选择最丰富，适合对实时性要求较高、需要大批量素材生产的业务。 + +### 视频生成 -**选择图像生成 API 的场景：** +适合需要动态影像内容的场景： -- 需要快速生成营销素材、产品展示图、海报、插画等静态视觉内容 -- 需要对已有图片进行精细编辑（局部修改、扩图、风格迁移、文字替换） -- 电商场景下的商品背景生成、虚拟试衣、虚拟模特 -- 需要在图片中精准渲染中英文文字 -- 对响应速度要求高（秒级返回） +- **短视频制作**：基于文本或图片快速生成短视频片段 +- **数字人直播/营销**：音频/文本驱动虚拟主播，口型同步 +- **服装/产品展示**：让静态商品图变为动态展示视频 +- **创意广告**：风格化转换、关键帧精确控制镜头运动 -**选择视频生成 API 的场景：** +视频生成耗时较长（分钟级），但模型生态丰富，覆盖从基础文生视频到精细编辑的全链路需求。多个模型厂商（万相、HappyHorse、Pixverse、Vidu、Kling）可按效果和成本灵活选择。 -- 需要生成短视频广告、产品展示动画、创意视频内容 -- 数字人驱动场景（虚拟主播、AI 说话人、音频驱动口型） -- 需要将静态图片转为动态视频（图生视频） -- 需要对已有视频进行风格化处理或口型替换 -- 多关键帧控制的精细视频生成需求 +### 3D 生成 -**选择 3D 模型生成 API 的场景：** +适合需要三维资产的场景： -- 需要快速生成 3D 资产用于游戏、AR/VR、电商 3D 展示 -- 从产品照片自动生成可交互的 3D 模型 -- 需要带 PBR 材质的高精度 3D 模型（最高 200 万面） -- 3D 内容创作流水线中的原型快速生成 +- **游戏/XR 开发**：快速原型建模，生成带 PBR 材质的可用资产 +- **电商 3D 展示**：从商品图片一键生成 3D 展示模型 +- **工业设计预览**：文本描述或草图快速转为三维概念模型 -## 技术选型决策参考 +3D 生成当前模型选择较少（仅 Tripo 系列），地域限制最严格（仅北京），但产出的 GLB 格式模型可直接用于主流 3D 引擎和渲染管线。高精度模型（Tripo-H3.1）最高支持 200 万面，能满足较高质量要求。 -1. **产物类型决定方向**：需要静态图选图像生成，需要动态内容选视频生成，需要三维资产选 3D 生成。 -2. **响应时间敏感度**：图像生成响应最快（秒级），视频和 3D 均为分钟级异步任务。如果业务对实时性要求高，优先考虑图像生成。 -3. **模型丰富度**：图像生成的模型和子能力最为丰富，视频生成次之，3D 生成目前仅有 Tripo 系列 2 款模型。 -4. **地域限制**：3D 生成仅限北京地域，图像和视频生成的核心模型多地域可用。部署在海外的服务需注意地域兼容性。 -5. **集成复杂度**：图像生成部分模型支持同步调用，集成最简单；视频和 3D 均需实现异步轮询逻辑，建议封装统一的任务管理层。 -6. **组合使用**：三类 API 可串联使用。例如先用图像生成产出高质量概念图，再用图生视频将其动态化，或用单图/多图生成 3D 模型，构建完整的[多模态](../concepts/multimodal.md)内容生产流水线。 +## 技术选型参考 + +在选择[多模态](../concepts/multimodal.md)生成能力时，建议从以下维度综合评估： + +1. **输出类型**：明确业务需要的是静态图片、动态视频还是三维模型，这是最基本的筛选条件。 +2. **实时性要求**：如果需要秒级响应（如在线编辑器），优先选择图像生成；如果可以接受分钟级延迟（如离线批处理），视频和 3D 生成均可考虑。 +3. **地域限制**：3D 生成仅支持北京地域，部分图像和视频模型也有地域限制，需确保 [API Key](../concepts/api-key.md) 和调用域名与模型所在地域一致。 +4. **编辑需求**：如果需要对已有内容进行精细编辑（局部修改、风格转换），图像生成和视频生成的编辑能力更成熟；3D 资产目前不支持增量编辑。 +5. **模型成熟度**：图像生成模型迭代最快，选择最多；视频生成次之；3D 生成仍处于相对早期阶段，模型数量有限。 +6. **成本控制**：三者均按任务或产出数量计费，实际单价差异较大。建议先使用免费额度或体验版模型进行效果验证，再决定正式接入方案。 + +## 来源文档 + +- [image generation](../api/image-generation.md) +- [video generation api](../api/video-generation-api.md) +- [3d generation](../api/3d-generation.md) ## 被对比主题页 diff --git a/skills/bailian-docs-llm-wiki/wiki/comparisons/qwen-api-vs-app-call-vs-agents-api.md b/skills/bailian-docs-llm-wiki/wiki/comparisons/qwen-api-vs-app-call-vs-agents-api.md new file mode 100644 index 0000000..4539716 --- /dev/null +++ b/skills/bailian-docs-llm-wiki/wiki/comparisons/qwen-api-vs-app-call-vs-agents-api.md @@ -0,0 +1,74 @@ +# Qwen API、应用调用与托管智能体 API 对比 + +百炼平台提供了多种 API 接入方式，开发者在集成大模型能力时常面临选型困惑：是直接调用 Qwen 模型 API，还是通过应用调用 API 使用已编排好的智能体/工作流，亦或是采用 Managed Agents API 获得平台全托管的智能体运行时？本文从接口定位、协议兼容性、会话管理、工具能力、计费模式等维度进行系统对比，帮助开发者根据实际场景做出技术选型。 + +## 定位差异 + +- **Qwen API**：直接调用 Qwen 系列大语言模型，获取文本生成能力。开发者自行管理 [prompt](../guides/prompt.md)、上下文和工具调用逻辑，灵活度最高。 +- **应用调用 API**：调用在百炼控制台中已创建并发布的智能体或工作流应用。应用内部已封装模型选择、知识库检索、插件调用等编排逻辑，开发者只需传入用户输入即可获取最终结果。 +- **Managed Agents API**：平台全托管的智能体运行时，提供 Agent、Session、Environment、Skill、File 等资源抽象。由平台负责会话状态机、沙箱执行、工具调用与事件流推送，适合需要长期运行、多步工具调用的复杂场景。 + +## 关键维度对比 + +| 维度 | Qwen API | 应用调用 API | Managed Agents API | +|------|----------|-------------|-------------------| +| **定位** | 模型级调用，直接访问 Qwen 系列模型 | 应用级调用，调用已编排好的智能体/工作流 | 平台托管智能体运行时，全生命周期管理 | +| **兼容协议** | OpenAI Chat Completions、OpenAI Responses、Anthropic Messages、DashScope 原生 | OpenAI Responses（兼容模式）、DashScope | 百炼原生 REST API | +| **API 端点** | `POST /compatible-mode/v1/chat/completions` 等 | `POST /api/v2/apps/agent/{APP_ID}/compatible-mode/v1/responses` 或 `POST /api/v1/apps/{APP_ID}/completion` | `POST /api/v1/agentstudio/sessions/{session_id}/events` 等 | +| **认证方式** | [API Key](../concepts/api-key.md)（`Authorization: Bearer`） | [API Key](../concepts/api-key.md) + APP ID（+ 可选 Workspace ID） | [API Key](../concepts/api-key.md) + Workspace ID | +| **模型选择** | 请求体 `model` 字段指定任意 Qwen 模型 | 控制台配置，调用时无需指定模型 | Agent 创建时配置模型 | +| **会话管理** | 调用方自行维护（Responses 接口除外） | DashScope API 通过 `session_id` 自动维护；Responses API 需传完整历史 | 平台全托管，Session 状态机自动驱动 | +| **工具/插件** | Responses 接口内置联网搜索、代码解释器、网页提取；其他接口需自定义 | 控制台可视化编排插件、知识库、工具 | Skill（zip 包上传）+ Environment 沙箱执行 | +| **[多模态](../concepts/multimodal.md)支持** | 需选用 VL 系列模型 | Responses API 支持图像和文件输入 | 通过 File 资源挂载到 Session | +| **[流式输出](../concepts/streaming.md)** | 支持（`stream=true`） | 支持（`stream=true`） | SSE 事件流（`GET .../events/stream`） | +| **[异步调用](../concepts/async-invocation.md)** | 不支持 | Responses API 支持（`background=true`），DashScope 暂不支持 | 原生异步，Session 状态机驱动 | +| **支持地域** | 多地域 | 仅华北2（北京） | 仅 cn-beijing | +| **SDK 支持** | OpenAI SDK、Anthropic SDK、[DashScope SDK](../concepts/dashscope-sdk.md) | OpenAI SDK、[DashScope SDK](../concepts/dashscope-sdk.md) | 百炼原生 SDK / HTTP | +| **配置方式** | 纯代码，请求参数控制 | 控制台可视化编排 + API 调用 | API 全程管理（Agent/Environment/Session/Skill） | + +## 适用场景建议 + +### 选择 Qwen API + +- 需要直接、细粒度地控制模型推理参数（temperature、top_p 等）。 +- 已有基于 OpenAI 或 Anthropic SDK 的应用，希望低成本迁移到百炼平台。 +- 构建自定义的 RAG、Agent 框架，模型调用只是其中一环。 +- 对 [prompt](../guides/prompt.md) 工程有深度需求，需要完整掌控输入输出。 + +### 选择应用调用 API + +- 已在百炼控制台完成智能体或工作流的可视化编排，希望通过 API 将其集成到业务系统。 +- 需要使用控制台配置的知识库检索、插件、工作流节点等平台能力，不想在代码中重新实现。 +- 团队中非开发人员负责应用逻辑编排，开发人员只负责 API 集成。 +- 需要快速上线，应用逻辑变更通过控制台完成而非修改代码。 + +### 选择 Managed Agents API + +- 需要平台全托管的智能体运行时，不想自行管理会话状态和工具执行环境。 +- 智能体任务涉及多步工具调用、代码执行、文件读写，需要沙箱环境保障安全。 +- 希望通过 API 动态创建和管理多个智能体，实现多 Agent 协作。 +- 需要细粒度的事件流（SSE）来追踪智能体执行过程中的每一步操作。 +- 有自定义工具（Skill）需要安全审核后挂载，要求版本锁定和隔离。 + +## 选型决策参考 + +1. **"我只需要一个模型回答问题"** — 选 Qwen API。最简单直接，兼容主流 SDK。 +2. **"我已在控制台搭好应用，想 API 接入"** — 选应用调用 API。零编排代码，改逻辑只需改控制台配置。 +3. **"我需要平台帮我管理 Agent 的执行环境和工具调用"** — 选 Managed Agents API。平台托管状态机、沙箱和事件流，适合复杂任务。 +4. **迁移成本优先** — Qwen API 的 OpenAI/Anthropic 兼容接口迁移成本最低；应用调用 API 也提供 OpenAI 兼容模式。 +5. **功能完整度优先** — Qwen API 的 DashScope 原生接口参数最丰富；Managed Agents API 的资源模型最完整。 + +## 注意事项 + +- Qwen API 的兼容接口可能不暴露 DashScope 原生的全部参数，如需最全功能建议使用 DashScope 接口。 +- 应用调用 API 要求先在控制台创建并发布应用，APP ID 只能通过控制台手动获取。 +- Managed Agents API 当前仅支持 cn-beijing 地域，Skill 上传后需通过安全扫描才能挂载。 +- 三种 API 的计费方式均基于 token 消耗，但应用调用和 Managed Agents 可能涉及额外的平台资源费用（如沙箱、存储），请参考官方定价文档。 + +## 被对比主题页 + +- [qwen api reference](../api/qwen-api-reference.md) +- [application call](../api/application-call.md) +- [managed agents api](../api/managed-agents-api.md) + + diff --git a/skills/bailian-docs-llm-wiki/wiki/concepts/api-key.md b/skills/bailian-docs-llm-wiki/wiki/concepts/api-key.md index 067245b..fcb09d2 100644 --- a/skills/bailian-docs-llm-wiki/wiki/concepts/api-key.md +++ b/skills/bailian-docs-llm-wiki/wiki/concepts/api-key.md @@ -1,95 +1,111 @@ -# API Key 鉴权 +# API Key -API Key 是调用阿里云百炼平台模型服务和应用接口的唯一鉴权凭证，用于标识调用者身份并控制访问权限。开发者在调用任何百炼 API 之前，必须先在控制台创建 API Key 并妥善保管。 +API Key 是调用阿里云百炼平台模型服务和应用的唯一鉴权凭证，用于标识调用者身份并控制其可访问的模型与资源范围。 -## API Key 的类型 +## 基本概念 -百炼目前存在三类 API Key，它们的格式、Base URL 和计费方式互不相通： +百炼平台的 API Key 由控制台统一管理，归属于特定的[业务空间](workspace.md)和用户。每个 API Key 只能属于一个地域内的一个[业务空间](workspace.md)和一个用户，且不能转移。API Key 没有失效日期，手动删除后即失效。 -| 类型 | 格式 | Base URL | 计费方式 | -| --- | --- | --- | --- | -| 按量计费 API Key | `sk-xxx` | `dashscope.aliyuncs.com` | 按 Token 用量计费 | -| Token Plan 团队版 | `sk-sp-xxx` | `token-plan.cn-beijing.maas.aliyuncs.com` | 预付费 Credits 抵扣 | -| Coding Plan | `sk-sp-xxx` | `coding.dashscope.aliyuncs.com` | 按模型调用次数 | +根据用途和计费方式的不同，百炼平台存在三类 API Key： -误用不同类型的 API Key 与 Base URL 会导致意外扣费或 401/403 报错。 +| 类型 | 前缀 | Base URL | 计费方式 | +|------|------|----------|----------| +| 按量计费 | `sk-xxx` / `sk-ws-xxx` | `dashscope.aliyuncs.com` | 按 [Token](token.md) 用量后付费 | +| [Token](token.md) Plan 团队版 | `sk-sp-xxx` | `token-plan.cn-beijing.maas.aliyuncs.com` | 预付费 Credits 抵扣 | +| Coding Plan | `sk-sp-xxx` | `coding.dashscope.aliyuncs.com` | 预付费按调用次数 | + +三类 API Key 与 Base URL 互不相通，误用会导致非预期扣费或 401/403 报错。 ## 创建与获取 -在百炼控制台的 API Key 管理页面创建，操作权限要求： +### 操作权限 -- 使用主账号，或具备"管理员"或"API-Key"页面权限的子账号。 -- 不同地域的控制台入口不同（华北2/新加坡/日本/德国使用 `bailian.console.aliyun.com`，美国使用 `modelstudio.console.aliyun.com`）。 +创建 API Key 需使用主账号，或具备「管理员」或「API-Key」页面权限的子账号（RAM 用户）。 -创建时可选择归属[业务空间](workspace.md)并配置权限（全部模型或自定义 IP 白名单 + 模型范围）。升级后新创建的 API Key 以 `sk-ws` 开头，**仅在创建时展示一次明文**，关闭弹窗后无法再次查看，请立即复制保存。 +### 创建步骤 -自 2026 年 3 月 25 日起，华北2（北京）地域所有新创建的 API Key 均归属主账号，并支持设置 IP 访问白名单。 +1. 登录百炼控制台（不同地域入口不同：华北2、新加坡、日本、德国使用 `bailian.console.aliyun.com`；美国使用 `modelstudio.console.aliyun.com`）。 +2. 进入密钥管理页面，点击创建 API Key。 +3. 选择归属[业务空间](workspace.md)（建议选默认空间）。 +4. 配置权限范围（全部模型或自定义 IP 白名单 + 模型范围）。 +5. 创建成功后立即复制保存——升级后新创建的 API Key 以 `sk-ws` 开头，仅在创建时展示一次明文，关闭弹窗后无法再次查看。 ## 权限模型 -单个 API Key 只能归属一个地域内的一个[业务空间](workspace.md)和一个用户，且不能转移。其核心权限规则： +API Key 的调用权限由其归属业务空间决定，同一空间内的 API Key 权限相同，无需为不同模型类型（文生文、文生图、语音合成）分别创建。 -- API Key 的可调用模型和限流与**归属[业务空间](workspace.md)**的权限保持一致，不受用户控制台权限影响。 -- 默认业务空间的 API Key 可调用所有标准模型；子业务空间的 API Key 仅可调用已授权的模型。 -- 无需为不同模型类型（文生文、文生图、语音合成）分别创建 API Key。 -- API Key 没有失效日期，手动删除后即失效。 +- **默认业务空间**：API Key 可调用所有标准模型，无法设置模型级限制。 +- **子业务空间**：API Key 仅可调用该空间内已授权的模型，支持按模型维度配置调用权限、请求数限流和 [Token](token.md) 限流。 -### API Key 状态变化 +自 2026 年 3 月 25 日起，华北2（北京）地域所有新创建的 API Key 均归属主账号，并支持设置 IP 访问白名单。 -| 触发操作 | 影响 | -| --- | --- | -| 主动删除 API Key | 失效，不可恢复 | -| 将 RAM 账号移出业务空间 | 该账号的 API Key 失效（重新加入后恢复） | -| 在 RAM 控制台删除账号/角色 | API Key 永久失效，不可恢复 | +### 失效场景 -## 配置环境变量 +- 将 RAM 账号移出业务空间会使其 API Key 失效（重新加入后恢复）。 +- 在 RAM 控制台删除账号或角色则会使 API Key 永久失效，不可恢复。 +- 各地域的 API Key 不互通，跨地域调用将失败。 + +## 环境变量配置 建议将 API Key 配置到环境变量 `DASHSCOPE_API_KEY`，避免在代码中硬编码： -- **Linux/macOS**：追加 `export DASHSCOPE_API_KEY="your-key"` 到 `~/.bashrc`（Linux）或 `~/.zshrc`（macOS），然后 `source` 使其生效。 -- **Windows**：通过系统属性设置系统变量，或在 CMD 中用 `setx`、PowerShell 中用 `[Environment]::SetEnvironmentVariable` 设置。 +- **Linux**：在 `~/.bashrc` 中追加 `export DASHSCOPE_API_KEY="your-key"`，然后执行 `source ~/.bashrc`。 +- **macOS**：在 `~/.zshrc` 中追加 `export DASHSCOPE_API_KEY="your-key"`，然后执行 `source ~/.zshrc`。 +- **Windows**：通过系统属性设置系统变量，或在 CMD 中使用 `setx`、PowerShell 中使用 `[Environment]::SetEnvironmentVariable` 设置。 -设置后已打开的 IDE 或终端不会自动加载新变量，需重启相关程序。使用 `sudo` 运行脚本时默认不继承用户环境变量，需加 `-E` 参数。 +> **注意**：设置环境变量后，已打开的 IDE 或终端不会自动加载新变量，需要重启。使用 `sudo` 运行脚本时默认不继承用户环境变量，需加 `-E` 参数。 ## 临时 API Key -在浏览器、移动端等不可信环境中，直接暴露永久 API Key 存在安全风险。百炼支持通过后端服务生成有限时效的临时 API Key： +在浏览器、移动 App 等不可信环境中，应通过后端服务生成临时 API Key，避免永久 API Key 泄露。 + +**生成方式**： ``` POST https://dashscope.aliyuncs.com/api/v1/tokens?expire_in_seconds= ``` -- `expire_in_seconds`：有效期，范围 [1, 1800] 秒，默认 60 秒。 -- 临时 API Key 继承生成它的永久 API Key 的全部权限，到期后自动失效，无法手动删除。 -- 各地域的 API Key 不互通，请求时需使用对应地域的 Endpoint。 +| 参数 | 说明 | +|------|------| +| `expire_in_seconds` | 有效期，范围 [1, 1800] 秒，默认 60 秒 | + +返回的 `token` 字段即为临时 API Key（以 `st-` 开头），`expires_at` 为 UNIX 过期时间戳。临时 API Key 继承生成它的永久 API Key 的全部权限，到期后自动失效，无法手动删除或提前撤销。 + +## 在不同场景中的使用 + +### 模型 API 调用 + +通过 [DashScope SDK](dashscope-sdk.md) 或 OpenAI 兼容 SDK 调用模型时，API Key 作为 Bearer Token 传入请求头，或通过 SDK 客户端的 `api_key` 参数指定。 -## 在框架中使用 +### 应用调用 -百炼支持的主流框架均以 API Key 进行鉴权： +调用百炼智能体或工作流应用时，需同时提供 API Key 和 APP ID。若应用位于子业务空间，还需提供 Workspace ID。 -- **OpenAI 兼容 SDK**（Python/Java/Node.js/Go）：通过 `api_key` 参数或 `DASHSCOPE_API_KEY` 环境变量传入。 -- **[DashScope SDK](dashscope-sdk.md)**（Python/Java）：同样通过环境变量或初始化参数传入。 -- **LlamaIndex**：构建 RAG 应用时通过 API Key 访问百炼云端知识库。 -- **Spring AI Alibaba**：集成百炼智能体/工作流应用时通过 `application.yml` 配置 API Key。 +### 框架集成 -不同框架对环境变量名的约定可能不一致（如 `DASHSCOPE_API_KEY` 与 `AI_DASHSCOPE_API_KEY`），需确保配置文件中的占位符与实际变量名一致。 +- **LlamaIndex**：按百炼通用约定配置环境变量 `DASHSCOPE_API_KEY`。 +- **Spring AI Alibaba**：应用集成推荐 `DASHSCOPE_API_KEY`，知识库检索推荐 `AI_DASHSCOPE_API_KEY`。 -## 安全建议 +### Token Plan / Coding Plan -- 不要在客户端代码中硬编码永久 API Key，前端场景使用临时 API Key。 -- 按环境（dev/test/prod）划分业务空间，实现 API Key 权限隔离。 -- 定期审计 API Key 使用情况，及时删除不再使用的 Key。 -- 华北2（北京）地域可为 API Key 设置 IP 访问白名单，进一步收缩访问范围。 +订阅制套餐使用专属 API Key（`sk-sp-xxx`），由管理员在成员管理页面创建成员并分配席位后自动生成，需搭配专属 Base URL 使用。 + +## 安全最佳实践 + +1. **永远不要在前端代码中硬编码 API Key**，使用环境变量或密钥管理服务。 +2. 对外暴露的场景（浏览器、移动端）使用临时 API Key，有效期设置为满足业务需求的最短时长。 +3. 利用子业务空间和 IP 白名单实现最小权限原则。 +4. 定期检查并清理不再使用的 API Key。 +5. 按环境（dev/test/prod）划分业务空间，实现权限与成本隔离。 ## 关联主题页 - [preparations](../api/preparations.md) -- [more about models](../api/more-about-models.md) +- [more](../api/more.md) +- [application call](../api/application-call.md) - [security and compliance](../guides/security-and-compliance.md) -- [token plan guide](../guides/token-plan-guide.md) -- [get started with models](../guides/get-started-with-models.md) -- [application permission management](../guides/application-permission-management.md) - [frameworks](../api/frameworks.md) -- [more](../api/more.md) +- [token plan guide](../guides/token-plan-guide.md) +- [more about models](../api/more-about-models.md) diff --git a/skills/bailian-docs-llm-wiki/wiki/concepts/async-invocation.md b/skills/bailian-docs-llm-wiki/wiki/concepts/async-invocation.md index 46d1de7..52d873c 100644 --- a/skills/bailian-docs-llm-wiki/wiki/concepts/async-invocation.md +++ b/skills/bailian-docs-llm-wiki/wiki/concepts/async-invocation.md @@ -1,74 +1,75 @@ # 异步调用 -异步调用是百炼平台针对耗时较长的生成类任务所采用的标准调用模式，流程为「创建任务 → 轮询获取结果」，适用于视频生成、3D 模型生成、部分图像生成等场景。 +异步调用是百炼平台为耗时较长的 AI 任务提供的非阻塞执行模式。客户端提交任务后立即获得任务 ID，随后通过轮询或回调获取最终结果，避免因长时间等待导致请求超时。 -## 调用流程 +## 核心流程 -异步调用统一分为两步： +百炼平台的异步调用遵循统一的「创建任务 → 轮询获取结果」两步模式： -1. **创建任务**：向对应能力的 API 端点发送 POST 请求，请求头中必须携带 `X-DashScope-Async: enable`，否则会报错 `current user api does not support synchronous calls`。请求成功后返回 `task_id`。 -2. **轮询查询结果**：使用返回的 `task_id`，向 `GET /api/v1/tasks/{task_id}` 发送查询请求，根据 `output.task_status` 判断任务状态。 +1. **创建任务**：向对应的 API 端点发送 POST 请求，服务端立即返回 `task_id`。 +2. **轮询查询**：使用 `GET /api/v1/tasks/{task_id}` 定期查询任务状态，直到任务完成或失败。 -## 任务状态流转 +任务状态流转通常为：`PENDING`（排队中）→ `RUNNING`（处理中）→ `SUCCEEDED`（成功）/ `FAILED`（失败）。部分接口还支持 `CANCELED`（已取消）和 `UNKNOWN`（任务不存在或已过期）状态。 -异步任务的状态枚举如下： +## 适用场景 -| 状态 | 含义 | -| --- | --- | -| `PENDING` | 排队中，任务已提交但尚未开始处理 | -| `RUNNING` | 处理中 | -| `SUCCEEDED` | 任务成功完成，可从响应中获取产物 | -| `FAILED` | 任务失败，响应中包含错误码和错误信息 | -| `CANCELED` | 任务已取消 | -| `UNKNOWN` | 任务不存在或已超过有效期 | +异步调用广泛应用于百炼平台中以下耗时任务： -正常流转路径为 `PENDING` → `RUNNING` → `SUCCEEDED` 或 `FAILED`。 +- **视频生成**：文生视频、图生视频、数字人等任务通常需要 1-5 分钟，所有视频生成 API 均强制使用异步调用。 +- **3D 资产生成**：基于 Tripo 模型的文生 3D、图生 3D 任务，仅支持异步调用。 +- **图像生成**：部分图像生成任务（如高分辨率文生图、批量图像编辑）可通过异步模式提升稳定性。 +- **应用调用**：智能体和工作流应用在执行多步骤工具调用或生成长报告时，可开启异步模式。 +- **模型生产**：模型微调训练任务属于长时间运行的后台作业，通过轮询监控训练进度。 -## 适用场景 +## 触发方式 -百炼平台以下能力采用异步调用模式： +百炼平台提供两种方式开启异步调用，具体取决于所使用的 API 体系： -- **视频生成**：万相（Wan）系列、HappyHorse、Pixverse、Vidu、Kling 等所有视频生成接口，单次生成耗时通常 1-5 分钟。 -- **3D 模型生成**：Tripo 系列模型的文生 3D、图生 3D、多图生 3D 接口。 -- **图像生成**：部分图像生成与编辑接口（如万相文生图 V1 版、涂鸦作画等）。 -- **模型调优**：微调训练任务通过轮询或监听方式获取训练进度和结果。 +### DashScope API -## 关键参数与配置 +在 HTTP 请求头中添加： -### 请求头 +``` +X-DashScope-Async: enable +``` -| 参数 | 必填 | 说明 | -| --- | --- | --- | -| `X-DashScope-Async` | 是 | 固定值 `enable`，开启异步模式 | -| `Authorization` | 是 | `Bearer $DASHSCOPE_API_KEY`，鉴权令牌 | +视频生成和 3D 生成等接口**必须**携带此请求头，否则会报错 `current user api does not support synchronous calls`。 -### 轮询策略 +### OpenAI 兼容 Responses API -- 建议轮询间隔约 **15 秒**，避免过于频繁触发限流。 -- 查询接口默认 RPS 限制为 **20**，如需更高频率可配置异步任务回调通知。 -- `task_id` 有效期为 **24 小时**，超时后查询返回 `UNKNOWN` 状态。 +在请求体中设置参数： -### 地域与域名 +```json +{ + "background": true +} +``` -调用异步接口时需确保模型、Endpoint URL、API Key 属于同一地域。推荐使用[业务空间](workspace.md)专属域名： +任务创建后通过 `client.responses.retrieve(task_id)` 查询状态，完成状态为 `completed`、`failed` 或 `cancelled`。 -- 华北2（北京）：`https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com` -- 新加坡：`https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com` +## 关键参数与配置 -旧域名 `dashscope.aliyuncs.com` 仍可使用。 +| 参数 | 说明 | +|------|------| +| `task_id` | 创建任务后返回的唯一标识符，用于后续状态查询。有效期通常为 24 小时，过期后返回 `UNKNOWN`。 | +| `task_status` | 当前任务状态，可选值：`PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN`。 | +| 轮询间隔 | 建议 10-15 秒轮询一次。查询接口默认 RPS 限制为 20。 | +| 异步回调 | 如需更高频通知，可配置异步任务回调替代轮询，减少不必要的查询请求。 | -## 最佳实践 +## 开发最佳实践 -1. **避免重复创建任务**：创建成功后保存 `task_id`，通过轮询获取结果即可，不要对同一请求重复提交。 -2. **及时下载产物**：生成产物（视频、3D 模型等）的下载链接通常有时效限制（如 2 小时），请及时保存。 -3. **使用回调替代轮询**：对于高频调用场景，建议配置异步任务回调通知，减少轮询请求开销。 -4. **处理失败状态**：任务失败时响应中包含 `code` 和 `message` 字段，可参照百炼错误码文档排查问题。 +1. **避免重复创建任务**：获得 `task_id` 后应持续轮询，不要因为未立即获取结果而重复提交相同请求。 +2. **合理设置轮询间隔**：建议 10-15 秒轮询一次，过于频繁的轮询可能触发限流。 +3. **及时处理产物**：部分异步任务的产物下载链接有时效限制（如 3D 模型产物链接有效期仅 2 小时），需在有效期内完成下载。 +4. **处理失败状态**：轮询时应同时检查 `FAILED` 状态，读取响应中的 `code` 和 `message` 字段进行错误排查。 +5. **注意地域一致性**：确保模型、Endpoint URL 和 [API Key](api-key.md) 属于同一地域，跨地域调用会导致异步任务创建失败。 ## 关联主题页 - [3d generation](../api/3d-generation.md) - [video generation api](../api/video-generation-api.md) -- [image generation](../api/image-generation.md) +- [application call](../api/application-call.md) - [model production](../api/model-production.md) +- [image generation](../api/image-generation.md) diff --git a/skills/bailian-docs-llm-wiki/wiki/concepts/dashscope-sdk.md b/skills/bailian-docs-llm-wiki/wiki/concepts/dashscope-sdk.md index d8ad6a4..338456f 100644 --- a/skills/bailian-docs-llm-wiki/wiki/concepts/dashscope-sdk.md +++ b/skills/bailian-docs-llm-wiki/wiki/concepts/dashscope-sdk.md @@ -1,85 +1,113 @@ # DashScope SDK -DashScope SDK 是阿里云百炼平台的官方原生 SDK，提供对百炼全部模型能力和应用服务的编程访问接口。相比 [OpenAI 兼容接口](openai-compatible-interface.md)，DashScope SDK 的功能集最完整、参数支持最丰富，是需要使用百炼平台全部能力时的首选接入方式。 +DashScope SDK 是阿里云百炼平台的官方客户端开发工具包，为开发者提供对平台各类大模型和应用服务的编程访问能力。SDK 封装了鉴权、请求构造、响应解析等底层细节，是除 HTTP 直接调用和 [OpenAI 兼容接口](openai-compatible-interface.md)之外的主要接入方式。 ## 支持的语言与安装 | 语言 | 安装方式 | 版本要求 | -| --- | --- | --- | +|------|---------|---------| | Python | `pip install -U dashscope` | Python >= 3.8 | | Java | Maven/Gradle 引入 `com.alibaba:dashscope-sdk-java`（建议 >= 2.12.0） | - | -Node.js 目前没有官方 DashScope SDK，需通过 `axios` 等 HTTP 库直接调用 REST API，或使用 OpenAI 兼容 SDK 接入。 +> Node.js 目前没有官方 DashScope SDK，可通过 HTTP 直接调用或使用 OpenAI 兼容 SDK 接入。 -## 鉴权与环境配置 +## 鉴权配置 -DashScope SDK 使用 API Key 进行鉴权。推荐将 API Key 配置到环境变量 `DASHSCOPE_API_KEY`，SDK 会自动读取该变量，避免在代码中硬编码： +DashScope SDK 统一使用 [API Key](api-key.md) 进行鉴权。推荐将 [API Key](api-key.md) 配置到环境变量 `DASHSCOPE_API_KEY`，SDK 会自动读取该变量，避免在代码中硬编码： -- **Linux/macOS**：在 `~/.bashrc` 或 `~/.zshrc` 中添加 `export DASHSCOPE_API_KEY="your-key"`，然后 `source` 生效。 -- **Windows**：通过系统属性设置系统变量，或使用 `setx` / PowerShell 命令。 +- **Linux/macOS**：在 `~/.bashrc` 或 `~/.zshrc` 中追加 `export DASHSCOPE_API_KEY="your-key"`，然后 `source` 使其生效。 +- **Windows**：通过系统属性设置系统变量，或使用 `setx` / PowerShell 命令设置永久变量。 -也可在调用时通过 `api_key` 参数显式传入。注意不同地域（北京、新加坡等）的 API Key 不通用，切换地域时需同步更换。 +也可在调用时通过参数显式传入 `api_key`。 -## 使用场景 +## 覆盖的能力场景 + +DashScope SDK 覆盖百炼平台的大部分模型和应用调用场景： + +### 文本生成 + +通过 DashScope 原生接口调用 Qwen 系列文本生成模型，功能集最完整，支持全部采样参数和业务字段。适合需要使用百炼平台特有能力（如插件、扩展参数）的场景。 + +### 图像生成与编辑 + +图像模型（千问-图像、万相系列、Z-Image 等）均可通过 DashScope SDK 调用，涵盖文生图、图像编辑、图像翻译、风格迁移等能力。 + +### 视频生成 + +视频生成接口采用[异步调用](async-invocation.md)模式（创建任务 + 轮询获取），DashScope SDK 对任务提交和状态查询提供了封装支持。 + +### 向量与排序 + +文本向量（Embedding）和文本排序（Rerank）模型同时支持 [OpenAI 兼容接口](openai-compatible-interface.md)和 DashScope SDK。对于大规模向量化场景，可通过 SDK 使用异步批处理接口。 ### 应用调用 -通过 `Application.call` 方法调用百炼上创建的智能体应用和工作流应用。Python 示例： +通过 `Application.call`（Python）或 `ApplicationParam`（Java）调用百炼控制台中已创建的智能体应用和工作流应用。SDK 封装了请求构造和多轮对话的 `session_id` 管理。 + +### 专用模型 + +部分专用模型仅通过 DashScope SDK 可用。例如 `qwen-deep-research`（深度研究模型）当前仅支持 Python DashScope SDK，暂不支持 Java SDK 和 [OpenAI 兼容接口](openai-compatible-interface.md)。 + +## 调用示例 + +### Python — 调用应用 ```python +import os +from http import HTTPStatus from dashscope import Application response = Application.call( + api_key=os.getenv("DASHSCOPE_API_KEY"), app_id='YOUR_APP_ID', - prompt='你好' + prompt='你是谁？' ) -print(response.output.text) -``` - -Java 通过 `ApplicationParam.builder()` 构建参数，调用 `Application.call(param)` 完成请求。两种应用类型的调用接口完全一致，支持多轮对话（通过 `session_id` 或手动拼接历史消息）。 - -### 文本生成（Qwen 系列） - -DashScope 原生接口是百炼为 Qwen 系列模型提供的四种调用方式之一（另有 OpenAI 兼容、Anthropic 兼容、OpenAI Responses）。当需要使用最全的采样参数、插件或业务字段时，建议优先选择 DashScope 原生接口。 -### 专用模型 +if response.status_code == HTTPStatus.OK: + print(response.output.text) +``` -多个专用模型支持通过 DashScope SDK 调用： +### Java — 调用应用 -- **farui-plus**：法律行业大模型，支持法律咨询、文书生成、案情分析。 -- **tongyi-intent-detect-v3**：意图理解模型。 -- **qwen-deep-research**：深度研究模型（仅支持 Python DashScope SDK，不支持 Java SDK 和 [OpenAI 兼容接口](openai-compatible-interface.md)，且仅限华北2北京地域）。 -- **qwen-mt-plus**：翻译模型，支持术语干预和翻译记忆。 -- **qwen3.5-ocr**：图像文字提取与结构化抽取。 +```java +import com.alibaba.dashscope.app.*; -### 文本向量与排序 +ApplicationParam param = ApplicationParam.builder() + .apiKey(System.getenv("DASHSCOPE_API_KEY")) + .appId("YOUR_APP_ID") + .prompt("你是谁？") + .build(); -DashScope SDK 支持调用文本向量模型（如 text-embedding-v4）将文本转换为数值向量，也支持通过排序模型（如 qwen3-rerank）对候选文档进行相关性排序，广泛应用于语义搜索和 RAG 场景。 +Application application = new Application(); +ApplicationResult result = application.call(param); +System.out.printf("text: %s%n", result.getOutput().getText()); +``` -## 与 [OpenAI 兼容接口](openai-compatible-interface.md)的对比 +## 与 OpenAI 兼容接口的对比 | 维度 | DashScope SDK | OpenAI 兼容接口 | -| --- | --- | --- | -| 功能完整度 | 最全，支持百炼全部参数和插件 | 保证协议一致性，可能不暴露全部百炼参数 | -| 迁移成本 | 需学习百炼原生 API | 可直接复用现有 OpenAI 代码和生态工具 | +|------|--------------|----------------| +| 功能覆盖 | 最完整，支持百炼原生全部参数 | 为保证协议一致性，可能不暴露部分平台特有参数 | +| 迁移成本 | 需学习百炼原生 API | 可直接复用 OpenAI SDK 和现有代码 | | 语言支持 | Python、Java | Python、Java、Node.js、Go | -| 内置工具 | 按各接口自行定义 | Responses 接口内置联网搜索、代码解释器等 | +| 内置工具 | 无内置工具，需自行定义 | Responses 接口内置联网搜索、代码解释器等 | -如果项目已有 OpenAI SDK 集成且无需百炼专属参数，使用 OpenAI 兼容接口迁移成本更低；如果需要使用百炼平台的全部能力或调用仅 DashScope 支持的模型，建议使用 DashScope SDK。 +选择建议：如需使用百炼平台的全部能力或仅支持 DashScope SDK 的模型，使用 DashScope SDK；如从 OpenAI 生态迁移或需要 Node.js/Go 支持，使用 OpenAI 兼容接口。 -## 常见问题 +## 注意事项 -- **环境变量不生效**：设置环境变量后需重启 IDE 或终端；使用 `sudo` 运行脚本时需加 `-E` 参数以继承用户环境变量。 -- **模型不可用**：确认模型名称拼写正确，注意大小写，不要混用开源社区名与百炼模型 ID。 -- **地域限制**：部分模型（如 qwen-deep-research）仅在特定地域可用，需使用对应地域的 API Key。 +- 设置环境变量后，已打开的 IDE 或终端不会自动加载新变量，需要重启相关程序。 +- 使用 `sudo` 运行脚本时，默认不继承用户环境变量，需加 `-E` 参数。 +- 调用不同地域的模型时，需保证 [API Key](api-key.md) 与模型属于同一地域。华北2（北京）和新加坡地域推荐使用[业务空间](workspace.md)专属域名以获得更好性能。 ## 关联主题页 -- [bailian application calling](../guides/bailian-application-calling.md) +- [image generation](../api/image-generation.md) - [more models](../api/more-models.md) -- [qwen api reference](../api/qwen-api-reference.md) -- [toolkits and frameworks](../api/toolkits-and-frameworks.md) -- [preparations](../api/preparations.md) +- [bailian application calling](../guides/bailian-application-calling.md) +- [video generation api](../api/video-generation-api.md) - [vector and sort](../api/vector-and-sort.md) +- [preparations](../api/preparations.md) +- [qwen api reference](../api/qwen-api-reference.md) diff --git a/skills/bailian-docs-llm-wiki/wiki/concepts/function-calling.md b/skills/bailian-docs-llm-wiki/wiki/concepts/function-calling.md index ded5950..31c2bb9 100644 --- a/skills/bailian-docs-llm-wiki/wiki/concepts/function-calling.md +++ b/skills/bailian-docs-llm-wiki/wiki/concepts/function-calling.md @@ -1,74 +1,95 @@ -# 函数调用（Function Calling） +# 函数调用 -函数调用（Function Calling）是大模型与外部工具交互的核心机制：开发者在请求中声明可用的函数（工具）定义，模型根据用户输入自主判断是否需要调用某个函数，并输出结构化的调用参数，由应用侧执行后将结果回传模型以生成最终回答。 +函数调用（Function Calling）是大模型与外部工具交互的核心机制，允许模型在对话过程中根据用户意图自主决定调用预定义的函数或工具，获取实时数据或执行特定操作后再生成最终回复。 -## 工作原理 +## 基本原理 -函数调用的典型流程分为三步： +函数调用的典型流程为： -1. **声明工具**：开发者在 API 请求中通过 `tools` 字段传入函数名称、描述和参数 JSON Schema。 -2. **模型决策**：模型分析用户输入与工具描述，判断是否需要调用工具。如需调用，模型输出 `tool_calls`（包含函数名与参数），而非直接生成文本回答。 -3. **执行与回传**：应用侧根据 `tool_calls` 执行实际函数，将返回结果以 `tool` 角色消息追加到对话历史，再次请求模型生成最终回答。 +1. 开发者在请求中定义一组可用工具（函数名称、描述、参数 schema）。 +2. 模型根据用户输入判断是否需要调用工具，若需要则输出结构化的函数名与参数。 +3. 客户端执行实际的函数调用，将返回结果回传给模型。 +4. 模型结合工具返回结果生成最终回复。 -模型本身不执行函数，仅负责决策和参数生成；实际执行完全在应用侧完成。 +这一机制使大模型能够突破自身在实时信息获取、精确计算、外部系统操作等方面的局限。 ## 在百炼平台的使用场景 -### OpenAI 兼容 Chat Completions 接口 +### 通过 API 接口调用 -通过标准 `tools` 和 `tool_choice` 字段定义函数，支持非流式与流式调用。开发者只需将 `api_key`、`base_url`、`model` 替换为百炼的值，即可复用现有 OpenAI function call 代码。支持的模型包括 Qwen 系列商业版与开源版、DeepSeek、Kimi、GLM 等。 +百炼提供多种兼容接口，均支持函数调用能力： -### OpenAI 兼容 Responses 接口 - -Responses 接口在函数调用基础上进一步内置了联网搜索、代码解释器、网页内容提取等工具，开箱即用，无需自行定义。平台自动管理对话历史，简化了多轮工具调用的上下文维护。 +| 接口 | 函数调用方式 | +| --- | --- | +| OpenAI 兼容 Chat Completions | 通过 `tools` 参数定义工具列表，模型返回 `tool_calls` 结构 | +| OpenAI 兼容 Responses | 内置联网搜索、代码解释器、网页内容提取等工具，开箱即用；也支持自定义工具 | +| Anthropic 兼容 Messages | 兼容 Anthropic 工具调用协议，支持思考模式与工具调用 | +| DashScope 原生 | 功能集最完整，参数支持最丰富 | -### Anthropic 兼容 Messages 接口 +其中 Responses 接口内置的联网搜索、代码解释器等为平台托管工具，无需开发者自行实现函数逻辑；其他接口需按各自协议自行定义工具。 -兼容 Anthropic Messages API 的工具调用协议，支持 thinking 与 tool use，适合从 Anthropic 生态迁移的开发者。 +### 在实时[多模态](multimodal.md)交互中使用 -### DashScope 原生接口 +Qwen-Omni-Realtime API 支持在 WebSocket 实时会话中使用函数调用。当模型判断需要调用工具时，服务端会在响应中输出工具调用请求，客户端完成实际调用后，通过 `conversation.item.create` 事件将结果回传，再发送 `response.create` 触发模型继续生成。这种机制使语音对话场景也能接入外部数据源和服务。 -百炼原生接口提供最完整的参数支持，适合需要使用全部采样参数、插件或业务字段的场景。 +### 在智能体应用中使用 -### 插件系统 +百炼智能体应用将函数调用作为核心能力之一： -百炼插件本质上是对函数调用的平台级封装。每个插件包含一个或多个工具，在智能体应用中由模型自动判断是否调用。支持官方插件（如代码解释器、夸克搜索、计算器）、三方插件和自定义插件。单个智能体应用最多可添加 10 个工具。 +- **Agent 2.0**：将知识库、MCP 服务、插件等统一为工具，由模型自主规划调用顺序，支持完整的"规划-执行-反思"链路。通过 ReAct 最大轮次参数（1-50）限制单次会话中工具调用的最大次数。 +- **Agent 1.0**：先检索知识库，再决策是否调用插件工具，适用于流程固定的简单任务。 -### MCP 服务 +### 在工作流应用中使用 -模型上下文协议（MCP）为函数调用提供了标准化的工具接入通道。通过 MCP，智能体可接入海量第三方工具而无需逐一编写接口。单个智能体最多同时添加 5 个 MCP 服务。 +工作流中的插件节点和 MCP 节点本质上也是函数调用，区别在于调用顺序由用户编排的流程决定，而非由模型自主规划。 -### 实时[多模态](multimodal.md)交互 +### 通过插件体系使用 -Qwen-Omni-Realtime API 在 WebSocket 长连接中支持函数调用。模型在实时语音对话过程中可触发工具调用，客户端执行后通过 `conversation.item.create` 回传结果，再发送 `response.create` 让模型继续生成响应。 +百炼插件是函数调用在平台层的封装。每个插件包含一个或多个工具（API），模型根据工具名称和描述自动判断是否调用。官方插件包括 Python 代码解释器、计算器、夸克搜索、图片生成等，均可在智能体中直接关联使用。 -### Managed Agents API +### 通过 MCP 协议使用 -托管智能体运行时中，函数调用通过 Event 机制实现。用户消息、工具调用回执、函数执行结果等均以事件形式在会话中流转，支持 SSE 流式推送。 +模型上下文协议（MCP）为函数调用提供了标准化的传输层。百炼支持官方 MCP 服务和自定义 MCP 服务，单个智能体最多可同时接入 5 个 MCP 服务，工作流中每个 MCP 节点使用一个工具。 ## 关键参数与配置 -| 参数 | 说明 | -| --- | --- | -| `tools` | 工具定义数组，每个元素包含 `type`（通常为 `function`）、`function.name`、`function.description` 和 `function.parameters`（JSON Schema） | -| `tool_choice` | 控制模型的工具调用策略：`auto`（模型自主决定）、`none`（禁止调用）、或指定某个函数名（强制调用） | -| `tool_calls` | 模型返回的调用指令，包含 `id`、`function.name` 和 `function.arguments` | -| `parallel_tool_calls` | 是否允许模型在单次响应中并行调用多个函数 | +### API 层面 + +- **`tools`**：工具定义数组，每个工具包含 `type`（固定为 `function`）、`function.name`、`function.description` 和 `function.parameters`（JSON Schema 格式）。 +- **`tool_choice`**：控制模型的工具调用策略，可选 `auto`（模型自主决定）、`none`（禁止调用）或指定特定函数名。 +- **`parallel_tool_calls`**：是否允许模型在一次回复中并行调用多个工具。 + +### 应用层面 + +- **ReAct 最大轮次**：智能体应用中限制单次会话的工具调用次数上限（1-50），超出后自动生成最终回复。 +- **工具数量限制**：每个智能体应用最多添加 10 个插件工具，最多 5 个 MCP 服务。 + +## 支持的模型 + +函数调用能力对模型有一定要求，目前支持的主要模型包括： + +- Qwen 系列：qwen-max、qwen-plus、qwen-turbo 及其变体 +- Qwen3 系列：qwen3-max、qwen3.7-max、qwen3.7-plus 等 +- Qwen-VL 系列：qwen-vl-max、qwen-vl-plus +- Qwen-Omni-Realtime 系列：支持实时语音场景下的工具调用 +- 部分三方直供模型（DeepSeek、Kimi、GLM、MiniMax 等） + +建议选用具备强工具调用能力的模型（如千问-Max 系列）以获得更好的调用准确性。 ## 注意事项 -- **Token 消耗**：工具定义和工具返回结果都会占用上下文窗口中的 Token，工具数量较多时需注意输入 Token 的增长。 -- **模型兼容性**：不同模型对函数调用的支持程度不同，建议使用 Qwen-Plus、Qwen-Max 等较强的推理模型以获得更准确的调用决策。 -- **描述质量**：函数名称和描述的清晰度直接影响模型的调用准确性，建议在描述中明确说明函数用途、参数含义和返回值格式。 -- **接口差异**：Responses 接口内置工具开箱即用，Chat Completions 和其他接口需自行定义工具；从不同平台迁移时应先确认目标接口对 `tools` 参数的支持情况。 +- 函数调用会增加 [Token](token.md) 消耗：工具定义和工具返回内容均计入输入 [Token](token.md)。 +- 调用准确性依赖工具描述的质量，建议在描述中明确工具的功能、适用场景和参数含义。 +- 不同接口的工具调用能力存在差异，Responses 接口内置工具最丰富，DashScope 原生接口参数支持最全。 +- 自定义插件有超时限制（旧版智能体为 5 秒），需确保工具响应速度。 ## 关联主题页 - [omni realtime api](../api/omni-realtime-api.md) - [qwen api reference](../api/qwen-api-reference.md) +- [toolkits and frameworks](../api/toolkits-and-frameworks.md) - [plug in](../guides/plug-in.md) +- [llm application](../guides/llm-application.md) - [model context protocol](../guides/model-context-protocol.md) -- [toolkits and frameworks](../api/toolkits-and-frameworks.md) -- [managed agents api](../api/managed-agents-api.md) diff --git a/skills/bailian-docs-llm-wiki/wiki/concepts/multimodal.md b/skills/bailian-docs-llm-wiki/wiki/concepts/multimodal.md index c3c3f0c..4829fc1 100644 --- a/skills/bailian-docs-llm-wiki/wiki/concepts/multimodal.md +++ b/skills/bailian-docs-llm-wiki/wiki/concepts/multimodal.md @@ -1,74 +1,68 @@ # 多模态 -多模态（Multimodal）指模型同时处理和生成多种信息形态（文本、图像、音频、视频、3D 等）的能力。百炼平台围绕多模态提供了从理解、生成到检索排序的完整模型矩阵，开发者可按场景选择对应的模型和 API。 - -## 百炼平台的多模态能力谱 - -百炼平台的多模态能力覆盖以下维度： - -| 维度 | 典型场景 | 代表模型 | -|------|----------|----------| -| 多模态理解 | 图像分析、视频理解、OCR | qwen3.7-plus、qwen3.6-flash、qwen3.5-ocr | -| 实时多模态交互 | 语音+视频实时对话 | qwen3.5-omni-realtime 系列 | -| 图像生成与编辑 | 文生图、图像编辑、文字渲染 | wan2.7-image-pro、qwen-image-2.0-pro、z-image-turbo | -| 视频生成与编辑 | 文生视频、图生视频、视频编辑 | happyhorse-1.1 系列、wan2.7 系列 | -| 3D 生成 | 文生 3D、图生 3D | Tripo/Tripo-H3.1、Tripo/Tripo-P1.0 | -| 多模态向量 | 跨模态检索（以文搜图、以图搜视频） | qwen3-vl-embedding | -| 多模态排序 | 图文视频混合 Rerank | qwen3-vl-rerank | +多模态（Multimodal）是指模型同时处理和生成多种信息形态（文本、图像、音频、视频、3D 等）的能力。在百炼平台中，多模态贯穿模型调用、知识库检索、向量化与排序等核心环节，是实现跨媒体理解与生成的基础技术概念。 ## 多模态理解 -视觉理解模型接受图像或视频作为输入，与文本提示配合完成分析、问答、OCR 等任务。推荐从 qwen3.7-plus 开始——它支持 1M 上下文、最长 2 小时视频输入、每张图片最高 1600 万像素，同时具备 Function Calling 和结构化输出能力。图像 Token 计算公式为 `h x w / (32 x 32) + 2`。 - -## 实时多模态交互 +百炼平台提供多种模型用于理解不同模态的输入内容： -Qwen-Omni-Realtime API 基于 WebSocket 长连接实现低延迟的语音、视频、图像实时对话。支持 VAD 自动检测与 Manual 手动控制两种交互模式，并可配合声音复刻、工具调用、联网搜索等能力。关键配置包括： - -- **交互模式**：`turn_detection.type` 设为 `server_vad`（自动检测）或 `null`（手动控制） -- **VAD 灵敏度**：`threshold` 范围 [-1.0, 1.0]，默认 0.5 -- **静音时长**：`silence_duration_ms` 范围 [200, 6000]，默认 800 -- **静默超时**：`idle_timeout_ms` 范围 [5000, 30000]，超时后模型主动引导对话 +- **视觉理解**：`qwen3.7-plus`、`qwen3.6-flash` 等模型支持图像分析和视频理解，单张图片最高 1600 万像素，视频最长 2 小时。[Token](token.md) 计算公式为 `h x w / (32 x 32) + 2`。`qwen3.5-ocr` 专为文档、表格、手写内容的 OCR 场景优化。 +- **实时多模态交互**：Qwen-Omni-Realtime 系列模型通过 WebSocket 长连接实现低延迟的语音、视频、图像实时对话，支持 VAD 自动检测与 Manual 手动控制两种交互模式，并提供声音复刻、工具调用、联网搜索等能力。 ## 多模态生成 -### 图像生成 +平台覆盖图像、视频、3D 等生成场景： -百炼提供千问（Qwen-Image）、万相（Wan/Wanx）、Z-Image 等多个图像生成模型系列。wan2.7-image-pro 支持文生图最高 4K 输出、文字渲染和角色一致性；z-image-turbo 速度快且成本低，适合只需生成不需编辑的场景；qwen-image-2.0-pro 支持负向提示词和多张变体。 +- **图像生成与编辑**：千问（Qwen-Image）系列擅长文字渲染与图文混合布局；万相（Wan）系列覆盖文生图、图像编辑、多图参考生成；Z-Image 提供轻量快速的文生图能力。 +- **视频生成**：万相 2.7 系列为主力模型，支持文生视频、图生视频、参考生视频、视频编辑、风格转换等。HappyHorse、Pixverse、Vidu、Kling 等第三方模型提供补充能力。所有视频生成 API 均采用[异步调用](async-invocation.md)模式（创建任务 → 轮询获取）。 +- **3D 模型生成**：通过 Tripo 模型支持文生 3D、单图生 3D 和多图生 3D。 -### 视频生成 +## 多模态向量与排序 -视频生成 API 覆盖文生视频、图生视频、参考生视频、视频编辑、数字人等场景，底层模型包括万相（Wan）、HappyHorse、Pixverse、Vidu、Kling 等。所有接口采用[异步调用](async-invocation.md)模式（创建任务 → 轮询获取），单次生成通常耗时 1-5 分钟。 +向量化和排序模型将多模态内容统一到同一语义空间，是 RAG 检索和跨模态搜索的基础： -### 3D 生成 +- **多模态向量模型**：`qwen3-vl-embedding`（2560 维）可将文本、图像、视频转换为同一语义空间的向量，支持独立向量（逐项对比）和融合向量（综合理解）两种类型，适用于以文搜图、以图搜视频等跨模态检索场景。`multimodal-embedding-v1`（1024 维）用于图片问答类知识库。 +- **多模态排序模型**：`qwen3-vl-rerank` 支持对文本、图片、视频混合文档进行相关性排序，最大支持 100 条文本 / 40 张图片 / 4 个视频，单条最大 8,000 [Token](token.md)。多模态知识库的排序必须选用此模型。 -基于 Tripo 模型实现文生 3D、单图生 3D 和多图生 3D，产出带 PBR 材质贴图的 GLB 模型。同样采用[异步调用](async-invocation.md)模式，仅限北京地域使用。 +## 多模态知识库 -## 多模态检索与排序 +百炼知识库支持多种多模态场景： -多模态向量模型（qwen3-vl-embedding）将文本、图像和视频映射到同一语义空间，支持跨模态检索。向量类型分为独立向量（逐项对比）和融合向量（综合理解多模态内容）。 +| 知识库类型 | 多模态能力 | 说明 | +|-----------|-----------|------| +| 图片问答 | 图像理解 + 检索 | 仅支持 `multimodal-embedding-v1` 向量模型 | +| 音视频搜索 | 语音识别 + 视频帧提取 + 剧情解析 | 按时间轴结构化对齐 | +| 视觉理解文档搜索 | 富文本文档的图文并茂回复 | 自动切换为 `qwen3-vl-embedding` 向量模型 | -多模态排序模型（qwen3-vl-rerank）可对文本、图片、视频混合的候选文档进行相关性排序，最多支持 100 条文本、40 张图片或 4 段视频的单次排序请求，适用于 RAG 流程中的精排阶段。 +知识库创建时需选定类型且不可更改。多模态知识库的排序模型只能使用 `qwen3-vl-rerank`。 -## 调用方式差异 +## 关键参数速查 -不同多模态能力的调用方式有所不同： +| 场景 | 参数 / 配置 | 说明 | +|------|------------|------| +| 视觉理解 | 图片像素上限 1600 万 | [Token](token.md) = `h x w / (32 x 32) + 2` | +| 实时交互 | `session.turn_detection.type` | `server_vad` / `semantic_vad` / `null`（Manual） | +| 多模态向量 | `dimensions` | `qwen3-vl-embedding` 默认 2560 维 | +| 多模态排序 | `qwen3-vl-rerank` | 文本 100 条 / 图片 40 张 / 视频 4 个 | +| 视频生成 | [异步调用](async-invocation.md) | `X-DashScope-Async: enable`，轮询 task_id | +| 图像生成 | 模型选择 | 文字渲染用千问系列，通用生成用万相系列 | -| 能力类型 | 调用方式 | 响应模式 | -|----------|----------|----------| -| 多模态理解（视觉） | [OpenAI 兼容接口](openai-compatible-interface.md) / [DashScope SDK](dashscope-sdk.md) | 同步流式 | -| 实时交互 | WebSocket 长连接 | 双向实时 | -| 图像/视频/3D 生成 | HTTP REST + 异步头 | 异步轮询 | -| 向量与排序 | [OpenAI 兼容接口](openai-compatible-interface.md) / [DashScope SDK](dashscope-sdk.md) | 同步 | +## 开发者注意事项 -开发者在接入多模态能力时需注意：模型、Endpoint URL 与 API Key 必须属于同一地域，跨地域调用会失败。推荐使用[业务空间](workspace.md)专属域名（`{WorkspaceId}.cn-beijing.maas.aliyuncs.com`）以获得更好的性能与稳定性。 +- 多模态模型、Endpoint URL、[API Key](api-key.md) 必须属于同一地域，跨地域调用会失败。 +- 知识库功能仅在华北2（北京）地域可用。 +- 视频生成为异步接口，单次请求耗时通常 1-5 分钟，需通过 task_id 轮询结果。 +- Token Plan 团队版支持多模态生成模型（图像生成），Coding Plan 仅支持文本生成模型。 +- 实时多模态交互（Omni Realtime）通过 WebSocket 接入，北京与新加坡地域使用不同的接入地址。 ## 关联主题页 - [omni realtime api](../api/omni-realtime-api.md) +- [token plan guide](../guides/token-plan-guide.md) - [model experience](../guides/model-experience.md) -- [video generation api](../api/video-generation-api.md) +- [knowledge base](../guides/knowledge-base.md) - [image generation](../api/image-generation.md) -- [3d generation](../api/3d-generation.md) +- [video generation api](../api/video-generation-api.md) - [vector and sort](../api/vector-and-sort.md) diff --git a/skills/bailian-docs-llm-wiki/wiki/concepts/openai-compatible-interface.md b/skills/bailian-docs-llm-wiki/wiki/concepts/openai-compatible-interface.md index dd1c83d..907d701 100644 --- a/skills/bailian-docs-llm-wiki/wiki/concepts/openai-compatible-interface.md +++ b/skills/bailian-docs-llm-wiki/wiki/concepts/openai-compatible-interface.md @@ -1,33 +1,35 @@ # OpenAI 兼容接口 -OpenAI 兼容接口是阿里云百炼平台提供的一组遵循 OpenAI API 协议规范的接口，开发者只需将 `api_key`、`base_url`、`model` 三个参数替换为百炼的值，即可复用现有 OpenAI SDK 和生态工具直接调用百炼模型服务，实现最低成本的迁移接入。 +OpenAI 兼容接口是阿里云百炼平台提供的一组遵循 OpenAI API 协议的调用端点，开发者无需修改已有的 OpenAI SDK 代码，只需替换 `api_key`、`base_url` 和 `model` 三个参数即可接入百炼的模型服务。 -## 覆盖的接口类型 +## 接口类型 -百炼兼容的 OpenAI 接口覆盖以下能力，调用路径均挂载在 `compatible-mode/v1` 下： +百炼兼容的 OpenAI 接口覆盖多种能力，调用路径均位于 `compatible-mode/v1` 下： | 接口 | HTTP 路径 | 典型场景 | | --- | --- | --- | | Chat Completions | `POST /chat/completions` | 多轮对话、function call、[流式输出](streaming.md) | -| Responses | `POST /responses` | 智能体原生能力、内置工具（联网搜索、代码解释器、网页抓取）、自动管理对话历史 | +| Responses | `POST /responses` | 智能体原生能力、内置工具（联网搜索、代码解释器、网页内容提取）、自动上下文管理 | | Completions | `POST /completions` | 代码补全、文本续写（FIM） | | Embeddings | `POST /embeddings` | 文本向量化 | | Vision | 走 Chat Completions | 图像/视频理解 | -| File | `POST /files` 等 | 文件上传/查询/删除 | -| Batch | `POST /batches` | 异步批量推理（费用 50%） | +| File | `POST /files` 等 | 上传/查询/删除文件 | +| Batch | `POST /batches` | 异步批量推理，费用 50% | | Conversations | `POST /conversations` | 跨设备会话状态管理 | -其中 Chat Completions 是最常用的接口，支持 Qwen 全系列、DeepSeek、Kimi、GLM、MiniMax 等模型；Responses 接口作为 Chat Completions 的演进版本，额外内置联网搜索、代码解释器和网页内容提取，并由平台自动管理对话历史。 +其中 **Chat Completions** 是最常用的接口，支持 Qwen 全系列、DeepSeek、Kimi、GLM、MiniMax 等大语言模型；**Responses** 接口是 Chat Completions 的演进版本，内置联网搜索、代码解释器和网页内容提取工具，并由平台自动管理对话历史，无需在请求中手动拼接 `messages`。 + +百炼还提供 Anthropic 兼容接口和 DashScope 原生接口。当 OpenAI 兼容接口无法满足全部参数需求时，可考虑使用 DashScope 原生接口获取最完整的功能集。 ## 接入三要素 -所有兼容接口的迁移都围绕以下三个参数： +从 OpenAI 迁移到百炼时，需要替换以下三项配置： -- **api_key**：替换为百炼 API Key，建议通过环境变量 `DASHSCOPE_API_KEY` 注入。不同计费方案（按量计费、Token Plan 团队版、Coding Plan）的 API Key 互不通用。 -- **base_url**：使用[业务空间](workspace.md)专属域名，格式为 `https://{WorkspaceId}..maas.aliyuncs.com/compatible-mode/v1`，其中 `{WorkspaceId}` 为[业务空间](workspace.md) ID。不同计费方案和地域的 Base URL 不能混用。 -- **model**：指定目标模型名称，如 `qwen3.7-plus`、`deepseek-v4-pro` 等。 +- **api_key**：替换为百炼 [API Key](api-key.md)，建议通过环境变量 `DASHSCOPE_API_KEY` 注入。不同地域的 [API Key](api-key.md) 相互独立，不能跨地域混用。 +- **base_url**：使用[业务空间](workspace.md)专属域名，格式为 `https://{WorkspaceId}..maas.aliyuncs.com/compatible-mode/v1`，其中 `{WorkspaceId}` 为[业务空间](workspace.md) ID。 +- **model**：替换为百炼支持的模型名称，如 `qwen3.7-max`、`qwen3.7-plus`、`deepseek-v4-pro` 等。 -### 各地域 Base URL +## 各地域 Base URL | 地域 | Base URL | | --- | --- | @@ -35,18 +37,22 @@ OpenAI 兼容接口是阿里云百炼平台提供的一组遵循 OpenAI API 协 | 新加坡 | `https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1` | | 日本（东京） | `https://{WorkspaceId}.ap-northeast-1.maas.aliyuncs.com/compatible-mode/v1` | | 美国（弗吉尼亚） | `https://dashscope-us.aliyuncs.com/compatible-mode/v1` | -| 德国（法兰克福） | `https://{WorkspaceId}.eu-central-1.maas.aliyuncs.com/compatible-mode/v1`（仅 Responses 接口） | +| 德国（法兰克福） | `https://{WorkspaceId}.eu-central-1.maas.aliyuncs.com/compatible-mode/v1`（Responses 接口） | + +> 弗吉尼亚地域使用固定域名，不带 `{WorkspaceId}`；其余地域均需替换为真实[业务空间](workspace.md) ID。 -### 订阅套餐专属 Base URL +订阅套餐用户使用专属域名： -| 方案 | Base URL | +| 套餐 | Base URL | | --- | --- | -| Token Plan 团队版 | `https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1` | +| [Token](token.md) Plan 团队版 | `https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1` | | Coding Plan | `https://coding.dashscope.aliyuncs.com/v1` | -## 调用示例 +三类 [API Key](api-key.md) 与 Base URL 互不相通，误用会导致 401/403 错误。 + +## 快速上手 -以 Python 为例，使用 OpenAI SDK 调用百炼 Qwen 模型： +安装 OpenAI Python SDK 后即可调用： ```python import os @@ -57,37 +63,54 @@ client = OpenAI( base_url="https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1", ) completion = client.chat.completions.create( - model="qwen3.7-plus", - messages=[{"role": "user", "content": "你是谁？"}] + model="qwen-plus", + messages=[ + {"role": "system", "content": "You are a helpful assistant."}, + {"role": "user", "content": "你好"} + ] ) print(completion.choices[0].message.content) ``` -Node.js 和 curl 的用法同理，只需替换对应的 api_key、base_url 和 model 即可。 +## 支持的第三方工具 + +百炼的 OpenAI 兼容接口可直接对接主流 AI 编程工具和聊天客户端： + +- **终端 CLI**：Claude Code、Codex、Qwen Code、OpenCode、Kilo CLI 等 +- **桌面客户端**：Cherry Studio、Chatbox、QwenPaw +- **IDE 插件**：Cursor、Cline、Qoder +- **开发平台**：Dify、LangChain、LangChain4j + +这些工具只需在配置中填入百炼的 API Key 和 Base URL 即可完成接入。 -## 在不同场景中的使用 +## 应用调用 -- **模型直接调用**：通过 Chat Completions 或 Responses 接口调用 Qwen、DeepSeek、Kimi 等文本生成模型，以及翻译模型（qwen-mt-plus）、OCR 模型（qwen3.5-ocr）、GUI 交互模型（gui-plus）等专用模型。 -- **应用调用**：百炼智能体和工作流应用支持通过 OpenAI 兼容的 Responses API 调用，Endpoint 为 `/api/v2/apps/agent/{APP_ID}/compatible-mode/v1/responses`，支持同步、异步和[流式输出](streaming.md)。 -- **AI 编程工具接入**：Claude Code、Cursor、Cline、OpenCode 等终端工具均可通过 OpenAI 兼容协议接入百炼，配置对应的 API Key 和 Base URL 即可。 -- **框架集成**：LangChain、LangChain4j 等框架可直接通过 OpenAI 兼容接口对接百炼，无需额外适配。 +百炼的智能体和工作流应用也支持通过 OpenAI 兼容的 Responses API 调用，Endpoint 格式为： + +``` +POST https://dashscope.aliyuncs.com/api/v2/apps/agent/{APP_ID}/compatible-mode/v1/responses +``` + +支持同步/[异步调用](async-invocation.md)、多轮对话、[流式输出](streaming.md)和[多模态](multimodal.md)输入。 ## 限制与注意事项 -- **功能完整度**：兼容接口为保证协议一致性，可能不暴露百炼原生 DashScope 接口的全部参数。如需最完整的采样参数和业务字段，建议使用 DashScope 原生接口。 -- **接口能力差异**：联网搜索、代码解释器、网页内容提取为 Responses 接口专属内置能力，Chat Completions 接口不内置这些工具。 -- **对话历史管理**：仅 Responses 接口自动维护对话历史，使用其他接口时需自行管理上下文。 -- **模型兼容性**：部分模型（如 Qwen-Audio、qwen-deep-research）不支持 OpenAI 兼容协议，仅支持 DashScope 协议，使用前需确认目标模型的协议支持情况。 -- **API Key 与 Base URL 必须匹配**：按量计费、Token Plan、Coding Plan 的 API Key 和 Base URL 互不通用，混用会导致 401/403 错误。 +- **功能完整度**：兼容接口为保证协议一致性，可能不暴露百炼原生的全部参数。如需最完整的采样参数和业务字段，建议使用 DashScope 原生接口。 +- **工具能力差异**：联网搜索、代码解释器、网页内容提取为 Responses 接口专属内置能力，Chat Completions 接口不内置这些工具。 +- **对话历史管理**：仅 Responses 接口自动维护对话历史，其余接口需由调用方自行管理上下文。 +- **模型兼容性**：部分专用模型（如 `qwen-deep-research`）暂不支持 OpenAI 兼容接口，仅支持 [DashScope SDK](dashscope-sdk.md) 调用。`Qwen-Audio` 同样仅支持 DashScope 协议。 +- **地域限制**：[Token](token.md) Plan 团队版仅支持华北2（北京）地域；三方直供模型仅在中国站的中国内地地域可用。 +- **迁移评估**：从 OpenAI 迁移时，应先确认目标模型在兼容接口下是否支持所需参数（如 `temperature`、`tools`、`stream` 等），再决定接口选型。 ## 关联主题页 - [qwen api reference](../api/qwen-api-reference.md) - [toolkits and frameworks](../api/toolkits-and-frameworks.md) +- [use chat client or development tool](../guides/use-chat-client-or-development-tool.md) - [get started with models](../guides/get-started-with-models.md) - [more models](../api/more-models.md) -- [use chat client or development tool](../guides/use-chat-client-or-development-tool.md) - [token plan guide](../guides/token-plan-guide.md) +- [managed agents api](../api/managed-agents-api.md) - [application call](../api/application-call.md) diff --git a/skills/bailian-docs-llm-wiki/wiki/concepts/rag.md b/skills/bailian-docs-llm-wiki/wiki/concepts/rag.md index 15f0832..9f2cfa1 100644 --- a/skills/bailian-docs-llm-wiki/wiki/concepts/rag.md +++ b/skills/bailian-docs-llm-wiki/wiki/concepts/rag.md @@ -1,87 +1,117 @@ -# 检索增强生成（RAG） +# 检索增强生成 -检索增强生成（Retrieval-Augmented Generation，RAG）是一种将外部知识检索与大模型生成相结合的技术范式，通过在推理时动态检索相关文档片段并注入上下文，使大模型能够基于私有数据和最新信息生成更准确的回答。百炼平台以 RAG 为核心技术构建了知识库服务体系，覆盖从数据导入、向量化、检索召回到问答生成的完整链路。 +检索增强生成（Retrieval-Augmented Generation, RAG）是一种将外部知识检索与大模型生成相结合的技术范式：先从知识库中检索与用户问题相关的文本片段，再将这些片段作为上下文注入大模型，从而生成更准确、更具时效性的回答。在百炼平台中，RAG 是知识库问答、智能体应用和多渠道 AI 助手的核心技术基础。 ## 核心流程 -百炼 RAG 的标准流水线分为四个阶段： +百炼平台的 RAG 流程分为四个阶段： -1. **文档解析与切片**：将非结构化文档（PDF、Word、Markdown 等）解析为文本，按语义切分为片段（推荐智能切分，单切片上限 6,000 Token）。 -2. **向量化**：使用 Embedding 模型将切片转换为数值向量并存入向量索引。推荐 text-embedding-v4（Qwen3-Embedding 系列，支持 100+ 语种，维度可选 64–2048）。 -3. **检索与排序**：接收用户 Query 后，经 Query 改写 → 向量 + 关键词混合检索 → Rerank 排序 → 加权返回相关切片。 -4. **生成回答**：将检索到的切片与用户问题拼接为 Prompt，送入大模型生成最终回答。 +1. **数据导入与解析**：将非结构化文档（PDF、Word、Markdown、音视频等）导入知识库，经文档解析后切分为语义片段（切片）。 +2. **向量化索引**：使用文本向量模型（如 text-embedding-v4）将切片转换为数值向量并建立索引。 +3. **检索与排序**：接收用户查询后，通过向量语义检索 + 关键词匹配混合召回候选切片，再用排序模型（如 qwen3-rerank）对结果做二次精排。 +4. **生成回答**：将排序后的切片与用户问题拼接为 [prompt](../guides/prompt.md)，送入大模型（如 qwen3.6-plus、qwen-max）生成最终回答。 -## 在百炼平台的使用方式 +## 在百炼平台中的使用方式 -### 知识库服务（托管式） +### 云端知识库 RAG -在百炼控制台创建知识库，平台托管全部 RAG 流程。支持四种知识库类型： +百炼控制台提供完整的知识库管理能力，支持以下知识库类型： -- **文档搜索类**：企业文档、产品手册等非结构化数据问答 -- **数据查询类**：结构化 Excel/CSV，支持 NL2SQL -- **图片问答类**：基于 multimodal-embedding-v1 的视觉检索 -- **音视频搜索类**：语音识别 + 视频帧提取，按时间轴结构化 +- **文档搜索类**：适用于企业文档、产品手册等非结构化数据，支持基础问答、图文回复、视觉理解等子场景。 +- **数据查询类**：结构化知识库，支持 NL2SQL 查询 Excel/CSV 数据。 +- **图片问答类**：基于[多模态](multimodal.md)向量模型 multimodal-embedding-v1 实现以图搜图。 +- **音视频搜索类**：对语音做识别、对视频做帧提取与剧情解析，按时间轴结构化对齐。 -平台提供两条独立服务线： -- **知识检索**（`POST /api/v1/indices/knowledge/search`）：仅返回排序后的切片，适合自定义生成流程 -- **知识问答**（`POST /api/v2/apps/knowledge/chat`）：端到端问答，支持极速模式和 Agentic 多轮规划搜索，通过 SSE [流式输出](streaming.md) +知识库提供两条独立服务线： -### 框架集成（自建式） +- **知识检索服务**：仅返回检索切片，不生成回答，适合需要自定义生成流程的场景。 +- **知识问答服务**：在检索基础上叠加生成模型，支持极速模式（单轮检索 + 生成）和多轮智能模式（Agentic 多轮规划搜索）。 -通过开源框架在应用侧构建 RAG： +### 框架集成 RAG -- **LlamaIndex**（Python）：使用 `DashScopeCloudIndex` 创建云端知识库，`DashScopeCloudRetriever` 执行检索，支持 `SimilarityPostprocessor` 和 `DashScopeRerank` 后处理 -- **Spring AI Alibaba**（Java）：在 Spring Boot 3.x 中集成百炼知识库检索能力 -- **本地 RAG**：检索在本地执行，生成调用通义千问 API，适合需要灵活切分和自定义嵌入模型的场景 +百炼支持通过开源框架构建 RAG 应用： -### 渠道接入 +- **LlamaIndex（Python）**：读取本地文件上传到百炼云端知识库，构建检索引擎与 RAG 应用。使用百炼默认的智能文档切分与官方向量模型。 +- **Spring AI Alibaba（Java）**：集成百炼智能体应用或工作流应用，并检索百炼知识库。需要 Spring Boot 3.x 和 JDK 17+。 -RAG 应用可通过 AppFlow 无代码连接流接入网站、企业微信、微信公众号、钉钉等渠道。 +### 本地知识库 RAG + +检索环节在本地执行，生成环节调用通义千问 API。适合需要灵活选择切分策略与嵌入模型的场景，可使用本地部署的 GTE 文本向量模型替代百炼 embedding API。 + +### 多渠道接入 + +RAG 应用可通过 AppFlow 无代码连接流接入网站、企业微信、微信公众号、钉钉等渠道，实现 AI 智能客服和自动回复。 ## 关键参数与配置 +### 向量模型 + +| 模型 | 向量维度 | 单行最大 [Token](token.md) | 适用场景 | +| --- | --- | --- | --- | +| text-embedding-v4 | 64–2048（默认 1024） | 8,192 | 推荐，支持 100+ 语种 | +| text-embedding-v3 | 64–1024（默认 1024） | 8,192 | 支持 50+ 语种 | +| multimodal-embedding-v1 | 1024 | - | 图片问答类知识库专用 | +| qwen3-vl-embedding | 2560 | - | 视觉理解（富文本）场景 | + +### 排序模型 + +| 模型 | 最大文档数 | 特点 | +| --- | --- | --- | +| qwen3-rerank | 500 | 100+ 语种，高性能文本排序 | +| qwen3-rerank(hybrid) | - | 混合排序 | +| qwen3-vl-rerank | 文本 100 / 图片 40 / 视频 4 | [多模态](multimodal.md)排序 | + ### 检索参数 | 参数 | 取值范围 | 说明 | | --- | --- | --- | -| 向量检索 TopK | 1–100（默认 50） | 向量语义召回切片数 | -| 关键词检索 TopK | 1–100（默认 50） | 关键词匹配召回切片数 | -| 排序模型 | qwen3-rerank / qwen3-rerank(hybrid) / qwen3-vl-rerank | [多模态](multimodal.md)库须选 vl-rerank | +| 初步向量检索 TopK | 1–100（默认 50） | 向量语义召回的切片数量 | +| 初步关键词检索 TopK | 1–100（默认 50） | 关键词匹配召回的切片数量 | | 相似度阈值 | 0.01–1.0 | 过滤低分切片，过高会丢弃全部结果 | -| 最大召回数量 | 1–20 | 最终返回切片数 | +| 最大召回数量 | 1–20 | 最终返回的切片数 | +| 排序模式 | 问答 / 相似 / 自定义高级 | 问答模式按 QA 匹配度排序 | -### 向量模型选择 +### 索引配置 -| 模型 | 向量维度 | 单行最大 Token | 适用场景 | -| --- | --- | --- | --- | -| text-embedding-v4 | 64–2048（默认 1024） | 8,192 | 推荐，100+ 语种 | -| text-embedding-v3 | 64–1024（默认 1024） | 8,192 | 50+ 语种 | -| multimodal-embedding-v1 | 1024 | - | 图片问答类知识库专用 | -| qwen3-vl-embedding | 2560 | - | 视觉理解（富文本文档） | +- **切片方式**：推荐智能切分，基于语义相关性自适应选择切片点，单切片 [Token](token.md) 上限 6,000。 +- **Meta 信息抽取**：创建时一次性配置，后续不可更改。可用于按产品名、日期等做前置过滤。 +- **多轮对话改写**：创建时选择是否开启，后续不可更改。开启后可优化多轮对话中的检索效果。 + +### 文档解析方式 + +| 解析方式 | 特点 | +| --- | --- | +| 电子文档解析 | 最快，不支持插图与图表 | +| 文档智能解析 | 对插图做 OCR 与摘要 | +| 大模型文档解析 | 用千问 VL 深度理解插图与图表，耗时较长 | +| 音视频解析 | 含录音识别、视频帧提取与剧情解析 | -### 索引配置注意事项 +## 效果优化建议 -- **Meta 信息抽取**和**多轮对话改写**在知识库创建后无法更改，必须在创建时配置 -- 切片方式推荐智能切分，基于语义相关性自适应选择切片点 -- 多知识库权重仅在同类型知识库之间生效 +当 RAG 效果不理想时，建议先建立评估基线（至少 100 组评测用例），再按失败类型针对性改进： -## 效果优化 +- **没有相关知识**：补充知识库内容，优化源文件排版，统一实体表述，启用多轮对话改写。 +- **召回不相关**：为文件添加标签或配置 Meta 元数据做前置过滤。 +- **切片不完整**：改用智能切分，人工检查并修正异常切片。 +- **重排不佳**：通过命中测试调整相似度阈值与 K 值；对列举/总结/比较类问题适当提高 K 值。 +- **模型理解有误**：更换生成模型或优化 [prompt](../guides/prompt.md) 指令。 -当召回不完整或回答不准确时，建议按以下方向排查： +## 规格与计费 -1. **补充知识**：优化源文件排版，统一实体表述，启用多轮对话改写 -2. **改善召回**：为文件添加标签或 Meta 元数据做前置过滤 -3. **优化切片**：改用智能切分，人工修正异常切片 -4. **调整排序**：通过命中测试反复调整相似度阈值与 K 值；对列举/总结/比较类问题适当提高 K -5. **升级模型**：生成模型可选 qwen-max（效果优先）、qwen-plus（均衡）、qwen-turbo（速度优先） +知识库分为两个规格： + +- **标准版**：0.03 元/小时，1 QPS，平台存储不超过 100 GB。 +- **旗舰版**：0.2 元/RCU/小时，50–10,000 QPS（对应 1–200 RCU），平台存储不超过 9,999 GB。RCU 按"向上取整（峰值 QPS / 50）"估算。 + +知识库仅在华北2（北京）地域开通和使用。知识检索与问答 API 默认限流为用户维度 25 QPS。 ## 关联主题页 - [knowledge base](../guides/knowledge-base.md) - [application use cases](../guides/application-use-cases.md) -- [use cases](../guides/use-cases.md) - [frameworks](../api/frameworks.md) - [vector and sort](../api/vector-and-sort.md) +- [use cases](../guides/use-cases.md) - [knowledge](../api/knowledge.md) diff --git a/skills/bailian-docs-llm-wiki/wiki/concepts/streaming.md b/skills/bailian-docs-llm-wiki/wiki/concepts/streaming.md index 9de23d0..6d00984 100644 --- a/skills/bailian-docs-llm-wiki/wiki/concepts/streaming.md +++ b/skills/bailian-docs-llm-wiki/wiki/concepts/streaming.md @@ -1,39 +1,56 @@ # 流式输出 -流式输出（Streaming）是指模型在生成过程中逐步返回部分结果，而非等待全部生成完毕后一次性返回。该机制显著降低了用户感知的首字延迟，适用于需要实时展示生成内容的交互场景。 +流式输出（Streaming）是指服务端在生成结果的过程中，将内容以增量片段的方式逐步推送给客户端，而非等待全部生成完毕后一次性返回。在大语言模型场景中，流式输出可以显著降低用户感知的首字延迟，提升交互体验。 ## 工作原理 -在非流式模式下，客户端发送请求后需等待模型完成全部推理，才能收到完整响应。流式模式下，服务端通过 Server-Sent Events（SSE）或 WebSocket 将生成结果拆分为多个数据块（chunk）逐个推送，客户端可边接收边渲染，实现打字机效果。 +百炼平台的流式输出基于 HTTP Server-Sent Events（SSE）协议实现。开启流式后，服务端会将模型生成的 token 逐步以事件流的形式推送到客户端，每个事件包含一段增量文本。客户端可以在收到第一个片段时就开始渲染，无需等待完整响应。 + +对于实时[多模态](multimodal.md)场景（如 Qwen-Omni-Realtime API），则采用 WebSocket 长连接实现双向事件流，服务端通过 `response.audio.delta`、`response.text.delta` 等事件逐帧推送音频和文本数据，实现更低延迟的实时交互。 ## 适用场景 -百炼平台在多个层面支持流式输出： +### 应用调用 -- **模型 API 调用**：通过 OpenAI 兼容的 Chat Completions 接口或 DashScope 原生接口调用 Qwen 系列模型时，均可启用流式输出。 -- **应用调用**：通过 Responses API（OpenAI 兼容模式）或 DashScope API 调用智能体应用和工作流应用时，支持流式返回生成内容。 -- **实时[多模态](multimodal.md)交互**：Qwen-Omni-Realtime API 基于 WebSocket 长连接实现实时语音/视频对话，本身即为流式交互架构，响应以事件流形式持续推送。 +通过 Responses API 或 DashScope API 调用智能体应用和工作流应用时，均可开启流式输出。适用于： -## 关键参数与配置 +- **实时对话**：聊天机器人等交互场景，用户可以边看边等，体验更流畅。 +- **长文本生成**：报告、摘要等耗时较长的生成任务，避免用户长时间等待空白响应。 + +> 注意：[异步调用](async-invocation.md)（`background=true`）模式下暂不支持流式输出。异步任务适合后台批量处理，结果通过轮询获取。 + +### 文本生成模型调用 + +通过 OpenAI 兼容 Chat Completions、OpenAI 兼容 Responses、Anthropic 兼容 Messages 或 DashScope 原生接口调用 Qwen 系列模型时，均支持 `stream` 参数开启流式输出。不同接口的流式响应格式遵循各自协议规范： -### HTTP 接口（Chat Completions / DashScope / 应用调用） +- [OpenAI 兼容接口](openai-compatible-interface.md)返回 `data: {...}` 格式的 SSE 事件，与 OpenAI 官方格式一致。 +- DashScope 原生接口同样支持 SSE 流式，响应结构与同步调用保持一致，增量包含在 `output.text` 中。 -| 参数 | 类型 | 说明 | -|------|------|------| -| `stream` | boolean | 设为 `true` 启用流式输出，默认 `false` | -| `stream_options.include_usage` | boolean | 设为 `true` 时，流式响应的最后一个 chunk 中包含 token 用量统计 | +### 实时[多模态](multimodal.md)交互 -### 工作流应用的额外要求 +Qwen-Omni-Realtime API 通过 WebSocket 实现天然的流式交互。服务端在生成过程中持续推送音频和文本增量事件，客户端实时播放和渲染，延迟可低至毫秒级。这种模式下无需显式设置 `stream` 参数，流式是默认且唯一的交互方式。 -调用工作流应用时，若使用 Responses API 并设置 `stream=true`，需在百炼控制台的工作流编辑器中，对结束节点或流程输出节点启用「流式输出」开关，并重新发布应用，否则流式不会生效。 +## 关键参数与配置 + +### stream 参数 -### 实时[多模态](multimodal.md)接口（WebSocket） +| 参数 | 类型 | 默认值 | 说明 | +|------|------|--------|------| +| `stream` | boolean | `false` | 设为 `true` 开启流式输出 | -Qwen-Omni-Realtime API 的响应天然以事件流形式返回，无需额外设置 `stream` 参数。服务端通过 `response.audio.delta`、`response.text.delta` 等事件持续推送音频和文本增量数据。 +在 HTTP API 中，通过请求体中的 `stream` 字段控制： -## 使用示例 +```json +{ + "input": { "prompt": "请介绍流式输出的原理" }, + "parameters": {}, + "stream": true +} +``` -### Python（OpenAI 兼容 Chat Completions） +### SDK 使用示例 + +**Python（OpenAI 兼容）：** ```python from openai import OpenAI @@ -46,24 +63,21 @@ client = OpenAI( stream = client.chat.completions.create( model="qwen-plus", - messages=[{"role": "user", "content": "介绍一下流式输出的原理"}], - stream=True, - stream_options={"include_usage": True} + messages=[{"role": "user", "content": "你好"}], + stream=True ) for chunk in stream: - if chunk.choices and chunk.choices[0].delta.content: + if chunk.choices[0].delta.content: print(chunk.choices[0].delta.content, end="", flush=True) ``` -### Python（DashScope 应用调用） +**Python（[DashScope SDK](dashscope-sdk.md) 应用调用）：** ```python from dashscope import Application -import os responses = Application.call( - api_key=os.getenv("DASHSCOPE_API_KEY"), app_id="YOUR_APP_ID", prompt="你好", stream=True @@ -74,19 +88,37 @@ for response in responses: print(response.output.text, end="", flush=True) ``` +### 增量输出与全量输出 + +部分接口支持通过 `incremental_output` 参数控制流式响应的内容模式： + +- `incremental_output=true`：每次事件只返回新增的增量文本片段。 +- `incremental_output=false`（默认）：每次事件返回截至当前的全量文本。 + +增量模式在网络带宽受限或需要精确控制渲染的场景下更为高效。 + +## 流式输出与其他调用模式的关系 + +| 调用模式 | 是否支持流式 | 适用场景 | +|----------|-------------|----------| +| 同步调用 + 流式 | 支持 | 实时对话、交互式生成 | +| 同步调用 + 非流式 | 支持 | 简单请求、后端处理 | +| [异步调用](async-invocation.md) | 不支持 | 耗时任务、批量处理 | +| WebSocket 实时交互 | 天然流式 | 语音对话、[多模态](multimodal.md)实时交互 | + ## 注意事项 -- [异步调用](async-invocation.md)（`background=true`）与流式输出互斥，不能同时启用。 -- 流式模式下，每个 chunk 的 `finish_reason` 字段为 `null`，仅最后一个 chunk 返回 `stop` 或其他终止原因。 -- 使用流式输出时，建议客户端实现超时和断线重连机制，以应对网络不稳定情况。 -- 不同兼容接口（OpenAI Chat Completions、Responses、Anthropic Messages、DashScope）均支持 `stream` 参数，用法一致。 +- 流式模式下，客户端需要正确处理 SSE 连接的建立、数据解析和断连重试。 +- 流式输出的最终结果与非流式调用完全一致，仅传输方式不同。 +- 在使用代理或网关时，需确保中间层支持 SSE 长连接转发，避免缓冲导致流式效果失效。 +- 视频生成等异步任务不使用流式输出，而是采用任务创建加轮询的模式获取结果。 ## 关联主题页 - [application call](../api/application-call.md) -- [omni realtime api](../api/omni-realtime-api.md) - [qwen api reference](../api/qwen-api-reference.md) +- [omni realtime api](../api/omni-realtime-api.md) - [bailian application calling](../guides/bailian-application-calling.md) -- [toolkits and frameworks](../api/toolkits-and-frameworks.md) +- [video generation api](../api/video-generation-api.md) diff --git a/skills/bailian-docs-llm-wiki/wiki/concepts/token.md b/skills/bailian-docs-llm-wiki/wiki/concepts/token.md index 356511c..0148b66 100644 --- a/skills/bailian-docs-llm-wiki/wiki/concepts/token.md +++ b/skills/bailian-docs-llm-wiki/wiki/concepts/token.md @@ -1,74 +1,75 @@ -# Token 计量 +# Token -Token 是百炼平台中衡量文本处理量的基本单位，用于模型推理计费、用量统计、吞吐量管理等核心场景。一个 Token 大致对应一个中文字或一个英文单词片段，实际切分由模型的分词器决定。 +Token 是大语言模型处理文本的最小单位，模型将输入和输出的自然语言文本拆分为 Token 序列进行理解与生成。在百炼平台中，Token 既是模型能力的度量基础，也是计费、监控和容量规划的核心计量单元。 -## 计费中的 Token +## 基本概念 -百炼平台的模型推理默认按量付费，核心计费维度就是输入 Token 和输出 Token： +大语言模型不直接处理原始文本，而是先通过分词器（Tokenizer）将文本切分为 Token。一个 Token 可能对应一个汉字、一个英文单词、一个子词片段或一个标点符号，具体粒度取决于模型所使用的分词算法。因此，同一段文本在不同模型下的 Token 数量可能不同。 -- **输入 Token**：发送给模型的 [prompt](../guides/prompt.md)、上下文、系统指令等文本经分词后的 Token 总量。 -- **输出 Token**：模型生成的回复文本对应的 Token 总量。 -- **思考 Token**：部分模型（如开启深度思考模式）会产生额外的思考过程 Token，可能按独立单价计费。 +在百炼平台中，Token 分为以下几类： -不同模型的输入/输出单价差异较大。以千问系列为例，qwen3-max 在 32K 以内输入单价为 2.5 元/百万 Token，输出为 10 元/百万 Token；超过 32K 后阶梯上升。部分模型还支持 Batch 调用（输入输出均半价）和上下文缓存（输入 Token 享折扣），两者不可同时生效。 +- **输入 Token**：用户发送给模型的 Prompt 及上下文所消耗的 Token 数量。 +- **输出 Token**：模型生成的回复文本所消耗的 Token 数量。 +- **缓存 Token**：命中上下文缓存的输入 Token，通常享有费用折扣。 +- **训练 Token**：模型调优（微调）过程中消耗的 Token 总量。 -模型训练同样按 Token 计费，费用等于训练数据 Token 总量乘以循环次数再乘以训练单价。 +## 计费场景 -## Token 与用量统计 +Token 是百炼平台按量付费的核心计量维度。不同场景的计费方式如下： -百炼按[业务空间](workspace.md)维度统计 Token 消耗，开发者可在控制台的**模型用量**页面查看各模型的 Token 用量汇总，数据延迟约 1 小时。不同模型类型的统计单位有所不同： +| 场景 | 计费方式 | +|------|---------| +| 模型推理（文本生成） | 按输入/输出 Token 数量分别计费，部分模型支持阶梯计费 | +| 模型训练 | 费用 = Token 总量 x 循环次数 x 训练单价 | +| 向量模型 | 按输入文本的 Token 数计费 | +| 全模态模型 | 文本与其他模态均按 Token 数计费 | -| 模型类型 | 统计单位 | -|---------|---------| -| 大语言模型（文本生成/深度思考/视觉理解） | Token | -| 全模态模型 | Token | -| 向量模型 | Token（按输入文本） | -| 语音模型 | 秒、字符或 Token（视模型而定） | -| 图像生成模型 | 张 | -| 视频生成模型 | 秒 | +部分模型实行阶梯计费，单价取决于单次请求的输入 Token 总量。例如 qwen3-max 在输入 0\~32K Token 时为基础价，32K\~128K 时单价提升，128K\~256K 时进一步提升。 -如需账号级 Token 总量，需在费用与成本页面导出账单查看。 +降低 Token 成本的常用手段包括：Batch 调用（输入/输出单价按实时推理的 50% 计费）、上下文缓存（输入 Token 享有折扣）、节省计划与资源包。 -## 应用观测中的 Token 追踪 +## 监控与观测 -在应用观测功能中，每次调用的 Token 消耗会被自动采集并展示，包括： +百炼平台在模型监控和应用观测两个层面提供 Token 相关指标： -- Token 总量（全部/输入/输出） -- 平均单次请求 Token 量 -- 平均首 Token 耗时（流式场景下衡量响应速度的关键指标） +- **模型监控**：按[业务空间](workspace.md)维度统计各模型的 Token 用量，支持按输入/输出分别查看。监控详情页提供 TPM（Tokens Per Minute）、平均单次请求 Token 量等性能指标。 +- **应用观测**：追踪应用内部每个节点的 Token 消耗，包括 Token 总量、输入/输出 Token、平均单次请求 Token 量，以及平均首 Token 耗时（流式场景下的关键性能指标）。 -开发者可按 Token 总量、输入 Token、输出 Token 等字段筛选调用记录，快速定位高消耗请求。 +用量数据按[业务空间](workspace.md)维度统计，数据延迟约 1 小时（普通监控）或分钟级（高级监控）。 -## 模型监控中的 Token 管理 +## 容量规划：TPM 预留 -模型监控提供分钟级的 Token 追踪能力，在成本类监控指标中可查看平均单次请求调用量。结合 TPM（Tokens Per Minute）指标，开发者能评估模型的吞吐消耗趋势，及时发现异常用量。 +TPM（Tokens Per Minute）是衡量模型推理吞吐能力的关键指标。百炼提供 TPM 预留功能，允许开发者为指定模型锁定专属推理容量。创建 TPM 预留时需要评估以下参数： -## TPM 预留与吞吐管理 +- **每分钟请求数（RPM）** +- **平均输入/输出 Token 长度** +- **预估缓存命中率** -TPM（Tokens Per Minute）是衡量模型推理吞吐量的核心指标。百炼支持 TPM 预留功能，开发者可为指定模型锁定专属吞吐量。影响实际 Token 容量消耗的关键参数包括： +预留容量内的调用不额外收费，超出部分自动降级为按量计费，服务不中断。 -- **缓存折扣**：命中缓存的输入 Token 按折扣系数消耗容量，不同模型折扣率不同（如千问系列 20%、DeepSeek-v4-Pro 8%）。 -- **长输入阶梯系数**：部分模型在输入超过一定长度后，Token 容量消耗系数会提升。 +## 订阅套餐中的 Token -## Token Plan 订阅套餐 +百炼提供 Token Plan 团队版和 Coding Plan 两类订阅套餐。Token Plan 以 Credits 统一计量，Credits 消耗由模型类型、Token 用量、思考模式等因素决定。两类套餐均使用专属 [API Key](api-key.md)（`sk-sp-xxx`）和专属 Base URL，与按量计费的通用 [API Key](api-key.md) 互不相通。 -百炼提供 Token Plan 团队版和 Coding Plan 两类订阅套餐，以 Credits 或调用次数统一计量。Token Plan 中，Credits 消耗由模型类型、Token 用量、思考模式及工具调用等因素共同决定。套餐的抵扣顺序为：坐席月度额度 > 共享用量包 > 服务暂停。 +## 数据集规模参考 -## 成本优化建议 +在模型调优场景中，训练数据的 Token 规模直接影响调优效果： -- **善用免费额度**：开通百炼时自动发放的免费额度可抵扣模型实时推理的 Token 费用，有效期 30~90 天。 -- **选择合适的节省计划**：AI 通用型节省计划通过承诺月消费金额换取 Token 单价折扣，最高 5.3 折。 -- **利用上下文缓存**：重复的系统提示或长上下文可通过缓存降低输入 Token 费用。 -- **关注阶梯计费**：输入 Token 超过一定阈值后单价上升，合理控制上下文长度有助于降低成本。 -- **开启用完即停**：避免免费额度耗尽后产生意外的 Token 扣费。 +| 调优方式 | 最低数据规模 | +|---------|------------| +| CPT（继续预训练） | 一千万 Token 优质预训练数据 | +| SFT（监督微调） | 上千条优质微调数据 | +| DPO（偏好对齐） | 上百条人类偏好数据 | ## 关联主题页 - [test 1](../guides/test-1.md) -- [application monitoring](../guides/application-monitoring.md) - [model monitoring](../guides/model-monitoring.md) - [token plan guide](../guides/token-plan-guide.md) -- [model high speed inference](../guides/model-high-speed-inference.md) +- [application monitoring](../guides/application-monitoring.md) - [qwen api reference](../api/qwen-api-reference.md) +- [get started with models](../guides/get-started-with-models.md) +- [model data overview](../guides/model-data-overview.md) +- [model high speed inference](../guides/model-high-speed-inference.md) diff --git a/skills/bailian-docs-llm-wiki/wiki/concepts/workspace.md b/skills/bailian-docs-llm-wiki/wiki/concepts/workspace.md index d857522..ef3e055 100644 --- a/skills/bailian-docs-llm-wiki/wiki/concepts/workspace.md +++ b/skills/bailian-docs-llm-wiki/wiki/concepts/workspace.md @@ -1,62 +1,77 @@ # 业务空间 -业务空间（Workspace）是阿里云百炼平台进行精细化权限管理和账单分账的最小管理单元。每个业务空间按地域隔离，单个业务空间不能跨地域存在，各地域的默认业务空间也是独立的空间。 +业务空间（Workspace）是阿里云百炼平台进行精细化权限管理、资源隔离和账单分账的最小管理单元。每个业务空间归属于特定地域，单个业务空间不能跨地域存在，各地域的默认业务空间也是相互独立的空间。 -## 核心作用 +## 核心定位 -业务空间在百炼平台中承担以下职责： +业务空间将平台资源划分为可独立管理的逻辑单元，承担以下职责： -- **权限隔离**：以业务空间为边界划分用户角色与资源访问范围，实现多地域、多用户的组织架构管理。 -- **成本管控**：用量统计、费用概览、模型限流均按业务空间维度汇总，是账单分账的基础单元。 -- **资源归属**：API Key、应用、数据集、模型调用记录等资源均归属于特定业务空间。 +- **权限边界**：控制哪些用户可以访问空间内的模型、应用和数据，以及可以执行哪些操作。 +- **资源隔离**：不同业务空间的模型调用权限、限流配额、[API Key](api-key.md)、数据集和应用互不干扰。 +- **成本核算**：用量数据按业务空间维度统计，便于按业务线或环境进行费用分摊。 ## 角色与权限体系 -业务空间的权限管理围绕三种角色展开： +业务空间围绕三种角色组织权限，权限范围自上而下递减： | 角色 | 权限范围 | | --- | --- | -| **超级管理员** | 阿里云主账号或拥有 `AliyunBailianFullAccess` 策略的 RAM 用户，可跨空间管理用户、模型授权、限流和 API Key | -| **业务空间管理员** | 拥有特定业务空间「权限管理」页面访问权限的 RAM 用户，可管理该空间内的用户与资源 | -| **普通用户** | 根据分配的权限访问和使用被授权的空间、页面及资源 | +| 超级管理员 | 阿里云主账号或拥有 `AliyunBailianFullAccess` 策略的 RAM 用户，可跨空间统一管理用户、模型授权、限流和 [API Key](api-key.md) | +| 业务空间管理员 | 负责特定业务空间内的用户权限和资源管理，拥有该空间所有页面的访问权限 | +| 普通用户 | 根据分配的权限使用被授权的空间、页面和资源 | -默认业务空间成员可查看所有业务空间的模型调用情况；子业务空间成员仅能查看当前空间数据，无法切换查看其他业务空间。 +## 模型与资源管控 -## 模型管控能力 +在非默认业务空间中，可对以下维度进行精细化管控（默认业务空间无法设置这些限制）： -在非默认业务空间中，超级管理员可对模型进行三类精细化授权（默认业务空间无法设置这些限制）： +- **模型调用**：控制某个模型是否可在该空间内调用（控制台和 API），并设置请求数限流和 [Token](token.md) 限流。 +- **模型训练**：控制某个模型是否可在该空间内进行调优及调优后部署。 +- **模型部署**：控制某个模型是否可在该空间内直接部署。 +- **用户控制台权限**：管理 RAM 用户对该空间控制台功能页面的访问权限。 -- **限制模型调用**：控制模型是否可在该空间调用（控制台与 API），并设置请求数限流和 Token 限流。 -- **限制模型训练**：控制模型是否可在该空间进行调优及调优后部署。 -- **限制模型部署**：控制模型是否可在该空间直接部署。 +## [API Key](api-key.md) 与业务空间的关系 -## API Key 与业务空间 +单个 API Key 只能归属一个地域内的一个业务空间和一个用户，且不能转移。API Key 可调用的功能和模型限流与其归属业务空间的权限保持一致，不受用户控制台权限的影响。将 RAM 账号移出业务空间会使其 API Key 失效（重新加入后恢复），在 RAM 控制台删除账号则会使 API Key 永久失效。 -单个 API Key 只能归属一个地域内的一个业务空间和一个用户，且不能转移。API Key 的可调用功能与模型限流与归属业务空间的权限保持一致，不受用户控制台权限管理的影响。将 RAM 账号移出业务空间会使其 API Key 失效（重新加入后恢复），在 RAM 控制台删除账号则会使 API Key 永久失效。 +## 子业务空间的模型调用 -## 监控与观测 +在需要按业务线隔离权限或分账的场景下，可使用子业务空间进行模型调用： -- **模型监控**：系统自动采集主账号下所有业务空间的模型调用数据，监控列表按「模型 + 业务空间」维度生成。 -- **用量统计**：模型用量数据按业务空间维度统计，不支持按阿里云账号维度统计。如需账号级汇总，需通过费用与成本页面导出账单。 -- **应用观测**：应用观测范围限定于当前业务空间内已发布的应用，添加观测时需确认应用属于当前空间。 +- 必须使用子业务空间自身的 API Key。 +- 调用标准模型前，需为该空间设置模型调用权限。 +- 通过 API 调用子业务空间内的应用时，必须在请求中额外提供 Workspace ID。 -## 数据管理 +## 监控与数据统计 -业务空间统一管理其下的大模型相关数据集（训练集和评测集），用于模型调优和评测。数据管理与数据处理能力仅适用于华北2（北京）地域。 +- **用量统计**：模型用量数据按业务空间维度聚合，不支持按阿里云账号维度统计。如需账号级汇总，需通过费用与成本页面导出账单。 +- **模型监控**：监控表格按「模型 + 业务空间」维度列出调用数据。默认业务空间成员可查看所有空间的监控数据，子业务空间成员仅能查看当前空间。 +- **应用观测**：应用观测的范围限定在当前业务空间，只能观测属于该空间的已发布应用。 +- **数据管理**：训练集和评测集统一管理在业务空间下，数据处理操作在控制台完成。 -## 生产环境实践建议 +## API 调用中的 Workspace ID -- **空间规划**：推荐按环境（dev/test/prod）或按业务线划分业务空间，实现权限与成本的精细化管理。 -- **限流策略**：将主账号总配额按比例分配给各业务空间并预留缓冲。例如总配额 1000 QPM，可分配 prod 600、test 200、dev 100，预留 100。 -- **安全合规**：AI 安全护栏、模型监控、应用观测等功能建议使用主账号一次性开通，避免子账号权限不全导致开启失败。 +所有应用组件 API 接口均需传入 `WorkspaceId` 参数。在以下场景中，API 调用必须显式提供 Workspace ID： + +- 调用子业务空间下的应用。 +- 调用特定地域（德国、华北2、新加坡、日本）的模型。 + +Workspace ID 可通过百炼控制台右上角图标查看，目前不支持通过 API 或 CLI 查询。 + +## 生产环境最佳实践 + +- **空间规划**：推荐按环境（dev / test / prod）划分业务空间实现隔离，或按业务线划分便于权限与成本管理。 +- **限流分配**：将主账号总配额按比例分配给各业务空间并预留缓冲。例如总配额 1000 QPM，可分配 prod 600 / test 200 / dev 100，预留 100。 +- **安全建议**：生产环境使用 RAM 用户而非主账号的 AccessKey，通过业务空间的模型授权功能实现最小权限原则。 ## 关联主题页 - [application permission management](../guides/application-permission-management.md) - [model monitoring](../guides/model-monitoring.md) -- [model data overview](../guides/model-data-overview.md) - [security and compliance](../guides/security-and-compliance.md) - [application monitoring](../guides/application-monitoring.md) - [application call](../api/application-call.md) +- [application component api reference](../api/application-component-api-reference.md) +- [more about models](../api/more-about-models.md) +- [model data overview](../guides/model-data-overview.md) diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/application-evaluation.md b/skills/bailian-docs-llm-wiki/wiki/guides/application-evaluation.md index b3b8835..df7b511 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/application-evaluation.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/application-evaluation.md @@ -1,131 +1,152 @@ # application evaluation -阿里云百炼的应用[评测](../concepts/evaluation.md)能力用于系统化评估[智能体应用](../concepts/agent-application.md)、[工作流](../concepts/workflow.md)应用的输出质量。覆盖[评测](../concepts/evaluation.md)集管理、[评测](../concepts/evaluation.md)任务编排、自动评估器评分、人工标签标注、评测报告分析等全流程，支持自动评测与手动评测两种范式，并区分"旧版"与"新版"两套界面。 +阿里云百炼提供完整的应用评测体系，支持对智能体应用和工作流应用的输出质量进行系统化评估。平台同时提供自动评测与手动评测两种模式，并通过评测集、评估器和标签三大组件构建多维度的评测闭环。当前平台存在新旧两套评测系统，新版在评测任务管理、评估器和标签体系上做了较大升级。 -## 评测范式 +## 评测模式 -应用评测存在两条主线： +百炼支持两种评测模式，分别适用于不同场景： -- **自动评测**：基于应用关联的[知识库](../concepts/knowledge-base.md)，由大模型自动生成评测集并评分（1-5 分），产出评分、BadCase 分析、归因分析和调优建议。详见 [自动评测](../../raw/application-user-guide/application-evaluation/application-auto-evaluation.md)。仅面向已发布且配置[知识库](../concepts/knowledge-base.md)的[智能体应用](../concepts/agent-application.md)，要求开通"应用观测"，单次最多 8 个应用横向评测。 -- **手动评测**：人工构建评测集，对应用输出逐条打标（较差/一般/较好，或 1-5 分），适合有领域专家介入的端到端验证。详见 [手动评测](../../raw/application-user-guide/application-evaluation/evaluate-manual-application.md)。 +### 自动评测 -> **注意**：当前控制台已推出"新版应用评测"，在评测任务、评估器、标签管理页面左上角单击"返回旧版"可回到旧版自动评测界面。新版与旧版在评测集类型、关联应用范围、评估器机制上有显著差异，使用前请先确认所处版本。 +[自动评测](../../raw/application-user-guide/application-evaluation/application-auto-evaluation.md)利用大模型基于应用关联的知识库自动生成评测集，并对智能体的回答进行自动评分，生成评测报告与调优建议。支持两种子模式： -## 评测集 +- **单应用评测**：深度评估单个智能体应用的表现，生成包含评分、错误分析和优化建议的详细报告。 +- **多应用横向评测**：在同一评测基准下对比最多 8 个应用（或同一应用的不同版本），用于选型决策或版本迭代效果验证。 + +前提条件： + +1. 仅面向**已发布**的智能体应用，且应用须已配置知识库。 +2. 须开通**应用观测**功能，并将待评测应用添加到观测列表。 +3. 子账号需获取`管理员`或`应用评测-操作`权限。 +4. 多应用横向评测时，所有被选应用必须关联至少一个相同的知识库。 -评测集是评测任务的数据基础，支持自动生成与手动上传两种创建方式，文件格式与字段要求因评测集类型而异。详见 [评测集](../../raw/application-user-guide/application-evaluation/application-evaluation-dataset.md)。 +自动评测流程分四步：创建评测任务 → 设置评测集 → 配置评测规则 → 执行评测。评测集生成和评估模型当前仅支持 `qwen-max` 和 `qwen-plus`。 -### 旧版评测集类型 +### 手动评测 -- **对话分析**：`.xls`/`.xlsx`，字段为 Prompt（用户输入）、Completion（参考答案）、SessionId（相同 SessionId 视为多轮对话）。适用于手动评测。 -- **知识问答**：`.jsonl`，字段为 query、queryType、referenceAnswer、fineKeywords（嵌套数组，每个子数组为一个独立信息点）、coarseKeywords（1-3 个核心主题词）。适用于自动评测。 +[手动评测](../../raw/application-user-guide/application-evaluation/evaluate-manual-application.md)通过人工构建评测集，对应用回答进行人工分析与评分。流程为：准备评测集（下载模板填充数据）→ 上传评测集 → 创建评测任务 → 人工标注打分 → 查看评测报告。 -### 新版评测集类型 +手动评测适用于需要领域专家主观判断的场景，评测维度支持使用内置模板或自定义评测维度模板。 -新版评测集支持 **智能体**、**[工作流](../concepts/workflow.md)**、**自定义** 三种类型，按所选应用的出入参形式自动生成数据模板，自定义类型可任意定义表结构。手动上传支持 `.xls`/`.xlsx`，单文件不超过 20MB，单次最多 10 个文件；存储位置固定为平台存储；创建后类型不可修改。详见 [新版评测集](../../raw/application-user-guide/application-evaluation/new-version-of-application-evaluation/new-version-of-evaluation-set.md)。 +> **注意**：手动评测属于旧版评测系统的功能。新版评测系统通过「评测任务 + 标签」的组合同样支持人工标注场景，且功能更灵活。 -### 创建与管理 +## 评测集 + +评测集是评测任务的数据基础，用于存储和管理评测数据。 -- 自动生成仅支持知识问答类型，且仅支持 `qwen-max` 和 `qwen-plus` 模型。 -- 手动上传需先下载模板填写，再上传并**发布**后才能用于评测任务；草稿状态不可用。 -- 修改通过"增量导入"完成：支持单条新增、批量导入、全量覆盖三种方式；每次发布生成新版本，评测任务可选特定版本。 +### 旧版评测集 -## 评测任务 +[旧版评测集](../../raw/application-user-guide/application-evaluation/application-evaluation-dataset.md)支持两种类型： -评测任务串联评测集、被测应用、评估器和标签，是新版应用评测的核心。详见 [评测任务](../../raw/application-user-guide/application-evaluation/new-version-of-application-evaluation/evaluation-task.md)。 +| 类型 | 文件格式 | 适用场景 | +|------|----------|----------| +| 对话分析 | `.xls` / `.xlsx` | 人工评测，包含 Prompt、Completion、SessionId 字段，支持多轮对话 | +| 知识问答 | `.jsonl` | 自动评测，包含 query、queryType、referenceAnswer、fineKeywords、coarseKeywords 字段 | -### 关键配置 +创建方式：自动生成（基于知识库，仅知识问答类型）或手动上传。单次上传最多 10 个文件，单个文件不超过 20MB。 -- **任务名称**：最多 50 字符；**任务描述**：最多 200 字符。 -- **选择评测集**：从已发布评测集中选择集合与版本。 -- **选择应用**：支持三种关联方式——不关联应用（纯人工标注）、[工作流](../concepts/workflow.md)、智能体。 -- **评估器**：每个评测任务最多添加 10 个评估器，建议组合 3-5 个覆盖不同维度（如 LLM + Code 组合）。所有变量必须完成参数映射后才能保存。 -- **标签**：可选，用于人工标注。 +### 新版评测集 -> **注意**：评测任务发起后配置不可修改，如需调整请创建新任务。任务调用大模型产生的 [Token](../concepts/token.md) 费用正常[计费](../concepts/billing.md)。 +[新版评测集](../../raw/application-user-guide/application-evaluation/new-version-of-application-evaluation/new-version-of-evaluation-set.md)支持三种类型： -### 任务详情与结果 +| 类型 | 说明 | +|------|------| +| 智能体 | 根据选中智能体应用的出入参形式定义评测集 | +| 工作流 | 根据选中工作流应用的出入参形式定义评测集 | +| 自定义 | 任意定义评测集表结构，适用于特殊评测场景 | -任务详情页提供"数据明细"与"指标统计"两个视图。数据明细展示每条评测数据的评估器评分结果，支持普通模式与快速标注两种标注模式；单条标注页分为评测集数据、应用输出、人工标注三栏，可通过上一条/下一条逐条切换。指标统计展示综合得分、评测进度、各评估器通过率及数据项分布。 +新版评测集支持手动上传和从应用观测导入两种创建方式，并具备版本管理能力，每次发布生成新版本。创建后类型不可修改。 ## 评估器 -评估器定义"如何评分"，可被多个评测任务复用。百炼提供预置模板与自定义创建两种途径，自定义又细分为 LLM 评估器、Code 评估器和基于评测任务创建。详见 [评估器](../../raw/application-user-guide/application-evaluation/new-version-of-application-evaluation/grader.md)。 +[评估器](../../raw/application-user-guide/application-evaluation/new-version-of-application-evaluation/grader.md)是新版评测体系的核心组件，用于自动评估应用输出质量。支持三种创建方式： -### 预置评估器模板 +### 基于预置模板 -按通用质量、智能体、文本匹配、文本相似度、格式校验五类组织。不同模板对评测集字段有不同必选参数要求（如"问答相关性"要求 query 和 response），建议构建评测集前先确认所需字段。 +百炼提供多种预置评估器模板，覆盖以下分类： -### 自定义评估器 +- **通用质量**：评估回答的基本质量指标 +- **智能体**：专门用于评测智能体应用 +- **文本匹配**：精确规则文本匹配 +- **文本相似度**：计算文本相似度得分 +- **格式校验**：验证输出格式规范性 -- **LLM 评估器**：用大模型评分，适合相关性、有害性、幻觉检测等需要语义理解的场景。配置项含模型选择、Prompt、评分范围、通过阈值；建议使用 32B 以上参数量模型，并通过试运行验证。 -- **Code 评估器**：用 Python 3.10 函数实现评分逻辑，适合格式校验、数值计算、精确匹配。函数签名须包含所有入参，必须返回数值类型评分，建议包含错误处理。 -- **基于评测任务创建**：从已完成标注的历史评测任务中自动抽象出 LLM 评估器。必须选择已完成评估的评测任务；`label_score` 映射的是评测任务中评估器的输出分数，而非评测集原始字段；不支持试运行。 +### 自定义评估器 -### 评分规则与使用 +| 类型 | 评估方式 | 适用场景 | 成本 | +|------|----------|----------|------| +| LLM 评估器 | 大模型语义理解 | 相关性、有害性、幻觉检测 | 产生 [Token](../concepts/token.md) 费用 | +| Code 评估器 | Python 代码规则判断 | 格式校验、数值计算、精确匹配 | 无额外费用 | -评分范围决定打分尺度（精细评估用 0-100，快速分类用 0-1 或 1-5），通过阈值决定 Pass/Fail。在评测任务中使用时，需将评估器参数（query、reference_response、context 等）映射到评测集字段或应用输出。映射错误会导致评估器失效，须仔细核对字段名。 +### 基于评测任务创建 -### LLM 与 Code 评估器对比 +通过历史评测任务的标注结果自动抽象为新的 LLM 评估器，适用于将人工标注经验固化为自动化评估规则的场景。需选择已完成评估的评测任务，并配置 query、response、label_score 的字段映射。 -| 对比项 | LLM 评估器 | Code 评估器 | -| --- | --- | --- | -| 评估方式 | 大模型语义理解 | 代码规则判断 | -| 优势 | 灵活，适应复杂场景 | 精确，可重复 | -| 适用场景 | 相关性、有害性、幻觉检测 | 格式校验、数值计算、精确匹配 | -| 成本 | 产生 [Token](../concepts/token.md) 费用 | 无额外费用 | +每个评测任务最多支持添加 10 个评估器。建议组合 3-5 个评估器从不同维度评估应用质量，例如：相关性评估器（LLM）+ 格式校验评估器（Code）。 ## 标签管理 -标签是评测与应用观测共用的核心组件，用于多维度标注与筛选。详见 [标签管理](../../raw/application-user-guide/application-evaluation/new-version-of-application-evaluation/label-management.md)。 +[标签管理](../../raw/application-user-guide/application-evaluation/new-version-of-application-evaluation/label-management.md)用于对评测数据和应用观测数据进行自定义标注，支持四种标签类型： + +| 标签类型 | 数据类型 | 适用场景 | +|----------|----------|----------| +| 分类 | 预定义选项（最多 20 个） | 回答质量分级、错误类型分类 | +| 布尔值 | True / False | 是否正确、是否存在幻觉 | +| 数字 | Double 数值 | 评分（1-5）、相关性得分（0-1） | +| 文本 | 自由文本 | 错误原因说明、改进建议 | + +标签可同时用于评测任务的人工标注和应用观测的数据标注，支持基于标签的数据筛选和指标统计。 + +## 评测任务（新版） + +[新版评测任务](../../raw/application-user-guide/application-evaluation/new-version-of-application-evaluation/evaluation-task.md)支持智能体和工作流应用的评测，核心配置包括： -### 标签类型 +- **选择评测集**：从已发布的评测集列表中选择评测集和版本 +- **关联应用**：支持不关联应用（纯人工标注）、关联工作流或关联智能体三种方式 +- **添加评估器**：配置自动评分规则及参数映射 +- **添加标签**：配置人工标注维度 -- **分类标签**：从预定义选项多选，最多 20 个选项，筛选用属于/不属于。示例：回答质量（较差/一般/较好）。 -- **布尔值标签**：True/False 二选一，适合是否正确、是否存在幻觉等二元判断。 -- **数字标签**：Double 类型，支持等于/不等于/大于/大于等于/小于/小于等于筛选。示例：1-5 分评分。 -- **文本标签**：String 类型自由输入，支持包含/不包含筛选。示例：错误原因说明、改进建议。 +任务详情页提供数据明细和指标统计两个视图，支持普通模式和快速标注两种标注方式。 -### 使用方式 +## 评测报告与归因分析 -标签名称必填（1-50 字），描述可选（0-200 字）。在评测任务详情页通过"标签配置"添加标签后，可在数据明细中按标签筛选；应用观测模块中可对每个 Span 标注标签，实现对线上真实数据的质量评估，标注内容自动保存。 +自动评测完成后生成评测报告，包含以下维度： -## 自动评测报告与归因 +- **总正确率**：得分 >= 4 分的回答占比（评分范围 1-5 分） +- **BadCase 分析**：按分数从低到高展示错误评测条目 +- **调优建议**：基于归因分析提供 Prompt、检索配置或知识库切片的具体优化建议 +- **RAG 智能体评价**：按问题类型展示单项得分 -自动评测使用大模型对每个回答评分（1-5 分），评分时对比智能体输出与参考答案，评估准确性、完整性和相关性。5 分优秀，4 分良好，4 分以下触发自动归因。 +归因分析将 BadCase 定位到 RAG 流程的具体环节： -### 报告内容 +| 归因类型 | 含义 | 优化方向 | +|----------|------|----------| +| 模型理解有误 | 已获取正确知识但推理错误 | 优化提示词或切换更强模型 | +| 重排不佳 | 正确切片排序靠后 | 调整重排配置或增加切片数量 | +| 检索无效 | 召回切片过多或过少 | 调整检索策略 | +| 切片不完整 | 语义单元被分割到多个切片 | 增大切片长度或启用语义切分 | +| 未获取知识 | 知识库缺少相关内容 | 补充知识库内容 | -- **总正确率**：得分不低于 4 分的回答数 / 总回答数 × 100%，多应用评测以图表对比。 -- **BadCase 分析**：默认按分数从低到高展示 Top-5 错误条目，无 BadCase 时列表为空。 -- **调优建议**：针对 Prompt、检索配置、[知识库](../concepts/knowledge-base.md)切片给出具体优化建议。 -- **RAG 智能体评价**：按问题类型（事实型、分析型、比较型、教程型）展示单项得分，分优秀（≥4）、良好（2-4）、待提升（<2）三档。 +## 最佳实践 -### 归因类型与优化建议 +### 建立持续评测机制 -- **模型理解有误**：已获取正确知识但提示词不明确或模型能力不足——补充清晰回答要求或切换更强模型。 -- **重排不佳**：正确切片被召回但排序靠后——调整重排配置或增加传给模型的切片数。 -- **检索无效**：检索策略不合适导致召回过多或过少——根据数据特点调整检索方式。 -- **切片不完整**：切分粒度过细导致语义单元被分割——增大切片长度或启用语义切分。 -- **未获取知识**：知识库无结果或缺失相关内容——补充相应知识。 +以下场景建议触发评测：知识库更新后、调整 Prompt 后、更换或升级模型后、调整检索/重排策略后、定期回归（每周或每月）。 -## 限制与注意事项 +### 优化闭环 -- 自动评测仅支持 `qwen-max` 和 `qwen-plus` 模型（评测集生成与评测打分均限）。 -- 自动评测仅面向已发布、配置知识库的[智能体应用](../concepts/agent-application.md)；多应用横向评测时所有应用须关联至少一个相同知识库；横向评测最多 8 个应用，追加评测后总数同样不超过 8。 -- 评测期间请勿关闭应用观测，否则可能导致任务失败、数据丢失或报告不准确。 -- 评测任务分步执行，每个成功步骤都会消耗 [Token](../concepts/token.md) 并[计费](../concepts/billing.md)，后续步骤失败不影响已消耗 [Token](../concepts/token.md) 的[计费](../concepts/billing.md)。 -- 评测报告只显示成功完成的用例，失败用例不计入正确率。 -- 评测集生成与评测均为离线任务，需后台排队，排队期间进度保持 0%。 -- 评估器删除后无法恢复；被评测任务引用的评估器不可删除。 -- 新版评测集类型创建后不可修改。 -- 子账号（RAM 用户）使用自动评测需具备"管理员"或"应用评测-操作"权限。 +识别 BadCase → 分析归因定位问题 → 实施针对性优化 → 发布新版本再次评测 → 对比结果确认改进。若效果未达预期则继续迭代。 -## 持续评测与优化闭环 +## 计费说明 -单次评测仅反映特定时间点表现，建议在以下场景触发评测：知识库更新后、调整 Prompt 后、更换或升级模型后、调整检索/重排策略后、定期回归（每周或每月）。 +评测任务调用大模型产生的 [Token](../concepts/token.md) 费用正常计费。自动评测的评测集生成和评估均会消耗 [Token](../concepts/token.md)，预估平均消耗仅为参考值，最终以实际账单为准。评估器模型当前限时免费。 -优化闭环建议按"识别 BadCase → 分析归因定位问题 → 实施针对性优化 → 发布新版本再次评测 → 对比结果确认改进"五步迭代，未达预期则返回第一步开始新一轮循环。 +## 常见问题 + +- **评测集生成进度长时间保持 0%**：评测集生成和应用评测为离线任务，需后台排队执行，排队期间进度保持 0%，任务开始后自动更新。 +- **评测期间能否关闭应用观测**：不可以，否则可能导致评测任务失败或数据丢失。 +- **评测报告中用例数量与设置不符**：自动评测可能部分失败，报告仅展示成功完成的用例。 +- **评测任务创建后可否修改**：任务配置（应用、评测集）不可修改，但可随时添加人工标签。如需不同配置请创建新任务。 ## 来源文档 @@ -138,13 +159,3 @@ - [评估器](../../raw/application-user-guide/application-evaluation/new-version-of-application-evaluation/grader.md) - - - - - - - - - - diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/application-monitoring.md b/skills/bailian-docs-llm-wiki/wiki/guides/application-monitoring.md index 29807b9..0a195b7 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/application-monitoring.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/application-monitoring.md @@ -75,9 +75,9 @@ | AGENT | 对智能体的调用 | | RETRIEVER | 检索操作；KnowledgeRetriever 表示在[知识库](../concepts/knowledge-base.md)中检索。子节点名称含 TextRetriever（改进 BM25，默认返回 100 个切片）、VectorRetriever（向量检索，默认返回 100 个切片） | | REWRITER | 基于会话上下文调整原始 Prompt 以提升检索效果 | -| EMBEDDING | 将 Prompt 转为向量，[Token](../concepts/token.md) 量为本次向量化的 Token 数 | +| EMBEDDING | 将 Prompt 转为向量，[Token](../concepts/token.md) 量为本次向量化的 [Token](../concepts/token.md) 数 | | RERANKER | 计算文本切片相似度分数并降序排列 | -| LLM | 大模型推理/文本生成，Token 量 = 输入 + 输出；延时包含输出回复过程 | +| LLM | 大模型推理/文本生成，[Token](../concepts/token.md) 量 = 输入 + 输出；延时包含输出回复过程 | | TOOL | 插件调用（官方或自定义） | | GUARDRAIL | 阿里绿网调用；ManualIntervention 为用户干预规则，SystemIntervention 为系统干预规则 | @@ -98,7 +98,7 @@ ## 关键指标说明 - **延时（调用时长）**：对 LLM 节点，包含输出回复的完整过程。 -- **Token 量**：Embedding 节点为本次向量化 Token 数；LLM 节点为输入 Token + 输出 Token。 +- **[Token](../concepts/token.md) 量**：Embedding 节点为本次向量化 Token 数；LLM 节点为输入 Token + 输出 Token。 - **数据时效**：指标更新频率为分钟级，调用记录最长可查 30 天。 - **应用总量 / 平均延时**：用于评估应用运营效果与成本，详见 [应用观测](../../raw/application-user-guide/application-monitoring/application-observation.md)。 @@ -117,3 +117,4 @@ + diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/application-permission-management.md b/skills/bailian-docs-llm-wiki/wiki/guides/application-permission-management.md index bc0ce6c..eade232 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/application-permission-management.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/application-permission-management.md @@ -27,7 +27,7 @@ ## [业务空间](../concepts/workspace.md)权限管理 -百炼按地理区域划分资源和[业务空间](../concepts/workspace.md)，**单个[业务空间](../concepts/workspace.md)不能跨地域存在**，即使是各地域的默认业务空间，也是不同的空间。业务空间是精细化权限管理的最小单元，可管理以下维度（默认业务空间无法设置这些限制）： +百炼按地理区域划分资源和[业务空间](../concepts/workspace.md)，**单个[业务空间](../concepts/workspace.md)不能跨地域存在**，即使是各地域的默认[业务空间](../concepts/workspace.md)，也是不同的空间。[业务空间](../concepts/workspace.md)是精细化权限管理的最小单元，可管理以下维度（默认[业务空间](../concepts/workspace.md)无法设置这些限制）： - **限制模型调用**：管理某个模型可否在该业务空间调用（控制台 & API），并设置该模型的请求数限流和 [Token](../concepts/token.md) 限流。默认业务空间所有模型均可调用且无法限流。 - **限制模型训练**：管理某个模型可否在该业务空间进行调优和调优后部署。默认业务空间所有支持调优的模型均可调优及部署。 @@ -44,12 +44,12 @@ | 触发操作 | 主账号的 [API Key](../concepts/api-key.md) | RAM 账号的 [API Key](../concepts/api-key.md) | | --- | --- | --- | -| 主动删除 API Key | 失效，不可恢复 | 失效，不可恢复 | +| 主动删除 [API Key](../concepts/api-key.md) | 失效，不可恢复 | 失效，不可恢复 | | 将账号移出业务空间 | — | 失效（重新加入后恢复生效） | | 在 RAM 控制台删除账号/角色 | — | 失效，不可恢复 | -| 为 API Key 设置 IP 访问白名单 | 华北2（北京）地域支持 | 华北2（北京）地域支持 | +| 为 [API Key](../concepts/api-key.md) 设置 IP 访问白名单 | 华北2（北京）地域支持 | 华北2（北京）地域支持 | -> **注意**：自 2026 年 3 月 25 日起，华北2（北京）地域的所有新创建的 API Key 均归属主账号。 +> **注意**：自 2026 年 3 月 25 日起，华北2（北京）地域的所有新创建的 [API Key](../concepts/api-key.md) 均归属主账号。 可通过百炼控制台左侧导航栏「权限管理」页签为 RAM 用户添加 API-Key 权限，赋予其创建、删除、查看该空间下所有 API-Key 的权限。 @@ -126,3 +126,4 @@ RAM 用户默认无权查看阿里云账单和购买预付费产品，需在 RAM + diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/application-publishing-and-sharing.md b/skills/bailian-docs-llm-wiki/wiki/guides/application-publishing-and-sharing.md index d9dc759..8f3e27d 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/application-publishing-and-sharing.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/application-publishing-and-sharing.md @@ -121,3 +121,4 @@ UI 设计器功能本身不[计费](../concepts/billing.md)，但使用过程中 + diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/application-support.md b/skills/bailian-docs-llm-wiki/wiki/guides/application-support.md index 6a6ade0..8c3f8c0 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/application-support.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/application-support.md @@ -80,3 +80,4 @@ RAG（[检索增强生成](../concepts/rag.md)）在问答系统、对话系统 + diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/application-use-cases.md b/skills/bailian-docs-llm-wiki/wiki/guides/application-use-cases.md index 9abc5f8..d0259af 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/application-use-cases.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/application-use-cases.md @@ -96,3 +96,4 @@ AppFlow 连接流可在百炼步骤后添加 SLS 日志云服务节点，将对 + diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/bailian-application-calling.md b/skills/bailian-docs-llm-wiki/wiki/guides/bailian-application-calling.md index c7bc575..efc5e6b 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/bailian-application-calling.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/bailian-application-calling.md @@ -184,3 +184,4 @@ Java SDK 通过 `JsonUtils.parse(...)` 将 JSON 字符串转为对象传入 `App + diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/data-connection-overview.md b/skills/bailian-docs-llm-wiki/wiki/guides/data-connection-overview.md index f4ad4ad..7adfbc4 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/data-connection-overview.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/data-connection-overview.md @@ -35,7 +35,7 @@ - **MySQL**：已有数据库实例（阿里云 RDS 或自建），网络可达。 - **PostgreSQL**：已有实例且 `wal_level` 参数设置为 `logical`；自建实例还需配置 `listen_addresses` 允许 `100.64.0.0/16` 网段访问。 - **PolarDB-X 2.0**：已有阿里云 PolarDB-X 2.0 实例，所在地域支持私网访问。 - - **语雀**：已有语雀知识库（仅公网版本），并获取个人访问 Token。 + - **语雀**：已有语雀知识库（仅公网版本），并获取个人访问 [Token](../concepts/token.md)。 - **OSS**：已创建 OSS Bucket 并开通向量检索服务。 ## 创建连接器 @@ -66,7 +66,7 @@ ### 语雀连接器 -填写连接器名称和描述后，需到语雀开放 API 页面获取 Tenant access token 并填入，点击"连接检测"验证 Token 有效性。 +填写连接器名称和描述后，需到语雀开放 API 页面获取 Tenant access token 并填入，点击"连接检测"验证 [Token](../concepts/token.md) 有效性。 ### OSS 连接器 @@ -114,3 +114,4 @@ - [数据连接](../../raw/application-user-guide/data-connection-overview/data-connection.md) + diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/fine-tuning.md b/skills/bailian-docs-llm-wiki/wiki/guides/fine-tuning.md index 67992cb..9a78604 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/fine-tuning.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/fine-tuning.md @@ -165,3 +165,4 @@ curl --location 'https://dashscope.aliyuncs.com/api/v1/deployments' \ + diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/get-started-with-models.md b/skills/bailian-docs-llm-wiki/wiki/guides/get-started-with-models.md index c738661..1ddd814 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/get-started-with-models.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/get-started-with-models.md @@ -1,56 +1,61 @@ # get started with models -阿里云百炼是一站式大模型开发平台，兼容 OpenAI 接口规范，集成千问（Qwen）全系列及 DeepSeek、Kimi、GLM 等第三方模型。开发者只需获取 API Key 并配置 Base URL，即可通过几行代码调用文本生成、视觉理解、图像生成、语音合成等[多模态](../concepts/multimodal.md)能力。本文梳理从账号开通到首次 API 调用的完整流程，以及地域选择、接入域名和限流等关键注意事项。 +阿里云百炼是一站式大模型开发与应用平台，提供兼容 OpenAI 的 API，集成千问（Qwen）全系列模型及 DeepSeek、Kimi、GLM 等第三方大模型。开发者只需几行代码即可完成模型调用，平台覆盖文本生成、视觉理解、图像/视频生成、语音识别与合成、向量嵌入等多种能力。本文汇总从账号开通到首次 API 调用的完整流程，以及地域选择、接入域名和限流等关键配置。 -## 支持的模型与能力 +## 支持的模型 -百炼提供开箱即用的模型服务，无需自行部署，按需选择即可。详细模型列表参见[选择模型](../../raw/model-user-guide/get-started-with-models/models.md)。 +百炼提供开箱即用的模型服务，无需自行部署或运维，详见[选择模型](../../raw/model-user-guide/get-started-with-models/models.md)。主要模型分类如下： -**文本生成（核心能力）**： +### 文本生成 -| 模型层级 | 代表模型 | 定位 | -|---------|---------|------| -| Max | qwen3.7-max | 效果最强，适合复杂多步骤任务 | -| Plus | qwen3.7-plus | 效果、速度、成本均衡，多数场景推荐 | -| Flash | qwen3.6-flash | 高性价比低延迟，适合简单快速响应 | -| 第三方 | deepseek-v4-pro、kimi-k2.7-code、glm-5.2 等 | API 格式与千问一致 | +- **千问旗舰模型**：qwen3.7-max（效果最强，适合复杂多步骤任务）、qwen3.7-plus（效果与成本均衡，多数场景推荐）、qwen3.6-flash（高性价比低延迟）。 +- **第三方模型**：deepseek-v4-pro、deepseek-v4-flash、kimi-k2.7-code、glm-5.2、MiniMax-M2.7 等，API 格式与千问模型一致。 -**[多模态](../concepts/multimodal.md)能力**： +### [多模态](../concepts/multimodal.md)与其他能力 -- **视觉理解**：qwen3.7-plus、qwen3.5-omni-plus 等，支持图片/视频内容分析 -- **图像/视频生成**：wan2.7-image-pro、qwen-image-2.0-pro、happyhorse 系列 -- **语音合成**：cosyvoice-v3.5-plus -- **语音识别**：fun-asr-realtime（专业 ASR）、qwen3.5-omni-plus（大模型方案） -- **全模态（Omni）**：qwen3.5-omni-plus-realtime，融合文本/图像/音频/视频的端到端理解与生成 -- **向量与重排序**：text-embedding-v4、qwen3-rerank -- **3D 生成**：Tripo-H3.1、Tripo-P1.0 +| 能力类别 | 代表模型 | +|---------|---------| +| 图像/视频理解 | qwen3.7-plus、qwen3.5-omni-plus | +| 图像/视频生成 | wan2.7-image-pro、qwen-image-2.0-pro、happyhorse-1.1-t2v | +| 3D 模型生成 | Tripo/Tripo-H3.1、Tripo/Tripo-P1.0 | +| 语音合成（TTS） | cosyvoice-v3.5-plus、MiniMax/speech-2.8-hd | +| 语音识别（ASR） | fun-asr-realtime、fun-asr | +| 语音转语音（S2S） | qwen3.5-omni-plus-realtime | +| 全模态 | qwen3.5-omni-plus-realtime | +| 向量与重排序 | text-embedding-v4、qwen3-rerank | +| 音乐生成 | fun-music-v1 | -## 快速开始：首次 API 调用 +## 首次 API 调用 -完整步骤参见[首次调用千问API](../../raw/model-user-guide/get-started-with-models/first-api-call-to-qwen.md)。 +完成以下准备步骤后即可发起第一个请求，详细指引见[首次调用千问API](../../raw/model-user-guide/get-started-with-models/first-api-call-to-qwen.md)。 -### 1. 开通服务与获取 API Key +### 1. 账号设置 -1. 使用阿里云主账号访问[百炼控制台](https://bailian.console.aliyun.com/?tab=model#/model-market)，阅读协议后自动开通 -2. 前往 [API Key 页面](https://bailian.console.aliyun.com/?tab=model#/api-key)创建密钥 -3. 如使用华北2（北京）、新加坡、日本（东京）或德国（法兰克福）地域，还需在 Base URL 中填入[业务空间](../concepts/workspace.md) ID（WorkspaceId） +1. 注册阿里云账号并完成实名认证。 +2. 使用主账号前往百炼控制台，阅读并同意协议即可开通服务。 +3. 在 [API Key](../concepts/api-key.md) 页面创建 [API Key](../concepts/api-key.md)。 +4. 如使用华北2（北京）、新加坡、日本（东京）或德国（法兰克福）地域，需在 Base URL 中填入[业务空间](../concepts/workspace.md) ID（WorkspaceId）。 -### 2. 配置 API Key 到环境变量 +### 2. 配置 [API Key](../concepts/api-key.md) 环境变量 -建议将 API Key 存入环境变量 `DASHSCOPE_API_KEY`，避免在代码中硬编码： +建议将 API Key 配置到环境变量 `DASHSCOPE_API_KEY`，避免代码中硬编码： ```bash -# macOS / Linux -export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY" - -# 永久生效（macOS zsh） +# Linux / macOS (Zsh) echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.zshrc source ~/.zshrc + +# Windows (PowerShell) +[Environment]::SetEnvironmentVariable("DASHSCOPE_API_KEY", "YOUR_DASHSCOPE_API_KEY", [EnvironmentVariableTarget]::User) ``` -### 3. 调用示例（[OpenAI 兼容接口](../concepts/openai-compatible-interface.md)） +### 3. 发起请求（Python 示例） + +安装 SDK 后即可调用： -**Python**： +```bash +pip install -U openai +``` ```python import os @@ -58,107 +63,97 @@ from openai import OpenAI client = OpenAI( api_key=os.getenv("DASHSCOPE_API_KEY"), + # 华北2（北京）业务空间专属域名，将 {WorkspaceId} 替换为真实 ID base_url="https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1", ) completion = client.chat.completions.create( - model="qwen3.7-plus", - messages=[{'role': 'user', 'content': '你是谁？'}] + model="qwen-plus", + messages=[ + {'role': 'system', 'content': 'You are a helpful assistant.'}, + {'role': 'user', 'content': '你是谁？'} + ] ) print(completion.choices[0].message.content) ``` -**Node.js**： +百炼同时支持 DashScope Python SDK、Node.js SDK 和 curl 调用。 -```javascript -import OpenAI from "openai"; +## 地域与接入域名 -const openai = new OpenAI({ - apiKey: process.env.DASHSCOPE_API_KEY, - baseURL: "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1", -}); -const completion = await openai.chat.completions.create({ - model: "qwen3.7-plus", - messages: [{ role: "user", content: "你是谁？" }], -}); -console.log(completion.choices[0].message.content); -``` - -**curl**： +调用前需选择地域和接入域名，各地域的 API Key 相互独立、不能跨地域混用。详见[选择地域、服务部署范围和接入域名](../../raw/model-user-guide/get-started-with-models/regions.md)。 -```bash -curl -X POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/chat/completions \ - -H "Authorization: Bearer $DASHSCOPE_API_KEY" \ - -H "Content-Type: application/json" \ - -d '{"model":"qwen3.7-plus","messages":[{"role":"user","content":"你是谁？"}]}' -``` +### 可用地域 -> **注意**：以上示例均使用华北2（北京）地域的 Base URL，需将 `{WorkspaceId}` 替换为实际的[业务空间](../concepts/workspace.md) ID。不同地域的 Base URL 不通用。 - -## 地域、服务部署范围与接入域名 - -百炼目前在 5 个地域提供服务，详细说明参见[选择地域、服务部署范围和接入域名](../../raw/model-user-guide/get-started-with-models/regions.md)。 - -### 地域选择指南 - -| 数据合规需求 | 推荐地域 | 服务部署范围 | -|-------------|---------|------------| -| 数据不出中国内地 | 华北2（北京） | 中国内地 | -| 数据不出美国 | 美国（弗吉尼亚） | 美国 | -| 数据不出欧盟 | 德国（法兰克福） | 欧盟 | -| 数据不出日本 | 日本（东京） | 日本 | -| 无合规限制，追求最大资源池 | 美国/德国/日本 | 全球 | -| 数据不经过中国内地 | 新加坡 | 国际 | - -> **注意**：各地域的 API Key 相互独立，不能跨地域使用。部分功能（模型调优、应用开发）仅在华北2（北京）地域支持。 +| 地域 | 地域 ID | 服务部署范围 | 典型场景 | +|------|---------|------------|---------| +| 华北2（北京） | cn-beijing | 中国内地 | 数据不出中国内地 | +| 新加坡 | ap-southeast-1 | 国际（除中国内地） | 数据不经过中国内地 | +| 美国（弗吉尼亚） | us-east-1 | 全球 / 美国 | 无合规限制或限美国 | +| 德国（法兰克福） | eu-central-1 | 全球 / 欧盟 | 无合规限制或限欧盟 | +| 日本（东京） | ap-northeast-1 | 全球 / 日本 | 无合规限制或限日本 | ### 接入域名类型 百炼提供三种接入域名，详见[Base URL总览](../../raw/model-user-guide/get-started-with-models/base-url.md)： -| 类型 | 格式 | 适用场景 | 超时 | SLA | -|------|------|---------|------|-----| -| [业务空间](../concepts/workspace.md)专属域名（推荐） | `{WorkspaceId}.{region}.maas.aliyuncs.com` | 生产环境，高并发 | 3600s | 99.9% | -| Dashscope 域名 | `dashscope.aliyuncs.com` | 存量兼容，建议迁移 | 600s | 99.9% | -| 试用域名 | `trial.{region}.maas.aliyuncs.com` | 快速验证 | 600s | 无 | +| 域名类型 | 格式 | 适用场景 | 请求超时 | SLA | +|---------|------|---------|---------|-----| +| **[业务空间](../concepts/workspace.md)专属（推荐）** | `{WorkspaceId}.{region}.maas.aliyuncs.com` | 生产环境 | 3600s | 99.9% | +| Dashscope | `dashscope.aliyuncs.com` | 存量兼容 | 600s | 99.9% | +| 试用 | `trial.{region}.maas.aliyuncs.com` | 快速验证 | 600s | 不提供 | -生产环境强烈建议使用**业务空间专属域名**，迁移仅需替换 Base URL 中的域名部分，无需修改业务逻辑。 +此外，Coding Plan 和 [Token](../concepts/token.md) Plan 有各自的专属域名和 API Key，仅限 AI 编码工具交互式使用，不能用于后端服务。 -此外百炼还提供 Coding Plan 和 Token Plan 专属域名，仅限 Claude Code、Codex 等 AI 编码工具使用，不能用于后端服务。 +> **注意**：美国（弗吉尼亚）地域目前不支持[业务空间](../concepts/workspace.md)专属域名，仅能使用 Dashscope 域名 `dashscope-us.aliyuncs.com`。德国（法兰克福）和日本（东京）地域不支持 Dashscope 域名和试用域名，仅支持业务空间专属域名。 -## 限流机制 +## 限流 -限流按**主账号维度**计算，账号下所有 RAM 子账号、业务空间和 API Key 的调用量合并统计。不同模型的限流额度相互独立。详细规则参见[限流](../../raw/model-user-guide/get-started-with-models/rate-limit.md)。 +百炼按主账号维度对模型调用设置限流，账号下所有 RAM 子账号、业务空间和 API Key 的调用量合并计算。详见[限流](../../raw/model-user-guide/get-started-with-models/rate-limit.md)。 ### 限流指标 -- **RPM**（Requests Per Minute）：每分钟请求数 -- **TPM**（Tokens Per Minute）：每分钟 Token 消耗（含输入与输出） +- **RPM**（每分钟请求数）和 **TPM**（每分钟 [Token](../concepts/token.md) 数，含输入与输出），超出任一即触发限流。 +- 限流还可能按秒级 RPS（RPM/60）与 TPS（TPM/60）执行，短时间爆发请求即使未达分钟级上限也可能被限流。 -稳定版/最新版模型通常拥有更高的限流额度。以华北2（北京）为例： +### 主要模型限流额度（华北2-北京，稳定版） | 模型 | RPM | TPM | |------|-----|-----| | qwen3.7-max | 30,000 | 5,000,000 | | qwen3.7-plus | 30,000 | 5,000,000 | | qwen3.6-flash | 30,000 | 10,000,000 | +| qwen-plus | 30,000 | 5,000,000 | +| qwen-turbo | 1,200 | 5,000,000 | + +> **注意**：带日期后缀的快照版本（如 qwen3.7-max-2026-06-08）限流额度通常远低于稳定版，使用前请确认。 + +### 避免限流的建议 + +1. 优先使用稳定版模型（限流额度更高）。 +2. 平滑请求速率，采用匀速调度或指数退避，避免瞬时高峰。 +3. 配置备选模型：主模型限流时自动切换到备用模型。 +4. 将大批量任务拆分为小批次分时段提交。 +5. 无需实时响应时，使用批量推理（Batch API），不受实时限流约束。 +6. 默认额度不足时，在控制台「限流提额」页面提升临时 TPM 额度，提交后立即生效，有效期 30 天。 -> **注意**：即使每分钟总量未超限，短时间内请求爆发也可能触发秒级限流（RPS = RPM/60）。收到 `Request rate increased too quickly` 时，需平滑请求速率。 +## 费用与成本控制 -### 应对限流的策略 +- 开通百炼免费，调用模型按量付费。新用户享有北京地域的免费额度。 +- 可开启「免费额度用完即停」功能，避免超出免费额度后产生费用。 +- 通过删除 API Key、停止调用、下线部署实例等方式阻断计费。 +- 在费用中心设置高额消费预警，及时发现异常消费。 +- Coding Plan（AI 编码套餐）采用固定月费，提供月度请求额度，无按量扣费风险。 -1. **优先使用高限流模型**：如 qwen-plus 系列，稳定版比日期快照版额度更宽松 -2. **添加备选模型**：主模型限流时自动切换到备用模型重试 -3. **平滑请求**：采用匀速调度或指数退避，避免瞬时高峰 -4. **批量推理**：非实时场景使用 Batch API，不受实时限流约束 -5. **临时提额**：在控制台[限流提额](https://bailian.console.aliyun.com/?tab=model#/efm/temp_limit_raise)页面提升 TPM，提交后立即生效，有效期 30 天 +## 各地域功能差异 -## 计费要点 +| 功能 | 北京 | 新加坡 | 美国 | 德国 | 日本 | +|------|------|-------|------|------|------| +| 实时推理 | 支持 | 支持 | 支持 | 支持 | 支持 | +| 批量推理 | 支持 | 支持 | 不支持 | 不支持 | 不支持 | +| 模型调优 | 支持 | 不支持 | 不支持 | 不支持 | 不支持 | +| 应用开发 | 支持 | 不支持 | 不支持 | 不支持 | 不支持 | -- 开通百炼免费，调用模型按量付费（分钟级出账） -- 新用户享有北京地域专属免费额度；可开启"免费额度用完即停"避免意外扣费 -- 已认证用户免费额度用完后自动转为按量付费 -- 订阅 Coding Plan（AI 编码套餐）可获得固定月费的请求额度，无按量扣费风险 -- 通过[模型监控](https://bailian.console.aliyun.com/?tab=model#/model-telemetry)查看调用量统计（调用约一小时后可见） +> **注意**：模型调优和应用开发（智能体、工作流等）目前仅在华北2（北京）地域可用。如需这些功能，请选择北京地域。 ## 来源文档 diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/knowledge-base.md b/skills/bailian-docs-llm-wiki/wiki/guides/knowledge-base.md index f5d2ef6..e212731 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/knowledge-base.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/knowledge-base.md @@ -1,6 +1,6 @@ # [knowledge](../api/knowledge.md) base -阿里云百炼知识库基于 RAG（检索增强生成）技术，为大模型补充私有数据与最新信息，提升特定领域问答的准确性。它覆盖知识库创建、数据导入、检索召回、问答生成、日志监控与计费计量的完整链路，支持文档搜索、数据查询、图片问答、音视频搜索等[多模态](../concepts/multimodal.md)场景，并可经控制台或开放 API 接入业务系统。 +阿里云百炼知识库基于 RAG（[检索增强生成](../concepts/rag.md)）技术，为大模型补充私有数据与最新信息，提升特定领域问答的准确性。它覆盖知识库创建、数据导入、检索召回、问答生成、日志监控与计费计量的完整链路，支持文档搜索、数据查询、图片问答、音视频搜索等[多模态](../concepts/multimodal.md)场景，并可经控制台或开放 API 接入业务系统。 ## 支持的模型与知识库类型 @@ -35,7 +35,7 @@ - Meta 抽取在知识库创建后**无法再配置**，需在创建时一次性设好。 - 多轮对话改写与知识库绑定，创建时未开启则后续无法开启，除非重建。 -- 切片方式推荐 **智能切分**，基于语义相关性自适应选择切片点；单切片 Token 上限 6,000。 +- 切片方式推荐 **智能切分**，基于语义相关性自适应选择切片点；单切片 [Token](../concepts/token.md) 上限 6,000。 ## 检索与问答 @@ -99,7 +99,7 @@ | ADB-PG 单表行数 / 单行大小 | 10,000,000 / 100 KB | | 单文件标签数 | 32 | | 控制台单次导入文件数 | 50（API 建议单次 ≤ 10,000） | -| 单切片 Token | 6,000 | +| 单切片 [Token](../concepts/token.md) | 6,000 | | 单次检索召回切片数 | 20 | | 检索并发 | 标准版 1 QPS（固定）/ 旗舰版 50–10,000 QPS（1–200 RCU） | @@ -113,7 +113,7 @@ **免费额度**：所有用户一次性 720 小时，仅抵扣标准版规格费用。老用户（2026-01-04 前开通）额度有效期至 2026-02-03 23:59；新用户自开通起 30 天内有效，过期作废。模型调用费用不在免费额度内。 -**模型调用费用**：独立计费项，按输入 Token 计费，遵循模型广场定价。 +**模型调用费用**：独立计费项，按输入 [Token](../concepts/token.md) 计费，遵循模型广场定价。 - 创建/更新：按新增内容 Token 数计费，删除文件不产生费用。 - 检索：Query 向量化按输入 Token 计费；Rerank 费用 = **初步召回总切片数 × 平均切片 Token × 模型单价**，与最终返回切片数无关。 @@ -125,7 +125,7 @@ ## 使用要点 -- 业务空间隔离：子账号只能操作已加入业务空间中的知识库，主账号可操作所有业务空间下的知识库。 +- [业务空间](../concepts/workspace.md)隔离：子账号只能操作已加入[业务空间](../concepts/workspace.md)中的知识库，主账号可操作所有[业务空间](../concepts/workspace.md)下的知识库。 - 知识库 ID：每个知识库卡片上的 `ID` 字段，用于 API 调用。 - 删除文件不退模型调用费，但删除知识库可停止规格计费。 - 命中测试会产生向量模型与排序模型的调用计费。 @@ -148,3 +148,4 @@ + diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/llm-application.md b/skills/bailian-docs-llm-wiki/wiki/guides/llm-application.md index 78cffde..b90cd52 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/llm-application.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/llm-application.md @@ -1,111 +1,101 @@ # llm application -阿里云百炼提供三种核心应用构建模式——智能体（Agent）、工作流（Workflow）和高代码应用，用于突破大模型在处理私有知识、获取实时信息、遵循固定流程及规划复杂任务等方面的原生局限。三种模式分别面向零代码、低代码和专业代码开发者，通过集成知识库检索增强、外部工具调用、记忆等核心能力，帮助快速构建解决真实业务问题的 AI 应用。 +阿里云百炼提供三种核心应用构建模式——智能体（Agent）、工作流（Workflow）和高代码应用，用于突破大模型在处理私有知识、获取实时信息、遵循固定流程及规划复杂任务等方面的原生局限。开发者可根据场景复杂度和技术栈选择合适的模式，通过集成知识库、MCP 工具、插件等能力快速构建 AI 应用。 -## 应用类型与选型 +## 应用类型选型 -百炼应用分为三类，开发门槛与灵活度依次递增： +百炼平台的三种应用类型在开发方式、适用人群和核心特点上有明显差异，详见[应用类型介绍](../../raw/application-user-guide/llm-application/application-introduction.md)。 -| 对比维度 | 智能体（Agent） | 工作流（Workflow） | 高代码应用 | -|---------|----------------|-------------------|-----------| -| 开发方式 | 自然语言配置（零代码） | 可视化节点编排（低代码） | Python 编码（专业代码） | +| 维度 | 智能体（Agent） | 工作流（Workflow） | 高代码应用 | +|------|-----------------|---------------------|------------| +| 开发方式 | 自然语言配置（零代码） | 可视化节点编排（低代码） | Python 编码 | | 核心特点 | AI 自主决策、动态规划 | 预定义流程精确控制 | 完全由代码控制 | | 适合人群 | 业务人员、产品经理 | IT 运维、业务分析师 | AI 工程师、开发者 | -| 典型场景 | 智能客服、知识问答、任务助理 | 自动化报告、订单处理、审批流 | 私有算法部署、复杂系统集成 | +| 典型场景 | 智能客服、知识问答、任务助理 | 报告生成、订单处理、审批流 | 私有算法部署、复杂系统集成 | -详细的选型说明参见 [应用类型介绍](../../raw/application-user-guide/llm-application/application-introduction.md)。 +## 智能体应用（Agent） -## 智能体应用 +智能体由提示词驱动，通过自主理解用户意图、制定决策并调用外部工具完成任务。百炼目前提供两个版本： ### Agent 2.0（推荐） -新版智能体（Agent 2.0）将知识库、MCP 等多种能力统一为工具，由智能体自主思考和规划调用顺序，能完整展示每一轮"规划-执行-反思"链路。与旧版相比，新版在规划调度、过程透明度和适用场景广度上均有显著提升。 +新版智能体将知识库、MCP 等多种能力统一为工具，由模型自主规划调用顺序，支持完整的"规划-执行-反思"链路展示。详见[新版智能体应用（Agent 2.0）](../../raw/application-user-guide/llm-application/new-single-agent-application.md)。 -核心能力配置： +核心能力： -- **模型选择**：推荐具备强工具调用能力的模型（如千问-Max 系列）。支持配置最长回复长度、temperature、enable_thinking（思考模式）等参数。 -- **提示词**：支持静态文本和自定义变量（通过 `/` 插入），定义角色、行为指令和能力边界。 -- **内置工具**：提供沙箱环境中的 `bash`、`write`、`read`、`edit`、`glob`、`grep`、`download_file` 等工具，默认关闭，按需开启。 -- **知识库**：作为工具由智能体自主规划调用，支持通过标签限定查询范围。 -- **MCP**：外部工具以 MCP 协议接入，支持动态非固定顺序调用。插件可一键转换为 MCP 服务。 -- **应用组件**：可将其他智能体或工作流发布为组件后作为工具接入。 -- **技能（Skill）**：可添加能力包，智能体自动识别匹配任务并调用。 -- **记忆**：支持短期记忆（0-30 轮上下文），长期记忆计划未来支持。 -- **预解析文件**：控制上传文件处理方式，千问-VL 系列模型即使关闭预解析也能直接解析图片和视频。 +- **模型选择**：推荐选用具备强工具调用能力的模型（如千问-Max 系列）。支持配置 temperature、最长回复长度、enable_thinking（思考模式）等参数。 +- **内置工具**：提供沙箱环境中的 bash、read、write、edit、glob、grep、download_file 等工具，默认关闭，按需开启。 +- **知识库**：作为工具由智能体自主规划调用，支持通过标签限定检索范围。 +- **MCP 服务**：外部工具均以 MCP 协议接入，支持动态非固定顺序调用。 +- **预解析文件**：支持开启/关闭文件预解析，千问-VL 系列可直接解析图片和视频。 +- **应用组件**：可将已发布的智能体或工作流作为工具接入。 +- **技能（Skill）**：可添加能力包，智能体在对话中自动识别并调用。 +- **短期记忆**：支持 0-30 轮上下文记忆。 -**ReAct 最大轮次**（1-50）用于限制单次会话中工具调用最大次数，超出后自动生成最终回复。 +> **注意**：旧版智能体和新版智能体基于不同的技术架构，不支持直接升级或版本切换。如需使用 Agent 2.0，需重新创建应用。 -详细配置参见 [新版智能体应用（Agent 2.0）](../../raw/application-user-guide/llm-application/new-single-agent-application.md)。 - -> **注意**：旧版智能体（Agent 1.0）与新版基于不同技术架构，不支持直接升级或切换。如需使用新版功能，需在控制台重新创建 Agent 2.0 应用。 +**ReAct 最大轮次**：取值 1-50，限制单次会话中工具调用的最大次数，超出后自动生成最终回复。 ### Agent 1.0（旧版） -旧版智能体通过知识库（RAG）和插件两类核心能力扩展模型。知识库检索到的文本会占用模型上下文窗口，需注意调整检索策略避免超限。自定义插件有 5 秒超时限制。 +旧版智能体在检索知识库后再决策是否调用其他工具，适用于意图单一、流程固定的简单任务。核心能力包括知识库（RAG）和插件调用，详见[智能体应用](../../raw/application-user-guide/llm-application/single-agent-application.md)。 + +> **注意**：旧版智能体的自定义插件有 5 秒超时限制。 -旧版智能体的能力详情参见 [智能体应用](../../raw/application-user-guide/llm-application/single-agent-application.md)。 +## 工作流应用（Workflow） -## 工作流应用 +工作流通过可视化节点编排将多步骤复杂任务串联成稳定可控的执行链路。适合固定流程自动化场景，如诈骗信息识别、智能导购、日程管理等。详见[工作流应用](../../raw/application-user-guide/llm-application/workflow-application.md)。 -工作流通过可视化节点编排将复杂任务串联为稳定可控的执行链路。核心节点包括： +主要节点类型： -- **开始/结束节点**：定义输入输出参数结构，预置 `query`、`historyList`、`imageList` 等变量。 -- **大模型节点**：配置模型、提示词和用户提示词，支持变量插入（`${sys.query}`）。 +- **开始/结束节点**：定义输入输出参数，预置 query、historyList、imageList 变量。 +- **大模型节点**：配置模型、提示词和用户提示词，支持记忆功能。 - **意图分类节点**：根据用户意图分流到不同处理分支。 -- **智能体群组节点**：将多个子智能体组合，由决策模型分派任务。 -- **变量处理节点**：静态文本输出或变量转换。 -- **会话变量**：全局变量，贯穿工作流全生命周期，可跨节点引用。 +- **智能体群组节点**：编排多个子智能体协作完成任务。 +- **变量处理节点**：处理和转换流程中的变量。 -工作流支持记忆功能（本节点缓存或自定义缓存），适用于诈骗识别、智能导购、日程管理等多步骤场景。详细节点说明和案例参见 [工作流应用](../../raw/application-user-guide/llm-application/workflow-application.md)。 +工作流支持**会话变量**作为全局变量，在整个工作流生命周期内记录参数信息并在各节点间共享。 ## 高代码应用 -面向专业开发者，支持基于完整 Python 项目结构部署 AI 后端服务。关键特性： +面向专业开发者，支持基于 Python 项目结构部署 AI 后端服务。详见[高代码应用](../../raw/application-user-guide/llm-application/rich-code-application.md)。 -- **部署方式**：Serverless Function（低负载、无状态）和 K8s（高性能、有状态长程任务）。 -- **代码提交**：可使用预置模板（基础对话 Agent、工具调用 Agent、深度研究 Agent）或上传 `.whl` 代码包。 -- **MCP 工具接入**：在控制台直接关联知识库、工作流、插件等 MCP 服务。 -- **前端体验**：支持直接体验、自定义交互卡片、基于 Spark Design 框架的自定义 WebUI。 -- **网关配置**：通过云原生 API 网关配置自定义域名和路由，支持 Token 鉴权。 -- **企业级能力**：自动化运维、可观测、日志服务、API 网关等。 +关键特性： -详细创建和部署流程参见 [高代码应用](../../raw/application-user-guide/llm-application/rich-code-application.md)。 +- **部署方式**：Serverless Function（低负载、无状态、快速拉起）和 K8s（高性能、有状态、长程任务）两种模式。 +- **代码提交**：支持使用模板代码（基础对话 Agent、工具调用 Agent、深度研究 Agent）或上传 .whl 格式代码包。 +- **MCP 工具接入**：控制台直接关联知识库、工作流、插件等 MCP 服务。 +- **自定义前端**：支持直接体验、自定义交互卡片和基于 Spark Design 框架的自定义 WebUI。 +- **企业级能力**：自动化运维、可观测、日志服务、API 网关。 +- **网关配置**：通过云原生 API 网关实现自定义域名和生产环境访问，支持 [Token](../concepts/token.md) 鉴权。 ## 文件问答 -智能体应用支持上传文件（文档、图片、音视频）进行智能问答，提供三种处理模式： - -| 模式 | 原理 | 适用场景 | -|------|------|---------| -| 全文引用 | 解析文件内容整体传入模型 | 文档总结、全文翻译、风格润色 | -| 切片检索（RAG） | 切分文件为片段，检索最相关内容 | 长文档问答、精确定位信息来源 | -| 自定义处理 | 文件信息交由模型自主调用工具处理 | 图片风格转换、视频分析等 | +智能体应用支持上传文件后进行智能问答，提供三种处理模式，详见[文件问答](../../raw/application-user-guide/llm-application/file-q-a.md)： -支持的文件格式包括 `.doc`/`.docx`/`.pdf`/`.xlsx`/`.md`/`.txt` 等文档，`.png`/`.jpg` 等图片，`.mp4`/`.mkv` 等视频和 `.mp3`/`.wav` 等音频。单会话最多 10 个文件，单文件不超过 10MB（API 方式可支持更大文件）。 +| 模式 | 适用场景 | 特点 | +|------|----------|------| +| 全文引用 | 文档总结、全文翻译、风格润色 | 简单直接，受上下文长度限制 | +| 切片检索（RAG） | 长文档问答、知识库检索 | 能处理超长文件，依赖切片和检索策略 | +| 自定义处理 | 图片转换、视频分析等需要外部工具的任务 | 功能灵活，依赖所配置的工具 | -关键参数： -- **全文引用**：可配置单文件最大解析长度（token）和最大拼装长度（token），超出部分从末尾截断。 -- **切片检索**：可配置召回片段数和最大拼装长度，超限时按相关性得分从低到高丢弃。 +文件格式支持：文档（doc/docx/ppt/pdf/md 等）、图片（png/jpg/gif 等）、视频（mp4/mkv 等）、音频（mp3/wav 等）。单会话最多 10 个文件，单文件不超过 10MB。超过 10MB 的文件需使用文件上传 API。 -文件问答的详细使用方法参见 [文件问答](../../raw/application-user-guide/llm-application/file-q-a.md)。 +## 发布与调用 -## 发布与集成 +三种应用类型均需先在控制台**发布**后才能通过 API/SDK 调用： -所有应用类型均需先在控制台发布后才能进行 API 调用或第三方集成。发布时会展示自上次发布以来的配置变更差异。 - -- **智能体应用**：支持通过 API/SDK 调用，也可发布到钉钉、微信公众号等平台，或发布为可复用组件。RAM 账号发布前需确认拥有 `ram:CreateServiceLinkedRole` 权限。 +- **智能体应用**：支持 API/SDK 调用，也可发布到钉钉、微信公众号等第三方平台，或发布为可复用组件。 - **工作流应用**：发布后通过工作流应用 API 调用。 -- **高代码应用**：部署后通过触发器或 API 网关访问。 +- **高代码应用**：通过触发器 URL 或云原生 API 网关访问。 ## 计费说明 -百炼应用创建本身不收费，费用主要来自以下方面： - -- **模型调用**：按模型类型和 Token 用量计费。上传文件的问答会额外消耗输入 Token（全文引用模式消耗最大，切片检索模式相对较少）。 -- **知识库**：按量付费，检索到的文本切片会增加模型输入 Token 消耗。 -- **MCP/插件**：部分官方 MCP（文生图、文生视频等）按模型调用计费；涉及第三方 API 的费用由第三方收取。 -- **高代码应用**：部署后函数计算、API 网关、存储等资源均会产生费用。 -- **长期记忆**：数据存储不收费，记忆体内容占用的 Token 暂不计费。 +- **模型调用**：按模型类型和 [Token](../concepts/token.md) 用量计费，创建应用本身不收费。 +- **知识库**：按量付费，召回的文本切片会增加模型输入 [Token](../concepts/token.md)。 +- **MCP/插件**：部分官方 MCP 按模型调用计费（如文生图），部分涉及第三方 API 费用。 +- **高代码应用**：部署后函数计算、API 网关、存储均会产生费用。 +- **文件问答**：文件上传不收费，问答按模型 Token 计费，全文引用模式消耗最大，切片检索模式通常更经济。 ## 来源文档 diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/memory-library-overview.md b/skills/bailian-docs-llm-wiki/wiki/guides/memory-library-overview.md index cf9bb67..070272e 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/memory-library-overview.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/memory-library-overview.md @@ -155,3 +155,4 @@ CLI 等效：`openclaw modelstudio-memory search|list|stats`。 + diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/model-compression.md b/skills/bailian-docs-llm-wiki/wiki/guides/model-compression.md index 248dd1d..da4802d 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/model-compression.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/model-compression.md @@ -1,97 +1,69 @@ # model compression -模型压缩（Model Compression）使用量化算法将全精度微调模型转换为低精度版本。压缩后的模型推理时显存占用更低，可部署到更小规格的部署单元，从而降低部署成本并提升推理吞吐。该功能可在百炼控制台「模型训练 > 模型压缩」页面创建压缩任务，也可通过 OpenAPI 调用，产出的模型可直接用于[模型部署](../concepts/model-deployment.md)。详见 [模型压缩](../../raw/model-user-guide/model-compression/model-compression-introduction.md)。 +模型压缩是百炼平台提供的量化功能，用于将全精度微调模型转换为低精度版本，在保持模型能力的前提下降低部署所需的 MU 规格，从而减少推理成本。该功能属于模型生产链路中的可选环节，位于模型调优与模型部署之间。需要注意的是，百炼平台的模型压缩特指量化，不涉及结构剪枝或知识蒸馏。 -## 使用前提 +## 核心概念 -压缩前需满足以下条件： +模型压缩通过量化技术降低模型参数精度来实现部署成本优化。完整的模型生产链路为：模型调优 → 模型压缩（可选）→ 模型部署。以 qwen3.5-flash-2026-02-23 微调模型为例，压缩前部署规格为 MU1*2（108 元/小时），压缩后降至 MU8*1（47 元/小时），部署成本节省约 56%。详细说明参见[模型压缩](../../raw/model-user-guide/model-compression/model-compression-introduction.md)。 -- **源模型准备**：当前工作空间至少有一个支持压缩的自定义微调模型（通过[模型调优](../concepts/fine-tuning.md)产出）。具体支持哪些基础模型，参见下方「支持压缩的模型」。微调流程详见[模型调优](../concepts/fine-tuning.md)文档。 +> **注意**：压缩操作不可逆。压缩后的模型不支持继续微调，也不支持二次压缩。如需调整，必须从上游全精度微调模型重新压缩。 -## 支持压缩的模型 +## 支持的模型 -当前支持以下基础模型对应的自定义微调模型： +当前支持压缩的模型以控制台展示为准。已知支持的模型系列及规格如下： -| 模型系列 | 模型名称 | 压缩前部署 | 压缩后部署 | -| --- | --- | --- | --- | -| 千问 | qwen3.5-flash-2026-02-23 | MU1 * 2（¥108/小时） | MU8 * 1（¥47/小时） | +| 模型系列 | 基础模型 | 压缩前部署规格 | 压缩后部署规格 | +|---------|---------|--------------|--------------| +| Qwen | qwen3.5-flash-2026-02-23 | MU1*2（108 元/小时） | MU8*1（47 元/小时） | -> **注意**：具体支持模型以百炼控制台「模型压缩」页面为准，列表可能随版本更新变化。 +仅支持通过百炼平台微调产出的自定义模型，不支持基础模型或第三方模型。 -## 操作步骤 +## 使用限制 -1. 登录百炼控制台，在顶部导航栏单击「模型」，在「模型训练」区域单击「模型压缩」。 -2. 单击页面右上角「+ 创建压缩任务」。 -3. 在创建压缩任务页面填写以下信息： - - **基本信息**：任务名称（必填）、任务描述（可选）。 - - **压缩配置**： - - **选择源模型**：从弹窗中选择当前工作空间内符合条件的自定义微调模型。 - - **量化产出模型名后缀**：用于拼接产出模型 ID，仅支持小写字母和数字，长度不超过 8 位。 - - **量化模板**：从所选源模型支持的模板列表中选择。模板名称中包含目标部署规格（如 MU5、MU8），选择模板即决定压缩后可部署的规格。 - - **校准数据**（所选模板要求校准数据时显示）：校准数据用于统计模型权重和激活值的数值分布，以确定量化时的缩放范围和分块大小。从已发布数据集中按「数据集 → 版本」选择，数据集需先在「数据管理」中创建并发布。OpenAPI 调用时通过 `custom_calibration_file_ids` 字段传入。 -4. 单击「开始压缩」，任务进入列表。 -5. 跟踪任务进度： - - 在任务列表中查看运行状态（待开始 / 排队中 / 运行中 / 停止中 / 压缩成功 / 压缩失败 / 已取消）。 - - 单击任务名进入详情页，在「详情」页签查看任务基本信息，切换到「日志」页签查看运行日志。 - - 如需取消运行中的任务，在列表中单击「停止」。 -6. 任务成功后，在任务列表中单击压缩后的模型名称，跳转到「我的模型」页面，单击「部署」即可上线。支持的部署规格由所选量化模板决定。 +- 仅华北2（北京）地域可用。 +- 仅支持百炼平台微调产出的自定义模型。 +- 压缩后的模型不支持继续微调或二次压缩。 +- 压缩任务创建后不可修改配置。 -完整操作流程可参考 [模型压缩](../../raw/model-user-guide/model-compression/model-compression-introduction.md)。 +## 创建压缩任务 -## 关键参数 +在使用模型压缩前，需确保工作空间中已有微调训练完成的自定义模型。操作路径：控制台 → 模型 → 模型训练 → 模型压缩 → 创建压缩任务。 -创建压缩任务时的核心配置项： +创建任务时需配置以下参数（详见[模型压缩](../../raw/model-user-guide/model-compression/model-compression-introduction.md)中的操作步骤）： -| 参数 | 是否必填 | 说明 | -| --- | --- | --- | -| 任务名称 | 必填 | 压缩任务标识 | -| 任务描述 | 可选 | 任务补充说明 | -| 选择源模型 | 必填 | 当前工作空间内符合条件的自定义微调模型 | -| 量化产出模型名后缀 | 必填 | 拼接产出模型 ID，仅小写字母和数字，长度 ≤ 8 | -| 量化模板 | 必填 | 决定压缩后可部署规格（如 MU5、MU8） | -| 校准数据 | 条件必填 | 模板要求时显示，用于统计权重和激活值分布 | +| 参数 | 必填 | 说明 | +|-----|------|-----| +| 任务名称 | 是 | 最长 50 字符，建议包含模型简称、量化方式和版本号 | +| 任务描述 | 否 | 最长 200 字符 | +| 选择源模型 | 是 | 仅展示可压缩的微调模型，切换源模型会清空已选量化模板 | +| 量化产出模型名后缀 | 是 | 仅支持小写字母和数字，最长 8 位 | +| 量化模板 | 是 | 须先选择源模型，MU 编号越大表示部署规格越小、成本越低 | +| 校准数据 | 条件选填 | 仅当量化模板包含校准输入参数时显示，最多选择 5 个数据集 | -## 限制和注意事项 +## 量化模板与校准数据选择 -- **模型范围**：仅「支持压缩的模型」列表中的自定义微调模型可压缩，已量化的模型不支持二次压缩。 -- **部署规格**：压缩产出的模型支持的部署单元规格由所选量化模板决定（模板名称中包含目标规格，如 MU5、MU8 等），部署数量在「[模型部署](../concepts/model-deployment.md)」中配置。 -- **任务状态**：包含待开始、排队中、运行中、停止中、压缩成功、压缩失败、已取消。仅「排队中」或「运行中」状态支持取消；终态任务（压缩成功 / 压缩失败 / 已取消）可删除。单击「停止」或「删除」后需在确认弹窗中二次确认。 -- **任务不可逆**：压缩产出的模型不支持继续训练，也不支持二次压缩。如需迭代，请回到上游全精度模型重新训练后再压缩。 -- **删除任务的影响**：删除任务记录仅删除任务本身，已生成的产出模型仍保留在「我的模型」中。 -- **校准数据限制**：控制台 UI 暂不支持选择 OSS 挂载 / 挂载存储类型的数据集，请使用「数据管理」中「内部上传」类型且「已发布」状态的数据集。OpenAPI 调用可通过 `custom_calibration_file_ids` 字段直接传入数据集组 ID，由后端校验。 +**量化模板**决定了压缩后模型的部署规格。模板名称中 MU 编号越大，部署规格越小、成本越低，但精度损失可能越大。建议根据业务对成本和精度的权衡来选择。 -## [计费](../concepts/billing.md)说明 +**校准数据**用于提升量化精度，建议选择与目标推理场景语义相近的数据集。例如用于客服问答场景时，应选择包含客服对话样本的数据集。 -当前模型压缩功能限时免费，具体免费截止时间以控制台公告为准。压缩产出的[模型部署](../concepts/model-deployment.md)上线后，按所选部署单元的标准规格[计费](../concepts/billing.md)，[计费](../concepts/billing.md)详情参见模型部署文档。 +## 任务状态与管理 -## 常见问题 +压缩任务有 7 种状态：PENDING（待开始）→ QUEUING（排队中）→ RUNNING（运行中）→ SUCCEEDED（成功）/ FAILED（失败）/ CANCELING（停止中）→ CANCELED（已取消）。 -**Q1：哪些模型可以压缩？** -支持「压缩的模型」列表中的自定义微调模型。已量化的模型不支持二次压缩。具体支持模型以控制台为准。 +任务管理操作： +- **停止任务**：仅 PENDING 和 RUNNING 状态可停止，停止后不可恢复。 +- **删除任务**：仅终态（SUCCEEDED、FAILED、CANCELED）可删除，删除任务记录不影响已产出的压缩模型。 -**Q2：任务可以取消吗？** -「排队中」或「运行中」状态的任务支持取消，取消后状态变为「停止中」再转为「已取消」。终态任务无法取消。 +任务失败时，可在详情页查看错误信息，或切换到日志页签搜索 ERROR 级别日志进行排查。如仍无法解决，可提交工单并附上任务 ID 和日志文件。更多管理细节参见[模型压缩](../../raw/model-user-guide/model-compression/model-compression-introduction.md)。 -**Q3：压缩后的模型支持继续微调或再压缩吗？** -不支持。压缩产出的模型既不支持继续训练，也不支持二次压缩。如需迭代，请回到上游全精度模型重新训练。 +## 计费说明 -**Q4：校准数据可以使用 OSS 挂载的数据集吗？** -控制台 UI 暂不支持选择 OSS 挂载 / 挂载存储类型的数据集，请使用「数据管理」中「内部上传」类型且「已发布」状态的数据集。OpenAPI 调用可通过 `custom_calibration_file_ids` 字段直接传入数据集组 ID，由后端校验。 - -更多常见问题与限制说明详见 [模型压缩](../../raw/model-user-guide/model-compression/model-compression-introduction.md)。 +- 压缩任务本身限时免费，截止时间以控制台公告为准。 +- 压缩后的模型在部署阶段按 MU 规格计费。 +- 建议在免费期内对同一微调模型尝试多个量化模板，分别部署后用业务测试集验证推理效果，选择最优方案后再正式上线。 ## 来源文档 - [模型压缩](../../raw/model-user-guide/model-compression/model-compression-introduction.md) - - - - - - - - - - diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/model-context-protocol.md b/skills/bailian-docs-llm-wiki/wiki/guides/model-context-protocol.md index a2afd31..e2be058 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/model-context-protocol.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/model-context-protocol.md @@ -105,3 +105,4 @@ MCP 服务可集成至第三方应用（Cherry Studio、Cursor）或个人项目 + diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/model-data-overview.md b/skills/bailian-docs-llm-wiki/wiki/guides/model-data-overview.md index 88eaa4e..62cc19a 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/model-data-overview.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/model-data-overview.md @@ -162,3 +162,4 @@ Few-Shot 策略示例：训练集 1000 条、指令生成依赖样本数 5、生 + diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/model-deployment-1.md b/skills/bailian-docs-llm-wiki/wiki/guides/model-deployment-1.md index acb3bf6..01ee6d8 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/model-deployment-1.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/model-deployment-1.md @@ -1,50 +1,44 @@ # model deployment 1 -百炼平台的模型部署功能为预置模型和调优后模型提供独立的、资源专享的推理服务，支持预置吞吐（PTU）、模型单元和按 Token 用量三种计费方式。开发者可通过控制台或 API 完成部署，并可将本地训练的 LoRA 模型从 OSS 导入平台后进行部署。 +百炼平台提供模型部署功能，支持将预置模型或调优后的模型部署为独立的、资源专享的推理服务，满足高并发、低延迟等不同业务需求。平台提供三种计费方式（预置吞吐 PTU、模型单元、[Token](../concepts/token.md) 用量），并支持通过控制台或 API 完成部署操作，同时允许从 OSS 导入自训练的 LoRA 模型进行部署。 -## 计费方式概览 +## 计费方式概述 -百炼提供三种计费方式，创建后不可更改，如需切换须先下线再重新部署。详见[模型部署](../../raw/model-user-guide/model-deployment-1/model-deployment-introduction.md)。 - -| 计费方式 | 适用场景 | 性能特点 | 扩缩容 | -|---------|---------|---------|--------| -| **预置吞吐（PTU）** | 高负载生产环境，流量可预估 | 平台预置吞吐/并发，TPS 通常提升 1.5~2.0 倍 | 自助增减吞吐量 | -| **模型单元** | 调优后大规模推理，需自定义性能指标 | 延迟/吞吐可自定义，支持 PD 分离模式 | 自助增减单元数量 | -| **按 Token 用量** | 调优后效果验证，对并发和延迟要求不高 | 不使用不计费，价格优势最高 | 控制台提交申请，人工审核 | +百炼模型部署提供三种计费方式，创建后无法更改，如需切换需先下线再重新部署。详细计费规则参见[模型部署](../../raw/model-user-guide/model-deployment-1/model-deployment-introduction.md)。 ### 预置吞吐（PTU） -费用公式：`费用 = 使用时长 × (输入 TPM 单价 × 输入 TPM + 输出 TPM 单价 × 输出 TPM)` +通过平台预留资源保障特定 TPM 吞吐能力，在保障额度内不限速。适用于流量稳定、需保障并发体验的高负载生产环境。 -- 支持后付费（按小时）和预付费（按天）两种结算方式。 -- 预付费订单支付后实时生效，无法提前终止；22:00 后下单到期日自动顺延 1 天。 -- 超出购买的 TPM 量或输入超过模型上限时，自动切换为按量付费模式（响应头包含 `x-dashscope-ptu-overflow:true`）。 -- 支持的模型包括千问3.7-Max、千问3.7-Plus、千问-Flash、DeepSeek-v4 系列、GLM-5.2 等。 +- 计费公式：`费用 = 使用时长 × (输入 TPM 单价 × 输入 TPM + 输出 TPM 单价 × 输出 TPM)` +- 支持后付费（按小时）和预付费（按天）两种模式 +- 超出购买的 TPM 量或输入超过模型上限时，自动切换为按量付费模式（响应头包含 `x-dashscope-ptu-overflow:true`） +- TPS 相比按 [Token](../concepts/token.md) 计费通常提升约 1.5~2.0 倍 +- 预付费订单无法提前终止 -### 模型单元 +### 模型单元（MU） -费用公式：`费用 = 使用时长（小时）× 模型单元数量 × 模型单元单价` +按使用时长与模型单元数量配置算力，资源独占，性能指标可自定义。 -- 支持后付费（按小时）和预付费（包月）。首月内提前退订，日单价按 1.2 倍计费。 -- 模型单元规格从 MU1 到 MU9 不等，不同规格对应不同算力和性能。 -- 部分模型支持 PD 分离模式（Prefill/Decode 分离），可降低首 Token 延迟、提高吞吐。 -- 支持配置推理模式（Instruct 非思考 / Thinking 思考模式）、最长上下文、服务限流（RPM/TPM）。 -- 后付费方式的算力资源先买到先得，购买不成功全额退款。 +- 计费公式：`费用 = 使用时长（小时）× 模型单元数量 × 模型单元单价` +- 支持后付费（按小时）和预付费（包月），首月内提前退订日单价按 1.2 倍计费 +- 支持 PD 分离计算模式（将 Prefill 和 Decode 拆到不同节点，降低首 [Token](../concepts/token.md) 延迟、提高吞吐） +- 后付费方式的算力资源先买到先得，购买不成功全额退款 -### 按 Token 用量 +### Token 用量 -费用公式：`费用 = 输入 Token 数 × 输入单价 + 输出 Token 数 × 输出单价` +按调用产生的输入/输出 Token 计费，仅支持部分经过 LoRA 调优后的模型。 -- 仅支持部分基础模型完成 SFT 高效训练（LoRA）后的自定义模型。 -- 一个月内不使用将自动释放。 +- 计费公式：`费用 = 输入 Token 数 × 输入单价 + 输出 Token 数 × 输出单价` +- 不使用不计费，一个月内不使用将自动释放 -## PTU 长输入与前缀缓存 +## PTU 长输入与缓存 -PTU 部署支持长输入请求和前缀缓存，适用于长文档分析和多轮对话场景。详见[预置吞吐长输入与缓存](../../raw/model-user-guide/model-deployment-1/ptu-long-input-and-cache.md)。 +PTU 部署支持长输入请求和前缀缓存功能，详见[预置吞吐长输入与缓存](../../raw/model-user-guide/model-deployment-1/ptu-long-input-and-cache.md)。 ### 长输入阶梯系数 -部分模型（如 glm-5.1）在输入超过 32K token 后，按更高的阶梯系数折算 TPM 消耗： +部分模型输入超过 32K token 时，按更高阶梯系数折算 TPM 消耗： | 模型 | 输入上限 | 缓存折扣 | 阶梯系数 | |------|---------|---------|---------| @@ -54,83 +48,120 @@ PTU 部署支持长输入请求和前缀缓存，适用于长文档分析和多 ### 前缀缓存 -命中缓存的输入 token 按折扣系数消耗额度，可显著降低多轮对话场景的成本。通过 API 响应中的 `cached_tokens` 字段（值大于 0）确认缓存是否生效。 +命中缓存的输入 token 按折扣系数消耗额度，可降低多轮对话和重复前缀场景的成本。通过 API 响应中的 `cached_tokens` 字段确认缓存是否生效（值大于 0 表示命中）。 -超出 PTU 额度或超过模型输入上限（千问 128K / DeepSeek 64K）时，请求自动转为按量计费，无需修改调用代码。 +### 溢出机制 -### 容量计算器 +超出 PTU 额度或输入超过模型上限（千问 128K / DeepSeek 64K）时，请求自动转为按量计费，业务不中断。API 响应中 `service_tier` 为 `default` 或不返回表示已转按量计费。 -建议在创建或扩容前，使用控制台的容量计算器估算长输入场景的额度需求。输入参数包括每分钟请求数（RPM）、平均输入/输出长度和预估缓存命中率。 +## 支持的模型 -## 模型导入 +### PTU 支持的主要模型 + +| 模型 | 代码 | 最长输入 | +|------|-----|---------| +| 千问3.7-Max | qwen3.7-max-2026-05-20 | 256K | +| 千问3.7-Plus | qwen3.7-plus-2026-05-26 | 256K | +| DeepSeek-v4-Pro | deepseek-v4-pro | 256K | +| DeepSeek-v4-Flash | deepseek-v4-flash | 256K | +| GLM-5.2 | glm-5.2 | 1M | + +### 模型单元支持的模型类别 + +模型单元支持更广泛的模型，包括文本生成（千问、DeepSeek、GLM 等）、[多模态](../concepts/multimodal.md)（千问 VL、千问 Omni）、语音合成（CosyVoice）等。部署时可选择 Instruct（非思考模式）或 Thinking（思考模式）推理模式。 -百炼支持将本地训练的 LoRA 模型从 OSS 导入平台，导入后可进行部署、增量训练等操作。详见[模型导入](../../raw/model-user-guide/model-deployment-1/model-import.md)。 +### Token 用量支持的基础模型 -### 支持的基础模型 +仅支持部分千问系列和千问 VL 系列基础模型经 SFT 高效训练后的自定义模型，包括 qwen3-32b、qwen3-8b、qwen2.5-72b-instruct 等。 -当前仅支持导入 LoRA 微调版本，不支持全参微调模型。支持的基础模型系列包括：千问3（32B/14B/8B/4B）、千问3-VL-8B、千问2.5（72B/32B/14B/7B）、千问2.5-VL（72B/7B）。 +## 模型导入 + +百炼支持将本地训练的 LoRA 模型从 OSS 导入平台进行部署，详细流程参见[模型导入](../../raw/model-user-guide/model-deployment-1/model-import.md)。 ### 导入要求 -- **必需文件**：`adapter_model.safetensors`（权重）和 `adapter_config.json`（配置）。 -- **rank 值**：必须为 8、16、32 或 64 之一，且所有 LoRA 层使用相同 rank。 -- 不支持修改词汇表或 chat_template 的模型。 -- VL 模型必须冻结 VIT 部分（adapter 文件中不能包含 `visual` 相关权重）。 +- 仅支持 LoRA 模型，不支持全参微调模型 +- 必需文件：`adapter_model.safetensors`（权重）和 `adapter_config.json`（配置） +- rank 值必须为 8、16、32 或 64 之一 +- 不支持修改了词汇表或 chat_template 的模型 +- VL 模型必须冻结 VIT 部分（adapter 中不能包含 `visual` 相关参数） + +### 支持导入的基础模型 + +千问3（32B/14B/8B/4B）、千问3-VL-8B、千问2.5（72B/32B/14B/7B）、千问2.5-VL（72B/7B）。 ### OSS 授权 -首次导入需完成 OSS 授权，并为目标 Bucket 添加 `bailian-datahub-access` 标签（值为 `read`）。子账号需额外授予 `ram:CreateServiceLinkedRole` 权限。 +首次导入需完成 OSS 服务关联角色授权，并为目标 Bucket 添加 `bailian-datahub-access` 标签（值为 `read`）。子账号需额外获取 `ram:CreateServiceLinkedRole` 权限。 -## 通过 API 部署模型 +## 部署方式 -百炼支持通过 HTTP API 完成模型部署的全生命周期管理。详见[使用 API或命令行进行模型部署](../../raw/model-user-guide/model-deployment-1/model-deployment-quick-start.md)。 +### 控制台部署 -> **注意**：API 部署目前仅适用于华北2（北京）地域。 +前往[模型部署控制台](https://bailian.console.aliyun.com/cn-beijing/?tab=model#/efm/model_deploy/create)，填写服务名称、选择模型和计费方式，确认后等待状态变为"运行中"即部署成功。 -### 创建部署 +### API 部署 -API 端点：`POST https://dashscope.aliyuncs.com/api/v1/deployments` +通过 DashScope API 进行部署，适用于自动化场景，详细示例参见[使用 API或命令行进行模型部署](../../raw/model-user-guide/model-deployment-1/model-deployment-quick-start.md)。 -三种计费方式的关键参数差异： +**PTU 部署示例：** -| 参数 | PTU（`plan: "ptu"`） | 模型单元（`plan: "mu"`） | Token 用量（`plan: "lora"`） | -|------|---------------------|------------------------|---------------------------| -| `ptu_capacity` | 必填：`input_tpm` + `output_tpm` | - | - | -| `deploy_spec` | - | 必填：如 `"MU1"` | - | -| `capacity` | - | 副本数 | 必填但无实际效果 | -| `enable_thinking` | - | 可选：启用思考模式 | - | -| `max_context_length` | - | 可选：最长上下文 | - | -| `rpm_limit` / `tpm_limit` | - | 可选：服务限流 | - | +```bash +curl "https://dashscope.aliyuncs.com/api/v1/deployments" \ +--header "Authorization: Bearer $DASHSCOPE_API_KEY" \ +--header 'Content-Type: application/json' \ +--data '{ + "name": "my_qwen_flash", + "model_name": "qwen-flash-2025-07-28", + "plan": "ptu", + "ptu_capacity": { + "input_tpm": 10000, + "output_tpm": 1000 + } +}' +``` -### 查询与删除 +**模型单元部署示例：** -- 查询状态：`GET /api/v1/deployments/{deployed_model}`，`status` 为 `RUNNING` 表示部署完成。 -- 删除服务：`DELETE /api/v1/deployments/{deployed_model}`，执行后立即开始下线且不可恢复。 +```bash +curl "https://dashscope.aliyuncs.com/api/v1/deployments" \ +--header "Authorization: Bearer $DASHSCOPE_API_KEY" \ +--header 'Content-Type: application/json' \ +--data '{ + "name": "my_qwen_plus", + "model_name": "qwen-plus-2025-12-01", + "plan": "mu", + "deploy_spec": "MU1", + "enable_thinking": true, + "capacity": 4 +}' +``` -### 推理调用 +关键 `plan` 参数值：`ptu`（预置吞吐）、`mu`（模型单元）、`lora`（Token 用量）。 -部署完成后，使用 [DashScope SDK](../concepts/dashscope-sdk.md) 或兼容的 OpenAI API 格式发起推理请求。确保 API Key 所在的[业务空间](../concepts/workspace.md)与模型部署所在的[业务空间](../concepts/workspace.md)一致。 +部署成功后通过 `GET /api/v1/deployments/{deployed_model}` 查询状态，`status` 为 `RUNNING` 表示可用。不再使用时通过 `DELETE` 请求删除，删除后立即停止计费且不可恢复。 -## API 响应中的额度字段 +## API 响应中的关键字段 -PTU 部署的 API 响应包含以下关键字段： +PTU 部署的 API 响应包含额度相关字段，在不同 API 格式（OpenAI Chat、OpenAI Responses、Anthropic、DashScope）下 JSON 路径略有不同： | 字段 | 说明 | |------|------| | `service_tier` | `ptu-standard` 表示使用 PTU 额度；`default` 或不返回表示按量计费 | -| `provisioned_tokens` | 折算后实际消耗的 PTU 额度（含阶梯系数和缓存折扣） | +| `provisioned_tokens` | 折算后实际消耗的 PTU 额度 token 数（含阶梯系数和缓存折扣） | | `cached_tokens` | 前缀缓存命中的 token 数 | -上述字段在不同 API 格式（OpenAI Chat、OpenAI Responses、Anthropic、DashScope）下的 JSON 路径有所不同，具体位于 `usage.prompt_tokens_details` 和 `usage.completion_tokens_details`（或 `output_tokens_details`）下。 - -> **注意**：Anthropic 兼容格式暂不返回 `cached_tokens` 字段，可通过 `provisioned_tokens` 间接判断缓存效果。 +> **注意**：Anthropic 兼容格式暂不返回 `cached_tokens` 字段，仅可通过 `provisioned_tokens` 间接判断缓存效果。 -## 常见问题 +## 限制与注意事项 -- **部署后报权限不足**：检查 API Key 归属[业务空间](../concepts/workspace.md)是否拥有目标模型的部署权限，并确认归属账号在该业务空间中有操作权限。 -- **导入模型与本地推理效果不一致**：百炼推理引擎参数默认值可能不同，建议显式设置 `temperature=1.0`、`top_p=1.0`、`repetition_penalty=1.0` 以对齐 vLLM 默认行为。 -- **PTU 利用率超过 100%**：长输入阶梯系数使折算消耗高于原始 token 数，超出部分自动转按量计费，不影响可用性。 -- **OSS 导入报错 10041495**：主账号需先开通 OSS 服务。 +- 计费方式在创建后无法更改，需下线重新部署才能切换 +- 部署成功后即开始计费，即使尚未调用模型 +- PTU 预付费订单无法提前终止；后付费欠费后资源保留 24 小时，超时底层资源被删除 +- Token 用量计费方式一个月内不使用将自动释放 +- 导入的 LoRA 模型若与本地 vLLM/SGLang 推理效果不一致，需调整 `temperature`、`top_p`、`top_k` 等参数对齐 +- API 部署需确保 [API Key](../concepts/api-key.md) 所在[业务空间](../concepts/workspace.md)拥有模型部署权限，否则会报 `Workspace xxx does not have deployment privilege` +- 本文档仅适用于华北2（北京）地域 ## 来源文档 diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/model-evaluation-introduction.md b/skills/bailian-docs-llm-wiki/wiki/guides/model-evaluation-introduction.md index 76f13d7..065e683 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/model-evaluation-introduction.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/model-evaluation-introduction.md @@ -1,72 +1,49 @@ # model evaluation introduction -模型评测是百炼平台提供的模型能力评估功能，支持自定义评测和基线评测两种方式，通过评测维度对模型推理结果进行打分和对比，帮助开发者选择最优模型或验证调优效果。当前仅支持文本生成类模型的评测，评测结果以报告和排行榜形式呈现。 +模型评测是百炼平台提供的模型能力评估功能，支持自定义评测和基线评测两种方式，通过评测维度对模型推理结果进行打分和对比，帮助开发者进行模型选型、调优验证和持续质量监控。当前仅支持文本生成类模型的评测。 -## 使用场景 +## 评测方式 -- **模型选型对比**：使用相同的评测数据集和维度评测多个候选模型，通过排行榜横向对比综合得分和通过率，用数据驱动选型决策。 -- **调优效果验证**：对模型调优前后分别执行评测，对比评分变化，量化调优带来的能力提升。 -- **能力量化评估**：生成包含综合得分、通过率和分数分布的评测报告，为团队协作提供客观数据支撑。 -- **持续质量监控**：建立定期评测机制，使用相同评测条件追踪模型表现趋势，及时发现能力下降。 - -## 自定义评测与基线评测 - -百炼平台提供两种评测方式，详见[模型评测](../../raw/model-user-guide/model-evaluation-introduction/model-evaluation-overview.md)。 +百炼提供两种评测方式，适用于不同场景。详细说明参见[模型评测](../../raw/model-user-guide/model-evaluation-introduction/model-evaluation-overview.md)。 ### 自定义评测 -使用开发者自有数据集和自定义维度进行评测，支持三种评分方式： +使用自有数据集和自定义维度进行评测，支持三种评分方式： -| 评分方式 | 说明 | 适用场景 | 裁判模型费用 | -|---------|------|---------|------------| -| 大模型评估（AI 自动评测） | 由裁判模型（推荐千问-Max）对回答进行评分。数值型输出整数分，分类型输出 Pass/Fail | 问答质量、内容安全等需语义理解的场景 | 有 | -| 规则评估（自动化指标） | 使用 ROUGE、BLEU、Cosine 等算法或字符串匹配直接计算 | 翻译、摘要、Function Calling 等有确定性标准的场景 | 无 | -| 人工评估（人工标注） | 人工逐条查看推理结果并标注 Pass/Fail | 创意性写作、专业领域判断等机器难以准确评价的场景 | 无 | +- **大模型评估（AI 自动评测）**：由裁判模型（推荐千问-Max）对被评测模型的回答打分。数值型维度输出评分区间内的整数分，分类型维度输出 Pass/Fail 标签。适用于问答质量、内容安全等需要语义理解的场景。 +- **规则评估（自动化指标）**：使用算法直接计算评分，无需裁判模型。支持字符串匹配（相等/不相等/包含）和文本相似度（ROUGE-1/2/L、BLEU、Cosine、Fuzzy Match、Accuracy）。适用于翻译、摘要、Function Calling 等有确定性标准的场景。 +- **人工评估（人工标注）**：由人工逐条查看模型推理结果并标注 Pass/Fail 标签。适用于创意性写作、专业领域判断等机器难以准确评价的场景。 ### 基线评测 -使用公开标准数据集（C-Eval、MMLU、ARC、GSM8K、BBH、HellaSwag）快速评测模型基础能力，无需自行准备数据集或配置维度。 - -> **注意**：基线评测仅北京地域可用。其他地域控制台不显示此选项，属正常行为。基线评测不支持结果下载，也不支持推理结果集数据来源。 +使用公开标准数据集（C-Eval、MMLU、ARC、GSM8K、BBH、HellaSwag）快速评测模型基础能力，无需自行准备数据集或配置评测维度。 -## 评测流程 - -端到端流程分为四个阶段： +> **注意**：基线评测仅北京地域可用，其他地域不显示此选项。基线评测不支持下载评测结果，也不可进入人工标注页面。 -1. **准备数据集**：在数据管理模块上传评测集（EvaluationSet）类型的数据，包含 Prompt（用户问题）和 Completion（参考答案）两列。 -2. **创建评测维度**：定义评分标准和方式，从 5 种维度类型中选择（大模型评估-数值型/分类型、规则评估-文本相似度/字符串匹配、人工评估-分类型）。维度类型创建后不可修改。 -3. **创建评测任务**：选择被评测模型、关联数据集和维度，可选参与排行榜。 -4. **查看结果**：在指标统计 Tab 查看综合得分和通过率，在数据明细 Tab 查看逐条评分。 +## 评测维度 -需注意区分两个核心概念：**评分器 Prompt** 配置于评测维度，指导裁判模型如何打分；**System Prompt** 配置于评测任务，为被评测模型设定角色定位，通常可留空。 +评测维度定义模型的评分标准，使用前须至少创建一个。维度类型创建后不可修改，选错需删除重建。百炼支持 5 种维度类型： -## 评测维度配置 +| 维度类型 | 评分方式 | 适用场景 | 裁判模型费用 | +|---------|---------|---------|------------| +| 大模型评估-数值型 | 裁判模型打分（整数，如 0-5） | 问答质量、内容生成 | 有 | +| 大模型评估-分类型 | 裁判模型标签（Pass/Fail） | 内容安全、正确性判断 | 有 | +| 规则评估-文本相似度 | ROUGE/BLEU/Cosine 等算法 | 翻译、摘要 | 无 | +| 规则评估-字符串匹配 | 相等/不相等/包含 | Function Calling、NL2SQL | 无 | +| 人工评估-分类型 | 人工标注 Pass/Fail | 创意性写作、专业判断 | 无 | -根据[模型评测](../../raw/model-user-guide/model-evaluation-introduction/model-evaluation-overview.md)文档，支持以下 5 种维度类型： +大模型评估维度的自定义评分器 Prompt 支持变量：`${prompt}`（用户问题）、`${output}`（模型回答）、`${completion}`（参考答案），须至少包含一个变量。 -| 维度类型 | 评分方式 | 适用场景 | -|---------|---------|---------| -| 大模型评估-数值型 | 裁判模型打分（整数，如 0-5） | 问答质量、内容生成 | -| 大模型评估-分类型 | 裁判模型标签（Pass/Fail） | 内容安全、正确性判断 | -| 规则评估-文本相似度 | ROUGE/BLEU/Cosine 等 7 种算法 | 翻译、摘要 | -| 规则评估-字符串匹配 | 相等/不相等/包含 | Function Calling、NL2SQL | -| 人工评估-分类型 | 人工标注 Pass/Fail | 创意性写作、专业判断 | - -### 大模型评估维度关键参数 - -- **裁判模型**：推荐千问-Max，推理能力强。 -- **评分器模板**：数值型可选综合评测、语义相似度、自定义评测；分类型可选标准匹配判断、情感分析、自定义评分器。 -- **评分范围**：仅数值型，默认 0-5 整数。 -- **通过阈值**：默认 3.0，步长 0.1，评分达到此值判定为 Pass。 -- **自定义 Prompt 变量**：`${prompt}`（用户问题）、`${output}`（模型回答）、`${completion}`（参考答案），须至少包含一个变量。 - -### 规则评估算法选择 +## 评测流程 -文本相似度支持 7 种算法：ROUGE-1、ROUGE-2、ROUGE-L（文本摘要）、BLEU（翻译）、Cosine（语义理解和开放问答）、Fuzzy Match（OCR 和语音识别）、Accuracy（精确匹配）。字符串匹配支持相等、不相等、包含三种方式。 +完整的评测流程分为四个阶段，具体操作步骤参见[模型评测](../../raw/model-user-guide/model-evaluation-introduction/model-evaluation-overview.md)中的快速入门部分： -## 数据来源配置 +1. **准备数据集**：在数据管理模块上传评测集（EvaluationSet）类型的数据，包含 Prompt（用户问题）和 Completion（参考答案）两列。 +2. **创建评测维度**：定义评分标准和方式，选择维度类型、裁判模型、评分范围和通过阈值。 +3. **创建评测任务**：选择被评测模型，配置数据来源（评测数据集或推理结果集），关联评测维度。 +4. **查看评测结果**：分析综合得分、通过率和分数分布，可选加入排行榜对比。 -创建评测任务时可选择两种数据来源： +### 数据来源配置 | 对比项 | 评测数据集 | 推理结果集 | |-------|-----------|-----------| @@ -77,56 +54,46 @@ 数据量建议：小规模验证 50-100 条，正式评测 200-500 条，全面评估 500 条以上。 -## 排行榜 +### 关键参数说明 -排行榜用于在相同评测维度下横向对比多个模型。创建时须选择评测维度（创建后不可修改），得分范围为 0-100（基于关联维度综合评分计算，与维度本身评分范围不同）。为确保公平性，建议所有任务使用相同数据集。 +- **评分范围**：定义裁判模型的打分区间（整数，如 0-5），决定评分粒度。 +- **通过阈值**：判定 Pass/Fail 的分界线（支持小数，步长 0.1，如 3.0），用于统计通过率。 +- **System Prompt**：配置于评测任务，为被评测模型设定角色定位，大多数场景可留空。 +- **评分器 Prompt**：配置于评测维度，指导裁判模型如何打分，两者作用对象和费用归属不同。 ## 评测结果分析 -据[模型评测](../../raw/model-user-guide/model-evaluation-introduction/model-evaluation-overview.md)文档的建议： +评测任务完成后，结果包含两部分： -- 关注**分数分布**而非仅看综合得分。综合得分是各维度平均分，可能掩盖维度间差异。 -- **1-3% 的分数差异**通常为评测噪声，不建议仅凭微小分差做决策。 -- 使用人工评估维度的任务须全部数据标注完成后才变为评测完成状态。 -- 评测结果支持下载（待执行状态和基线评测任务除外）。 +- **指标统计**：综合得分（各维度平均分）、通过率（达到通过阈值的样本占比）、分数分布图。 +- **数据明细**：逐样本展示 Prompt、模型 Output、参考 Completion 及各维度评分。 -## 计费说明 +> **注意**：综合得分可能掩盖维度间的显著差异，建议逐维度分析。1-3% 的分数差异通常为评测噪声，不建议仅凭微小分差做决策。 + +## 排行榜 -评测费用由两部分构成： +排行榜用于在相同评测维度下横向对比多个模型的表现。排行榜得分范围为 0-100，基于关联评测维度的综合评分计算。创建时须绑定评测维度（创建后不可修改），可关联使用相同维度的已完成任务。为确保公平性，建议排行榜内所有评测任务使用相同的评测数据集。 -| 维度类型 | 被评测模型推理费 | 裁判模型评分费 | -|---------|----------------|--------------| -| 大模型评估（数值型/分类型） | 按 Token 计费 | 按 Token 计费 | -| 规则评估（字符串匹配/文本相似度） | 按 Token 计费 | 无 | -| 人工评估（分类型） | 按 Token 计费 | 无 | -| 使用推理结果集时 | 无 | 按维度类型决定 | +## 计费说明 -推理费用计算公式：输入 Token 数 / 1M x 输入单价 + 输出 Token 数 / 1M x 输出单价。已部署的调优模型评测不额外计费（推理费用已含在部署算力费用中）。 +模型评测费用由被评测模型推理费用和裁判模型评分费用两部分构成，按 [Token](../concepts/token.md) 消耗计费。计算公式：输入 [Token](../concepts/token.md) 数 / 1M × 输入单价 + 输出 [Token](../concepts/token.md) 数 / 1M × 输出单价。详细定价参见[模型评测](../../raw/model-user-guide/model-evaluation-introduction/model-evaluation-overview.md)中的计费说明。 -### 成本优化策略 +成本优化策略： -1. **先小规模验证**：使用 50-100 条数据验证配置正确性，确认无误后再扩大规模。 -2. **保存推理结果集复用**：首次评测后下载含模型 Output 的结果，后续评测使用推理结果集方式避免重复推理。 -3. **优先选规则评估**：无裁判模型费用，适用于翻译、摘要、Function Calling 等有确定性标准的场景。 +- 先用 50-100 条数据小规模验证配置正确性，再扩大规模。 +- 首次评测后保存推理结果集复用，避免重复推理费用。 +- 翻译、摘要等有确定性标准的场景优先选用规则评估（无裁判模型费用）。 +- 已部署的调优模型评测不额外计费，推理费用包含在部署算力费用中。 ## 限制与注意事项 - 当前仅支持文本生成类模型评测。 -- 维度类型创建后不可修改，选错需删除重建。 -- 评测任务提交后不可更换目标模型，选错需删除重建（已消耗 Token 费用不可追回）。 - 基线评测仅北京地域可用。 -- 模型评测当前仅支持控制台操作，不提供公开 API/SDK。如需编程化评测，可参考 PAI Judge Model API 作为替代方案。 -- 排行榜绑定的评测维度删除后，会阻止在该排行榜下创建新任务。 +- 维度类型创建后不可修改，选错需删除重建。 +- 评测任务提交后不可更换被评测模型，需删除重建（已消耗 Token 费用不可追回）。 +- 模型评测当前仅支持控制台操作，不提供公开 API/SDK。如需编程化评测能力，可参考 PAI Judge Model API 作为替代方案。 - LLM 评分器存在位置偏差和自我偏好偏差，建议定期人工抽查校准。 -## 常见问题 - -**评测任务提交后状态失败**：检查数据集是否为评测集（EvaluationSet）类型并已发布版本，模型是否可选（灰色表示暂不支持），数据格式是否包含 Prompt 和 Completion 列。 - -**评分结果区分度低**：检查评分器 Prompt 是否有明确评分标准和正确变量引用，为每个分数档提供清晰判定条件，并确认裁判模型推理能力足够（推荐千问-Max）。 - -**评分范围与通过阈值混淆**：评分范围定义打分区间（整数，如 0-5），通过阈值是判定 Pass/Fail 的分界线（支持小数，如 3.0）。前者决定"能得几分"，后者决定"几分算及格"。 - ## 来源文档 - [模型评测](../../raw/model-user-guide/model-evaluation-introduction/model-evaluation-overview.md) diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/model-experience.md b/skills/bailian-docs-llm-wiki/wiki/guides/model-experience.md index cc7f030..3dbdb4b 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/model-experience.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/model-experience.md @@ -37,7 +37,7 @@ ### 关键参数 -- **图像分辨率**：大多数模型支持每张图片最高 1600 万像素，Token 计算公式为 `h x w / (32 x 32) + 2`。 +- **图像分辨率**：大多数模型支持每张图片最高 1600 万像素，[Token](../concepts/token.md) 计算公式为 `h x w / (32 x 32) + 2`。 - **视频支持**：`qwen3.7-plus`、`qwen3.6-flash` 等支持最长 2 小时 / 2GB 视频输入。 - **OCR**：`qwen3.5-ocr` 专为文档、表格、手写内容优化。 @@ -92,7 +92,7 @@ | `Tripo/Tripo-H3.1` | 200 万面 | 较慢 | 影视级渲染、高精度数字资产 | | `Tripo/Tripo-P1.0` | 2 万面 | 更快 | 快速预览、游戏/AR、实时应用 | -> **注意**：Tripo 3D 模型生成仅适用于华北2（北京）地域，必须使用该地域的 API Key。 +> **注意**：Tripo 3D 模型生成仅适用于华北2（北京）地域，必须使用该地域的 [API Key](../concepts/api-key.md)。 ### 使用方式 @@ -178,7 +178,7 @@ Fun-Music 模型支持通过提示词或自定义歌词生成完整歌曲或纯 ### 推荐模型 -| 模型 | 类型 | 维度 | 最大 Token | 场景 | +| 模型 | 类型 | 维度 | 最大 [Token](../concepts/token.md) | 场景 | |------|------|------|-----------|------| | `text-embedding-v4` | 文本 Embedding | 64~2048 | 8,192 | 文本搜索、RAG、聚类 | | `qwen3-vl-embedding` | [多模态](../concepts/multimodal.md) Embedding | 256~2560 | 32,000 | 图文混合检索 | @@ -233,3 +233,4 @@ Fun-Music 模型支持通过提示词或自定义歌词生成完整歌曲或纯 - [全模态](../../raw/model-user-guide/model-experience/omni.md) + diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/model-high-speed-inference.md b/skills/bailian-docs-llm-wiki/wiki/guides/model-high-speed-inference.md index 9f9946a..819599a 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/model-high-speed-inference.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/model-high-speed-inference.md @@ -1,6 +1,6 @@ # model high speed inference -百炼平台提供 TPM（Tokens Per Minute）预留功能，允许开发者为指定模型锁定专属推理吞吐量，确保业务高峰期不受公共资源限流影响。预留容量内的调用不额外收费，超出部分自动降级为按量计费，服务不中断。 +百炼平台提供 TPM（[Token](../concepts/token.md)s Per Minute）预留功能，允许开发者为指定模型锁定专属推理吞吐量，确保业务高峰期不受公共资源限流影响。预留容量内的调用不额外收费，超出部分自动降级为按量计费，服务不中断。 ## 方案选型 @@ -107,3 +107,4 @@ response = dashscope.Generation.call( - [TPM 预留](../../raw/model-user-guide/model-high-speed-inference/tpm-reservation.md) + diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/model-monitoring.md b/skills/bailian-docs-llm-wiki/wiki/guides/model-monitoring.md index 12a6e35..6442dec 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/model-monitoring.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/model-monitoring.md @@ -22,9 +22,9 @@ | 视觉模型·视频生成 | 秒 | 按成功生成的视频秒数[计费](../concepts/billing.md) | | 语音模型（TTS/ASR/音视频翻译等） | 秒、字符或 [Token](../concepts/token.md) | 视模型而定，可能按时长、字符数或 [Token](../concepts/token.md) 数 | | 全模态模型 | [Token](../concepts/token.md) | 文本与其他模态均按 [Token](../concepts/token.md) 数[计费](../concepts/billing.md) | -| 向量模型 | [Token](../concepts/token.md) | 按输入文本的 Token 数[计费](../concepts/billing.md) | +| 向量模型 | [Token](../concepts/token.md) | 按输入文本的 [Token](../concepts/token.md) 数[计费](../concepts/billing.md) | -> **注意**：用量数据按**[业务空间](../concepts/workspace.md)**维度统计，**不支持按阿里云账号维度统计**。如需账号级 Token 总量，需用主账号在费用与成本页面导出账单查看。 +> **注意**：用量数据按**[业务空间](../concepts/workspace.md)**维度统计，**不支持按阿里云账号维度统计**。如需账号级 [Token](../concepts/token.md) 总量，需用主账号在费用与成本页面导出账单查看。 ## 查看用量与费用概览 @@ -63,7 +63,7 @@ - **安全**：识别违规内容，如内容安全错误次数。 - **成本**：评估成本效益，如平均单次请求调用量。 -- **性能**：观察性能变化，如调用时长、首 Token 延时、RPM、TPM、非首 Token 延时。 +- **性能**：观察性能变化，如调用时长、首 [Token](../concepts/token.md) 延时、RPM、TPM、非首 Token 延时。 - **错误**：判断稳定性，如失败次数、失败率、限流错误次数（429）、内容安全错误次数。 调用统计页签支持按 API-KEY、推理类型、时间范围、时间精度（分钟/小时）筛选；失败次数图表可点击"失败详情"查看失败明细。 @@ -164,3 +164,4 @@ Authorization: Basic base64Encode(AccessKey:AccessKeySecret) + diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/plug-in.md b/skills/bailian-docs-llm-wiki/wiki/guides/plug-in.md index c4c5c8b..15df8d3 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/plug-in.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/plug-in.md @@ -147,3 +147,4 @@ Python 代码解释器可用依赖包括：matplotlib、pandas、scipy、seaborn + diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/prompt.md b/skills/bailian-docs-llm-wiki/wiki/guides/prompt.md index 0b3d954..af16ba1 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/prompt.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/prompt.md @@ -68,7 +68,7 @@ Prompt 样例库采用少样本学习（Few-shot learning）思路，从预定 ### 计费说明 -样例库功能本身不收费，但启用后会增加大模型调用的 Token 消耗。总输入 Token 约等于：用户查询 Token + 所有召回样例的总 Token + 系统指令 Token。 +样例库功能本身不收费，但启用后会增加大模型调用的 [Token](../concepts/token.md) 消耗。总输入 [Token](../concepts/token.md) 约等于：用户查询 [Token](../concepts/token.md) + 所有召回样例的总 Token + 系统指令 Token。 详见 [使用Prompt样例库优化模型输出](../../raw/application-user-guide/prompt/prompt-sample-optimization.md)。 @@ -101,3 +101,4 @@ Prompt 样例库采用少样本学习（Few-shot learning）思路，从预定 - [基于大模型输入输出样例的Prompt自动优化](../../raw/application-user-guide/prompt/prompt-feedback-optimization.md) + diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/release-notes.md b/skills/bailian-docs-llm-wiki/wiki/guides/release-notes.md index 5b90cc6..df5e493 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/release-notes.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/release-notes.md @@ -1,90 +1,108 @@ # release notes -百炼平台持续迭代模型能力与平台功能，本页汇总平台功能更新与模型上下架动态。功能更新涵盖模型调优、部署、评测、观测、API 扩展及 SDK 支持等模块；模型动态则记录各类模型（推理、视觉、视频生成、语音、3D 等）的上架时间与能力说明。完整时间线请参阅 [模型平台功能更新](../../raw/model-user-guide/release-notes/model-release-notes.md) 和 [模型上下架与更新](../../raw/model-user-guide/release-notes/newly-released-models.md)。 +百炼平台持续迭代模型能力与平台功能，发布节奏覆盖模型上新、功能模块升级、计费调整及模型下线等方面。开发者可通过 [模型平台功能更新](../../raw/model-user-guide/release-notes/model-release-notes.md) 跟踪平台级变更，通过 [模型上下架与更新](../../raw/model-user-guide/release-notes/newly-released-models.md) 查看具体模型的上架时间与规格信息。 -## 推理与文本生成模型 +## 平台公告与计费变更 -百炼持续引入和升级推理模型，覆盖自研千问系列与第三方直供模型： +百炼平台定期发布计费调整与政策公告，开发者在接入前应关注以下要点： -- **Qwen3.7 Max** — 2026 年 5 月上线，千问 Max 系列新一代旗舰，默认开启思考模式，支持显式缓存和 Function Calling，在编程、办公与长周期自主执行方面表现突出。6 月快照新增视觉模态理解能力。 -- **Qwen3.6 系列** — 包含 qwen3.6-max-preview、qwen3.6-plus、qwen3.6-flash 等，重点强化智能体编程（Agentic Coding）和数学推理能力，Flash 版本还增强了空间智能与物体定位。 -- **Qwen3.5 系列** — qwen3.5-plus 为原生视觉语言模型，qwen3.5-omni 系列支持全模态（音视频交互、113 种语言识别、36 种语言音频生成）。 -- **DeepSeek-V4** — 含 deepseek-v4-pro（旗舰）和 deepseek-v4-flash（轻量高速），另有快手万擎直供版本。 -- **第三方直供** — Kimi K2.6/K2.7（月之暗面）、GLM-5/5.1（智谱）、MiMo-V2.5-Pro（小米）、Step 3.7 Flash（阶跃星辰）等均已上架。 +- **模型降价**：千问系列、通义千问VL系列多次降价；qwen-max 输入价格降低 88%、输出降低 84%。 +- **上下文缓存降价**：部分模型上下文缓存 `cached_token` 单价已调整（如 deepseek-v4-pro 调至 1 元/百万 token）。 +- **资源包变更**：qwen-turbo 资源包已启动退市流程；团队版新增跨坐席共享 Credits 弹性用量包。 +- **免费额度**：新人免费额度有效期调整；支持"用完即停"功能，避免超额产生费用。 +- **模型下线机制**：老旧模型按既定规则下线，部分已延期，详见模型下线机制说明。 -详细模型列表及上架时间见 [模型上下架与更新](../../raw/model-user-guide/release-notes/newly-released-models.md)。 +## 模型上新动态 -## 视频与图像生成模型 +平台持续引入多类型模型，按模型类型分类如下： -多媒体生成是百炼近期重点扩展方向，主要模型家族包括： +### 推理与文生文模型 -- **万相 2.7** — 覆盖文生视频（wan2.7-t2v）、图生视频（wan2.7-i2v）、参考生视频（wan2.7-r2v）、视频编辑（wan2.7-videoedit）及图像生成与编辑（wan2.7-image-pro/image），支持 4K 输出与多图参考。 -- **HappyHorse 1.0/1.1** — 支持有声视频生成（3-15 秒，720P/1080P），涵盖文生视频、图生视频、参考生视频及视频编辑。 -- **爱诗 PixVerse** — C1 和 V6 两代产品线，支持文生视频、首帧/首尾帧生视频、参考生视频，C1 版本新增提示词智能分镜。 -- **Vidu** — 参考生视频与首帧生视频系列（Q3/Q2 Pro 等）。 -- **千问文生图** — qwen-image-2.0-pro 持续迭代，增强文字渲染、真实质感和语义遵循能力。 -- **Tripo 3D** — 支持文生 3D、单图/多图生 3D，H3.1 版本最高 200 万面。 +| 模型 | 上架时间 | 说明 | +|------|----------|------| +| qwen3.7-max | 2026-05 | Qwen Max 新一代旗舰，默认思考模式，擅长编程与办公 | +| qwen3.7-plus | 2026-06 | 视觉-语言全面升级，[多模态](../concepts/multimodal.md)交互混合智能体 | +| qwen3.6-flash | 2026-04 | 视觉语言 Flash 系列，智能体编程能力显著提升 | +| qwen3.6-plus | 2026-04 | 代码开发能力重点升级，[多模态](../concepts/multimodal.md)识别增强 | +| qwen3.5-plus | 2026-04 | Agentic coding 大幅提升，推理速度显著提升 | +| deepseek-v4-pro / flash | 2026-04 | DeepSeek-V4 系列，阿里直供 | +| kimi/kimi-k2.7-code | 2026-06 | 月之暗面直供，编码为中心的智能体模型 | +| glm-5.1 | 2026-04 | 智谱 200K 上下文，最大输出 128K [Token](../concepts/token.md) | +| xiaomi/mimo-v2.5-pro | 2026-05 | 小米直供，通用智能体与复杂工程增强 | -## 语音、OCR 与其他模态 +### 视觉与[多模态](../concepts/multimodal.md)模型 -- **全模态 Qwen-Omni** — qwen3.5-omni-plus/flash 支持长视频分析、会议纪要、字幕输出，实时版本支持语音打断与联网搜索。 -- **实时语音翻译** — qwen3.5-livetranslate-flash-realtime 可识别 60 种语言并实时翻译为 29 种语言音频。 -- **Fun-ASR** — 实时语音识别，覆盖汉语七大方言及 30 个语种，增强古诗词和标点预测。 -- **文字提取** — qwen3.5-ocr 基于 Qwen3.5 架构，128K 上下文，覆盖多种国内外卡证信息抽取。 -- **CosyVoice 声音复刻** — 支持音色复刻任务创建与查询。 -- **Fun 音乐大模型** — fun-music-v1 支持中英文歌曲生成。 +| 模型 | 上架时间 | 说明 | +|------|----------|------| +| qwen3.5-omni-plus/flash | 2026-03 | 全模态，支持长视频分析、113 语种识别 | +| qwen3.5-omni-*-realtime | 2026-03 | 实时多模态，原生联网搜索与语音打断 | +| qwen3.5-ocr | 2026-06 | 128K 上下文，多轮对话，多卡证信息抽取 | +| qwen-image-2.0-pro | 多快照 | 图片生成与编辑融合，支持多语言图内文字 | -## 平台功能更新 +### 视频生成模型 -### 模型调优与部署 +| 模型系列 | 上架时间 | 能力 | +|----------|----------|------| +| 万相 2.7 (wan2.7-*) | 2026-04 起 | 文生视频、图生视频、参考生视频、视频编辑 | +| HappyHorse 1.0/1.1 | 2026-04/06 | 有声视频生成，3-15 秒，720P/1080P | +| 爱诗 PixVerse v6/C1 | 2026-03/04 | 文/图/首尾帧/参考生视频，支持智能分镜 | +| Vidu Q3 系列 | 2026-03/04 | 文/图/参考生视频 | + +### 其他模型 + +- **3D 生成**：Tripo H3.1（最高 200 万面）、Tripo P1.0（2 万面，快速生成） +- **音乐生成**：fun-music-v1，支持输入创作要求或歌词生成演唱歌曲 +- **音视频翻译**：qwen3.5-livetranslate-flash-realtime，60 语种识别、29 语种实时翻译 +- **语音识别**：fun-asr，覆盖汉语七大方言与 30 个语种 +- **图像生成与编辑**：wan2.7-image-pro/image，支持 4K 输出、文生图/组图/交互式编辑 -- **调优能力扩展** — 先后新增视觉理解（VL）、视频生成、图像生成模型类型支持，并增加 DPO 偏好训练和强化学习训练（邀约制）。0 代码安全合规强化功能可直接提升模型安全能力。 -- **模型部署** — 支持按模型单元（MU）时长计费和按调用量计费两种模式，可部署预置模型（qwen-flash/qwen-plus 等）及调优后模型。 -- **模型导入** — 支持从 OSS 导入 LoRA 微调模型，已在国际站上线，并开放完整 API。 -- **模型压缩** — 使用量化算法将全精度模型转为低精度版本，降低部署成本。 +详细模型规格与服务部署范围参见 [模型上下架与更新](../../raw/model-user-guide/release-notes/newly-released-models.md)。 -### 模型观测与评测 +## 平台功能更新 + +### 模型调优与部署 -- **模型观测** — 支持推理日志查看、分钟级高级监控模式、告警与通知、用量统计看板。 -- **模型评测** — 新增排行榜（Leaderboard）和综合评测功能，覆盖 BLEU、ROUGE 等多种评估器。 +- **模型调优**：已支持文本生成、视觉理解 (VL)、视频生成、图像生成模型的 SFT 微调；新增 DPO 偏好训练和强化学习训练（邀约制）；新增 0 代码安全合规强化流程。 +- **模型部署**：新增按模型单元 (MU) 时长计费的 PTU 部署方式，支持灵活调整性能与固定成本；预置吞吐部署新增长输入与前缀缓存能力。 +- **模型压缩**：使用量化算法将全精度微调模型转为低精度版本以降低部署成本。 +- **模型导入**：支持从 OSS 导入 LoRA 微调模型，并提供完整的 API 接口。 -### API 与开发工具 +### 知识库与 RAG -- **Responses API** — 新增[异步调用](../concepts/async-invocation.md)模式（background=true 提交长耗时任务并轮询）。 -- **异步任务回调** — 支持 EventBridge HTTP 回调与 RocketMQ，无需轮询。 -- **Context Cache** — 减少重复运算、提升响应速度、降低使用成本。 -- **临时 API Key** — 在不可信环境下避免永久 API Key 泄露。 -- **Batch API** — 支持任务通知功能。 -- **兼容接口** — 文本生成 API 入口聚合 OpenAI Responses 与 Anthropic Messages 分类。 -- **MCP 服务** — 上线官方 MCP 服务，支持平台内集成与第三方接入。 -- **Spring AI Alibaba** — 支持调用百炼智能体与工作流应用。 -- **Kilo CLI** — 支持 Token Plan/Coding Plan/按量计费三种方式接入。 +- **知识检索服务**：支持多知识库联合检索与混合排序。 +- **知识问答服务**：基于大模型结合检索生成回答。 +- **检索增强**：Retrieve 接口新增排序模型选项与指令干预模式。 +- **日志与监控**：知识库检索调用全量投递至 SLS 日志服务，支持审计与告警。 -### 应用与组件 +### 智能体与应用 -- **记忆库 Memory 2.0** — 自动从对话提取记忆片段与用户画像，支持多应用共享。 -- **知识库 RAG** — 检索调用支持 SLS 日志审计，Retrieve 接口新增排序模型与指令干预模式。 -- **Prompt 工程** — 应用组件新增 Prompt 模板管理 API。 -- **UI 设计器** — 集成魔笔低代码能力，可视化拖放构建应用 UI。 -- **[多模态](../concepts/multimodal.md)交互 SDK** — 覆盖 Web（JS SDK）、Android、iOS、Linux C++、RTOS C 等平台。 -- **通义听悟 Agent** — 新增特惠 ASR 资源包与工业生产指令转写 WebSocket 协议。 +- **智能体托管运行时**：平台托管会话与工具执行，通过 API 管理。 +- **Skill 能力包**：智能体可添加官方或自定义技能。 +- **MCP 服务**：上线官方 MCP 服务，支持平台内集成与第三方接入。 +- **记忆库 Memory 2.0**：自动从对话提取记忆片段与用户画像，支持多应用共享。 +- **UI 设计器**：集成魔笔低代码能力，可视化拖放构建网页 UI 应用。 -## 计费变动要点 +### API 与接入工具 -百炼持续推进模型降价，主要变动包括： +- **Responses API**：新增[异步调用](../concepts/async-invocation.md)模式（`background=true`）。 +- **Anthropic Messages 接口**：文本生成 API 入口新增 OpenAI Responses 与 Anthropic Messages 分类。 +- **异步任务回调**：支持通过 EventBridge 推送完成事件，无需轮询。 +- **临时 [API Key](../concepts/api-key.md)**：在不可信环境下避免永久 [API Key](../concepts/api-key.md) 泄露。 +- **接入工具**：新增 Codex 终端编程助手接入、Kilo CLI、Spring AI Alibaba 框架等。 -- qwen-max 输入降价 88%、输出降价 84%（2025 年 2 月） -- 千问 VL 系列降幅最高 85%（2024 年 12 月） -- qwen2.5-14b/7b-instruct 降价 50%（2025 年 1 月） -- 部分模型（qwen2.5-3b-instruct、DeepSeek 系列等）由免费体验转为计费 -- deepseek-v4-pro cached_token 单价调整为 1 元/百万 token -- 新增推理资源包优惠活动与上下文缓存降价 +### 其他功能 -> **注意**：模型价格随时间调整，上述价格仅反映公告时点。最新计费以百炼控制台模型广场页面为准。 +- **Coding Plan**：Pro 套餐首月特惠 ¥39.90；联网搜索 MCP 升级 Streamable HTTP 协议。 +- **数据连接**：支持 MySQL / 语雀 / OSS 等数据源接入。 +- **模型评测**：新增排行榜、综合评测与多种评估器（BLEU、ROUGE 等）。 +- **模型观测**：支持推理日志查看、告警通知、高级监控模式（分钟级刷新）。 +- **地域扩展**：新增美国、德国、日本地域与服务部署范围。 -## 模型下线机制 +## 注意事项 -模型下线遵循统一的退市流程，详见 [模型平台功能更新](../../raw/model-user-guide/release-notes/model-release-notes.md) 中引用的模型下线机制说明。下线前会提前公告通知，建议开发者关注公告并及时迁移到推荐替代模型。 +- 模型版本快照（如 `qwen3.7-max-2026-05-20`）与别名（如 `qwen3.7-max`）的能力一致，但别名会自动指向最新快照。 +- 部分模型存在阿里直供与第三方直供（月之暗面、快手万擎、智谱、小米等）两种接入方式，计费与 SLA 可能不同。 +- 功能更新的完整时间线与详细说明请参考 [模型平台功能更新](../../raw/model-user-guide/release-notes/model-release-notes.md)。 ## 来源文档 diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/security-and-compliance.md b/skills/bailian-docs-llm-wiki/wiki/guides/security-and-compliance.md index 1ae3135..22e46d7 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/security-and-compliance.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/security-and-compliance.md @@ -38,7 +38,7 @@ RAM 用户默认无权调用百炼应用的数据、[知识库](../concepts/know ### 生产环境实践 - **空间规划**：推荐按环境（dev/test/prod）划分[业务空间](../concepts/workspace.md)实现隔离，或按业务线划分便于权限与成本管理。 -- **限流策略**：将主账号总配额按比例分配给各业务空间并预留缓冲。例如总配额 1000 QPM，可分配 prod 600 / test 200 / dev 100，预留 100。 +- **限流策略**：将主账号总配额按比例分配给各[业务空间](../concepts/workspace.md)并预留缓冲。例如总配额 1000 QPM，可分配 prod 600 / test 200 / dev 100，预留 100。 ## 内容安全：AI 安全护栏 @@ -145,9 +145,9 @@ SDK 自动完成加解密，响应为明文，无需手动处理。 - **同境内或同境外跨地域**（如华东1杭州 VPC → 华北2北京百炼）：推荐启用跨地域端点。 - **跨境跨地域**（中国内地与境外之间，如华北2北京 VPC → 新加坡百炼）：通过 CEN 跨地域 VPC 互通。 -## 安全存储业务空间 +## 安全存储[业务空间](../concepts/workspace.md) -安全存储业务空间通过反向终端节点与 VPC 私网连接，让部署其中的应用访问同 VPC 下的 ElasticSearch、AnalyticDB（ADB）、OSS 等云组件，避免公网访问风险。该能力需联系商务人员申请开通。 +安全存储[业务空间](../concepts/workspace.md)通过反向终端节点与 VPC 私网连接，让部署其中的应用访问同 VPC 下的 ElasticSearch、AnalyticDB（ADB）、OSS 等云组件，避免公网访问风险。该能力需联系商务人员申请开通。 ### 配置流程总览 @@ -171,7 +171,7 @@ SDK 自动完成加解密，响应为明文，无需手动处理。 ## 限制与注意事项汇总 - 默认业务空间无法设置模型调用/训练/部署限制，所有模型均可调用、调优、部署，且无法限流。 -- API Key 不可跨地域、跨业务空间、跨用户转移；账号移出空间会使其 API Key 失效（重新加入恢复），删除账号/角色则永久失效。 +- [API Key](../concepts/api-key.md) 不可跨地域、跨业务空间、跨用户转移；账号移出空间会使其 [API Key](../concepts/api-key.md) 失效（重新加入恢复），删除账号/角色则永久失效。 - AI 安全护栏目前仅支持文本和图片类型模型。 - [DashScope SDK](../concepts/dashscope-sdk.md) 自动加密仅支持 Java/Python 且不支持自定义密钥；HTTP 手动加密仅适用于 DashScope Endpoint，OpenAI 兼容 Endpoint 不支持。 - PrivateLink 私网访问美国（弗吉尼亚）地域暂不支持；跨地域访问需区分同境内/同境外与跨境两种方式。 @@ -204,3 +204,4 @@ SDK 自动完成加解密，响应为明文，无需手动处理。 + diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/skill.md b/skills/bailian-docs-llm-wiki/wiki/guides/skill.md index 5a56e8f..fd43917 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/skill.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/skill.md @@ -124,3 +124,4 @@ description: "Use this skill any time a spreadsheet file is the primary input or + diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/start-using.md b/skills/bailian-docs-llm-wiki/wiki/guides/start-using.md index 0b096c6..4e30987 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/start-using.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/start-using.md @@ -70,3 +70,4 @@ + diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/support.md b/skills/bailian-docs-llm-wiki/wiki/guides/support.md index 942fe54..78d0c60 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/support.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/support.md @@ -95,3 +95,4 @@ + diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/test-1.md b/skills/bailian-docs-llm-wiki/wiki/guides/test-1.md index 565e4c4..11ce09b 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/test-1.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/test-1.md @@ -1,122 +1,131 @@ # test 1 -阿里云百炼平台的计费体系涵盖模型推理调用、模型训练、模型部署三大场景，同时提供免费额度、节省计划、资源包等多种成本优化手段。本文从计费规则、费用查询、成本优化三个维度，帮助开发者快速理解百炼平台的费用结构并做出合理选择。 +阿里云百炼平台的计费体系涵盖模型推理（按量付费）、模型训练、模型部署三大场景，同时提供免费额度、节省计划、资源包等多种成本优化手段。本文汇总百炼平台的计费规则、账单管理方式和省钱策略，帮助开发者快速理解费用构成并做出合理的成本决策。 ## 计费模式概览 -百炼平台的计费按使用场景分为三类： +百炼平台的费用主要由以下部分构成： -- **模型推理（调用）**：默认按量付费，按输入/输出 Token 数计费。部分模型支持阶梯计费，单价取决于单次请求的输入 Token 总量。详见[模型调用价格](../../raw/model-user-guide/test-1/model-pricing.md)。 -- **模型训练**：按训练 Token 计费，费用 = 训练数据 Token 总数 x 循环次数 x 训练单价。支持文本生成（千问）、图像生成（万相）、视频生成（万相）等模型的微调训练。 -- **模型部署**：支持按使用时长计费（预置吞吐）和按模型单元计费两种方式，可选后付费或预付费（按天/包月）。 +- **模型推理（按量付费）**：按输入/输出 [Token](../concepts/token.md) 数量计费，部分模型支持阶梯计费（单价取决于单次请求的输入 [Token](../concepts/token.md) 总量）。详见[模型调用价格](../../raw/model-user-guide/test-1/model-pricing.md)。 +- **模型训练**：按训练 [Token](../concepts/token.md) 计费，费用 = Token 总量 x 循环次数 x 训练单价。支持千问文本、万相图像、万相视频三类模型的微调训练。 +- **模型部署**：支持按使用时长计费（预置吞吐）和按模型单元计费两种方式，可选后付费（按小时）或预付费（按天/月）。 -> **注意**：免费额度仅抵扣模型实时推理费用，不支持抵扣 Batch 调用、模型调优、模型部署及自定义模型的费用。 +费用抵扣优先级为：**免费额度 > 资源包 > 其他模型节省计划 > AI 通用型节省计划 > 按量付费**。 -## 免费额度 +## 新人免费额度 -首次开通百炼时，平台自动发放新人免费额度，有效期 30~90 天（2025年9月8日后开通的用户为 90 天）。免费额度仅适用于华北2（北京）地域且服务部署范围为中国内地的模型。主账号与 RAM 子账号共享额度。 +首次开通百炼时，平台自动发放各模型的免费推理额度（通常每个模型 100 万 Token），有效期 90 天。关键规则如下： -关键操作： +- 仅限华北2（北京）地域且服务部署范围为中国内地的模型 +- 仅抵扣实时推理费用，不支持 Batch 调用、模型调优、模型部署 +- 主账号与 RAM 子账号共享额度，不同模型的额度相互独立 +- 带日期后缀的快照版本（如 `qwen-max-2026-05-17`）与最新版本（如 `qwen-max`）视为独立模型，各有独立额度 -- **查看余量**：在控制台[免费额度](https://bailian.console.aliyun.com/?tab=costing-balance#/costing-balance/free-quota)页面查看，或在模型广场详情页的"免费额度"区域查看（分钟级更新，需手动刷新）。 -- **用完即停**：已认证用户免费额度耗尽后会自动扣费。可开启"免费额度用完即停"功能，额度耗尽时返回 `AllocationQuota.FreeTierOnly` 错误码，避免意外扣费。全新未认证用户则默认额度耗尽后停止服务。 +已认证用户免费额度耗尽后会直接按量扣费。可开启**免费额度用完即停**功能防止意外费用。详见[新人免费额度](../../raw/model-user-guide/test-1/new-free-quota.md)。 -详细规则参见[新人免费额度](../../raw/model-user-guide/test-1/new-free-quota.md)。 +> **注意**：Token Plan / Coding Plan 专属 [API Key](../concepts/api-key.md) 不消耗免费额度，使用专属 [API Key](../concepts/api-key.md) 调用模型将直接按量付费。如需使用免费额度，请改用通用 [API Key](../concepts/api-key.md)。 -## 模型调用价格 +## 模型调用价格要点 -模型推理按量计费，不同模型系列和地域的单价不同。以千问 Max 系列为例（华北2-北京，中国内地部署）： +### 阶梯计费 -| 模型 | 输入单价（每百万Token） | 输出单价（每百万Token） | 免费额度 | -|------|----------------------|----------------------|---------| -| qwen3.7-max | 12元 | 36元 | 100万Token | -| qwen3-max（≤32K） | 2.5元 | 10元 | 100万Token | -| qwen3-max（32K~128K） | 4元 | 16元 | - | -| qwen3-max（128K~256K） | 7元 | 28元 | - | +部分模型实行阶梯计费，单价取决于**单次请求**的输入 Token 总量。例如千问 Max 系列： -千问 Plus 系列（华北2-北京）： +| 模型 | 输入 Token 范围 | 输入单价（每百万 Token） | 输出单价（每百万 Token） | +|------|----------------|----------------------|----------------------| +| qwen3.7-max | 0 < Token <= 1M | 12 元 | 36 元 | +| qwen3-max | 0 < Token <= 32K | 2.5 元 | 10 元 | +| qwen3-max | 32K < Token <= 128K | 4 元 | 16 元 | +| qwen3-max | 128K < Token <= 256K | 7 元 | 28 元 | -| 模型 | 输入单价（每百万Token） | 非思考输出 | 思考输出 | 免费额度 | -|------|----------------------|-----------|---------|---------| -| qwen3.7-plus（≤256K） | 2元 | 8元 | 8元 | 100万Token | -| qwen-plus（≤128K） | 0.8元 | 2元 | 8元 | 100万Token | +### 降低推理成本的方式 -部分模型支持 Batch 调用（输入输出均半价）和上下文缓存（输入 Token 享折扣），两者不能同时生效。海外地域（美国、新加坡、德国、日本）的单价通常高于北京地域。 +- **Batch 调用**：支持的模型输入/输出 Token 单价均按实时推理价格的 50% 计费 +- **上下文缓存**：支持的模型仅输入 Token 享有折扣 +- Batch 调用与上下文缓存不能同时生效 + +完整价格表请参考[模型调用价格](../../raw/model-user-guide/test-1/model-pricing.md)。 ## 模型训练与部署计费 ### 训练计费 -训练费用因模型类型而异，详见[模型训练与部署计费](../../raw/model-user-guide/test-1/model-training-and-deployment-billing.md)： +训练按 Token 计费，不同模型类型的计算公式不同： -- **文本模型（千问）**：费用 = (训练数据 Token + 混合训练数据 Token) x 循环次数 x 单价。例如 qwen3-32b 训练单价为 0.04元/千Token。 -- **图像模型（万相）**：费用 = 训练 Token 总量 x 单价。Token 总量 = max_steps x Lstep，Lstep 由 max_token_length 和 generation_type 决定。wan2.7-image-pro 训练单价 0.08元/千Token。 -- **视频模型（万相）**：Token 总量与视频时长、max_pixels、n_epochs 相关。wan2.2-i2v-flash 训练单价 0.06元/千Token。 +- **千问文本模型**：费用 = （训练数据 Token + 混合训练 Token）x 循环次数 x 训练单价 +- **万相图像模型**：费用 = 训练 Token 总量 x 训练单价，其中 Token 总量 = max_steps x L_max +- **万相视频模型**：费用 = 训练 Token 总量 x 训练单价，Token 总量与视频时长、max_pixels、n_epochs 相关 ### 部署计费 -部署支持两种计费模式： +部署分为两种计费模式： -1. **预置吞吐（按 TPM）**：费用 = 时长 x (输入 TPM 单价 x 输入 TPM + 输出 TPM 单价 x 输出 TPM)。超出购买的 TPM 量时自动切换为按量付费（返回 Header 包含 `x-dashscope-ptu-overflow:true`）。 -2. **模型单元**：费用 = 时长(小时) x 单元数量 x 单元单价。支持后付费（按小时）和预付费（包月）。部分模型支持 PD 分离模式以降低首 Token 延迟。 +1. **预置吞吐**：费用 = 使用时长 x（输入 TPM 单价 x 输入 TPM + 输出 TPM 单价 x 输出 TPM）。当模型输入超过最长输入 Token 或超出购买的 TPM 量时，自动切换为按量付费。 +2. **模型单元**：费用 = 使用时长 x 模型单元数量 x 模型单元单价。支持后付费（按小时）和预付费（包月）。 -## 成本优化方案 +详见[模型训练与部署计费](../../raw/model-user-guide/test-1/model-training-and-deployment-billing.md)。 -百炼提供三种成本优化方案，抵扣优先级为：**免费额度 > 资源包 > 其他模型节省计划 > AI 通用型节省计划 > 按量付费**。 +## 成本优化方案 ### AI 通用型节省计划（推荐） -通过承诺每月消费金额换取阶梯折扣，最高 5.3 折。覆盖阿里直供全部模型，灵活性最高。 +通过承诺每月消费金额换取阶梯式折扣，最高可享 **5.3 折**优惠。核心特点： -- **承诺周期**：3/6/12/24 个月，月承诺额度 1000 元起（10 元为单位递增） -- **付费方式**：全预付（最大折扣）或零预付（需商务开通） -- **抵扣范围**：模型调用（输入输出 Token）、工具调用（Function Call 等）、上下文缓存、批量推理。不支持抵扣训练和部署费用 -- **折扣示例**：12个月全预付、月承诺 10,000 元，A 类模型（千问文本）享 8 折 - -> **注意**：C 类模型（DeepSeek、Kimi、GLM、MiniMax 等第三方模型）当前不享受节省计划折扣。每月未用完的额度自动清零，不可累积。 +- 可抵扣阿里直供的全部模型（A/B/C 三类），一次购买跨模型使用 +- 承诺周期：3/6/12/24 个月，月承诺金额 1000 元起 +- 付费方式：全预付（折扣更大）或零预付（需商务经理申请） +- 每月额度独立，未使用部分自动清零，不可累积 +- 支持抵扣 Token 调用、工具调用、上下文缓存、批量推理等费用 +- 不支持抵扣模型调优和模型部署费用 ### 其他模型节省计划 -针对特定模型系列的一次性购买方案，适合用量集中于单一模型的场景： - -- **大语言模型推理**：20元~500,000元多档，无折扣，按原价扣费 -- **千问语音模型**：20元~5,000元五档，最高 8 折 -- **向量及排序模型**：100元~10,000元五档，最高 7 折 -- **万相模型**：20元~30,000元五档，最高 9 折 +面向特定模型系列（语音模型、向量及排序模型、万相模型等），折扣通常不如 AI 通用型节省计划。适合用量较小或需求集中于某一模型的场景。 ### 资源包 -预购具体 Token 数量，抵扣特定模型超出免费额度后的实时推理用量。购买后立即生效，到期未用完自动作废。详见[节省计划与资源包](../../raw/model-user-guide/test-1/savings-plan-and-resource-package.md)。 +预先购买具体 Token 数量，用于抵扣特定模型超出免费额度后的实时推理用量。购买后立即生效，无需手动激活。详见[节省计划与资源包](../../raw/model-user-guide/test-1/savings-plan-and-resource-package.md)。 -## 账单查询与费用管理 +## 账单查询与成本管理 ### 查询账单 -- **费用概览**：在控制台"用量 & 费用 > 费用概览"查看当月总消费（订阅购买 + 按量账单），支持按模型或 API Key 筛选 -- **账单详情**：在[账单详情](https://usercenter2.aliyun.com/finance/expense-report/expense-detail)页面，产品名称选"大模型服务平台百炼"。实例 ID 格式为 `ApiKeyID;业务空间ID;模型名称;输入输出类型;调用渠道;免费额度用完即停标识` -- **出账延迟**：推理账单通常 2~10 分钟出账，训练/批量推理/知识库按小时出账 +- **费用概览**：在百炼控制台的「用量 & 费用 > 费用概览」页面查看当月总消费及构成 +- **账单详情**：在阿里云费用中心的「账单详情」页面，按产品名称筛选「大模型服务平台百炼」 +- 账单的「实例 ID（出账粒度）」字段以分号分隔，格式为 `ApiKeyID;业务空间ID;模型名称;输入/输出类型;调用渠道;免费额度用完即停标识` + +### 出账时效 + +| 场景 | 出账时效 | +|------|---------| +| 大模型推理 | 分钟级（通常 2~10 分钟） | +| 批量推理、模型训练、知识库 | 小时级 | ### 分账管理 -给[业务空间](../concepts/workspace.md)绑定标签，可按部门或项目归集费用。在标签管理页面为"大模型服务平台百炼:[业务空间](../concepts/workspace.md)"资源绑定标签键值，启用后 T+1 天生效。 +通过给[业务空间](../concepts/workspace.md)绑定标签，可按部门或项目归集费用。在标签管理页面绑定标签后，分账账单 T+1 天生效。 + +### 欠费处理 + +账户可用额度 < 0 视为欠费。欠费时即使模型仍有免费额度也无法调用。已购 Coding Plan 或 Token Plan 的套餐额度独立于账户余额，欠费期间可继续使用。详见[账单查询与成本管理](../../raw/model-user-guide/test-1/bill-query-and-cost-management.md)。 -### 欠费与停止计费 +## 停止计费 -- **欠费判定**：账户可用额度 < 0 时欠费，即使有免费额度也可能无法调用（视具体商品而定） -- **停止计费**：停止 API 调用并删除 API-Key 即可停止推理费用；部署资源需手动下线；Token Plan/Coding Plan 需关闭自动续费或退订 +不再使用百炼时，按场景关停对应服务： -详细操作步骤参见[账单查询与成本管理](../../raw/model-user-guide/test-1/bill-query-and-cost-management.md)。 +- **模型推理**：停止 API 调用，删除已创建的 API Key +- **模型训练**：确保无进行中的训练任务 +- **模型部署**：下线已部署模型；包月预付费需额外在退订管理页面退订实例 +- **Coding Plan**：到期自动停止，中途不支持取消；如已开启自动续费，需手动关闭 +- **Token Plan**：在控制台按席位退订，未产生用量消耗的席位可退订 ## 常见问题 -**为什么产生了意外费用？** -常见原因包括：免费额度已耗尽但未开启用完即停、控制台额度显示未及时刷新（分钟级更新需手动刷新）、代码中开启了联网搜索（`enable_search`）等附加功能产生单独计费。 +**调用后查不到账单？** 模型推理账单通常 2~10 分钟出账，批量推理、训练等按小时出账。公测或邀测模型不产生账单记录。 -**按量付费是实时扣款吗？** -不是。阿里云采用"预占+月结"模式，先冻结部分额度，次月初生成最终账单并实际扣款。 +**没怎么用却产生了欠费？** 检查应用代码或配置中是否开启了 `enable_search` 参数，联网搜索等附加功能按调用次数单独计费。 -**如何选择节省计划？** -大多数场景优先选择 AI 通用型节省计划（覆盖面广、折扣力度大）。仅当用量高度集中于语音、向量排序或万相模型时，考虑对应的专项节省计划。资源包适合小额试用或精确预算控制的场景。 +**如何避免意外扣费？** 开启「免费额度用完即停」、设置高额消费预警、删除不再使用的 API Key。 ## 来源文档 diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/token-plan-guide.md b/skills/bailian-docs-llm-wiki/wiki/guides/token-plan-guide.md index 9988a6c..8965e94 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/token-plan-guide.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/token-plan-guide.md @@ -1,21 +1,21 @@ # token plan guide -阿里云百炼提供两类面向 AI 编程与智能体场景的订阅型套餐——**Token Plan 团队版**与 **Coding Plan**。两者均以专属 API Key + 专属 Base URL 的方式接入主流 AI 编程工具（Claude Code、Qwen Code、OpenClaw、OpenCode、Cursor、Codex、Cline、Kilo CLI 等），通过预付费订阅锁定预算、避免按量计费欠费风险。本主题汇总两款套餐的产品定位、订阅流程、接入方式、团队与用量管理、工具扩展（联网搜索 / [多模态](../concepts/multimodal.md)生成 / 视觉理解）以及高频报错排查。 +阿里云百炼提供两类面向 AI 编程与智能体场景的订阅型套餐——**[Token](../concepts/token.md) Plan 团队版**与 **Coding Plan**。两者均以专属 [API Key](../concepts/api-key.md) + 专属 Base URL 的方式接入主流 AI 编程工具（Claude Code、Qwen Code、OpenClaw、OpenCode、Cursor、Codex、Cline、Kilo CLI 等），通过预付费订阅锁定预算、避免按量计费欠费风险。本主题汇总两款套餐的产品定位、订阅流程、接入方式、团队与用量管理、工具扩展（联网搜索 / [多模态](../concepts/multimodal.md)生成 / 视觉理解）以及高频报错排查。 ## 套餐总览与对比 -| 对比项 | Token Plan 团队版 | Coding Plan | +| 对比项 | [Token](../concepts/token.md) Plan 团队版 | Coding Plan | | --- | --- | --- | | 适用场景 | 一人公司 / 团队 / 企业日常办公 | 个人开发场景 | | 支持模型 | 文本生成 + 图像生成模型 | 文本生成模型 | -| 计费方式 | 按 Token 消耗抵扣 Credits | 按模型调用次数 | +| 计费方式 | 按 [Token](../concepts/token.md) 消耗抵扣 Credits | 按模型调用次数 | | 使用频次限制 | 无每 5 小时 / 每周限额 | 每 5 小时 / 每周 / 每月限额 | | 高峰期性能 | 多租户隔离，不排队 | 高峰期间可能排队 | | 数据安全 | 承诺不使用对话数据训练模型 | 用户数据授权用于服务改进 | -| API Key 格式 | `sk-sp-xxx`（专属） | `sk-sp-xxx`（专属） | +| [API Key](../concepts/api-key.md) 格式 | `sk-sp-xxx`（专属） | `sk-sp-xxx`（专属） | | 服务地域 | 仅支持华北2（北京） | 不限制使用地域 | -> 三类 API Key 与 Base URL 互不相通：百炼按量计费（`sk-xxx` + `dashscope.aliyuncs.com`）、Token Plan 团队版（`sk-sp-xxx` + `token-plan.cn-beijing.maas.aliyuncs.com`）、Coding Plan（`sk-sp-xxx` + `coding.dashscope.aliyuncs.com`）。误用会导致按量计费扣费或 401/403 报错。 +> 三类 [API Key](../concepts/api-key.md) 与 Base URL 互不相通：百炼按量计费（`sk-xxx` + `dashscope.aliyuncs.com`）、Token Plan 团队版（`sk-sp-xxx` + `token-plan.cn-beijing.maas.aliyuncs.com`）、Coding Plan（`sk-sp-xxx` + `coding.dashscope.aliyuncs.com`）。误用会导致按量计费扣费或 401/403 报错。 ## Token Plan 团队版 @@ -282,3 +282,4 @@ Coding Plan 中 `qwen3.6-plus`、`qwen3.5-plus`、`kimi-k2.5` 原生支持视觉 + diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/use-cases.md b/skills/bailian-docs-llm-wiki/wiki/guides/use-cases.md index 79306bb..f6f254b 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/use-cases.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/use-cases.md @@ -1,126 +1,159 @@ # use cases -阿里云百炼平台提供了丰富的使用场景支持，涵盖 Prompt 工程、[多模态](../concepts/multimodal.md)内容生成、RAG 应用构建、自定义模型训练、第三方模型集成以及 API 调用优化等方面。本文汇总了平台的主要使用场景，帮助开发者快速找到适合自身业务需求的实践方案。 +阿里云百炼平台为开发者提供了丰富的模型使用场景，涵盖 Prompt 工程、[多模态](../concepts/multimodal.md)内容生成、RAG 应用构建、模型微调、第三方模型集成以及 API 调用优化等方面。本文汇总了百炼平台的主要使用场景与最佳实践，帮助开发者快速找到适合自身业务的方案。 ## Prompt 工程 -### 文生文 Prompt 优化 +### 文生文 Prompt 设计 -设计高质量 Prompt 是充分发挥大模型能力的关键。百炼推荐使用 Prompt 框架来系统化地组织输入，该框架包含背景、目的、风格、语气、受众和输出六个要素，能显著提升模型输出的相关性和有效性。此外，百炼控制台提供了 [Prompt 一键优化工具](https://bailian.console.aliyun.com/?tab=app#/component-manage/prompt)，可对输入的 Prompt 进行自动扩写和细节添加。详细的 Prompt 设计技巧、分隔符使用、Few-shot 示例编排等方法参见 [文生文Prompt指南](../../raw/model-user-guide/use-cases/prompt-engineering-guide.md)。 +设计高质量 Prompt 是充分发挥大模型能力的关键。百炼推荐使用 **Prompt 框架**来系统化组织提示词，框架包含背景、目的、风格、语气、受众、输出六个要素。此外，平台提供了 Prompt 一键优化工具，可对输入的提示词进行自动扩写和细节补充。 -### 文生图 Prompt 技巧 +常用技巧包括： -文生图模型通过 `prompt`（正向提示词）和 `negative_prompt`（反向提示词）两个参数控制图像生成。百炼提供两种提示词公式： +- **构建清晰明确的 Prompt**：任务描述越具体，模型输出越符合预期 +- **使用分隔符**：用特殊符号（如 `---`、`###`）分隔 Prompt 的不同部分 +- **Few-shot 示例**：提供输入输出示例引导模型行为 +- **链式思考（CoT）**：引导模型分步推理，提升复杂任务准确率 -- **基础公式**：`主体 + 场景 + 风格`，适合初次尝试的用户 -- **进阶公式**：`主体描述 + 场景描述 + 定义风格 + 镜头语言 + 氛围词 + 细节修饰`，适合有经验的用户 +详见 [文生文Prompt指南](../../raw/model-user-guide/use-cases/prompt-engineering-guide.md)。 -文生图 V2 还支持 `prompt_extend` 参数开启大模型智能改写，默认开启。提示词词典覆盖景别、视角、镜头拍摄类型、风格和光线五大维度，详见 [文生图Prompt指南](../../raw/model-user-guide/use-cases/text-to-image-prompt.md)。 +### 文生图 Prompt 设计 -### 视频生成 Prompt 技巧 +文生图模型支持 `prompt`（正向提示词）和 `negative_prompt`（反向提示词）两个参数。提示词公式分为两级： -万相系列模型支持文生视频和图生视频，提示词公式为 `主体 + 场景 + 运动`。进阶公式在此基础上增加美学控制和风格化描述。wan2.7/wan2.6 模型还支持多镜头连贯叙事、参考生视频、以及原生音频能力（人声/音效/背景音乐描述）。图生视频场景中，由于图像已确定主体和风格，提示词主要描述运动和运镜。 +- **基础公式**：主体 + 场景 + 风格 +- **进阶公式**：主体描述 + 场景描述 + 定义风格 + 镜头语言 + 氛围词 + 细节修饰 -此外，Vidu 视频生成模型提供了独立的提示词体系，支持通过特定关键词触发动态控制、运镜控制、视频风格和特效等能力，详见 [Vidu视频生成Prompt指南](../../raw/model-user-guide/use-cases/third-party-model-integration-tutorial/vidu-video-generation-prompt-guide.md)。 +文生图 V2 还支持 `prompt_extend` 参数开启大模型智能改写（默认开启），可自动丰富提示词细节。详见 [文生图Prompt指南](../../raw/model-user-guide/use-cases/text-to-image-prompt.md)。 -## 应用构建 +### 文生视频 / 图生视频 Prompt 设计 -### 基于 LlamaIndex 构建 RAG 应用 +视频生成的提示词公式与图片类似但增加了运动维度： -百炼提供了与 LlamaIndex 的集成方案，通过 `DashScopeCloudIndex` 和 `DashScopeCloudRetriever` 组件，开发者可以在 LlamaIndex 框架中直接使用百炼的知识库检索增强服务。完整流程包括： +- **基础公式**：主体 + 场景 + 运动 +- **进阶公式**：主体描述 + 场景描述 + 运动描述 + 美学控制 + 风格化 +- **图生视频**：运动 + 运镜（图像已确定主体和场景） +- **声音公式**（wan2.7/wan2.6/wan2.5）：增加人声/音效/背景音乐描述 +- **多镜头公式**（wan2.7/wan2.6）：总体描述 + 镜头序号 + 时间戳 + 分镜内容 -1. 使用 `DashScopeParse` 解析文档（支持 .doc/.docx/.pdf，单文件 100M、1000 页以内） -2. 通过 `DashScopeCloudIndex.from_documents()` 创建知识库 -3. 获取 retriever 或 query engine 进行检索和问答 +wan2.7 支持通过"图n"/"视频n"指代参考素材，实现参考生视频。详见 [文生视频/图生视频Prompt指南](../../raw/model-user-guide/use-cases/text-to-video-prompt.md)。 -前提条件为获取 API Key 并安装 `llama-index-indices-managed-dashscope` 等依赖包。详见 [基于LlamaIndex构建RAG应用](../../raw/model-user-guide/use-cases/build-rag-applications-based-on-llamaindex.md)。 +Vidu 视频生成模型也有专用的提示词体系，基本结构为"主体/场景 + 场景描述 + 环境描述 + 艺术风格/媒介"，支持通过特定关键词控制动态幅度、运镜、景别、视角和特效等。详见 [Vidu视频生成Prompt指南](../../raw/model-user-guide/use-cases/third-party-model-integration-tutorial/vidu-video-generation-prompt-guide.md)。 -### 借助大模型将文档转换为视频 +## RAG 应用构建 -百炼支持利用大语言模型和[多模态](../concepts/multimodal.md)技术将文档自动转换为包含图文、语音、字幕的视频。方案流程为：文档切片（LLM 总结标题和段落）、生成演示文稿（Marp）、生成讲解语音与字幕（[多模态](../concepts/multimodal.md)模型）、合成视频（FFmpeg）。该方案依赖 FFmpeg 和 Marp 工具，提供了完整的 Python 代码包。 +百炼支持通过 LlamaIndex 框架构建 RAG（[检索增强生成](../concepts/rag.md)）应用。核心流程： + +1. **文件解析**：使用 `DashScopeParse` 解析 `.doc`、`.docx`、`.pdf` 文件（单文件 100M 以内，1000 页以内） +2. **创建知识库**：通过 `DashScopeCloudIndex.from_documents()` 创建索引 +3. **获取 Retriever**：从 index 对象获取检索器 +4. **构建 Query Engine**：结合 `DashScope` LLM 和知识库创建问答引擎 + +```python +from llama_index.indices.managed.dashscope import DashScopeCloudIndex +index = DashScopeCloudIndex("my_first_index") +retriever = index.as_retriever() +query_engine = index.as_query_engine(llm=dashscope_llm) +``` + +Python 版本要求 >=3.8 且 <=3.12。详见 [基于LlamaIndex构建RAG应用](../../raw/model-user-guide/use-cases/build-rag-applications-based-on-llamaindex.md)。 ## 自定义模型调优 -百炼支持基于通用大语言模型创建自定义模型，流程包含三个主要步骤和三个辅助步骤： +百炼提供完整的模型定制化流程：**模型调优 -> 模型部署 -> 模型评测**。 -| 步骤 | 说明 | -|------|------| -| 训练数据准备 | 收集业务数据，编排为 Prompt-Completion 格式，建议至少 500 条 | -| 模型调优 | 配置超参数（学习率、迭代次数等），平台自动训练 | -| 模型部署 | 部署到独占实例，完成部署后方可调用和评测 | -| 模型评测 | 选择评测方式、数据和维度，平台自动完成评测 | +- **训练数据**：建议至少准备 500 条"Prompt-Completion"格式的数据，需做脱敏处理 +- **模型调优**：配置学习率、迭代次数等超参数，平台自动训练 +- **模型部署**：调优后的模型必须部署到独占实例才能调用和评测 +- **模型评测**：支持多种评测维度，结果不满意可调整策略重新训练 -如果评测结果不满意，可调整训练策略（更换基础模型、扩充数据、调整超参数）后重复流程。详见 [自定义模型调优、部署与评测](../../raw/model-user-guide/use-cases/model-training-best-practices.md)。 +详见 [自定义模型调优、部署与评测](../../raw/model-user-guide/use-cases/model-training-best-practices.md)。 + +## 文档转视频 + +借助大模型可将文档自动转换为包含图文、语音、字幕的视频。方案流程： + +1. 文档切片：大模型总结标题并划分段落 +2. 生成演示文稿：整合标题、正文和图片生成幻灯片 +3. 生成讲解语音与字幕：[多模态](../concepts/multimodal.md)模型将文字转换为音频 +4. 合成视频：将演示文稿、音频和字幕合并 + +依赖工具：FFmpeg（音视频处理）、Marp（演示文稿制作）、浏览器引擎。详见 [借助大模型将文档转换为视频](../../raw/model-user-guide/use-cases/use-llm-to-convert-document-to-video.md)。 ## 第三方模型集成 -百炼平台聚合了多家第三方模型供应商的推理服务，统一通过 [OpenAI 兼容接口](../concepts/openai-compatible-interface.md)或 [DashScope SDK](../concepts/dashscope-sdk.md) 调用，开发者只需使用百炼 API Key 即可访问。 +百炼平台统一接入了多家第三方模型供应商，均可通过 [OpenAI 兼容接口](../concepts/openai-compatible-interface.md)或 [DashScope SDK](../concepts/dashscope-sdk.md) 调用。 -### 可用模型 +### 支持的第三方模型 -| 模型系列 | 供应商 | 最新型号 | 可用地域 | -|---------|--------|---------|---------| -| DeepSeek | 阿里云百炼 | deepseek-v4-pro | 北京、弗吉尼亚、新加坡、法兰克福、东京 | -| DeepSeek | 硅基流动 | siliconflow/deepseek-v3.2 | 仅北京 | -| DeepSeek | 快手万擎 | vanchin/deepseek-v4-pro | 仅北京 | -| Kimi | 阿里云百炼 | kimi-k2-thinking | 北京、新加坡、东京、弗吉尼亚、法兰克福 | -| Kimi | 月之暗面 | kimi/kimi-k2.7-code | 仅北京 | -| GLM | 阿里云百炼 | glm-5.2 | 北京、弗吉尼亚、法兰克福、新加坡 | -| GLM | 智谱 | ZHIPU/GLM-5.2 | 仅北京 | -| MiniMax | 阿里云百炼 | MiniMax-M2.5 | 仅中国内地 | -| MiniMax | 稀宇科技 | MiniMax/MiniMax-M2.7 | 仅北京 | -| MiMo | 小米 | xiaomi/mimo-v2.5-pro | 仅北京 | -| Step | 阶跃星辰 | stepfun/step-3.7-flash | 仅北京 | +| 模型系列 | 供应商 | 代表模型 | 特点 | +|---------|--------|---------|------| +| DeepSeek | 阿里云百炼 / 硅基流动 / 快手万擎 | deepseek-v4-pro | 编程、数学、通用任务；支持思考模式 | +| Kimi | 阿里云百炼 / 月之暗面 | kimi-k2.7-code, kimi-k2.6 | [多模态](../concepts/multimodal.md)支持；kimi-k2.7-code 为仅思考模型 | +| GLM | 阿里云百炼 / 智谱 | glm-5.2 | 支持 1M 上下文 | +| MiniMax | 阿里云百炼 / 稀宇科技 | MiniMax-M2.7, MiniMax-M2.5 | 思考模式 | +| MiMo | 小米 | mimo-v2.5-pro | 混合推理模型，默认开启思考 | +| Step | 阶跃星辰 | step-3.7-flash | 多模态推理，默认关闭思考 | -> **注意**：部分模型即将下架。deepseek-v3 系列、glm-4.6/4.7、Moonshot-Kimi-K2-Instruct、kimi-k2-thinking、MiniMax-M2.1 将于 2026 年 7 月 9 日下架，推荐转用 qwen3.7-plus、qwen3.7-max 或 qwen3.6-flash。 +> **注意**：多个第三方模型（deepseek-v3/r1 系列、kimi-k2 系列部分模型、glm-4.6/4.7、MiniMax-M2.1）将于 **2026年7月9日** 下架，推荐迁移至 qwen3.7-plus、qwen3.7-max 或 qwen3.6-flash。 ### 调用方式 -所有第三方模型均支持 [OpenAI 兼容接口](../concepts/openai-compatible-interface.md)调用，大部分也支持 [DashScope SDK](../concepts/dashscope-sdk.md)。以 OpenAI Python SDK 为例： +所有第三方模型的调用模式统一，通过 [OpenAI 兼容接口](../concepts/openai-compatible-interface.md)： ```python from openai import OpenAI -import os - client = OpenAI( api_key=os.getenv("DASHSCOPE_API_KEY"), base_url="https://dashscope.aliyuncs.com/compatible-mode/v1", ) - completion = client.chat.completions.create( - model="deepseek-v4-pro", # 替换为目标模型名称 + model="<模型名>", # 如 "siliconflow/deepseek-v3.2" messages=[{"role": "user", "content": "你好"}], + extra_body={"enable_thinking": True}, # 开启思考模式 ) ``` -多数模型支持通过 `enable_thinking` 参数开启思考模式，开启后模型会输出 `reasoning_content` 字段展示推理过程。该参数为非标准参数，Python SDK 通过 `extra_body` 传入，Node.js SDK 作为顶层参数传入。 +`enable_thinking` 为非 OpenAI 标准参数，Python SDK 通过 `extra_body` 传入，Node.js SDK 作为顶层参数传入。部分模型还支持 `reasoning_effort` 参数控制思考深度（可选值：`low`、`medium`、`high`、`max`、`none`）。 + +> **注意**：不同供应商提供的同名模型在地域支持、限流条件和功能特性上存在差异。例如，硅基流动供应的 DeepSeek 支持更长上下文，而阿里云百炼供应的 DeepSeek 限流更宽松且支持联网搜索和上下文缓存。部分供应商仅限华北2（北京）地域使用。 + +### 多地域支持 -> **注意**：同一模型在不同供应商间存在差异。例如硅基流动供应商的 DeepSeek 支持更长上下文，而阿里云百炼供应商的限流条件更宽松且支持联网搜索和上下文缓存。部分直供模型（如月之暗面 Kimi、智谱 GLM、小米 MiMo 等）需先在百炼控制台搜索并开通服务后方可调用。 +百炼在多个地域提供服务，不同地域的 Base URL 不同： + +- **华北2（北京）**：`https://dashscope.aliyuncs.com/compatible-mode/v1`（推荐使用[业务空间](../concepts/workspace.md)专属域名 `https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1`） +- **美国（弗吉尼亚）**：`https://dashscope-us.aliyuncs.com/compatible-mode/v1` +- **新加坡 / 德国 / 日本**：`https://{WorkspaceId}..maas.aliyuncs.com/compatible-mode/v1` ## API 调用优化 ### 限流应对 -百炼 API 按主账号和模型维度独立限流，包括分钟级配额（RPM/TPM）、瞬时频率（RPS/TPS）和增速限制（Traffic Burst）三种规则。应对方案按改动成本从低到高分为三类： +百炼 API 按请求数（RPM/RPS）和 [Token](../concepts/token.md) 用量（TPM/TPS）限流，还有增速限制（Traffic Burst）。按改动成本从低到高的应对方案： -1. **平台配置方案**：服务端排队等待（推荐首选，仅需添加 `X-DashScope-Wait-Timeout` 请求头）、提升限流额度、PTU 预置吞吐单元、Batch API 异步批处理 -2. **客户端流控策略**：从基础重试到令牌桶、平滑限速器、自适应拥塞控制，按工程复杂度递进 -3. **架构兜底方案**：模型降级（Fallback）、基于消息队列的削峰填谷 +**平台配置方案**（低改动成本）： -遇到 `429` 错误时，可根据错误码和触发维度特征快速定位原因并选择策略。详见 [限流应对最佳实践](../../raw/model-user-guide/use-cases/rate-limiting-best-practices.md)。 +- **服务端排队等待**（推荐首选）：请求头添加 `X-DashScope-Wait-Timeout`，服务端在指定时间内排队重试，仅适用于 Traffic Burst 限流 +- **提升限流额度**：在百炼控制台直接提升，提交后立即生效 +- **PTU**：独立预留专享算力，避免公共资源池竞争 +- **Batch API**：离线任务批量提交，不受在线限流约束 -### 显式缓存 +**客户端流控策略**（需改代码）： -显式缓存通过在请求中添加 `cache_control` 标记，确保相同输入内容确定性命中缓存，首次写入仅产生标准价格 25% 的额外开销，后续命中可节省 90% 成本。适用于高频复用相同 Prompt、工业级 Agent 长上下文管理等场景。 +- 基础重试 -> 令牌桶 -> 平滑限速器 -> 自适应拥塞控制 + +**架构兜底方案**：模型降级（Fallback）、基于 MQ 的削峰填谷。 + +详见 [限流应对最佳实践](../../raw/model-user-guide/use-cases/rate-limiting-best-practices.md)。 + +### 显式缓存 -多种主流 Agent 和 Coding 工具已原生支持显式缓存： +显式缓存通过在请求中添加 `cache_control` 标记，确保相同输入确定性命中缓存。首次写入缓存产生标准价格 25% 的额外开销，后续命中可节省 90% 成本。 -- **Claude Code**：v2.x 起默认携带 `cache_control` 标记，接入百炼 Anthropic 兼容端点后自动生效 -- **Open Code**：通过 `@ai-sdk/anthropic` 接入时默认注入缓存标记 -- **OpenClaw**：走 Anthropic 兼容端点时默认启用 -- **Hermes**：通过配置接入参数即可使用 +适用场景：高频复用相同 Prompt、工业级 Agent 的长上下文管理。 -详见 [显式缓存最佳实践](../../raw/model-user-guide/use-cases/explicit-cache-guide.md)。 +主流 Coding Agent 工具（Claude Code、Open Code、OpenClaw、Hermes）通过 Anthropic 兼容端点接入百炼时原生支持显式缓存，无需额外配置。详见 [显式缓存最佳实践](../../raw/model-user-guide/use-cases/explicit-cache-guide.md)。 ## 来源文档 diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/use-chat-client-or-development-tool.md b/skills/bailian-docs-llm-wiki/wiki/guides/use-chat-client-or-development-tool.md index 82ff857..25d04b0 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/use-chat-client-or-development-tool.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/use-chat-client-or-development-tool.md @@ -1,119 +1,127 @@ # use chat client or development tool -阿里云百炼支持通过各类终端 AI 编程工具、桌面客户端、IDE 插件、低代码平台及 HTTP 工具接入其模型服务。所有客户端共享同一套[计费](../concepts/billing.md)与鉴权模型：按量[计费](../concepts/billing.md)、Coding Plan、[Token](../concepts/token.md) Plan 团队版，区别仅在于配置入口和 Base URL。本文汇总各工具的接入方式、关键参数与限制。 +阿里云百炼平台兼容 OpenAI 和 Anthropic API 协议，支持通过多种第三方聊天客户端和开发工具接入模型服务。开发者可根据使用场景选择终端 CLI 工具、桌面客户端、IDE 插件或开发平台，配合按量计费、Coding Plan 或 [Token](../concepts/token.md) Plan 团队版三种计费方案完成接入。本文汇总了各类工具的接入方式、配置要点和常见问题。 -## [计费](../concepts/billing.md)方案与通用接入参数 +## 支持的工具概览 -百炼为客户端接入提供三种[计费](../concepts/billing.md)方案，任何工具的配置都围绕这三组参数展开： +百炼支持的工具按使用形态可分为以下几类： -| 方案 | [计费](../concepts/billing.md)方式 | [API Key](../concepts/api-key.md) 来源 | 适用范围 | -| --- | --- | --- | --- | -| 按量[计费](../concepts/billing.md) | 按实际调用量后付费 | [阿里云百炼 API Key](https://help.aliyun.com/zh/model-studio/get-api-key) | 所有工具类型 | -| Coding Plan | 固定月费，按模型调用次数计量 | Coding Plan 专属 [API Key](https://bailian.console.aliyun.com/cn-beijing/?tab=model#/efm/coding_plan) | 仅 AI 编程工具与 OpenClaw | -| [Token](../concepts/token.md) Plan 团队版 | 按坐席订阅，按 token 抵扣 Credits | [Token](../concepts/token.md) Plan 团队版专属 [API Key](https://bailian.console.aliyun.com/cn-beijing?tab=plan#/efm/subscription/uac-admin/organization/members/list) | 仅 AI 编程工具与 OpenClaw | +| 类型 | 工具 | 简介 | +|------|------|------| +| 终端 CLI | [Claude Code](../../raw/model-user-guide/use-chat-client-or-development-tool/claude-code.md)、[Codex](../../raw/model-user-guide/use-chat-client-or-development-tool/codex.md)、[Hermes Agent](../../raw/model-user-guide/use-chat-client-or-development-tool/hermes-agent.md)、[OpenCode](../../raw/model-user-guide/use-chat-client-or-development-tool/opencode.md)、[Qwen Code](../../raw/model-user-guide/use-chat-client-or-development-tool/qwen-code.md)、[Kilo CLI](../../raw/model-user-guide/use-chat-client-or-development-tool/kilo-cli.md)、[OpenClaw](../../raw/model-user-guide/use-chat-client-or-development-tool/openclaw.md) | 命令行 AI 编程助手，直接在终端中交互 | +| 桌面客户端 | [Cherry Studio](../../raw/model-user-guide/use-chat-client-or-development-tool/cherry-studio.md)、[Chatbox](../../raw/model-user-guide/use-chat-client-or-development-tool/chatbox.md)、[QwenPaw](../../raw/model-user-guide/use-chat-client-or-development-tool/qwenpaw.md) | GUI 聊天界面，适合日常对话和多模型管理 | +| IDE 插件/编辑器 | [Cursor](../../raw/model-user-guide/use-chat-client-or-development-tool/cursor.md)、[Cline](../../raw/model-user-guide/use-chat-client-or-development-tool/cline.md)、[Qoder](../../raw/model-user-guide/use-chat-client-or-development-tool/qoder-agent.md)、[Qoder CN（原 Lingma）](../../raw/model-user-guide/use-chat-client-or-development-tool/lingma-agent.md) | 集成到 IDE 中的 AI 编程辅助 | +| 开发平台 | [Dify](../../raw/model-user-guide/use-chat-client-or-development-tool/dify.md) | 大模型应用开发平台，支持工作流和知识库 | +| API 测试工具 | [Postman/cURL](../../raw/model-user-guide/use-chat-client-or-development-tool/first-call-to-image-and-video-api.md) | 快速验证 API 调用（仅适用于按量计费） | -### Base URL 速查 +## 三种计费方案 -不同协议、不同方案的 Base URL 不能混用。OpenAI 兼容协议统一以 `/compatible-mode/v1` 结尾，Anthropic 兼容协议统一以 `/apps/anthropic` 结尾。 +所有工具均支持以下三种计费方案，但各方案的 [API Key](../concepts/api-key.md) 和 Base URL 互不通用： -| 方案 | OpenAI 兼容 Base URL | Anthropic 兼容 Base URL | -| --- | --- | --- | -| 按量[计费](../concepts/billing.md)（华北2-北京） | `https://dashscope.aliyuncs.com/compatible-mode/v1` | `https://dashscope.aliyuncs.com/apps/anthropic` | -| 按量[计费](../concepts/billing.md)（新加坡） | `https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1` | `https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic` | -| 按量[计费](../concepts/billing.md)（美国-弗吉尼亚） | `https://dashscope-us.aliyuncs.com/compatible-mode/v1` | （文档未列出 Anthropic 端点） | -| Coding Plan | `https://coding.dashscope.aliyuncs.com/v1` | `https://coding.dashscope.aliyuncs.com/apps/anthropic` | -| [Token](../concepts/token.md) Plan 团队版 | `https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1` | `https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic` | +- **[Token](../concepts/token.md) Plan 团队版**：按坐席订阅，按 token 消耗抵扣 Credits。[API Key](../concepts/api-key.md) 在 [Token Plan 管理页面](https://bailian.console.aliyun.com/cn-beijing?tab=plan#/efm/subscription/uac-admin/organization/members/list) 获取。 +- **Coding Plan**：固定月费订阅，按模型调用次数计量。[API Key](../concepts/api-key.md) 在 [Coding Plan 页面](https://bailian.console.aliyun.com/cn-beijing/?tab=model#/efm/coding_plan) 获取。 +- **按量计费**：按实际调用量后付费。API Key 通过 [百炼控制台](https://help.aliyun.com/zh/model-studio/get-api-key) 获取。 -> **注意**：三种方案的 [API Key](../concepts/api-key.md) 互不通用，且必须与 Base URL 同一方案、同一地域。按量计费的 [API Key](../concepts/api-key.md) 还需与 Base URL 地域一致，否则会报 `401 Incorrect API key provided`。新加坡地域需将 `{WorkspaceId}` 替换为真实的 [Workspace ID](https://help.aliyun.com/zh/model-studio/obtain-the-app-id-and-workspace-id#d3eb3cd37b7fu)。 +> **注意**：[Token](../concepts/token.md) Plan 团队版和 Coding Plan 仅限在 AI 编程工具和 OpenClaw 类型 Agent 中使用。Dify、Postman 等工作流/自动化平台和 API 测试工具不支持使用这两种套餐的 API Key，违规使用可能导致订阅被暂停。详见 [更多工具](../../raw/model-user-guide/use-chat-client-or-development-tool/more-tools.md)。 -## 终端 AI 编程工具 +## API 协议与 Base URL -终端类工具的安装方式相近，多为 npm 全局安装或官方安装脚本，配置则写入各自约定路径的 JSON / YAML / TOML 文件。 +百炼提供两种 API 协议，不同工具使用不同协议： -| 工具 | 安装命令 | 配置文件路径 | 默认协议 | -| --- | --- | --- | --- | -| [Hermes Agent](../../raw/model-user-guide/use-chat-client-or-development-tool/hermes-agent.md) | `curl ... install.sh \| bash` | `~/.hermes/config.yaml`（`hermes config set`） | Anthropic Messages | -| [Claude Code](../../raw/model-user-guide/use-chat-client-or-development-tool/claude-code.md) | `npm install -g @anthropic-ai/claude-code` | `~/.claude/settings.json` | Anthropic | -| [OpenCode](../../raw/model-user-guide/use-chat-client-or-development-tool/opencode.md) | `npm install -g opencode-ai` | `~/.config/opencode/opencode.json` | Anthropic（`@ai-sdk/anthropic`） | -| [Codex](../../raw/model-user-guide/use-chat-client-or-development-tool/codex.md) | `npm install -g @openai/codex` | `~/.codex/config.toml` + `OPENAI_API_KEY` 环境变量 | OpenAI Responses / Chat | -| [Qwen Code](../../raw/model-user-guide/use-chat-client-or-development-tool/qwen-code.md) | 官方安装脚本（`--source bailian`） | `~/.qwen/settings.json`（`/auth` 向导） | OpenAI 兼容 | -| [Kilo CLI](../../raw/model-user-guide/use-chat-client-or-development-tool/kilo-cli.md) | `npm install -g @kilocode/cli` | `~/.config/kilo/config.json` | OpenAI 兼容 / Anthropic | +### OpenAI 兼容协议 -### Codex 的 API 形态差异 +大部分工具使用此协议（Cursor、Cline、Cherry Studio、Chatbox、Codex、OpenCode、Kilo CLI、Qwen Code、Qoder/Qoder CN 等）。 -Codex 较为特殊：[Token](../concepts/token.md) Plan 团队版下，`qwen3.7-max`、`qwen3.7-plus`、`qwen3.6-plus`、`qwen3.6-flash` 支持 Responses API（`wire_api = "responses"`），可使用最新版 Codex；其他模型（如 `glm-5`）只能走 Chat/Completions API（`wire_api = "chat"`），需降级安装旧版本（如 `npm install -g @openai/codex@0.80.0`）。Coding Plan 仅支持 Chat/Completions API，必须使用旧版本 Codex。 +| 计费方案 | Base URL | +|----------|----------| +| Token Plan 团队版 | `https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1` | +| Coding Plan | `https://coding.dashscope.aliyuncs.com/v1` | +| 按量计费（北京） | `https://dashscope.aliyuncs.com/compatible-mode/v1` | +| 按量计费（新加坡） | `https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1` | +| 按量计费（弗吉尼亚） | `https://dashscope-us.aliyuncs.com/compatible-mode/v1` | -### Hermes Agent 接入要点 +### Anthropic 兼容协议 -Hermes Agent 默认使用 OpenRouter 作为推理提供商，接入百炼时 `model.provider` 必须显式设置为 `custom`，否则会继续连到 OpenRouter。配置写入 `~/.hermes/config.yaml`，`api_mode` 设为 `anthropic_messages`。 +Claude Code、Hermes Agent、OpenClaw 等使用此协议。 -### Claude Code 跳过官方登录 +| 计费方案 | Base URL | +|----------|----------| +| Token Plan 团队版 | `https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic` | +| Coding Plan | `https://coding.dashscope.aliyuncs.com/apps/anthropic` | +| 按量计费（北京） | `https://dashscope.aliyuncs.com/apps/anthropic` | +| 按量计费（新加坡） | `https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic` | -Claude Code 默认要求 Anthropic 官方登录。接入百炼时需编辑 `~/.claude.json`，将 `hasCompletedOnboarding` 设为 `true` 以跳过验证；随后在 `~/.claude/settings.json` 的 `env` 中写入 `ANTHROPIC_AUTH_TOKEN`、`ANTHROPIC_BASE_URL`、`ANTHROPIC_MODEL` 等。社区工具 [CC Switch](https://github.com/farion1231/cc-switch) 可在多个套餐间一键切换，无需手动改文件。 +> **注意**：按量计费的 API Key 必须与所选地域对应，跨地域使用会导致认证失败（HTTP 401）。 -## 桌面客户端与 IDE 插件 +## 各工具配置要点 -桌面 / IDE 类工具通过图形界面配置，提供商类型多选 **OpenAI Compatible** 或 **OpenAI API 兼容**，再填入 Base URL、[API Key](../concepts/api-key.md)、Model ID。 +### Claude Code -| 工具 | 形态 | 安装来源 | 备注 | -| --- | --- | --- | --- | -| [Cursor](../../raw/model-user-guide/use-chat-client-or-development-tool/cursor.md) | AI IDE | Cursor 官网 | 免费版仅支持 Auto 模式，调用自定义模型需 Cursor Pro 及以上 | -| [Cline](../../raw/model-user-guide/use-chat-client-or-development-tool/cline.md) | VSCode 插件 | VSCode 扩展商店 | 使用 Qwen3 思考模式 / QwQ 时需勾选 **Enable R1 messages format** | -| [Cherry Studio](../../raw/model-user-guide/use-chat-client-or-development-tool/cherry-studio.md) | 桌面客户端 | Cherry Studio 下载页 | 开源；RAM 子账号需在[业务空间](../concepts/workspace.md)授予模型调用权限 | -| [Chatbox](../../raw/model-user-guide/use-chat-client-or-development-tool/chatbox.md) | 跨平台客户端 | Chatbox 官网 / 网页版 | API 路径无需填写 | -| [Qoder](../../raw/model-user-guide/use-chat-client-or-development-tool/qoder-agent.md) | IDE + CLI + JetBrains 插件 | Qoder 官网 / `curl ... \| bash` | 仅支持文本生成模型 | -| Qoder CN（原 Lingma） | 独立 IDE | Qoder CN 官网 | 个人社区版 / 专业版支持，企业版不支持 | -| [QwenPaw](../../raw/model-user-guide/use-chat-client-or-development-tool/qwenpaw.md) | 个人 AI 助手 | pip / 一键脚本 / Docker | Console 图形配置，按量计费内置 DashScope 提供商 | -| [OpenClaw](../../raw/model-user-guide/use-chat-client-or-development-tool/openclaw.md) | 开源 Agent 平台 | 官方脚本 / `npm install -g openclaw@latest` | 需 Node.js 22+；配置在 `~/.openclaw/openclaw.json` | +通过环境变量配置，编辑 `~/.claude/settings.json`，设置 `ANTHROPIC_AUTH_TOKEN`、`ANTHROPIC_BASE_URL`、`ANTHROPIC_MODEL` 等。需先在 `~/.claude.json` 中设置 `"hasCompletedOnboarding": true` 跳过官方登录验证。社区工具 [CC Switch](https://github.com/farion1231/cc-switch) 支持在多套餐间一键切换。详见 [Claude Code](../../raw/model-user-guide/use-chat-client-or-development-tool/claude-code.md)。 -### Cursor 的模型名别名 +### Codex -Cursor 与部分内置模型名冲突，需使用别名：`kimi-k2.6` → `kimi-k2-6`、`kimi-k2.5` → `kimi-k2-5`、`glm-5.2` → `glm-5-2`、`glm-5.1` → `glm-5-1`、`glm-5` → `glm-5-0`。配置后若找不到模型，需在聊天面板关闭 Auto 模式并从下拉栏选择。 +编辑 `~/.codex/config.toml` 配置 `model_provider`、`base_url` 和 `wire_api`，同时通过环境变量 `OPENAI_API_KEY` 设置密钥。qwen3.7-max 等模型支持 Responses API（最新版 Codex），其他模型需通过 Chat/Completions API 接入（需安装 Codex 0.80.0 旧版本）。详见 [Codex](../../raw/model-user-guide/use-chat-client-or-development-tool/codex.md)。 -### Qoder / Qoder CN 的提供商与类型一致性 +### Cursor -Qoder 系列在模型配置中需同时选对**提供商**（阿里云百炼 - 国内）与**类型**（[Token](../concepts/token.md) Plan / Coding Plan / 按量付费）。若类型与实际套餐不一致（如用 [Token](../concepts/token.md) Plan 的 Key 但类型选 Coding Plan），会报 `Unknown Custom model Exception`。 +在 Cursor Settings > Models 中开启 OpenAI API Key 和 Override OpenAI Base URL，填入对应凭证。需要 Cursor Pro 及以上套餐才能使用自定义模型（免费版仅支持 Auto 模式）。部分模型名称需调整，如 `kimi-k2.6` 写为 `kimi-k2-6`、`glm-5` 写为 `glm-5-0`。 -## 百炼 CLI 集成 +### Cline + +在 VSCode 侧边栏的 Cline 配置界面选择 OpenAI Compatible 作为 API Provider。使用 Qwen3 思考模式或 QwQ 模型时，需在 MODEL CONFIGURATION 中勾选 Enable R1 messages format。 + +### Hermes Agent / OpenCode / Kilo CLI + +均通过配置文件设置 Base URL 和 API Key。Hermes Agent 使用 `~/.hermes/config.yaml`，OpenCode 使用 `~/.config/opencode/opencode.json`，Kilo CLI 使用 `~/.config/kilo/config.json`。Hermes Agent 默认使用 OpenRouter，接入百炼时 `model.provider` 必须设置为 `custom`。 + +### Qwen Code + +安装后通过 `/auth` 命令可视化配置，也可直接编辑 `~/.qwen/settings.json`。安装时指定 `--source bailian` 参数可预设百炼配置。 -Cursor、Cline、Qoder 等支持通过对话调用百炼能力：全局安装 `bailian-cli` 后，安装过程会向 `~/.<工具>/skills/bailian-cli/` 注册 Skill，工具即可通过自然语言调用百炼能力（如生成电商主图、产品演示视频）。前置要求 Node.js 18+，[API Key](../concepts/api-key.md) 通过对话告知工具即可。 +### Qoder / Qoder CN（原 Lingma） -## 低代码与 HTTP 工具 +[Qoder](../../raw/model-user-guide/use-chat-client-or-development-tool/qoder-agent.md) 支持桌面 IDE、CLI 和 JetBrains 插件三种形态，在设置中选择"阿里云百炼 - 国内"作为提供商即可。[Qoder CN](../../raw/model-user-guide/use-chat-client-or-development-tool/lingma-agent.md) 仅个人社区版和个人专业版支持接入百炼，企业版不支持。 + +### Cherry Studio / Chatbox / QwenPaw + +桌面客户端均在设置界面添加供应商，选择 OpenAI 兼容模式，填入 API Key 和 Base URL。QwenPaw 内置了百炼各套餐的提供商配置模板，在 Console 设置页面直接填入 API Key 即可。 ### Dify -[Dify](../../raw/model-user-guide/use-chat-client-or-development-tool/dify.md) 是开源大模型应用开发平台，通过**通义千问插件**接入百炼（DeepSeek 模型也走该插件）。配置要点： +安装"通义千问"插件（非阿里云官方维护，由 Dify 官方维护），在模型供应商设置中填入 API Key。使用 DeepSeek 模型也需通过"通义千问"插件接入。Qwen-Omni、Qwen-Audio、Qwen-OCR 不支持直接在 Dify 配置，需通过 HTTP 节点接入。万相模型需导入工作流模板使用。 + +### Postman / cURL + +适用于图像/视频生成等异步 API 的快速验证。调用分为两步：先创建任务获取 `task_id`，再轮询查询结果。仅支持按量计费方案。 + +## 百炼 CLI 集成 + +Cursor、Cline、Qoder 等工具支持通过安装百炼 CLI（`npm install -g bailian-cli`）注册 Skill，从而在对话中直接调用百炼的图像生成、视频生成等扩展能力。安装后 CLI 会自动向对应工具的 [skill](skill.md)s 目录注册，无需额外配置。 + +## 常见问题 -- 在 Dify 市场安装**通义千问**插件，于模型供应商设置中填入对应地域 [API Key](../concepts/api-key.md)；华北2（北京）设**使用国际端点**为**否**，新加坡设为**是**。 -- 插件非阿里云官方维护，最新版可能不稳定，报错 `Invalid API-key provided` 时可降级安装较早版本。 -- Qwen-Omni / Qwen-Audio / Qwen-OCR 不支持直接配置，需通过 Chatflow / [工作流](../concepts/workflow.md)的 HTTP 节点接入，建议[流式输出](../concepts/streaming-output.md)以降低超时风险。 -- 万相文生图 / 视频：Dify 无内置插件，需导入官方[工作流](../concepts/workflow.md)模板（`万相-文生图 Demo.yml` 等），并把 `DASHSCOPE_API_KEY` 环境变量改为自己的 Key。 +### API Key 认证失败（HTTP 401） -### Postman / cURL 调用图像视频 API +- 三种计费方案的 API Key 不通用，确认 API Key 与 Base URL 来自同一方案。 +- 按量计费的 API Key 必须与 Base URL 地域一致。 +- 检查 API Key 是否完整复制、无多余空格。 -图像 / 视频生成 API 采用**[异步调用](../concepts/async-invocation.md)机制**：先 POST 创建任务拿到 `task_id`，再 GET 轮询 `/api/v1/tasks/{task_id}` 直到 `task_status` 为 `SUCCEEDED`。请求头需带 `X-DashScope-Async: enable`、`Authorization: Bearer `、`Content-Type: application/json`。`task_id` 与最终图像 / 视频 URL 有效期均为 24 小时。该方式仅适用于快速测试与功能验证，生产环境应使用官方 SDK。 +### 模型名称冲突 -> **注意**：Postman / cURL / Dify 这类[工作流](../concepts/workflow.md)、API 测试、自定义应用工具**仅能使用按量计费**接入。[Token](../concepts/token.md) Plan 团队版和 Coding Plan 明确不支持此类工具，将套餐 Key 用于允许范围之外的调用可能被判定为违规滥用，导致订阅暂停或 Key 封禁。 +在 Cursor 中，部分模型名称与内置模型冲突，需使用别名（如 `glm-5` 写为 `glm-5-0`）。如果配置完成后找不到模型，需关闭 Auto 模式再手动选择。 -## 支持的模型 +### 思考模式报错 -各方案可用模型以官方文档为准： +部分模型仅支持思考模式运行。在 Cline 中需勾选 Enable R1 messages format；在 Cherry Studio 中需开启思考模式开关；在 Dify 中需将思考模式设置为 True。报错 `The value of the enable_thinking parameter is restricted to True` 即为此问题。 -- 按量计费：[OpenAI 兼容支持的模型](https://help.aliyun.com/zh/model-studio/compatibility-of-openai-with-dashscope#7f9c78ae99pwz) / [Anthropic 兼容支持的模型](https://help.aliyun.com/zh/model-studio/anthropic-api-messages#ae1b2c3d4e5f6) -- Coding Plan：[支持的模型](https://help.aliyun.com/zh/model-studio/coding-plan) -- [Token](../concepts/token.md) Plan 团队版：[支持的模型](https://help.aliyun.com/zh/model-studio/token-plan-overview)（仅文本生成类） +### 按量计费免费额度产生费用 -部分工具（如 OpenCode、Kilo CLI、Qwen Code）在配置文件中显式列出 `qwen3.7-max`、`qwen3.7-plus`、`qwen3.6-plus`、`qwen3.6-flash`、`deepseek-v4-pro/flash`、`kimi-k2.7-code/2.6/2.5`、`glm-5.2/5.1/5`、`MiniMax-M2.5` 等，支持开启 `thinking` 思考模式（`budgetTokens` 一般设 8192，Coding Plan 下 Kilo CLI 设 1024）。Qoder / Qoder CN 仅支持文本生成模型，不支持[多模态](../concepts/multimodal.md)。 +免费额度仅适用于华北2（北京）地域，各模型额度独立计算不可共享，且控制台数据每小时更新存在延迟。 -## 限制与注意事项 +### 上下文超限 -- **方案与工具匹配**：Token Plan 团队版、Coding Plan 仅限 AI 编程工具与 OpenClaw 使用；Dify、n8n、Coze、Postman、Insomnia、自定义应用后端等只能用按量计费。 -- **[API Key](../concepts/api-key.md) 不可混用**：三种方案 Key 互不通；按量计费 Key 还需与地域一致。报 `401 Incorrect API key provided` 时优先排查此项。 -- **思考模式开关**：思考型模型（Qwen3 思考模式、QwQ）在部分客户端需手动开启思考模式或勾选 R1 messages format，否则会报 `The value of the enable_thinking parameter is restricted to True` 或 `400 InternalError.Algo.InvalidParameter`。 -- **免费额度限制**：按量计费免费额度仅适用华北2（北京）地域模型，各模型额度独立、不可跨模型共享，控制台数据每小时更新可能滞后。 -- **Windows 安装**：Hermes Agent、Claude Code 等在 Windows 上需先装 WSL2 或 Git Bash，再在 WSL / Git Bash 中执行安装命令。 -- **地域与部署范围**：各地域支持的模型为系统预设绑定关系，不支持自由组合，详见 [地域与部署范围](https://help.aliyun.com/zh/model-studio/regions/#6e9530261dv6q)。 -- **错误码排查**：按量计费见 [错误码](https://help.aliyun.com/zh/model-studio/error-code)，Coding Plan 见 [Coding Plan 常见问题](https://help.aliyun.com/zh/model-studio/coding-plan-faq)，Token Plan 团队版见 [Token Plan 团队版常见问题](https://help.aliyun.com/zh/model-studio/token-plan-faq)。 +长对话或工具调用时可能触发上下文超限，需在对应工具中调整 `max_tokens` 参数或缩短对话历史。 ## 来源文档 @@ -136,13 +144,3 @@ Cursor、Cline、Qoder 等支持通过对话调用百炼能力：全局安装 `b - [更多工具](../../raw/model-user-guide/use-chat-client-or-development-tool/more-tools.md) - - - - - - - - - - diff --git a/skills/bailian-docs-llm-wiki/wiki/index.md b/skills/bailian-docs-llm-wiki/wiki/index.md index 9b28774..81f582a 100644 --- a/skills/bailian-docs-llm-wiki/wiki/index.md +++ b/skills/bailian-docs-llm-wiki/wiki/index.md @@ -61,22 +61,23 @@ ## 横切概念 -- [API Key 鉴权](concepts/api-key.md) — 关联 8 个主题 -- [DashScope SDK](concepts/dashscope-sdk.md) — 关联 6 个主题 -- [OpenAI 兼容接口](concepts/openai-compatible-interface.md) — 关联 7 个主题 -- [Token 计量](concepts/token.md) — 关联 6 个主题 -- [业务空间](concepts/workspace.md) — 关联 6 个主题 -- [函数调用（Function Calling）](concepts/function-calling.md) — 关联 6 个主题 -- [多模态](concepts/multimodal.md) — 关联 6 个主题 -- [异步调用](concepts/async-invocation.md) — 关联 4 个主题 -- [检索增强生成（RAG）](concepts/rag.md) — 关联 6 个主题 +- [API Key](concepts/api-key.md) — 关联 7 个主题 +- [DashScope SDK](concepts/dashscope-sdk.md) — 关联 7 个主题 +- [OpenAI 兼容接口](concepts/openai-compatible-interface.md) — 关联 8 个主题 +- [Token](concepts/token.md) — 关联 8 个主题 +- [业务空间](concepts/workspace.md) — 关联 8 个主题 +- [函数调用](concepts/function-calling.md) — 关联 6 个主题 +- [多模态](concepts/multimodal.md) — 关联 7 个主题 +- [异步调用](concepts/async-invocation.md) — 关联 5 个主题 +- [检索增强生成](concepts/rag.md) — 关联 6 个主题 - [流式输出](concepts/streaming.md) — 关联 5 个主题 ## 对比分析 -- [多模态内容生成 API 对比](comparisons/multimodal-generation-comparison.md) — 对比 3 个主题 -- [应用监控与模型监控对比](comparisons/app-vs-model-monitoring.md) — 对比 2 个主题 -- [应用评测与模型评测对比](comparisons/app-vs-model-evaluation.md) — 对比 2 个主题 -- [模型优化方案对比：微调、压缩与高速推理](comparisons/model-optimization-comparison.md) — 对比 3 个主题 -- [知识库与记忆库对比](comparisons/knowledge-vs-memory.md) — 对比 2 个主题 +- [Qwen API、应用调用与托管智能体 API 对比](comparisons/qwen-api-vs-app-call-vs-agents-api.md) — 对比 3 个主题 +- [图像生成、视频生成与 3D 生成对比](comparisons/multimodal-generation-comparison.md) — 对比 3 个主题 +- [应用监控与模型监控对比](comparisons/app-monitoring-vs-model-monitoring.md) — 对比 2 个主题 +- [应用评测与模型评测对比](comparisons/app-eval-vs-model-eval.md) — 对比 2 个主题 +- [模型微调、压缩与部署对比](comparisons/fine-tuning-vs-compression-vs-deployment.md) — 对比 3 个主题 +- [知识库与记忆库对比](comparisons/knowledge-base-vs-memory-library.md) — 对比 2 个主题