From 87873141b9912e59fbbaf3de0f68f6db9df43502 Mon Sep 17 00:00:00 2001 From: lishengzxc <306009337@qq.com> Date: Tue, 7 Jul 2026 10:39:38 +0800 Subject: [PATCH] chore: update bailian-docs-llm-wiki (2026-07-07) --- skills/bailian-docs-llm-wiki/SKILL.md | 30 +- skills/bailian-docs-llm-wiki/llms.txt | 953 +++--- .../bailian-docs-llm-wiki/models/index.json | 2 +- skills/bailian-docs-llm-wiki/models/index.md | 2 +- ...-and-workflow-application-api-reference.md | 20 +- .../managed-agents-quickstart.md | 75 +- .../multimodal-sdk/mmi-rtos-sdk.md | 198 +- .../data-connection.md | 12 +- .../new-single-agent-application.md | 6 +- .../single-agent-application.md | 2 +- .../prompt/prompt-sample-optimization.md | 2 +- ...droid-sdk-for-fun-asr-real-time-service.md | 81 +- .../fun-asr-client-events.md | 296 +- .../fun-asr-realtime-java-sdk.md | 131 + .../fun-asr-realtime-python-sdk.md | 144 + .../ios-sdk-for-fun-asr-real-time-service.md | 78 +- .../wan-image-generation-api-reference.md | 10 +- .../model-production/model-compression-api.md | 3 - .../get-temporary-file-url.md | 4 +- .../get-started-with-models/rate-limit.md | 8 + .../model-deployment-introduction.md | 14 +- .../model-evaluation-overview.md | 2840 ++--------------- .../model-experience/asr-model.md | 10 +- .../model-experience/image-model.md | 46 +- .../model-experience/vision-model.md | 42 +- .../release-notes/newly-released-models.md | 10 + .../model-user-guide/test-1/model-pricing.md | 22 + .../model-training-and-deployment-billing.md | 12 +- .../model-user-guide/test-1/new-free-quota.md | 32 +- .../deepseek-api.md | 58 +- .../kimi-api.md | 56 + .../wiki/api/3d-generation.md | 1 + .../wiki/api/application-call.md | 217 +- .../application-component-api-reference.md | 3 +- .../wiki/api/file-management-api.md | 36 +- .../wiki/api/frameworks.md | 1 + .../wiki/api/image-generation.md | 207 +- .../wiki/api/knowledge.md | 5 +- .../wiki/api/long-term-memory-new.md | 1 + .../wiki/api/managed-agents-api.md | 256 +- .../wiki/api/model-production.md | 51 +- .../wiki/api/more-about-models.md | 167 +- .../wiki/api/more-models.md | 5 +- skills/bailian-docs-llm-wiki/wiki/api/more.md | 1 + .../wiki/api/omni-realtime-api.md | 1 + .../wiki/api/preparations.md | 7 +- .../wiki/api/qwen-api-reference.md | 1 + .../wiki/api/toolkits-and-frameworks.md | 1 + .../wiki/api/vector-and-sort.md | 1 + .../wiki/api/video-generation-api.md | 9 +- .../comparisons/app-vs-model-evaluation.md | 64 + .../comparisons/app-vs-model-monitoring.md | 66 + .../wiki/comparisons/knowledge-vs-memory.md | 62 + .../model-optimization-comparison.md | 119 +- .../multimodal-generation-comparison.md | 95 +- .../wiki/concepts/api-key.md | 102 +- .../wiki/concepts/async-invocation.md | 93 +- .../wiki/concepts/dashscope-sdk.md | 115 +- .../wiki/concepts/function-calling.md | 76 +- .../wiki/concepts/multimodal.md | 83 +- .../concepts/openai-compatible-interface.md | 110 +- .../wiki/concepts/rag.md | 98 +- .../wiki/concepts/streaming.md | 92 + .../wiki/concepts/token.md | 86 +- .../wiki/concepts/workspace.md | 70 +- .../wiki/guides/application-evaluation.md | 1 + .../wiki/guides/application-monitoring.md | 1 + .../application-permission-management.md | 5 +- .../application-publishing-and-sharing.md | 1 + .../wiki/guides/application-support.md | 1 + .../wiki/guides/application-use-cases.md | 1 + .../guides/bailian-application-calling.md | 1 + .../wiki/guides/data-connection-overview.md | 142 +- .../wiki/guides/fine-tuning.md | 1 + .../wiki/guides/get-started-with-models.md | 191 +- .../wiki/guides/knowledge-base.md | 13 +- .../wiki/guides/llm-application.md | 149 +- .../wiki/guides/memory-library-overview.md | 1 + .../wiki/guides/model-compression.md | 1 + .../wiki/guides/model-context-protocol.md | 1 + .../wiki/guides/model-data-overview.md | 1 + .../wiki/guides/model-deployment-1.md | 147 +- .../guides/model-evaluation-introduction.md | 158 +- .../wiki/guides/model-experience.md | 232 +- .../wiki/guides/model-high-speed-inference.md | 166 +- .../wiki/guides/model-monitoring.md | 5 +- .../wiki/guides/plug-in.md | 1 + .../wiki/guides/prompt.md | 128 +- .../wiki/guides/release-notes.md | 140 +- .../wiki/guides/security-and-compliance.md | 7 +- .../wiki/guides/skill.md | 1 + .../wiki/guides/start-using.md | 1 + .../wiki/guides/support.md | 1 + .../wiki/guides/test-1.md | 205 +- .../wiki/guides/token-plan-guide.md | 5 +- .../wiki/guides/use-cases.md | 162 +- .../use-chat-client-or-development-tool.md | 1 + skills/bailian-docs-llm-wiki/wiki/index.md | 32 +- 98 files changed, 4079 insertions(+), 5325 deletions(-) delete mode 100644 skills/bailian-docs-llm-wiki/raw/model-api-reference/model-production/model-compression-api.md create mode 100644 skills/bailian-docs-llm-wiki/wiki/comparisons/app-vs-model-evaluation.md create mode 100644 skills/bailian-docs-llm-wiki/wiki/comparisons/app-vs-model-monitoring.md create mode 100644 skills/bailian-docs-llm-wiki/wiki/comparisons/knowledge-vs-memory.md create mode 100644 skills/bailian-docs-llm-wiki/wiki/concepts/streaming.md diff --git a/skills/bailian-docs-llm-wiki/SKILL.md b/skills/bailian-docs-llm-wiki/SKILL.md index d2adc0d..9be23cd 100644 --- a/skills/bailian-docs-llm-wiki/SKILL.md +++ b/skills/bailian-docs-llm-wiki/SKILL.md @@ -147,21 +147,21 @@ description: >- | **按家族筛选**：按 primaryCapability / providers / itemCount / maxContextWindow 找家族 | `models/families.jsonl`（一行一家族，含 items[] 摘要） | | 模型家族总览 / 按能力分桶浏览 | `models/index.md` | | 主题页 / API 文档（按功能领域查找） | `wiki/index.md`（完整索引入口） | -| 函数调用 | `wiki/concepts/function-calling.md` | -| 流式输出 | `wiki/concepts/streaming-output.md` | -| 模型调优 | `wiki/concepts/fine-tuning.md` | -| 向量嵌入 | `wiki/concepts/embedding.md` | -| 重排序 | `wiki/concepts/rerank.md` | -| 提示词工程 | `wiki/concepts/prompt-engineering.md` | -| 上下文窗口 | `wiki/concepts/context-window.md` | -| 限流与配额 | `wiki/concepts/rate-limiting.md` | -| 工作流 | `wiki/concepts/workflow.md` | -| 微调与模型压缩对比 | `wiki/comparisons/fine-tuning-vs-compression.md` | -| 模型部署与高速推理对比 | `wiki/comparisons/model-deployment-vs-inference.md` | -| 模型评测与模型监控对比 | `wiki/comparisons/model-evaluation-vs-monitoring.md` | -| 应用评测与应用监控对比 | `wiki/comparisons/application-evaluation-vs-monitoring.md` | -| 知识库与记忆库对比 | `wiki/comparisons/knowledge-base-vs-memory-library.md` | -| 应用调用方式对比 | `wiki/comparisons/application-call-vs-bailian-calling.md` | +| API Key 鉴权 | `wiki/concepts/api-key.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` | +| 异步调用 | `wiki/concepts/async-invocation.md` | +| 业务空间 | `wiki/concepts/workspace.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/index.md` 为准；上表若有出入应回到索引页查找。 diff --git a/skills/bailian-docs-llm-wiki/llms.txt b/skills/bailian-docs-llm-wiki/llms.txt index 39599c4..e613dc1 100644 --- a/skills/bailian-docs-llm-wiki/llms.txt +++ b/skills/bailian-docs-llm-wiki/llms.txt @@ -5,128 +5,128 @@ ## 模型使用指南 - **开始使用** - - [什么是阿里云百炼](raw/model-user-guide/get-started-with-models/what-is-model-studio.md) - [选择模型](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) - [Base URL总览](raw/model-user-guide/get-started-with-models/base-url.md) - - [选择地域、服务部署范围和接入域名](raw/model-user-guide/get-started-with-models/regions.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/text-generation-model.md) - [视觉理解](raw/model-user-guide/model-experience/vision-model.md) - - [视频生成与编辑](raw/model-user-guide/model-experience/video-generate-edit-model.md) + - [文本生成](raw/model-user-guide/model-experience/text-generation-model.md) - [图片生成与编辑](raw/model-user-guide/model-experience/image-model.md) - - [Tripo 3D模型生成](raw/model-user-guide/model-experience/tripo-3d-generation-guide.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) - - [向量与重排序](raw/model-user-guide/model-experience/embedding-rerank-model.md) - - [语音识别](raw/model-user-guide/model-experience/asr-model.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) - **接入客户端/开发工具** - - [Hermes Agent](raw/model-user-guide/use-chat-client-or-development-tool/hermes-agent.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) - [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) - - [Qwen Code](raw/model-user-guide/use-chat-client-or-development-tool/qwen-code.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) - [Chatbox](raw/model-user-guide/use-chat-client-or-development-tool/chatbox.md) - - [Qoder CN（原 Lingma）](raw/model-user-guide/use-chat-client-or-development-tool/lingma-agent.md) - [Cline](raw/model-user-guide/use-chat-client-or-development-tool/cline.md) - - [Kilo CLI](raw/model-user-guide/use-chat-client-or-development-tool/kilo-cli.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) + - [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) - - [更多工具](raw/model-user-guide/use-chat-client-or-development-tool/more-tools.md) - [Dify](raw/model-user-guide/use-chat-client-or-development-tool/dify.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/add-vision-skill.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/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) -- **模型推理** - - [TPM 预留](raw/model-user-guide/model-high-speed-inference/tpm-reservation.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) +- **模型推理** + - [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) - [使用 API 或命令行进行模型调优](raw/model-user-guide/fine-tuning/fine-tune-text-generation-model/fine-tuning-api-guide.md) - - [在控制台进行模型调优](raw/model-user-guide/fine-tuning/fine-tune-text-generation-model/model-training-on-console.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-evaluation-introduction/model-evaluation-overview.md) +- **模型压缩** + - [模型压缩](raw/model-user-guide/model-compression/model-compression-introduction.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-compression/model-compression-introduction.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/security-and-compliance/transmission-security/encrypted-access-to-model-inference.md) - - [获取RSA的公钥](raw/model-user-guide/security-and-compliance/transmission-security/model-interface-aes-encryption.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) - **实践教程** - **三方模型调用教程** - - [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.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-by-moonshot-ai.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) - [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) - - [Vidu视频生成Prompt指南](raw/model-user-guide/use-cases/third-party-model-integration-tutorial/vidu-video-generation-prompt-guide.md) - [MiniMax](raw/model-user-guide/use-cases/third-party-model-integration-tutorial/minimax-api-by-minimax.md) - - [Stepfun-阶跃星辰](raw/model-user-guide/use-cases/third-party-model-integration-tutorial/stepfun.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) - [文生文Prompt指南](raw/model-user-guide/use-cases/prompt-engineering-guide.md) - [文生图Prompt指南](raw/model-user-guide/use-cases/text-to-image-prompt.md) - - [文生视频/图生视频Prompt指南](raw/model-user-guide/use-cases/text-to-video-prompt.md) - [基于LlamaIndex构建RAG应用](raw/model-user-guide/use-cases/build-rag-applications-based-on-llamaindex.md) + - [文生视频/图生视频Prompt指南](raw/model-user-guide/use-cases/text-to-video-prompt.md) - [自定义模型调优、部署与评测](raw/model-user-guide/use-cases/model-training-best-practices.md) - - [限流应对最佳实践 ](raw/model-user-guide/use-cases/rate-limiting-best-practices.md) - [借助大模型将文档转换为视频](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/faq-about-alibaba-cloud-model-studio.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/release-notes/model-release-notes.md) - [模型上下架与更新](raw/model-user-guide/release-notes/newly-released-models.md) @@ -138,52 +138,52 @@ - [应用功能动态](raw/application-user-guide/start-using/application-release-notes.md) - **记忆库** - [记忆库](raw/application-user-guide/memory-library-overview/memory-library.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) -- **数据连接** - - [数据连接](raw/application-user-guide/data-connection-overview/data-connection.md) -- **应用开发** - - [新版智能体应用](raw/application-user-guide/llm-application/new-single-agent-application.md) - - [应用类型介绍](raw/application-user-guide/llm-application/application-introduction.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/workflow-application.md) - - [文件问答](raw/application-user-guide/llm-application/file-q-a.md) + - [为 OpenClaw 配置长期记忆插件](raw/application-user-guide/memory-library-overview/modelstudio-memory-for-openclaw.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) -- **Skill** - - [Skill](raw/application-user-guide/skill/introduction-to-skill.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/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) - - [知识库日志与监控](raw/application-user-guide/knowledge-base/rag-knowledge-base-log-monitoring.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) - [知识库计费说明](raw/application-user-guide/knowledge-base/billing-for-knowledge-base.md) - [知识问答](raw/application-user-guide/knowledge-base/rag-knowledge-qa.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/plug-in/plug-in-overview.md) - - [官方和第三方插件](raw/application-user-guide/plug-in/plugins.md) - - [自定义插件](raw/application-user-guide/plug-in/custom-plug-ins.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/use-agent-or-workflow-as-component.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/bailian-application-calling/invoke-workflow-application.md) - [应用的自定义参数传递](raw/application-user-guide/bailian-application-calling/pass-through-of-application-parameters.md) - [调用智能体应用](raw/application-user-guide/bailian-application-calling/call-single-agent-application.md) - - [调用工作流应用](raw/application-user-guide/bailian-application-calling/invoke-workflow-application.md) - **应用评测** - **新版应用评测** - [新版评测集](raw/application-user-guide/application-evaluation/new-version-of-application-evaluation/new-version-of-evaluation-set.md) @@ -196,6 +196,15 @@ - **应用观测** - [应用观测](raw/application-user-guide/application-monitoring/application-observation.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) + - [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) + - [通义音频播客生成产品介绍](raw/application-user-guide/application-gallery/official-application-aipodcast/brief-introduction-of-ai-podcast.md) - **官方应用-通义拍照解题辅导** - **API参考** - **API目录** @@ -205,31 +214,22 @@ - [服务接入点](raw/application-user-guide/application-gallery/edu-tutor/api-reference-edututor/api-edututor-2025-07-07-endpoint.md) - [授权信息](raw/application-user-guide/application-gallery/edu-tutor/api-reference-edututor/api-edututor-2025-07-07-ram.md) - [通义拍照解题辅导产品介绍](raw/application-user-guide/application-gallery/edu-tutor/brief-introduction-of-edu-tutor.md) - - **官方应用-通义音频播客生成** - - **API参考** - - **API目录** - - [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-ram.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/brief-introduction-of-ai-podcast.md) - **官方应用-多模态交互开发套件** - **使用指南** - [应用创建](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/agent-template.md) - - [对话日志接入](raw/application-user-guide/application-gallery/multimodal-products/multimodal-guidelines/multimodal-chatlog.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) + - [对话日志接入](raw/application-user-guide/application-gallery/multimodal-products/multimodal-guidelines/multimodal-chatlog.md) - [三方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/instruction-list.md) - [音色列表](raw/application-user-guide/application-gallery/multimodal-products/multimodal-guidelines/multimodal-timbre-list.md) - **SDK安装** - - [服务端Java SDK](raw/application-user-guide/application-gallery/multimodal-products/multimodal-sdk/multimodal-sdk-java.md) - - [移动端Android SDK](raw/application-user-guide/application-gallery/multimodal-products/multimodal-sdk/multimodal-sdk-android.md) - [服务端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) - [服务端 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) - [移动端Android Lite SDK](raw/application-user-guide/application-gallery/multimodal-products/multimodal-sdk/multimodal-sdk-android-lite.md) - [移动端iOS Lite SDK](raw/application-user-guide/application-gallery/multimodal-products/multimodal-sdk/multimodal-sdk-ios-lite.md) @@ -237,19 +237,19 @@ - [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) - [调用三方语音模型](raw/application-user-guide/application-gallery/multimodal-products/multimodal-api-references/third-party-voice-integration.md) - - [调用官方Agent](raw/application-user-guide/application-gallery/multimodal-products/multimodal-api-references/official-agent.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/management-hot-words.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/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/long-term-memory-api.md) - **最佳实践** - **接入百炼及三方Agent** - [百炼及三方Agent直连调用](raw/application-user-guide/application-gallery/multimodal-products/multimodal-best-practices/bailian-and-tripartite-agent/agent-direct-call.md) - - [接入百炼工作流应用](raw/application-user-guide/application-gallery/multimodal-products/multimodal-best-practices/bailian-and-tripartite-agent/multimodal-call-workflow.md) - [接入百炼智能体应用](raw/application-user-guide/application-gallery/multimodal-products/multimodal-best-practices/bailian-and-tripartite-agent/multimodal-call-app.md) + - [接入百炼工作流应用](raw/application-user-guide/application-gallery/multimodal-products/multimodal-best-practices/bailian-and-tripartite-agent/multimodal-call-workflow.md) - **接入拍照问答Agent** - [通过HTTP协议接入拍照问答Agent](raw/application-user-guide/application-gallery/multimodal-products/multimodal-best-practices/vqa-agent/vqa-agent-through-the-http-protocol.md) - [通过WebSocket协议接入拍照问答Agent和语音合成](raw/application-user-guide/application-gallery/multimodal-products/multimodal-best-practices/vqa-agent/vqa-agent-via-websocket-protocol.md) @@ -264,73 +264,156 @@ - [接入音乐电台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) - [动作情绪控制实践](raw/application-user-guide/application-gallery/multimodal-products/multimodal-best-practices/action-emotion-control-practice.md) - - [自定义指令实践](raw/application-user-guide/application-gallery/multimodal-products/multimodal-best-practices/custom-directive.md) - [自定义对话角色实践](raw/application-user-guide/application-gallery/multimodal-products/multimodal-best-practices/custom-role.md) + - [自定义指令实践](raw/application-user-guide/application-gallery/multimodal-products/multimodal-best-practices/custom-directive.md) - [音频采集和播放说明](raw/application-user-guide/application-gallery/multimodal-products/multimodal-best-practices/audio-capture-and-playback-instructions.md) - [基于RTOS SDK (License模式) 实现聊天能力](raw/application-user-guide/application-gallery/multimodal-products/multimodal-best-practices/chat-capability-based-on-rtos-sdk.md) - [产品概述](raw/application-user-guide/application-gallery/multimodal-products/multimodal-products-overview.md) - [产品计费](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-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) + - [影视互娱剧本创作](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-guidelines-for-use/film-and-television-script-creation.md) + - [影视传媒视频理解](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-guidelines-for-use/media-video-understanding.md) + - [车机网络热点信息互动问答](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-guidelines-for-use/car-machine-content-platform-news-hot-list-interaction.md) + - [泛企业VOC挖掘](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-guidelines-for-use/pan-enterprise-voc-mining.md) + - [泛企业线索挖掘](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) + - **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) + - **API目录** + - **电商零售推广文案写作** + - [RunMarketingInformationWriting - 电商零售推广文案写作](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-e-commerce-retail-promotion-copy-writing/api-quanmiaolightapp-2024-08-01-runmarketinginformationwriting.md) + - [RunMarketingInformationExtract - 电商零售内容实体抽取](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-e-commerce-retail-promotion-copy-writing/api-quanmiaolightapp-2024-08-01-runmarketinginformationextract.md) + - **影视互娱剧本创作** + - [RunScriptRefine - 影视互娱剧本创作-剧本整理](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-mutual-entertainment-script-creation/api-quanmiaolightapp-2024-08-01-runscriptrefine.md) + - [RunScriptChat - 影视互娱剧本创作-交互式创作](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-mutual-entertainment-script-creation/api-quanmiaolightapp-2024-08-01-runscriptchat.md) + - [RunScriptPlanning - 影视互娱剧本创作-剧本策划](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-mutual-entertainment-script-creation/api-quanmiaolightapp-2024-08-01-runscriptplanning.md) + - [RunScriptContinue - 影视互娱剧本创作-剧本续写](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-mutual-entertainment-script-creation/api-quanmiaolightapp-2024-08-01-runscriptcontinue.md) + - **传媒/零售文章风格与格式学习** + - [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) + - **影视传媒视频理解** + - [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) + - **影视传媒智能拆条** + - [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) + - [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) + - **网络内容安全审核** + - [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) + - [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) + - [SubmitTagMiningAnalysisTask - 提交标签挖掘分析任务](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-submittagmininganalysistask.md) + - [ListHotTopicSummaries - 查询完整播报单（热榜）](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-listhottopicsummaries.md) + - [GetTagMiningAnalysisTask - 获取标签挖掘分析任务结果](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-gettagmininganalysistask.md) + - [HotNewsRecommend - 新闻热点推荐](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-hotnewsrecommend.md) + - [GetFileContent - 获取文件内容](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-getfilecontent.md) + - [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) + - [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) + - [服务接入点](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-endpoint.md) + - [API概览](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-overview.md) + - [授权信息](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-ram.md) + - [版本说明](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-changeset.md) + - [全妙轻应用更新公告](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-update-announcement.md) + - [常见问题](raw/application-user-guide/application-gallery/quanmiao-light-application-series/quanmiao-lightapp-faq.md) - **官方应用-通义晓蜜CCAI-对话分析AIO** - **使用指南** - [如何开通通义晓蜜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/hot-phrase-management.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) - **API参考** - **API目录** - - **不推荐或白名单开放** - - [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) - **热词管理** - [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) - - [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) - [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) + - **不推荐或白名单开放** + - [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) - - [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) - [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) - [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) - [通过任务类型调用通义晓蜜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) - - [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-对话分析](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) - - [通义晓蜜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) + - [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) - - **最佳实践** - - [客服服务质检最佳实践](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-对话分析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) - [通义晓蜜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) - - [计费说明（通义晓蜜对话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/product-overview-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) - - [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) + - [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) - **变量管理** - [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) @@ -338,8 +421,8 @@ - [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) - - [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) - [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) - **热词管理** @@ -348,23 +431,23 @@ - [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) - - [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) - [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) - **克隆音管理** - [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) - [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) - - [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) - **应用管理** - [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) - - [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) - [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) - - [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) + - [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) - [GetApplication - 获取语音机器人应用](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-getapplication.md) - [UpdateApplicationVersion - 修改语音机器人应用版本](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-updateapplicationversion.md) @@ -378,152 +461,69 @@ - [语音对话机器人产品概述](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) - - **官方应用-全妙轻应用系列** - - **计费说明（全妙轻应用）** - - [电商零售推广文案写作计费](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/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) - - [影视互娱剧本创作计费](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/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/pan-enterprise-lead-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/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) - - [影视互娱剧本创作](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-guidelines-for-use/film-and-television-script-creation.md) - - [影视传媒视频理解](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-guidelines-for-use/media-video-understanding.md) - - [车机网络热点信息互动问答](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-guidelines-for-use/car-machine-content-platform-news-hot-list-interaction.md) - - [泛企业VOC挖掘](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-guidelines-for-use/pan-enterprise-voc-mining.md) - - [泛企业线索挖掘](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/composition-correction-assistant.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/development-documentation/light-application-best-practices/best-practices-for-applying-video-understanding-and-one-click-film.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) - - **API目录** - - **电商零售推广文案写作** - - [RunMarketingInformationExtract - 电商零售内容实体抽取](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-e-commerce-retail-promotion-copy-writing/api-quanmiaolightapp-2024-08-01-runmarketinginformationextract.md) - - [RunMarketingInformationWriting - 电商零售推广文案写作](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-e-commerce-retail-promotion-copy-writing/api-quanmiaolightapp-2024-08-01-runmarketinginformationwriting.md) - - **影视互娱剧本创作** - - [RunScriptRefine - 影视互娱剧本创作-剧本整理](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-mutual-entertainment-script-creation/api-quanmiaolightapp-2024-08-01-runscriptrefine.md) - - [RunScriptChat - 影视互娱剧本创作-交互式创作](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-mutual-entertainment-script-creation/api-quanmiaolightapp-2024-08-01-runscriptchat.md) - - [RunScriptPlanning - 影视互娱剧本创作-剧本策划](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-mutual-entertainment-script-creation/api-quanmiaolightapp-2024-08-01-runscriptplanning.md) - - [RunScriptContinue - 影视互娱剧本创作-剧本续写](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-mutual-entertainment-script-creation/api-quanmiaolightapp-2024-08-01-runscriptcontinue.md) - - **传媒/零售文章风格与格式学习** - - [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) - - [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) - - [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) - - [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) - - [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) - - [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) - - **影视传媒智能拆条** - - [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) - - [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) - - **车机网络热点信息互动问答** - - [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) - - **作文批改** - - [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) - - [SubmitTagMiningAnalysisTask - 提交标签挖掘分析任务](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-submittagmininganalysistask.md) - - [ListHotTopicSummaries - 查询完整播报单（热榜）](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-listhottopicsummaries.md) - - [GetTagMiningAnalysisTask - 获取标签挖掘分析任务结果](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-gettagmininganalysistask.md) - - [HotNewsRecommend - 新闻热点推荐](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-hotnewsrecommend.md) - - [GetFileContent - 获取文件内容](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-getfilecontent.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) - - [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) - - [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) - - [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) - - [API概览](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-overview.md) - - [服务接入点](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-endpoint.md) - - [授权信息](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-ram.md) - - [版本说明](raw/application-user-guide/application-gallery/quanmiao-light-application-series/development-documentation/api-reference-1/api-quanmiaolightapp-2024-08-01-changeset.md) - - [全妙轻应用更新公告](raw/application-user-guide/application-gallery/quanmiao-light-application-series/light-application-update-announcement.md) - - [常见问题](raw/application-user-guide/application-gallery/quanmiao-light-application-series/quanmiao-lightapp-faq.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目录** + - **平台能力-文档库** + - [UpdateDocumentChunk - 更新文档块内容](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-updatedocumentchunk.md) + - [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) + - [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) + - [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) + - [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) + - [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) + - [GetHistoryListByBizType - 根据业务类型获取对话历史记录](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-gethistorylistbybiztype.md) - **平台能力-应用** - [EndToEndRealTimeDialog - 语音实时对话](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-endtoendrealtimedialog.md) - [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) - - [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) - [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) - - [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) - - [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) - - [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) - - [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) + - [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) - [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) - [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) - [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) - - [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) - [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) - - [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) - - [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) - [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) - [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) - - **平台能力-文档库** - - [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) - - [UpdateDocumentChunk - 更新文档块内容](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-updatedocumentchunk.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) - - [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) - - [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) - - [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) - - [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) - - [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) - - [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) - - [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) - - [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) - - [GetHistoryListByBizType - 根据业务类型获取对话历史记录](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-gethistorylistbybiztype.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,91 +535,95 @@ - **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-information-extraction.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-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-tagging.md) - [文档删除](raw/application-user-guide/application-gallery/tongyi-docmining/docmining-api-reference/docmining-api-directory/document-delete.md) - - [服务接入点](raw/application-user-guide/application-gallery/tongyi-docmining/docmining-api-reference/docmining-service-access-point.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) - [错误码](raw/application-user-guide/application-gallery/tongyi-docmining/docmining-api-reference/docmining-error-code.md) - [通义数据挖掘产品介绍](raw/application-user-guide/application-gallery/tongyi-docmining/docmining-product-introduction.md) - - **官方应用-通义深度搜索** - - **API参考** - - **API目录** - - [生成对话](raw/application-user-guide/application-gallery/tongyi-deepsearch/deepsearch-api-reference/deepsearch-api-list/deepsearch-chat-generate.md) - - [上传文件](raw/application-user-guide/application-gallery/tongyi-deepsearch/deepsearch-api-reference/deepsearch-api-list/deepsearch-file-upload.md) - - [生成报告导出](raw/application-user-guide/application-gallery/tongyi-deepsearch/deepsearch-api-reference/deepsearch-api-list/deepsearch-report-export.md) - - [对话文件管理](raw/application-user-guide/application-gallery/tongyi-deepsearch/deepsearch-api-reference/deepsearch-api-list/deepsearch-session-file-management.md) - - [对接自有知识库](raw/application-user-guide/application-gallery/tongyi-deepsearch/deepsearch-api-reference/deepsearch-api-list/docking-self-built-database.md) - - [API概览](raw/application-user-guide/application-gallery/tongyi-deepsearch/deepsearch-api-reference/deepsearch-api-overview.md) - - [服务接入节点](raw/application-user-guide/application-gallery/tongyi-deepsearch/deepsearch-api-reference/deepsearch-service-access-point.md) - - [错误码-通义深度搜索](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) - **官方应用-通义多模态翻译** - **API参考** - **API目录** - **文本翻译** - - [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) - [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) + - [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) - - [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) - [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) - - [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) - **图片翻译** - - [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) + - [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) - **文档翻译** - [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) - - [服务接入点](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-endpoint.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) + - **官方应用-通义深度搜索** + - **API参考** + - **API目录** + - [生成对话](raw/application-user-guide/application-gallery/tongyi-deepsearch/deepsearch-api-reference/deepsearch-api-list/deepsearch-chat-generate.md) + - [上传文件](raw/application-user-guide/application-gallery/tongyi-deepsearch/deepsearch-api-reference/deepsearch-api-list/deepsearch-file-upload.md) + - [对话文件管理](raw/application-user-guide/application-gallery/tongyi-deepsearch/deepsearch-api-reference/deepsearch-api-list/deepsearch-session-file-management.md) + - [生成报告导出](raw/application-user-guide/application-gallery/tongyi-deepsearch/deepsearch-api-reference/deepsearch-api-list/deepsearch-report-export.md) + - [对接自有知识库](raw/application-user-guide/application-gallery/tongyi-deepsearch/deepsearch-api-reference/deepsearch-api-list/docking-self-built-database.md) + - [API概览](raw/application-user-guide/application-gallery/tongyi-deepsearch/deepsearch-api-reference/deepsearch-api-overview.md) + - [服务接入节点](raw/application-user-guide/application-gallery/tongyi-deepsearch/deepsearch-api-reference/deepsearch-service-access-point.md) + - [错误码-通义深度搜索](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.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) - **官方应用-全妙解决方案类产品** + - **妙搜和妙读** + - **使用指南** + - [妙搜](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaosou-and-miaodu/miaodou-and-miaodu-guidelines-for-use/ai-miaosou.md) + - [计费说明（妙搜和妙读）](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaosou-and-miaodu/miaosou-miaodu-api-billing.md) - **妙笔、妙策和审校** - **使用指南** - **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/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/direct-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) - - [系统配置](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/usage-guide/amb/system-configuration.md) + - [AI工具箱](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/usage-guide/amb/ai-toolbox.md) - [素材库](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/usage-guide/amb/material-library.md) + - [系统配置](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/usage-guide/amb/system-configuration.md) - [文章风格和格式学习](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/usage-guide/amb/style-imitation.md) - - [AI工具箱](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/usage-guide/amb/ai-toolbox.md) - [AI妙策](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/usage-guide/ai-miaoce.md) - [智能审校](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) - - **政务公文写作指导** - - [分步式撰写政务稿（精准控制章节内容）](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/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) - [常见FAQ](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/document-writing-best-practices/faq-for-using-quanmiao-series-products.md) - **更新公告** - **功能更新** @@ -630,30 +634,29 @@ - [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) - - [计费说明（PPT生成）](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/ppt-generation-billing.md) - [计费说明（政务公文配套工具）](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/government-document-tool-billing.md) + - [计费说明（PPT生成）](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/ppt-generation-billing.md) - [计费说明（妙策-自定义数据源）](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/billing-document-miaoce-custom-data-source.md) - [计费说明（视频混剪）](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaobi-miaoce-shenjiao/billing-description-video-mixing.md) - - **妙搜和妙读** - - **使用指南** - - [妙搜](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaosou-and-miaodu/miaodou-and-miaodu-guidelines-for-use/ai-miaosou.md) - - [计费说明（妙搜和妙读）](raw/application-user-guide/application-gallery/quanmiao-solution-products/miaosou-and-miaodu/miaosou-miaodu-api-billing.md) - **开发文档** - **API参考** - **数据结构** - - [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) + - [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) - [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) - - [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) - - [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) - [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) - [WritingStyleTemplateField](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-writingstyletemplatefield.md) - **API目录** + - **通用接口-文件上传下载** + - [GenerateFileUrlByKey - 生成文件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-common-interface-file-upload-and-download/api-aimiaobi-2023-08-01-generatefileurlbykey.md) + - [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) - - [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) - [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) - **通用接口-异步任务管理** - [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) @@ -662,89 +665,84 @@ - [ListAsyncTasks - 获取异步任务列表](raw/application-user-guide/application-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-listasynctasks.md) - **通用接口-通用配置** - [CreateGeneralConfig - 通用配置-创建](raw/application-user-guide/application-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-common-configuration/api-aimiaobi-2023-08-01-creategeneralconfig.md) - - [GetGeneralConfig - 通用配置-详情](raw/application-user-guide/application-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-common-configuration/api-aimiaobi-2023-08-01-getgeneralconfig.md) - [ListGeneralConfigs - 通用配置-列表](raw/application-user-guide/application-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-common-configuration/api-aimiaobi-2023-08-01-listgeneralconfigs.md) + - [GetGeneralConfig - 通用配置-详情](raw/application-user-guide/application-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-common-configuration/api-aimiaobi-2023-08-01-getgeneralconfig.md) - [UpdateGeneralConfig - 通用配置-修改](raw/application-user-guide/application-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-common-configuration/api-aimiaobi-2023-08-01-updategeneralconfig.md) - [DeleteGeneralConfig - 通用配置-删除](raw/application-user-guide/application-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-common-configuration/api-aimiaobi-2023-08-01-deletegeneralconfig.md) - **妙笔-创作文章** - [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) - - [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) - [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) - - [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) + - [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) - [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) - [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) - - [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) - [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) - [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) - - [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) - - [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) - [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) - [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) - - **通用接口-文件上传下载** - - [GenerateFileUrlByKey - 生成文件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-common-interface-file-upload-and-download/api-aimiaobi-2023-08-01-generatefileurlbykey.md) - - [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) + - [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) - - [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) - [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) - - [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) - [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) - - [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) + - [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) - **妙笔-文章审校-词库管理** - [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) - [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) - [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) - - [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) + - [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) - [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) - [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) - - [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) - **妙笔-文章审校** - [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) - - [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) + - [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) - [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) - **妙笔-文档管理** - - [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) - [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) - - [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) - [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) - - **妙笔-视频混剪** - - [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) - - [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) - - [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) - - [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) - - [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) + - **妙笔-素材库** + - [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) @@ -752,61 +750,47 @@ - [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) - - **妙笔-素材库** - - [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) + - **妙笔-视频混剪** + - [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) + - [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) - **妙策-自定义数据源** - [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) - **妙策-选题热点** - - [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) + - [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) - [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) - - [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) + - [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) - [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) - - [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) - [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) - - **公文库检索** - - [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) + - [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) - **妙策-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) - - [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) - - **妙策-自定义话题** - - [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) - - **妙搜-数据源** - - [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) - - [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) - - [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) - - [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) - - [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) - - [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) - - [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) - - **妙策-新闻播报** - - [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) + - [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) - **妙策-企业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) @@ -814,111 +798,127 @@ - [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) - [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) + - [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) + - [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) - **系统配置-干预配置** - - [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) - - [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) + - [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) - [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) - - [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) + - [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) - [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) - - [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) - [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) - [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) - - [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) + - [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) - - [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) - - **妙搜-智能搜索** - - [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) - - [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) - - [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) + - **系统配置-信源管理** + - [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) - **妙读-生成类** - [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) - - [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) - [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) - - [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) - [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) - **妙读-抽取类** - [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) - - **系统配置-信源管理** - - [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) - **妙读-问答类** - [RunGenerateQuestions - 猜你想问](raw/application-user-guide/application-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-question-and-answer-class/api-aimiaobi-2023-08-01-rungeneratequestions.md) - [RunDocQa - 文档问答（文章问答/多模态文件问答）](raw/application-user-guide/application-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-question-and-answer-class/api-aimiaobi-2023-08-01-rundocqa.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) + - **妙读-其他** + - [RunDocTranslation - 文档翻译](raw/application-user-guide/application-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-rundoctranslation.md) + - [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) - **深度写作** - - [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) + - [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) - [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) - - **妙读-其他** - - [RunDocTranslation - 文档翻译](raw/application-user-guide/application-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-rundoctranslation.md) - - [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) - **PPT生成** - - [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) + - [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) - [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) - - [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) - [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) - [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) + - **标书生成** + - [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) + - [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) + - [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) - **其他** - - [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) - [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) - [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) - - [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) - [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) - - **标书生成** - - [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) - - [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) - - [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) - [服务接入点](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-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) + - [授权信息](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/amb-api-reference/api-aimiaobi-2023-08-01-ram.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) - - [妙搜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) - [智能审校最佳实践](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) - - [妙读最佳实践](raw/application-user-guide/application-gallery/quanmiao-solution-products/ai-quan-miao-development-document/miaobi-and-miaoce-best-practices/miaodu-best-practices.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) + - [妙读最佳实践](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/quanmiao-more/quanmiao-slr.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) - [妙笔写作信源对接](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) @@ -926,9 +926,6 @@ - [官方应用-通义听悟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-support/application-faq.md) - - [相关协议](raw/application-user-guide/application-support/application-related-agreements.md) - **权限管理** - [权限管理](raw/application-user-guide/application-permission-management/application-permission-management-overview.md) - **实践教程** @@ -937,102 +934,92 @@ - [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) - [基于本地知识库构建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) + - [相关协议](raw/application-user-guide/application-support/application-related-agreements.md) ## 模型 API 参考 - **使用 API** - - [获取API Key](raw/model-api-reference/preparations/get-api-key.md) - [安装SDK](raw/model-api-reference/preparations/install-sdk.md) + - [获取API Key](raw/model-api-reference/preparations/get-api-key.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) - **万相** - [万相-文生图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) - [万相-图像生成与编辑2.7 API参考](raw/model-api-reference/image-generation/wan-image-api-reference/wan-image-generation-and-editing-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) + - [万相-图像生成与编辑2.6 API参考](raw/model-api-reference/image-generation/wan-image-api-reference/wan-image-generation-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/wan-image-api-reference/wanx-image-edit-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/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/image-scaling-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-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/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/wanx-background-generation-api-reference.md) - - [AI试衣OutfitAnyone](raw/model-api-reference/image-generation/image-creative-tools-api-reference/outfitanyone.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/wanx-background-generation-api-reference.md) - [人物写真生成FaceChain](raw/model-api-reference/image-generation/image-creative-tools-api-reference/facechain-portrait-generation.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) - [常见问题](raw/model-api-reference/image-generation/image-faq.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) + - [实时多模态交互流程](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) - **更多模型** - - [意图理解能力](raw/model-api-reference/more-models/intent-detect-capability.md) - [通义法睿大语言模型](raw/model-api-reference/more-models/tongyi-farui-api.md) + - [意图理解能力](raw/model-api-reference/more-models/intent-detect-capability.md) - [Qwen-MT API参考](raw/model-api-reference/more-models/qwen-mt-api.md) - [Qwen-Deep-Research API 参考](raw/model-api-reference/more-models/qwen-deep-research-api.md) - [Qwen-OCR API参考](raw/model-api-reference/more-models/qwen-vl-ocr-api-reference.md) - [GUI-Plus API参考](raw/model-api-reference/more-models/gui-plus-interface-interaction-model.md) -- **实时多模态** - - [客户端事件](raw/model-api-reference/omni-realtime-api/client-events.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) - - [实时多模态交互流程](raw/model-api-reference/omni-realtime-api/omni-realtime-interaction-process.md) - - [Java SDK](raw/model-api-reference/omni-realtime-api/omni-realtime-java-sdk.md) - - [声音复刻API参考](raw/model-api-reference/omni-realtime-api/qwen-omni-voice-cloning.md) - **工具包/框架** - - [OpenAI Responses接口兼容](raw/model-api-reference/toolkits-and-frameworks/compatibility-with-openai-responses-api.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 Vision接口兼容](raw/model-api-reference/toolkits-and-frameworks/qwen-vl-compatible-with-openai.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) - - [OpenAI兼容-Batch Chat](raw/model-api-reference/toolkits-and-frameworks/openai-compatible-batch-chat.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) - - [在LangChain中使用阿里云百炼](raw/model-api-reference/toolkits-and-frameworks/use-bailian-in-langchain.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 Conversations接口兼容](raw/model-api-reference/toolkits-and-frameworks/openai-compatible-conversations.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) - - [模型压缩](raw/model-api-reference/model-production/model-compression-api.md) - [模型部署](raw/model-api-reference/model-production/deployments-api.md) - **更多** - [生成临时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) - - [通过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) - - [上传本地文件获取临时URL](raw/model-api-reference/more-about-models/get-temporary-file-url.md) + - [通过HTTP回调URL或MQ接收异步任务完成通知](raw/model-api-reference/more-about-models/async-task-api.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-reference-to-video-api-reference.md) - - [HappyHorse-视频编辑API参考](raw/model-api-reference/video-generation-api/happyhorse-api-reference/happyhorse-video-edit-api-reference.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) - - [视频口型替换-声动人像VideoRetalk](raw/model-api-reference/video-generation-api/portrait-animation-api-reference/videoretalk.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) - - [视频风格重绘API参考](raw/model-api-reference/video-generation-api/portrait-animation-api-reference/video-style-transform-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) - [万相-文生视频API参考（2.1-2.6）](raw/model-api-reference/video-generation-api/wan-api-reference/legacy-video-models/legacy-wan-text-to-video-api-reference.md) - - [万相-视频编辑API参考（2.1）](raw/model-api-reference/video-generation-api/wan-api-reference/legacy-video-models/legacy-wanx-vace-api-reference.md) - [万相-参考生视频API参考（2.6）](raw/model-api-reference/video-generation-api/wan-api-reference/legacy-video-models/legacy-wan-reference-to-video-api-reference.md) - [万相-首尾帧生视频API参考（2.2）](raw/model-api-reference/video-generation-api/wan-api-reference/legacy-video-models/legacy-image-to-video-by-first-and-last-frame-api-reference.md) + - [万相-视频编辑API参考（2.1）](raw/model-api-reference/video-generation-api/wan-api-reference/legacy-video-models/legacy-wanx-vace-api-reference.md) - [万相2.7-图生视频API参考](raw/model-api-reference/video-generation-api/wan-api-reference/image-to-video-general-api-reference.md) - [万相2.7-文生视频API参考](raw/model-api-reference/video-generation-api/wan-api-reference/text-to-video-api-reference.md) - [万相2.7-参考生视频API参考](raw/model-api-reference/video-generation-api/wan-api-reference/wan-video-to-video-api-reference.md) @@ -1040,34 +1027,46 @@ - [万相-图生动作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) + - **人像驱动** + - [图生舞蹈视频-舞动人像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) - **爱诗** - [爱诗-文生视频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-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-image-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) - **音频** - **语音识别** - - **实时语音识别（Qwen-ASR-Realtime）** - - [Qwen-ASR实时语音识别WebSocket API](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/qwen-asr-realtime-api/qwen-asr-realtime-interaction-process.md) - - [实时语音识别（Qwen-ASR-Realtime）客户端事件](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/qwen-asr-realtime-api/qwen-asr-realtime-client-events.md) - - [实时语音识别（Qwen-ASR-Realtime）Python SDK-API参考](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/qwen-asr-realtime-api/qwen-asr-realtime-python-sdk.md) - - [实时语音识别（Qwen-ASR-Realtime）Java SDK-API参考](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/qwen-asr-realtime-api/qwen-asr-realtime-java-sdk.md) - - [实时语音识别（Qwen-ASR-Realtime）服务端事件](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/qwen-asr-realtime-api/qwen-asr-realtime-server-events.md) - **实时语音识别（Fun-ASR）** - [Fun-ASR实时语音识别WebSocket API](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/fun-asr-realtime-websocket-api.md) - [实时语音识别（Fun-ASR）客户端事件](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/fun-asr-client-events.md) - - [Python SDK](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/fun-asr-realtime-python-sdk.md) - [实时语音识别（Fun-ASR）服务端事件](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/fun-asr-server-events.md) + - [Python SDK](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/fun-asr-realtime-python-sdk.md) - [Java SDK](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/fun-asr-realtime-java-sdk.md) - [Fun-ASR实时语音识别Android SDK](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/android-sdk-for-fun-asr-real-time-service.md) - [Fun-ASR实时语音识别iOS SDK](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/ios-sdk-for-fun-asr-real-time-service.md) + - **实时语音识别（Qwen-ASR-Realtime）** + - [Qwen-ASR实时语音识别WebSocket API](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/qwen-asr-realtime-api/qwen-asr-realtime-interaction-process.md) + - [实时语音识别（Qwen-ASR-Realtime）客户端事件](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/qwen-asr-realtime-api/qwen-asr-realtime-client-events.md) + - [实时语音识别（Qwen-ASR-Realtime）服务端事件](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/qwen-asr-realtime-api/qwen-asr-realtime-server-events.md) + - [实时语音识别（Qwen-ASR-Realtime）Python SDK-API参考](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/qwen-asr-realtime-api/qwen-asr-realtime-python-sdk.md) + - [实时语音识别（Qwen-ASR-Realtime）Java SDK-API参考](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/qwen-asr-realtime-api/qwen-asr-realtime-java-sdk.md) - **实时语音识别（Paraformer）** - [Paraformer实时语音识别WebSocket API](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/paraformer-real-time-speech-recognition-api-reference/websocket-for-paraformer-real-time-service.md) - [实时语音识别（Paraformer）客户端事件](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/paraformer-real-time-speech-recognition-api-reference/paraformer-client-events.md) @@ -1078,14 +1077,14 @@ - [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录音文件识别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录音文件识别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录音文件识别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录音文件识别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录音文件识别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录音文件识别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录音文件识别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) @@ -1094,25 +1093,27 @@ - [定制热词HTTP API参考](raw/model-api-reference/audio-api-references/speech-recognition-api-reference/custom-hot-words/vocabulary-http-api.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) - [CosyVoice客户端事件](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/cosyvoice-large-model-for-speech-synthesis/cosyvoice-client-events.md) - [CosyVoice服务端事件](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/cosyvoice-large-model-for-speech-synthesis/cosyvoice-server-events.md) - - [语音合成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 Python SDK](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/cosyvoice-large-model-for-speech-synthesis/cosyvoice-python-sdk.md) - [实时语音合成CosyVoice Java SDK](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/cosyvoice-large-model-for-speech-synthesis/cosyvoice-java-sdk.md) + - [实时语音合成CosyVoice Python SDK](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/cosyvoice-large-model-for-speech-synthesis/cosyvoice-python-sdk.md) + - [语音合成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-server-events.md) - - [客户端事件](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/qwen-tts-realtime-api-reference/qwen-tts-realtime-client-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-server-events.md) - [Sambert客户端事件](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/sambert-speech-synthesis/sambert-client-events.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) - [语音合成Sambert Android SDK](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/sambert-speech-synthesis/sambert-android-sdk.md) @@ -1129,13 +1130,11 @@ - [声音复刻Python SDK参考](raw/model-api-reference/audio-api-references/speech-synthesis-api-reference/sound-reengraving/voice-clone-design-python-sdk.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）Python SDK-API参考](raw/model-api-reference/audio-api-references/speech-translation-api-reference/live-translator-api/qwen-livetranslate-python-sdk.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) - [音视频翻译-通义千问 API 参考](raw/model-api-reference/audio-api-references/speech-translation-api-reference/qwen3-livetranslate-flash-api.md) - **向量与排序** @@ -1152,43 +1151,33 @@ ## 应用 API 参考 - **Managed Agents** - - [Agent](raw/application-api-reference/managed-agents-api/agent-api.md) - - [API 总览与认证](raw/application-api-reference/managed-agents-api/managed-agents-api-overview.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) - - [File](raw/application-api-reference/managed-agents-api/files-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) -- **应用调用** - - **Responses API** - - [同步调用 API 参考](raw/application-api-reference/application-call/openai-responses-api/synchronous-call-api-reference.md) - - [异步调用API参考](raw/application-api-reference/application-call/openai-responses-api/asynchronous-call-api-reference.md) - - **DashScope API** - - [新版智能体应用 API 参考](raw/application-api-reference/application-call/application-dashscope-api-reference/new-agent-application-api-reference.md) - - [工作流与旧版智能体应用 API](raw/application-api-reference/application-call/application-dashscope-api-reference/agent-and-workflow-application-api-reference.md) - - [获取APP ID和Workspace ID](raw/application-api-reference/application-call/obtain-the-app-id-and-workspace-id.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) - [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) - - [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) - - [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) - [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) - [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) - - [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) - [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) - [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) - - [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) - [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) - [AddConnector - 新增连接器](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-addconnector.md) - [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) @@ -1204,9 +1193,9 @@ - [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) + - [ListChunks - 查询索引下的分片列表](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-listchunks.md) - [UpdateChunk - 修改切片](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-updatechunk.md) - [DeleteChunk - 删除切片](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-deletechunk.md) - - [ListChunks - 查询索引下的分片列表](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-listchunks.md) - [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) @@ -1216,23 +1205,33 @@ - [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) - **其他** - **长期记忆（旧）** - - [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) - [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) + - [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) - [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) - - [DeleteMemoryNode - 删除记忆片段](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-deletememorynode.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) + - [DeleteMemoryNode - 删除记忆片段](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-deletememorynode.md) - [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) - [GetAlipayTransferStatus - 查询支付宝打赏状态](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-getalipaytransferstatus.md) - [GetAlipayUrl - 获取支付宝打赏URL](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-getalipayurl.md) - [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-ram.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) +- **应用调用** + - **DashScope API** + - [新版智能体应用 API 参考](raw/application-api-reference/application-call/application-dashscope-api-reference/new-agent-application-api-reference.md) + - [应用 DashScope API 参考](raw/application-api-reference/application-call/application-dashscope-api-reference/agent-and-workflow-application-api-reference.md) + - **Responses API** + - [同步调用 API 参考](raw/application-api-reference/application-call/openai-responses-api/synchronous-call-api-reference.md) + - [异步调用API参考](raw/application-api-reference/application-call/openai-responses-api/asynchronous-call-api-reference.md) + - [获取APP ID和Workspace ID](raw/application-api-reference/application-call/obtain-the-app-id-and-workspace-id.md) - **框架** - **Spring AI Alibaba** - [使用Spring AI Alibaba集成阿里云百炼大模型应用](raw/application-api-reference/frameworks/spring-ai-alibaba/spring-ai-alibaba-integrate-llm-application.md) diff --git a/skills/bailian-docs-llm-wiki/models/index.json b/skills/bailian-docs-llm-wiki/models/index.json index 7ca55d0..ec76bf1 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-06", + "updatedAt": "2026-07-07", "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 47883af..18deb28 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-06 +> 自动生成 · 共 164 个模型家族 · 370 个主干模型 · 更新于 2026-07-07 **机器查询走结构化文件**： diff --git a/skills/bailian-docs-llm-wiki/raw/application-api-reference/application-call/application-dashscope-api-reference/agent-and-workflow-application-api-reference.md b/skills/bailian-docs-llm-wiki/raw/application-api-reference/application-call/application-dashscope-api-reference/agent-and-workflow-application-api-reference.md index 9e6e246..6135228 100644 --- a/skills/bailian-docs-llm-wiki/raw/application-api-reference/application-call/application-dashscope-api-reference/agent-and-workflow-application-api-reference.md +++ b/skills/bailian-docs-llm-wiki/raw/application-api-reference/application-call/application-dashscope-api-reference/agent-and-workflow-application-api-reference.md @@ -1,4 +1,4 @@ -# 工作流与旧版智能体应用 API +# 应用 DashScope API 参考 本文介绍 DashScope API 调用阿里云百炼应用（**智能体**、**工作流**）的输入与输出参数，并提供典型场景下的调用示例。 @@ -4563,13 +4563,6 @@ API 调用时，通过 `user_defined_params` 以 `mcp_id` 为 key 传入对应 组合逻辑： 不同键之间为“与”(AND) 逻辑。例如，`"author": "John.Doe", "source": ["internal_wiki", "public_docs"]` 表示筛选出作者是 "John.Doe" 并且来源是 "internal\_wiki" 或 "public\_docs" 的文档。 - - - - - - - > Java SDK 中为 **metadataFilter**。 @@ -4612,13 +4605,6 @@ API 调用时，通过 `user_defined_params` 以 `mcp_id` 为 key 传入对应 组合逻辑： 不同键之间为“与”(AND) 逻辑。例如，`"year": 2024, "department": ["技术部", "产品部"]` 表示筛选出年份是 2024 并且 部门是 "技术部" 或 "产品部" 的文档切片。 - - - - - - - > Java SDK 中为 **structuredFilter**。 @@ -4960,6 +4946,10 @@ message=Invalid API-key provided. 模型引用的文档名。 +**doc\_url** `_string_` + +模型引用的文档链接，若文档保存于阿里云百炼平台的安全存储空间中时为`null`。 + **text** `_string_` 模型引用的具体文本内容。 diff --git a/skills/bailian-docs-llm-wiki/raw/application-api-reference/managed-agents-api/managed-agents-quickstart.md b/skills/bailian-docs-llm-wiki/raw/application-api-reference/managed-agents-api/managed-agents-quickstart.md index aabd7fa..bc56924 100644 --- a/skills/bailian-docs-llm-wiki/raw/application-api-reference/managed-agents-api/managed-agents-quickstart.md +++ b/skills/bailian-docs-llm-wiki/raw/application-api-reference/managed-agents-api/managed-agents-quickstart.md @@ -1,6 +1,6 @@ # 快速开始 -五分钟跑通 Managed Agents 全链路：创建 Agent、开启 Session、发送消息并流式接收回复。 +五分钟跑通 Managed Agents 全链路：创建 Agent 与 Environment、开启 Session、提交任务并流式接收执行结果。 ## 前提 @@ -16,15 +16,17 @@ ## 调用流程 -一次完整的对话分四步： +一次完整的任务执行分五步： 1. **创建 Agent**：定义模型与系统提示词，得到 `agent_xxx`。Agent 通常只创建一次并长期复用。 -2. **创建 Session**：绑定 Agent，得到 `sesn_xxx`。每轮对话新建一个 Session。 +2. **创建 Environment**：定义运行环境，得到 `env_xxx`。Environment 通常只创建一次并长期复用。 -3. **发送 Event**：向 Session 写入用户消息，触发 Agent 进入 `running`。 +3. **创建 Session**：绑定 Agent 与 Environment，得到 `sesn_xxx`。 -4. **订阅 SSE**：以事件流方式接收回复，直至 Session 回到 `idle`。 +4. **发送 Event**：向 Session 提交任务指令，触发 Agent 进入 `running`。 + +5. **订阅 SSE**：以事件流方式接收执行结果，直至 Session 回到 `idle`。 ## 安装 SDK @@ -48,7 +50,7 @@ Java ## 端到端示例 -下例创建一个纯对话 Agent，开启 Session 后发送一条消息并流式接收回复。 +下例创建一个代码生成 Agent，开启 Session 后提交一个编码任务并流式接收执行结果。 Bash @@ -58,31 +60,38 @@ AGENT_ID=$(curl -s -X POST "$AGENTSTUDIO_URL/agents" \ -H "Authorization: Bearer $DASHSCOPE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ - "name": "quickstart-assistant", + "name": "quickstart-coder", "model": {"id": "qwen-plus"}, - "system": "你是一个有帮助的助手。" + "system": "你是一位 Python 专家。用户提交编码任务后，直接输出简洁、可运行的 Python 代码。" }' | jq -r '.id') echo "Agent: $AGENT_ID" -## 2. 创建 Session +## 2. 创建 Environment +ENV_ID=$(curl -s -X POST "$AGENTSTUDIO_URL/environments" \ + -H "Authorization: Bearer $DASHSCOPE_API_KEY" \ + -H "Content-Type: application/json" \ + -d '{"name": "quickstart-env", "config": {"type": "cloud"}}' | jq -r '.id') +echo "Environment: $ENV_ID" + +## 3. 创建 Session SESSION_ID=$(curl -s -X POST "$AGENTSTUDIO_URL/sessions" \ -H "Authorization: Bearer $DASHSCOPE_API_KEY" \ -H "Content-Type: application/json" \ - -d "{\"agent\": \"$AGENT_ID\"}" | jq -r '.id') + -d "{\"agent\": \"$AGENT_ID\", \"environment_id\": \"$ENV_ID\"}" | jq -r '.id') echo "Session: $SESSION_ID" -## 3. 发送用户消息 +## 4. 提交任务 curl -X POST "$AGENTSTUDIO_URL/sessions/$SESSION_ID/events" \ -H "Authorization: Bearer $DASHSCOPE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "input": [ {"role": "user", "type": "message", - "content": [{"type": "text", "text": "你好，请介绍一下自己"}]} + "content": [{"type": "text", "text": "写一个 Python 函数，接收一个整数列表并返回去重后的有序列表。"}]} ] }' -## 4. 订阅 SSE 事件流，接收 Agent 回复 +## 5. 订阅 SSE 事件流，接收执行结果 curl -N "$AGENTSTUDIO_URL/sessions/$SESSION_ID/events/stream" \ -H "Authorization: Bearer $DASHSCOPE_API_KEY" \ -H "Accept: text/event-stream" @@ -102,21 +111,24 @@ client = Client( # 1. 创建 Agent agent = client.agents.create( - name="quickstart-assistant", + name="quickstart-coder", model="qwen-plus", - system_prompt="你是一个有帮助的助手。", + system_prompt="你是一位 Python 专家。用户提交编码任务后，直接输出简洁、可运行的 Python 代码。", ) -# 2. 创建 Session -session = client.sessions.create(agent=agent.id) -print(f"Agent: {agent.id}, Session: {session.id}") +# 2. 创建 Environment +env = client.environments.create(name="quickstart-env", config={"type": "cloud"}) -# 3. 发送用户消息 +# 3. 创建 Session +session = client.sessions.create(agent=agent.id, environment_id=env.id) +print(f"Agent: {agent.id}, Environment: {env.id}, Session: {session.id}") + +# 4. 提交任务 client.sessions.events.send( - session.id, [user_message("你好，请介绍一下自己")] + session.id, events=[user_message("写一个 Python 函数，接收一个整数列表并返回去重后的有序列表。")] ) -# 4. 流式接收回复 +# 5. 流式接收执行结果 with client.sessions.events.stream(session.id) as stream: for event in stream: print(event, flush=True) @@ -130,6 +142,7 @@ Java import com.alibaba.dashscope.agentstudio.*; import com.alibaba.dashscope.agentstudio.model.*; import com.alibaba.dashscope.agentstudio.param.*; +import java.util.Collections; // 1. 创建客户端（自动读取 DASHSCOPE_API_KEY 环境变量） AgentStudioClient client = AgentStudioClient.builder() @@ -138,20 +151,28 @@ AgentStudioClient client = AgentStudioClient.builder() // 2. 创建 Agent Agent agent = client.agents().create(AgentCreateParam.builder() - .name("quickstart-assistant") + .name("quickstart-coder") .model("qwen-plus") - .instructions("你是一个有帮助的助手。") + .instructions("你是一位 Python 专家。用户提交编码任务后，直接输出简洁、可运行的 Python 代码。") + .build()); + +// 3. 创建 Environment +Environment env = client.environments().create(EnvironmentCreateParam.builder() + .name("quickstart-env") + .config(Map.of("type", "cloud")) .build()); -// 3. 创建 Session +// 4. 创建 Session Session session = client.sessions().create(SessionCreateParam.builder() .agentId(agent.getId()) + .environmentId(env.getId()) .build()); -System.out.println("Agent: " + agent.getId() + ", Session: " + session.getId()); +System.out.println("Agent: " + agent.getId() + ", Environment: " + env.getId() + ", Session: " + session.getId()); -// 4. 发送用户消息并流式接收回复 +// 5. 提交任务并流式接收执行结果 try (AgentStudioEventStream stream = client.sessions().events().stream(session.getId())) { - client.sessions().events().send(session.getId(), "你好，请介绍一下自己"); + client.sessions().events().send(session.getId(), + Collections.singletonList(ClientEvents.userMessage("写一个 Python 函数，接收一个整数列表并返回去重后的有序列表。"))); for (Message event : stream) { System.out.print(event); } 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 cf586e8..e4b0ff1 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 @@ -15,6 +15,10 @@ 4. License模式[产品计费](https://help.aliyun.com/zh/model-studio/product-billing) +**说明** + +当前最新SDK版本：v1.3.0 + - 已适配的硬件列表 @@ -28,17 +32,13 @@ **芯片平台** -**发布版本** - 1 安凯 V500 -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/mravan/qwen_sdk_core_anykav500_v1.2.1_7793d6e_800260.tar.gz) +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/yswomu/qwen_sdk_core_anykav500_v1.3.0_22bcf3f_830783.tar.gz) 2 @@ -46,9 +46,7 @@ v1.2.1 AiW626X -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/vwldcs/qwen_sdk_core_aiw626x_v1.2.1_7793d6e_800260.tar.gz) +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/sjneed/qwen_sdk_core_aiw626x_v1.3.0_22bcf3f_830783.tar.gz) 3 @@ -56,9 +54,7 @@ v1.2.1 ASR1606 -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/zqvxcr/qwen_sdk_core_asr1606_v1.2.1_0d0164d_800452.tar.gz) +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/guivxo/qwen_sdk_core_asr1606_v1.3.0_22bcf3f_830776.tar.gz) 4 @@ -66,21 +62,15 @@ v1.2.1 BL616CL -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/qplevj/qwen_sdk_core_bl616cl_v1.2.1_7793d6e_800260.tar.gz) +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/gwcgji/qwen_sdk_core_bl616cl_v1.3.0_22bcf3f_830783.tar.gz) BK7252 -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/ngkxlk/qwen_sdk_core_bk7252_v1.2.1_7793d6e_800260.tar.gz) +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/rvauch/qwen_sdk_core_bk7252_v1.3.0_22bcf3f_830783.tar.gz) BK7258 -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/kobqxp/qwen_sdk_core_bk7258_v1.2.1_7793d6e_800260.tar.gz) +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/fwewrl/qwen_sdk_core_bk7258_v1.3.0_22bcf3f_830783.tar.gz) 5 @@ -88,15 +78,11 @@ v1.2.1 LM600 -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/hfxjmh/qwen_sdk_core_lm600_v1.2.1_7793d6e_800260.tar.gz) +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/dqvuce/qwen_sdk_core_lm600_v1.3.0_22bcf3f_830783.tar.gz) LM620 -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/rpxvnp/qwen_sdk_core_lm620_v1.2.1_7793d6e_800260.tar.gz) +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/bsfrap/qwen_sdk_core_lm620_v1.3.0_22bcf3f_830783.tar.gz) 6 @@ -104,21 +90,23 @@ v1.2.1 AV100 -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/onkjhn/qwen_sdk_core_av100_v1.2.1_7793d6e_800260.tar.gz) +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/rxcore/qwen_sdk_core_av100_v1.3.0_22bcf3f_830783.tar.gz) AV200 -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/vtfqwa/qwen_sdk_core_av200_v1.2.1_7793d6e_800260.tar.gz) +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/yftpur/qwen_sdk_core_av200_v1.3.0_22bcf3f_830784.tar.gz) Hi3516CV610 -v1.2.1 +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/dxezrf/qwen_sdk_core_hi3516cv610_v1.3.0_22bcf3f_830784.tar.gz) + +7 + +恒玄 + +WS53 -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/vzizzs/qwen_sdk_core_hi3516cv610_v1.2.1_7793d6e_800260.tar.gz) +[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 @@ -126,21 +114,15 @@ v1.2.1 AC7911 -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/ofpbmy/qwen_sdk_core_ac7911_v1.2.1_7793d6e_800260.tar.gz) +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/occlwd/qwen_sdk_core_ac7911_v1.3.0_22bcf3f_830784.tar.gz) AC792X -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/mvttvk/qwen_sdk_core_ac792x_v1.2.1_7793d6e_800260.tar.gz) +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/oehxov/qwen_sdk_core_ac792x_v1.3.0_22bcf3f_830784.tar.gz) JL7014 -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/szveox/qwen_sdk_core_jl7014_v1.2.1_7793d6e_800260.tar.gz) +[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 @@ -148,21 +130,15 @@ v1.2.1 G32S10M -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/lqhlbh/qwen_sdk_core_g32s10m_v1.2.1_7793d6e_800261.tar.gz) +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/ryzfbc/qwen_sdk_core_g32s10m_v1.3.0_22bcf3f_830784.tar.gz) T23 -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/zaypmp/qwen_sdk_core_t23_v1.2.1_7793d6e_800261.tar.gz) +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/yuphho/qwen_sdk_core_t23_v1.3.0_22bcf3f_830784.tar.gz) T41 -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/vrcfwp/qwen_sdk_core_t41_v1.2.1_7793d6e_800261.tar.gz) +[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 @@ -170,15 +146,11 @@ v1.2.1 ESP32 -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260609/mrxfsv/qwen_sdk_core_esp32_v1.2.1_0d0164d_809947.tar.gz) +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/qahtbd/qwen_sdk_core_esp32_v1.3.0_22bcf3f_833235.tar.gz) ESP32S3 -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260609/uljqro/qwen_sdk_core_esp32s3_v1.2.1_0d0164d_809943.tar.gz) +[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 @@ -186,33 +158,23 @@ v1.2.1 F133 -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/mcxzgb/qwen_sdk_core_f133_v1.2.1_7793d6e_800261.tar.gz) +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/bkskvs/qwen_sdk_core_f133_v1.3.0_22bcf3f_830784.tar.gz) R128 -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/mravan/qwen_sdk_core_anykav500_v1.2.1_7793d6e_800260.tar.gz) +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/zzjedt/qwen_sdk_core_r128_v1.3.0_22bcf3f_830784.tar.gz) V821 -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/hbndtu/qwen_sdk_core_v821_v1.2.1_7793d6e_800261.tar.gz) +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/soaatk/qwen_sdk_core_v821_v1.3.0_22bcf3f_830784.tar.gz) V853 -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/ahztms/qwen_sdk_core_v853_v1.2.1_7793d6e_800261.tar.gz) +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/lmfflv/qwen_sdk_core_v853_v1.3.0_22bcf3f_830785.tar.gz) XR872 -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/jescgy/qwen_sdk_core_xr872_v1.2.1_7793d6e_800261.tar.gz) +[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 @@ -220,21 +182,15 @@ v1.2.1 RK3506 -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/zcznyv/qwen_sdk_core_rk3506_v1.2.1_7793d6e_800261.tar.gz) +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/qogizw/qwen_sdk_core_rk3506_v1.3.0_22bcf3f_830785.tar.gz) RK3588 -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/akjauh/qwen_sdk_core_rk3588_v1.2.1_7793d6e_800261.tar.gz) +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/ahmkbd/qwen_sdk_core_rk3588_v1.3.0_22bcf3f_830785.tar.gz) RV1103 -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/wlxxwp/qwen_sdk_core_rv1103_v1.2.1_7793d6e_800261.tar.gz) +[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 @@ -242,15 +198,11 @@ v1.2.1 RTL8711 -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/ojeulx/qwen_sdk_core_rtl8711_v1.2.1_7793d6e_800261.tar.gz) +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/vplboh/qwen_sdk_core_rtl8711_v1.3.0_22bcf3f_830785.tar.gz) RTL8721 -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/evfkxy/qwen_sdk_core_rtl8721_v1.2.1_7793d6e_800261.tar.gz) +[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 @@ -258,15 +210,11 @@ v1.2.1 VELA\_V7A -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/nthifs/qwen_sdk_core_vela_v7a_v1.2.1_7793d6e_800261.tar.gz) +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/psjnsu/qwen_sdk_core_vela_v7a_v1.3.0_22bcf3f_830785.tar.gz) VELA\_V8A -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/vedrcq/qwen_sdk_core_vela_v8a_v1.2.1_7793d6e_800261.tar.gz) +[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 @@ -274,9 +222,7 @@ v1.2.1 XMW718 -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/tdvtuj/qwen_sdk_core_xmw718_v1.2.1_7793d6e_800261.tar.gz) +[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 @@ -284,15 +230,11 @@ v1.2.1 SSC305DE -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/anvrdl/qwen_sdk_core_ssc305de_v1.2.1_7793d6e_800262.tar.gz) +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/clyiun/qwen_sdk_core_ssc305de_v1.3.0_22bcf3f_830785.tar.gz) SSC309QL -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/wijiks/qwen_sdk_core_ssc309ql_v1.2.1_7793d6e_800262.tar.gz) +[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 @@ -300,9 +242,7 @@ v1.2.1 XY4100LC -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/nstjza/qwen_sdk_core_xy4100lc_v1.2.1_0d0164d_800454.tar.gz) +[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 @@ -310,41 +250,39 @@ v1.2.1 EC718PM -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/zqnasv/qwen_sdk_core_ec718pm_v1.2.1_0d0164d_800458.tar.gz) +[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 中国移动 -ML307N +ML307H + +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/varhsw/qwen_sdk_core_ml307h_v1.3.0_22bcf3f_830786.tar.gz) -v1.2.1 +ML307N -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/drahpc/qwen_sdk_core_ml307n_v1.2.1_0d0164d_800456.tar.gz) +[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 紫光展锐 -UIS8910 +UIS8910(ARMCC) -v1.2.1 +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/rjdxqr/qwen_sdk_core_uis8910_v1.3.0_22bcf3f_830783.tar.gz) -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/luondz/qwen_sdk_core_uis8910_v1.2.1_0d0164d_800460.tar.gz) +UIS8910(GCC) -UMS9117 +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/wbqgdm/qwen_sdk_core_uis8910_bn_v1.3.0_22bcf3f_830786.tar.gz) -v1.2.1 +UMS9117 -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/mvwwrz/qwen_sdk_core_ums9117_v1.2.1_0d0164d_800464.tar.gz) +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/yqkscr/qwen_sdk_core_ums9117_v1.3.0_22bcf3f_830784.tar.gz) W217 -v1.2.1 - -[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260529/tlktzs/qwen_sdk_core_W217_v1.2.1_0d0164d_800470.tar.gz) +[SDK下载链接](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260706/medzgn/qwen_sdk_core_w217_v1.3.0_22bcf3f_830786.tar.gz) ## 1\. 接入模式说明 @@ -1645,10 +1583,9 @@ c_mmi_storage_set_api_key("Your ApiKey"); * * @param buffer 用于存储生成的注册字符串的缓冲区 * @param buffer_size 缓冲区大小 - * @param time_ms_str 时间戳字符串，单位为毫秒 * @return int32_t 返回操作结果，0表示成功，非0表示失败 */ -int32_t c_license_gen_register_str(char *buffer, uint32_t buffer_size, char *time_ms_str); +int32_t c_license_gen_register_str_v2(char *buffer, uint32_t buffer_size); /** * @brief 解析云端的设备注册响应信息。 @@ -1667,12 +1604,10 @@ int32_t c_license_analyze_register_rsp(char *rsp_str); #define REQ_BUFFER_SIZE (1024) char req[REQ_BUFFER_SIZE]; -char time_ms_str[14]; if (c_license_device_is_registered() == 0) { - snprintf(time_ms_str, sizeof(time_ms_str), "%" PRId64, util_get_timestamp()); // 根据时间戳timestamp，生成注册信息字串req - c_license_gen_register_str(req, sizeof(req), time_ms_str); + c_license_gen_register_str_v2(req, sizeof(req)); // 获取设备注册信息，http接口需客户自行实现 char *rsp = dummy_http_request(req); // 解析并完成注册 @@ -1740,7 +1675,7 @@ if (c_license_device_is_registered() == 0) { * * @return uint8_t 返回1表示token有效，0表示token已过期。 */ -uint8_t c_license_is_token_expire(void); +uint8_t c_license_is_token_expire_v2(void); /** * @brief 生成获取token的请求数据。 @@ -1749,11 +1684,10 @@ uint8_t c_license_is_token_expire(void); * * @param buffer 用于存储生成的请求字符串的缓冲区 * @param buffer_size 缓冲区的大小 - * @param time_ms_str 时间戳字符串，单位为毫秒 * @param api_key API密钥字符串，半托管模式api_key设置为NULL * @return int32_t 返回操作结果，0表示成功，非0表示失败 */ -int32_t c_license_gen_get_token_str(char *buffer, uint32_t buffer_size, char *time_ms_str, char *api_key); +int32_t c_license_gen_get_token_str_v2(char *buffer, uint32_t buffer_size, char *api_key); /** * @brief 解析登录响应数据。 @@ -1776,16 +1710,14 @@ int32_t c_license_analyze_get_token_rsp(char *rsp_str); #define REQ_BUFFER_SIZE (1024) char req[REQ_BUFFER_SIZE]; -char time_ms_str[14]; char api_key[36] = { 0 }; -snprintf(time_ms_str, sizeof(time_ms_str), "%" PRId64, util_get_timestamp()); c_mmi_storage_get_api_key(api_key); // 根据服务端下发时间戳timestamp，生成注册信息字串req // 使用全托管模式必须要有api_key -c_license_gen_get_token_str(req, sizeof(req), time_ms_str, api_key); +c_license_gen_get_token_str_v2(req, sizeof(req), api_key); // 使用半托管模式可以传入NULL -// c_license_gen_get_token_str(req, sizeof(req), time_ms_str, NULL); +// c_license_gen_get_token_str_v2(req, sizeof(req), NULL); // 获取服务端返回设备信息，该接口需客户自行实现 char *rsp = dummy_http_request(req); // 解析交互令牌 diff --git a/skills/bailian-docs-llm-wiki/raw/application-user-guide/data-connection-overview/data-connection.md b/skills/bailian-docs-llm-wiki/raw/application-user-guide/data-connection-overview/data-connection.md index 557b39e..ca8a107 100644 --- a/skills/bailian-docs-llm-wiki/raw/application-user-guide/data-connection-overview/data-connection.md +++ b/skills/bailian-docs-llm-wiki/raw/application-user-guide/data-connection-overview/data-connection.md @@ -429,7 +429,7 @@ OSS 4. 为文件**配置标签**（可选）。 - > [通过API调用应用](https://help.aliyun.com/zh/model-studio/application-calling-guide#4100253b7chc3)时，可以在请求参数`tags`中指定标签。应用在检索知识库时，会先根据标签筛选相关文件，从而提高检索效率。对于[智能体应用](https://help.aliyun.com/zh/model-studio/single-agent-application)，可在控制台调试知识库时设置标签。 + > [通过API调用应用](https://help.aliyun.com/zh/model-studio/application-calling-guide#4100253b7chc3)时，可以在请求参数`tags`中指定标签。应用在检索知识库时，会先根据标签筛选相关文件，从而提高检索效率。对于[智能体应用（Agent 1.0）](https://help.aliyun.com/zh/model-studio/single-agent-application)，可在控制台调试知识库时设置标签。 5. 点击**确认**，系统将开始解析和导入，可在页面查看任务进度。 @@ -548,7 +548,7 @@ OSS 4. 为文件**配置标签**（可选）。 - > [通过API调用应用](https://help.aliyun.com/zh/model-studio/application-calling-guide#4100253b7chc3)时，可以在请求参数`tags`中指定标签。应用在检索知识库时，会先根据标签筛选相关文件，从而提高检索效率。对于[智能体应用](https://help.aliyun.com/zh/model-studio/single-agent-application)，可在控制台编辑应用时直接设置标签（启用**知识库** > **+知识库** > **知识库高级配置** > **标签过滤**）。 + > [通过API调用应用](https://help.aliyun.com/zh/model-studio/application-calling-guide#4100253b7chc3)时，可以在请求参数`tags`中指定标签。应用在检索知识库时，会先根据标签筛选相关文件，从而提高检索效率。对于[智能体应用（Agent 1.0）](https://help.aliyun.com/zh/model-studio/single-agent-application)，可在控制台编辑应用时直接设置标签（启用**知识库** > **+知识库** > **知识库高级配置** > **标签过滤**）。 5. 点击**确认**，系统将开始解析和导入，可在页面查看任务进度。 @@ -1586,11 +1586,13 @@ VSwitch ID - **导入OSS文件遇到“10041495”报错，应如何处理？** - 通常是主账号未开通OSS服务，处理步骤： + 该报错由以下原因引起，按顺序排查： - 1. 需主账号前往[OSS管理控制台](https://oss.console.aliyun.com/)，按界面指引开通 OSS。 + 1. 主账号未开通OSS服务。需主账号前往[OSS管理控制台](https://oss.console.aliyun.com/)，按界面指引开通OSS。 - 2. 返回阿里云百炼页面，再尝试授权。 + 2. 目标OSS Bucket未添加`bailian-datahub-access`标签（值为`read`）。未添加该标签的Bucket阿里云百炼无法访问。前往[OSS管理控制台](https://oss.console.aliyun.com/bucket)Bucket标签页面，为目标Bucket添加标签。 + + 3. 完成上述操作后，返回阿里云百炼页面重新授权。 diff --git a/skills/bailian-docs-llm-wiki/raw/application-user-guide/llm-application/new-single-agent-application.md b/skills/bailian-docs-llm-wiki/raw/application-user-guide/llm-application/new-single-agent-application.md index e9adb4f..ede0fcd 100644 --- a/skills/bailian-docs-llm-wiki/raw/application-user-guide/llm-application/new-single-agent-application.md +++ b/skills/bailian-docs-llm-wiki/raw/application-user-guide/llm-application/new-single-agent-application.md @@ -1,4 +1,4 @@ -# 新版智能体应用 +# 新版智能体应用（Agent 2.0） 新版智能体应用（Agent 2.0）将知识库、MCP 等多种能力统一为工具，并通过自主思考和规划来调用，以解决复杂任务。 @@ -58,7 +58,7 @@ - **enable\_thinking**：是否开启思考模式。开启思考模式有助于提升智能体的反思效果。不支持思考模式的模型无法配置 enable\_thinking 参数。 -### 系统提示词 +### 提示词 系统提示词用于定义智能体角色、行为指令与能力边界，以确保其在交互中始终保持一致性、可控性和任务合规性。 @@ -74,7 +74,7 @@ 除了支持输入静态文本，系统提示词还允许嵌入自定义变量。 - 1. 单击系统提示词右上方的**新建变量**，设置自定义变量，单击**确定**保存。 + 1. 单击**提示词**右上方的**自定义变量**，设置自定义变量，单击**确定**保存。 2. 输入`/`，使用已配置的变量。 diff --git a/skills/bailian-docs-llm-wiki/raw/application-user-guide/llm-application/single-agent-application.md b/skills/bailian-docs-llm-wiki/raw/application-user-guide/llm-application/single-agent-application.md index 1a97d24..37f7db3 100644 --- a/skills/bailian-docs-llm-wiki/raw/application-user-guide/llm-application/single-agent-application.md +++ b/skills/bailian-docs-llm-wiki/raw/application-user-guide/llm-application/single-agent-application.md @@ -73,7 +73,7 @@ ## 发布与调用 -百炼智能体支持通过API调用，也支持一键发布到第三方平台，或通过组件集成到业务流程中。 +应用发布后，支持通过 API/SDK 调用，也可发布到钉钉、微信公众号等第三方平台，或发布为可复用组件集成到业务系统中。 ### 发布应用 diff --git a/skills/bailian-docs-llm-wiki/raw/application-user-guide/prompt/prompt-sample-optimization.md b/skills/bailian-docs-llm-wiki/raw/application-user-guide/prompt/prompt-sample-optimization.md index bf1493a..e2a9768 100644 --- a/skills/bailian-docs-llm-wiki/raw/application-user-guide/prompt/prompt-sample-optimization.md +++ b/skills/bailian-docs-llm-wiki/raw/application-user-guide/prompt/prompt-sample-optimization.md @@ -63,7 +63,7 @@ Prompt样例库功能已不再维护，推荐您将样例库数据迁移到 RAG 将Prompt样例库与位于相同的业务空间里的智能体应用关联，使其生效。 -1. 确保你已有一个[智能体应用](https://help.aliyun.com/zh/model-studio/single-agent-application)。 +1. 确保你已有一个[智能体应用（Agent 1.0）](https://help.aliyun.com/zh/model-studio/single-agent-application)。 2. 前往[应用管理](https://bailian.console.aliyun.com/?tab=app#/app-center)页面，找到目标智能体应用，单击应用卡片上的**配置**。 diff --git a/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/android-sdk-for-fun-asr-real-time-service.md b/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/android-sdk-for-fun-asr-real-time-service.md index d18dd59..93cd10d 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/android-sdk-for-fun-asr-real-time-service.md +++ b/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/android-sdk-for-fun-asr-real-time-service.md @@ -4,6 +4,12 @@ **用户指南：**关于模型介绍和选型建议请参见[实时语音识别-Fun-ASR/Paraformer](https://help.aliyun.com/zh/model-studio/real-time-speech-recognition) +**重要** + +阿里云百炼为华北2（北京）地域推出了业务空间专属域名，能够为推理请求提供卓越的性能和更高的稳定性，建议从 `dashscope.aliyuncs.com` 迁移至 `{WorkspaceId}.cn-beijing.maas.aliyuncs.com`。 + +`{WorkspaceId}`需要替换为真实的[Workspace ID](https://help.aliyun.com/zh/model-studio/obtain-the-app-id-and-workspace-id#d3eb3cd37b7fu)。现有域名仍可正常使用。 + ## **快速开始** 1. [获取API Key](https://help.aliyun.com/zh/model-studio/get-api-key) @@ -13,7 +19,8 @@ - [下载最新SDK整合包](https://help.aliyun.com/zh/isi/sdk-selection-and-download)。 - 解压 ZIP 包。在 `app/libs` 目录中获取 AAR 格式 SDK，并添加到项目依赖。 - 需要 Android CPP 接入时，使用 ZIP 包内的 `android_libs` 与 `android_include` 获取动态库和头文件。 + 需要 Android CPP 接入时，使用 ZIP 包内的 `android_libs` 与 `android_include` 获取动态库和头文件。 + - 用 Android Studio 打开工程。示例代码位于`DashFunAsrSpeechTranscriberActivity.java`，替换 API Key 后体验功能。 @@ -47,7 +54,7 @@ ``` { - "url": "wss://dashscope.aliyuncs.com/api-ws/v1/inference", + "url": "wss://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api-ws/v1/inference", "apikey": "st-****", "device_id": "my_device_id", "service_mode": "1" @@ -70,7 +77,7 @@ 是 - 服务地址，固定为 `wss://dashscope.aliyuncs.com/api-ws/v1/inference`。 + 服务地址，固定为 `wss://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api-ws/v1/inference`。调用时请将`{WorkspaceId}`替换为真实的[Workspace ID](https://help.aliyun.com/zh/model-studio/obtain-the-app-id-and-workspace-id#d3eb3cd37b7fu)。 `apikey` @@ -246,7 +253,7 @@ 待识别音频采样率（单位Hz）。 - 仅支持16000Hz。 + 8k模型仅支持 8000 Hz，其他模型支持任意采样率。 `nls_config.semantic_punctuation_enabled` @@ -347,12 +354,78 @@ - ja: 日语 + - ko：韩语 + + - vi：越南语 + + - th：泰语 + + - id：印尼语 + + - ms：马来语 + + - tl：菲律宾语 + + - hi：印地语 + + - ar：阿拉伯语 + + - fr：法语 + + - de：德语 + + - es：西班牙语 + + - pt：葡萄牙语 + + - ru：俄语 + + - it：意大利语 + + - nl：荷兰语 + + - sv：瑞典语 + + - da：丹麦语 + + - fi：芬兰语 + + - no：挪威语 + + - el：希腊语 + + - pl：波兰语 + + - cs：捷克语 + + - hu：匈牙利语 + + - ro：罗马尼亚语 + + - bg：保加利亚语 + + - hr：克罗地亚语 + + - sk：斯洛伐克语 + + - fun-asr-realtime-2026-02-28： + + - zh: 中文 + + - en: 英文 + + - ja: 日语 + - fun-asr-realtime-2025-09-15： - zh: 中文 - en: 英文 + - fun-asr-flash-8k-realtime、fun-asr-flash-8k-realtime-2026-01-28： + + - zh: 中文 + `nls_config.parameters` diff --git a/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/fun-asr-client-events.md b/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/fun-asr-client-events.md index abb0a8c..fb489ef 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/fun-asr-client-events.md +++ b/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/fun-asr-client-events.md @@ -1,12 +1,12 @@ # 实时语音识别（Fun-ASR）客户端事件 -本文介绍 Fun-ASR 实时语音识别服务中客户端通过 WebSocket 发送给服务端的客户端事件，包括 run-task（启动任务）和 finish-task（结束任务）两类指令的数据结构与字段含义。 +本文介绍 Fun-ASR 实时语音识别服务中客户端通过 WebSocket 发送给服务端的客户端事件，包括 run-task（启动任务）、continue-task（更新上下文）、finish-task（结束任务）等指令的数据结构与字段含义。 **用户指南：**关于模型介绍和选型建议请参见[语音识别](https://help.aliyun.com/zh/model-studio/asr-model/)。 **事件交互流程**：如需了解事件交互时序，请参见[WebSocket API](https://help.aliyun.com/zh/model-studio/fun-asr-realtime-websocket-api)。 -### **run-task** +## **run-task** **说明**：启动语音识别任务，设置模型、音频格式、采样率等参数。 @@ -30,6 +30,8 @@ 固定为 `duplex`。 +## 基本请求 + ``` { "header": { @@ -51,6 +53,50 @@ } ``` +## 携带上下文 + +``` +{ + "header": { + "action": "run-task", + "task_id": "2bf83b9a-baeb-4fda-8d9a-xxxxxxxxxxxx", + "streaming": "duplex" + }, + "payload": { + "task_group": "audio", + "task": "asr", + "function": "recognition", + "model": "fun-asr-realtime", + "parameters": { + "format": "pcm", + "sample_rate": 16000 + }, + "input": { + "context": [ + { + "role": "user", + "content": [ + { + "type": "input_text", + "text": "你好啊" + } + ] + }, + { + "role": "assistant", + "content": [ + { + "type": "text", + "text": "你好啊，我是通义千问，有什么可以帮助你的？" + } + ] + } + ] + } + } +} +``` + **payload** `_object_` **（必选）** **属性** @@ -73,7 +119,55 @@ **input** `_object_` **（必选）** -固定为`{}`。 +输入对象。不携带上下文时传入`{}`。 + +**重要** + +仅 `fun-asr-realtime` 和 `fun-asr-realtime-2025-11-07` 模型支持 context 参数。 + +**属性** + +**context** `_array(object)_` （可选） + +对话上下文，用于辅助识别、提升专有词汇的识别准确率。使用方法详见[快速开始](https://help.aliyun.com/zh/model-studio/improve-asr-accuracy#ctx-quickstart-sec)。 + +**重要** + +约束：上下文消息（`input_text` 和 `text` 类型）各最多 5 条，超出时保留最近的 5 条。每轮上下文文本总长度（`user` 和 `assistant` 的 `text` 字段长度之和）不超过 400 个字符（按字符数计算，每个字符计为 1），超出部分从末尾截断。 + +**重要** + +携带上下文时，`context` 中的消息顺序有要求：上下文消息必须按对话轮次排列，每轮中 `user`（`input_text` 类型）必须在对应的 `assistant`（`text` 类型）之前。 + +**属性** + +**role** `_string_` **（必选）** + +消息角色。取值范围： + +- `user`：前几轮用户语音的识别结果或领域相关的词表。 + +- `assistant`：前几轮大语言模型的回复内容。 + + +**content** `_array(object)_` **（必选）** + +消息内容列表。 + +**属性** + +**type** `_string_` **（必选）** + +内容类型。取值范围： + +- `input_text`：前几轮用户语音的识别结果或领域相关的词表（role 为 user 时使用），需同时传入 `text` 字段。 + +- `text`：前几轮大语言模型的回复内容（role 为 assistant 时使用），需同时传入 `text` 字段。 + + +**text** `_string_` **（必选）** + +文本内容。当 `type` 为 `input_text` 时，填入前几轮用户语音的识别结果或领域相关的词表；当 `type` 为 `text` 时，填入前几轮大语言模型的回复内容。 **parameters** `_object_` **（必选）** @@ -121,14 +215,88 @@ 系统仅读取数组中的首个值，多余值将被忽略。 -取值范围： +不同模型支持的语言代码如下： -- zh: 中文 +- fun-asr-realtime、fun-asr-realtime-2025-11-07： -- en: 英文 + - zh: 中文 + + - en: 英文 + + - ja: 日语 + + - ko：韩语 + + - vi：越南语 + + - th：泰语 + + - id：印尼语 + + - ms：马来语 + + - tl：菲律宾语 + + - hi：印地语 + + - ar：阿拉伯语 + + - fr：法语 + + - de：德语 + + - es：西班牙语 + + - pt：葡萄牙语 + + - ru：俄语 + + - it：意大利语 + + - nl：荷兰语 + + - sv：瑞典语 + + - da：丹麦语 + + - fi：芬兰语 + + - no：挪威语 + + - el：希腊语 + + - pl：波兰语 + + - cs：捷克语 + + - hu：匈牙利语 + + - ro：罗马尼亚语 + + - bg：保加利亚语 + + - hr：克罗地亚语 + + - sk：斯洛伐克语 + +- fun-asr-realtime-2026-02-28： -- ja: 日语 + - zh: 中文 + + - en: 英文 + + - ja: 日语 + +- fun-asr-realtime-2025-09-15： + - zh: 中文 + + - en: 英文 + +- fun-asr-flash-8k-realtime、fun-asr-flash-8k-realtime-2026-01-28： + + - zh: 中文 + **semantic\_punctuation\_enabled** `_boolean_` （可选） @@ -202,7 +370,119 @@ VAD 断句静音阈值（ms）。当一段语音后的静音时长超过该阈 - 根据实际音频环境小幅度调整（建议步长 0.1） -### **finish-task** +## **continue-task** + +**说明**：在任务执行过程中更新对话上下文信息，用于辅助识别。 + +**发送时机**：任务运行中，需要更新对话上下文时发送。 + +**重要** + +仅 `fun-asr-realtime` 和 `fun-asr-realtime-2025-11-07` 模型支持该事件。 + +**header** `_object_` **（必选）** + +**属性** + +**action** `_string_` **（必选）** + +指令类型，固定为 `continue-task`。 + +**task\_id** `_string_` **（必选）** + +客户端生成的任务 ID（UUID 格式），需与[run-task](#9cae7e7b85ebm)事件中的 task\_id 保持一致。 + +**streaming** `_string_` **（必选）** + +固定为 `duplex`。 + +``` +{ + "header": { + "action": "continue-task", + "task_id": "2bf83b9a-baeb-4fda-8d9a-xxxxxxxxxxxx", + "streaming": "duplex" + }, + "payload": { + "input": { + "context": [ + { + "role": "user", + "content": [ + { + "type": "input_text", + "text": "你好啊" + } + ] + }, + { + "role": "assistant", + "content": [ + { + "type": "text", + "text": "你好啊，我是通义千问，有什么可以帮助你的？" + } + ] + } + ] + } + } +} +``` + +**payload** `_object_` **（必选）** + +**属性** + +**input** `_object_` **（必选）** + +输入对象。 + +**属性** + +**context** `_array(object)_` （可选） + +对话上下文，用于辅助识别、提升专有词汇的识别准确率。使用方法详见[快速开始](https://help.aliyun.com/zh/model-studio/improve-asr-accuracy#ctx-quickstart-sec)。 + +**重要** + +约束：上下文消息（`input_text` 和 `text` 类型）各最多 5 条，超出时保留最近的 5 条。每轮上下文文本总长度（`user` 和 `assistant` 的 `text` 字段长度之和）不超过 400 个字符（按字符数计算，每个字符计为 1），超出部分从末尾截断。 + +**重要** + +携带上下文时，`context` 中的消息顺序有要求：上下文消息必须按对话轮次排列，每轮中 `user`（`input_text` 类型）必须在对应的 `assistant`（`text` 类型）之前。 + +**属性** + +**role** `_string_` **（必选）** + +消息角色。取值范围： + +- `user`：前几轮用户语音的识别结果或领域相关的词表。 + +- `assistant`：前几轮大语言模型的回复内容。 + + +**content** `_array(object)_` **（必选）** + +消息内容列表。 + +**属性** + +**type** `_string_` **（必选）** + +内容类型。取值范围： + +- `input_text`：前几轮用户语音的识别结果或领域相关的词表（role 为 user 时使用），需同时传入 `text` 字段。 + +- `text`：前几轮大语言模型的回复内容（role 为 assistant 时使用），需同时传入 `text` 字段。 + + +**text** `_string_` **（必选）** + +文本内容。当 `type` 为 `input_text` 时，填入前几轮用户语音的识别结果或领域相关的词表；当 `type` 为 `text` 时，填入前几轮大语言模型的回复内容。 + +## **finish-task** **说明**：通知服务端音频发送完毕，请求结束任务。 diff --git a/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/fun-asr-realtime-java-sdk.md b/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/fun-asr-realtime-java-sdk.md index 440b18f..a5fab50 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/fun-asr-realtime-java-sdk.md +++ b/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/fun-asr-realtime-java-sdk.md @@ -803,12 +803,78 @@ String\[\] - ja: 日语 + - ko：韩语 + + - vi：越南语 + + - th：泰语 + + - id：印尼语 + + - ms：马来语 + + - tl：菲律宾语 + + - hi：印地语 + + - ar：阿拉伯语 + + - fr：法语 + + - de：德语 + + - es：西班牙语 + + - pt：葡萄牙语 + + - ru：俄语 + + - it：意大利语 + + - nl：荷兰语 + + - sv：瑞典语 + + - da：丹麦语 + + - fi：芬兰语 + + - no：挪威语 + + - el：希腊语 + + - pl：波兰语 + + - cs：捷克语 + + - hu：匈牙利语 + + - ro：罗马尼亚语 + + - bg：保加利亚语 + + - hr：克罗地亚语 + + - sk：斯洛伐克语 + +- fun-asr-realtime-2026-02-28： + + - zh: 中文 + + - en: 英文 + + - ja: 日语 + - fun-asr-realtime-2025-09-15： - zh: 中文 - en: 英文 +- fun-asr-flash-8k-realtime、fun-asr-flash-8k-realtime-2026-01-28： + + - zh: 中文 + **说明** @@ -890,6 +956,71 @@ RecognitionParam param = RecognitionParam.builder() .build(); ``` +input + +Map + +\- + +否 + +输入对象，用于传入对话上下文（context）。上下文用于辅助识别、提升专有词汇的识别准确率。使用方法详见[快速开始](https://help.aliyun.com/zh/model-studio/improve-asr-accuracy#ctx-quickstart-sec)。 + +**重要** + +仅 `fun-asr-realtime` 和 `fun-asr-realtime-2025-11-07` 模型支持 context 参数。 + +Map 中需包含 `context` 键，值为 `List>` 类型的消息数组，每条消息包含以下字段： + +- `role`（String，必选）：消息角色。`user` 表示前几轮用户语音的识别结果或领域相关的词表；`assistant` 表示前几轮大语言模型的回复内容。 + +- `content`（List，必选）：消息内容列表。每个元素包含 `type`（String，role 为 user 时填 `input_text`，role 为 assistant 时填 `text`）和 `text`（String，文本内容）。 + + +**重要** + +约束：上下文消息（`input_text` 和 `text` 类型）各最多 5 条，超出时保留最近的 5 条。每轮上下文文本总长度不超过 400 个字符，超出部分从末尾截断。 + +**重要** + +携带上下文时，`context` 中的消息顺序有要求：上下文消息必须按对话轮次排列，每轮中 `user`（`input_text` 类型）必须在对应的 `assistant`（`text` 类型）之前。 + +**说明** + +使用该字段时，SDK版本不能低于2.22.23。 + +`input`通过`RecognitionParam`实例的`input`方法进行设置： + +``` +// 1. 构建 input 结构体 +Map userContent = new HashMap<>(); +userContent.put("type", "input_text"); +userContent.put("text", "你好啊"); + +Map assistantContent = new HashMap<>(); +assistantContent.put("type", "text"); +assistantContent.put("text", "你好啊，我是通义千问，有什么可以帮助你的？"); + +Map userMessage = new HashMap<>(); +userMessage.put("role", "user"); +userMessage.put("content", Arrays.asList(userContent)); + +Map assistantMessage = new HashMap<>(); +assistantMessage.put("role", "assistant"); +assistantMessage.put("content", Arrays.asList(assistantContent)); + +Map input = new HashMap<>(); +input.put("context", Arrays.asList(userMessage, assistantMessage)); + +// 2. 通过 input 方法传入 +RecognitionParam param = RecognitionParam.builder() + .model("fun-asr-realtime") + .format("pcm") + .sampleRate(16000) + .input(input) + .build(); +``` + apiKey String diff --git a/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/fun-asr-realtime-python-sdk.md b/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/fun-asr-realtime-python-sdk.md index 06a82d6..a013311 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/fun-asr-realtime-python-sdk.md +++ b/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/fun-asr-realtime-python-sdk.md @@ -484,12 +484,78 @@ list\[str\] - ja: 日语 + - ko：韩语 + + - vi：越南语 + + - th：泰语 + + - id：印尼语 + + - ms：马来语 + + - tl：菲律宾语 + + - hi：印地语 + + - ar：阿拉伯语 + + - fr：法语 + + - de：德语 + + - es：西班牙语 + + - pt：葡萄牙语 + + - ru：俄语 + + - it：意大利语 + + - nl：荷兰语 + + - sv：瑞典语 + + - da：丹麦语 + + - fi：芬兰语 + + - no：挪威语 + + - el：希腊语 + + - pl：波兰语 + + - cs：捷克语 + + - hu：匈牙利语 + + - ro：罗马尼亚语 + + - bg：保加利亚语 + + - hr：克罗地亚语 + + - sk：斯洛伐克语 + +- fun-asr-realtime-2026-02-28： + + - zh: 中文 + + - en: 英文 + + - ja: 日语 + - fun-asr-realtime-2025-09-15： - zh: 中文 - en: 英文 +- fun-asr-flash-8k-realtime、fun-asr-flash-8k-realtime-2026-01-28： + + - zh: 中文 + speech\_noise\_threshold @@ -529,6 +595,84 @@ RecognitionCallback [回调接口（RecognitionCallback）](#cec6e96138swr)。 +以下参数通过`Recognition`实例的`call`或`start`方法的关键字参数传入。 + +**参数** + +**类型** + +**默认值** + +**是否必须** + +**说明** + +raw\_input + +dict + +\- + +否 + +输入对象，用于传入对话上下文（context）。上下文用于辅助识别、提升专有词汇的识别准确率。使用方法详见[快速开始](https://help.aliyun.com/zh/model-studio/improve-asr-accuracy#ctx-quickstart-sec)。 + +**重要** + +仅 `fun-asr-realtime` 和 `fun-asr-realtime-2025-11-07` 模型支持 context 参数。 + +dict 中需包含 `context` 键，值为消息列表（list\[dict\]），每条消息包含以下字段： + +- `role`（str，必选）：消息角色。`user` 表示前几轮用户语音的识别结果或领域相关的词表；`assistant` 表示前几轮大语言模型的回复内容。 + +- `content`（list\[dict\]，必选）：消息内容列表。每个元素包含 `type`（str，role 为 user 时填 `input_text`，role 为 assistant 时填 `text`）和 `text`（str，文本内容）。 + + +**重要** + +约束：上下文消息（`input_text` 和 `text` 类型）各最多 5 条，超出时保留最近的 5 条。每轮上下文文本总长度不超过 400 个字符，超出部分从末尾截断。 + +**重要** + +携带上下文时，`context` 中的消息顺序有要求：上下文消息必须按对话轮次排列，每轮中 `user`（`input_text` 类型）必须在对应的 `assistant`（`text` 类型）之前。 + +**说明** + +使用该字段时，SDK版本不能低于1.25.23。 + +`raw_input`通过`Recognition`实例的`start`或`call`方法传入： + +``` +# 构建 input 传入数据 +input_context = { + "context": [ + { + "role": "user", + "content": [ + { + "type": "input_text", + "text": "你好啊" + } + ] + }, + { + "role": "assistant", + "content": [ + { + "type": "text", + "text": "你好啊，我是通义千问，有什么可以帮助你的？" + } + ] + } + ] +} + +# 通过 raw_input 参数传入 +recognition.start(raw_input=input_context) +# 或者 +recognition.call(raw_input=input_context) +``` + ## **关键接口** ### `Recognition`类 diff --git a/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/ios-sdk-for-fun-asr-real-time-service.md b/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/ios-sdk-for-fun-asr-real-time-service.md index 51112ec..20b2b83 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/ios-sdk-for-fun-asr-real-time-service.md +++ b/skills/bailian-docs-llm-wiki/raw/model-api-reference/audio-api-references/speech-recognition-api-reference/fun-asr-real-time-speech-recognition-api-reference/ios-sdk-for-fun-asr-real-time-service.md @@ -4,6 +4,12 @@ **用户指南：**关于模型介绍和选型建议请参见[实时语音识别-Fun-ASR/Paraformer](https://help.aliyun.com/zh/model-studio/real-time-speech-recognition) +**重要** + +阿里云百炼为华北2（北京）地域推出了业务空间专属域名，能够为推理请求提供卓越的性能和更高的稳定性，建议从 `dashscope.aliyuncs.com` 迁移至 `{WorkspaceId}.cn-beijing.maas.aliyuncs.com`。 + +`{WorkspaceId}`需要替换为真实的[Workspace ID](https://help.aliyun.com/zh/model-studio/obtain-the-app-id-and-workspace-id#d3eb3cd37b7fu)。现有域名仍可正常使用。 + ## **快速开始** 1. **获取API Key：**[获取API Key](https://help.aliyun.com/zh/model-studio/get-api-key) @@ -50,7 +56,7 @@ ``` { - "url": "wss://dashscope.aliyuncs.com/api-ws/v1/inference", + "url": "wss://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api-ws/v1/inference", "apikey": "st-****", "device_id": "my_device_id", "service_mode": "1" @@ -73,7 +79,7 @@ 是 - 服务地址，固定为 `wss://dashscope.aliyuncs.com/api-ws/v1/inference`。 + 服务地址，固定为 `wss://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api-ws/v1/inference`。调用时请将`{WorkspaceId}`替换为真实的[Workspace ID](https://help.aliyun.com/zh/model-studio/obtain-the-app-id-and-workspace-id#d3eb3cd37b7fu)。 `apikey` @@ -249,7 +255,7 @@ 待识别音频采样率（单位Hz）。 - 仅支持16000Hz。 + 8k模型仅支持 8000 Hz，其他模型支持任意采样率。 `nls_config.semantic_punctuation_enabled` @@ -350,12 +356,78 @@ - ja: 日语 + - ko：韩语 + + - vi：越南语 + + - th：泰语 + + - id：印尼语 + + - ms：马来语 + + - tl：菲律宾语 + + - hi：印地语 + + - ar：阿拉伯语 + + - fr：法语 + + - de：德语 + + - es：西班牙语 + + - pt：葡萄牙语 + + - ru：俄语 + + - it：意大利语 + + - nl：荷兰语 + + - sv：瑞典语 + + - da：丹麦语 + + - fi：芬兰语 + + - no：挪威语 + + - el：希腊语 + + - pl：波兰语 + + - cs：捷克语 + + - hu：匈牙利语 + + - ro：罗马尼亚语 + + - bg：保加利亚语 + + - hr：克罗地亚语 + + - sk：斯洛伐克语 + + - fun-asr-realtime-2026-02-28： + + - zh: 中文 + + - en: 英文 + + - ja: 日语 + - fun-asr-realtime-2025-09-15： - zh: 中文 - en: 英文 + - fun-asr-flash-8k-realtime、fun-asr-flash-8k-realtime-2026-01-28： + + - zh: 中文 + `nls_config.parameters` diff --git a/skills/bailian-docs-llm-wiki/raw/model-api-reference/image-generation/wan-image-api-reference/wan-image-generation-api-reference.md b/skills/bailian-docs-llm-wiki/raw/model-api-reference/image-generation/wan-image-api-reference/wan-image-generation-api-reference.md index 1a6a402..7d9f295 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-api-reference/image-generation/wan-image-api-reference/wan-image-generation-api-reference.md +++ b/skills/bailian-docs-llm-wiki/raw/model-api-reference/image-generation/wan-image-api-reference/wan-image-generation-api-reference.md @@ -16,6 +16,8 @@ wan2.6-image 支持图像编辑和图文混排输出 +如需纯文本生成图片（文生图），建议使用[wan2.6-t2i 模型（通义万相-文生图V2）](https://help.aliyun.com/zh/model-studio/text-to-image-v2-api-reference#t2841764.html)。 + 图片格式：PNG。 图像分辨率和尺寸请参见[size参数](#249489db9c7rf)。 @@ -34,14 +36,14 @@ wan2.6-image **重要** -百炼为华北2（北京）、新加坡地域推出了业务空间专属域名，**能够为推理请求提供卓越的性能和更高的稳定性**，建议迁移至新域名： +阿里云百炼为华北2（北京）、新加坡地域推出了业务空间专属域名，**能够为推理请求提供卓越的性能和更高的稳定性**，建议迁移至新域名： - 华北2（北京）地域：从 `https://dashscope.aliyuncs.com` 迁移至 `https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com` - 新加坡地域：从 `https://dashscope-intl.aliyuncs.com` 迁移至 `https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com` -其中 `{WorkspaceId}` 为您的业务空间 ID，可在百炼控制台的**业务空间详情**页面查看。现有域名仍可正常使用。 +其中 `{WorkspaceId}` 为您的业务空间 ID，可在阿里云百炼控制台的**业务空间详情**页面查看。现有域名仍可正常使用。 ## **HTTP同步调用** @@ -325,6 +327,8 @@ curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/servi - 用途：根据文本描述生成图文并茂的内容，或进行纯文本生成图像（文生图）。 + 纯文生图场景建议优先使用[wan2.6-t2i 模型（通义万相-文生图V2）](https://help.aliyun.com/zh/model-studio/text-to-image-v2-api-reference#t2841764.html)。 + - 输入：可以不提供图像（文生图），或提供最多1张参考图像。 - 输出：生成包含文本和图像的混合内容。 @@ -875,6 +879,8 @@ curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/servi - 用途：根据文本描述生成图文并茂的内容，或进行纯文本生成图像（文生图）。 + 纯文生图场景建议优先使用[wan2.6-t2i 模型（通义万相-文生图V2）](https://help.aliyun.com/zh/model-studio/text-to-image-v2-api-reference#t2841764.html)。 + - 输入：可以不提供图像（文生图），或提供最多1张参考图像。 - 输出：生成包含文本和图像的混合内容。 diff --git a/skills/bailian-docs-llm-wiki/raw/model-api-reference/model-production/model-compression-api.md b/skills/bailian-docs-llm-wiki/raw/model-api-reference/model-production/model-compression-api.md deleted file mode 100644 index e4350f4..0000000 --- a/skills/bailian-docs-llm-wiki/raw/model-api-reference/model-production/model-compression-api.md +++ /dev/null @@ -1,3 +0,0 @@ -# 模型压缩 - -通过量化等方式压缩模型，降低推理成本。 diff --git a/skills/bailian-docs-llm-wiki/raw/model-api-reference/more-about-models/get-temporary-file-url.md b/skills/bailian-docs-llm-wiki/raw/model-api-reference/more-about-models/get-temporary-file-url.md index ca9090e..4c3b266 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-api-reference/more-about-models/get-temporary-file-url.md +++ b/skills/bailian-docs-llm-wiki/raw/model-api-reference/more-about-models/get-temporary-file-url.md @@ -4,7 +4,9 @@ ## **使用限制** -- **文件与模型绑定**：文件上传时必须指定模型名称，且该模型须与后续调用的**模型一致**，不同模型无法共享文件。此外，不同模型对文件大小有不同限制，超出限制将导致上传失败。 +- **文件与模型绑定**：文件上传时必须指定模型名称，且该模型须与后续调用的**模型一致**，不同模型无法共享文件。 + +- **文件大小限制**：接口上传文件大小不得超过**1GB**，超出限制将导致上传失败。此外，不同模型对输入文件大小有不同限制，超出限制将导致模型调用失败。 - **文件与主账号绑定**：文件上传与模型调用所使用的 API Key 必须**属于同一个阿里云主账号**，且上传的文件仅限该主账号及其对应模型使用，无法被其他主账号或其他模型共享。 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 a2b621d..4fa36c1 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 @@ -617,6 +617,14 @@ qwen3.7-plus 5,000,000 +qwen3.7-plus-us + +美国 + +15,000 + +5,000,000 + qwen3.7-plus-2026-05-26 全球 diff --git a/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-deployment-1/model-deployment-introduction.md b/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-deployment-1/model-deployment-introduction.md index bd4ef2a..6b46008 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-deployment-1/model-deployment-introduction.md +++ b/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-deployment-1/model-deployment-introduction.md @@ -390,7 +390,7 @@ qwen3-vl-plus-2025-09-23 ¥28.8 -## GLM +## 更多模型 **模型名称** @@ -418,7 +418,7 @@ GLM-5.2 glm-5.2 -1Million +1M ¥28.8 @@ -959,6 +959,16 @@ MU1 x 4 ¥104,472 +Qwen-Plus-Character-2025-11-06 + +qwen-plus-character-2025-11-06 + +MU1 x 4 + +¥216 + +¥104,472 + #### GLM **模型名称** diff --git a/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-evaluation-introduction/model-evaluation-overview.md b/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-evaluation-introduction/model-evaluation-overview.md index 36982f3..9f57502 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-evaluation-introduction/model-evaluation-overview.md +++ b/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-evaluation-introduction/model-evaluation-overview.md @@ -1,2835 +1,547 @@ # 模型评测 -基于数据集对模型进行多维度评测有助于您全面了解其表现，从而确保模型在未来实际应用中能够提供有效的结果。 +模型评测是百炼平台提供的模型能力评估功能，支持自定义评测和基线评测两种方式，帮助您通过评测维度对模型推理结果进行打分和对比，选择最优模型或验证调优效果。 -**说明** - -## **快速开始** - -### 什么是模型评测 - -模型评测是百炼平台提供的模型质量验证工具，帮助您客观、量化地评估大语言模型的表现。 - -**一句话总结**：给模型出一套测试题，自动或人工打分，最后生成评测报告。 - -### **为什么要做模型评测** - -## 场景1：模型选型决策 - -**问题**：面对十几个大模型（千问、GPT、Claude、文心一言等），不知道哪个更适合我的业务。 - -**解决方案**： - -1. 准备100条业务场景的测试数据 - -2. 用相同数据评测所有候选模型 - -3. 对比评测报告（得分、通过率、典型样本表现） - -4. 选择最符合业务需求的模型 - - -**价值**： - -- 避免主观判断，用数据说话 - -- 节省人工逐个测试的时间 - -- 降低选型错误的风险 - - -## 场景2：模型调优效果验证 +## 模型评测概述 -**问题**：对千问进行了模型调优（提供了1000条训练数据），不确定调优是否真的有效。 +模型评测是百炼平台提供的模型能力评估功能，支持自定义评测和基线评测两种方式，通过评测维度对模型推理结果进行打分和对比，生成评测报告和排行榜。您可以使用预置模型或调优后的模型作为评测对象，量化模型表现并辅助选型决策。当前仅支持文本生成类模型评测。更多功能介绍请参见[模型评测产品概览](#)。 -**解决方案**： +### 使用场景 -1. 准备评测数据集（与训练集不重叠） +- **模型选型对比**：使用相同的评测数据集和维度评测多个候选模型，通过排行榜横向对比综合得分和通过率，用数据驱动选型决策。 -2. 分别评测调优前和调优后的模型 - -3. 对比两次评测结果： - - - 调优前得分：75分 - - - 调优后得分：85分 - - - 结论：调优有效，提升了10分 - - -**价值**： - -- 量化调优效果，验证投入是否值得 +- **调优效果验证**：对模型调优前后分别执行评测，对比评分变化，量化调优带来的能力提升。调优操作请参见[模型调优](#)。 -- 识别调优方向是否正确 +- **能力量化评估**：生成包含综合得分、通过率和分数分布的评测报告，为团队协作和管理层汇报提供客观数据支撑。 -- 为持续优化提供数据支持 +- **持续质量监控**：建立定期评测机制，使用相同评测条件追踪模型表现趋势，及时发现模型能力下降。 -## 场景3：模型能力量化评估 +### 自定义评测与基线评测 -**问题**：需要向团队或管理层汇报模型在特定任务上的表现，但缺少客观数据。 +自定义评测使用您的数据集和自定义维度进行评测，支持以下三种评分方式： -**解决方案**： - -1. 使用评测功能生成评测报告 +- **大模型评估（AI 自动评测）**：由裁判模型（如千问-Max）对被评测模型的回答进行评分。数值型维度输出评分区间内的整数分，分类型维度输出 Pass/Fail 标签。适用于问答质量、内容安全等需要语义理解的场景。 -2. 报告包含： +- **规则评估（自动化指标）**：使用算法直接计算评分，无需裁判模型。字符串匹配判断输出是否与参考答案精确匹配，文本相似度使用 ROUGE、BLEU、Cosine 等算法计算。适用于翻译、摘要、Function Calling 等有确定性标准的场景。 - - 综合得分：85/100 - - - 通过率：90%（达到3分阈值的样本占比） - - - 分数分布：5分30条、4分40条、3分20条、2分10条 - - - 典型案例：高分样本、低分样本 - -3. 用报告数据支撑决策和汇报 +- **人工评估（人工标注）**：由人工逐条查看模型推理结果并标注 Pass/Fail 标签。适用于创意性写作、专业领域判断等机器难以准确评价的场景。 -**价值**： +基线评测使用公开标准数据集快速评测模型基础能力，仅北京地域可用，详见[创建基线评测任务](#sec-baseline)。两种评测方式的对比如下： -- 用数据替代主观描述（"还不错" → "得分85分，通过率90%"） - -- 便于跨团队沟通和对齐认知 - -- 为后续优化提供基线参考 - +**对比项** -## **场景4：持续监控模型表现** +**自定义评测** -**问题**：模型上线后，随着时间推移或业务变化，模型表现可能下降，但很难及时发现。 +**基线评测** -**解决方案**： +数据来源 -1. 建立定期评测机制（如每月一次） - -2. 使用相同的评测数据集和评测维度 - -3. 追踪模型表现趋势： - - - 2024年1月：得分85 - - - 2024年2月：得分87（提升） - - - 2024年3月：得分78（下降，需要排查） - +用户数据集或推理结果集 -**价值**： +公开标准数据集（平台预设） -- 及时发现模型表现下降 - -- 为模型迭代提供数据依据 - -- 建立模型能力档案 - +评测维度 -### **核心价值总结** +自定义创建 -**价值** +系统预设（不可配置） -**说明** +评分方式 -**客观量化** +AI 评测 / 规则评估 / 人工标注 -用数据替代主观判断，避免“感觉还行”的模糊描述 +系统自动评分 -**高效对比** +结果下载 -快速对比多个模型，节省人工测试时间 +支持 -**风险控制** +不支持 -上线前充分验证，降低模型选型错误的风险 +可用范围 -**持续优化** +全地域 -为模型调优和迭代提供量化的效果反馈 +仅北京地域 -**决策支持** +### 评测流程与核心术语 -为团队协作和管理层汇报提供数据支撑 +评测的端到端流程分为四个阶段：准备数据集（在数据管理模块上传评测集类型的数据）→ 创建评测维度（定义评分标准和方式）→ 创建评测任务（选择模型、关联数据集和维度）→ 查看结果（分析得分报告，可选加入排行榜对比）。 -### 评测流程 +使用前需区分两个核心概念：**评分器 Prompt** 配置于评测维度，指导裁判模型如何给被评测模型的回答打分。**System Prompt** 配置于评测任务，为被评测模型设定角色定位或行为规范，通常可留空。两者作用对象和费用归属不同。 -**阶段** +## 快速入门 -**子步骤说明** +本节以最短路径引导您完成第一次模型评测。每步给出控制台导航路径和关键表单字段的最小配置，完成以下四步后，您将获得一份包含综合得分和通过率的评测报告。 -**1\. 准备工作** +**前提条件** -评测维度（定义评分标准）→ 测试数据（准备问题和答案） +- 已开通阿里云百炼账号，可通过[百炼控制台](https://bailian.console.aliyun.com/#/efm/model_evaluate/task/creation)访问模型评测功能。 + +- 已准备评测数据集：在数据管理模块上传评测集（EvaluationSet）类型的数据，包含 Prompt（用户问题）和 Completion（参考答案）两列。 + -**2\. 创建评测任务** +![image](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/9455233871/p1085616.png) -选择模型 → 选择数据 → 选择维度 → 是否参与排行（决定是否加入排行榜） +**操作步骤** -**3\. 执行评测** +1. **创建评测维度**：在控制台左侧导航栏选择**模型评测**，切换到**评测维度** Tab，单击**创建评测维度**。最小配置：维度类型选择大模型评估-数值型，裁判模型选择千问-Max，评分器模板选择综合评测，评分范围保持 0-5，通过阈值设为 3.0。详细配置请参见[创建评测维度](#sec-dimension)。 + +2. **创建评测任务**：切换到**评测任务** Tab，单击**创建评测任务**，评测方式选自定义。最小配置：选择被评测模型，数据来源选择评测数据集并指定已上传的数据集，关联上一步创建的维度，排行参与保持关闭。确认后单击**开始评测**。详细配置请参见[创建自定义评测任务](#sec-create-task)。 + +3. **等待评测完成**：提交后任务进入待执行状态，随后自动转为进行中。评测耗时取决于数据量和模型推理速度，50 条数据通常在数分钟内完成。 + +4. **查看评测结果**：任务完成后，单击任务名称打开详情页。在**指标统计** Tab 查看综合得分和通过率，在**数据明细** Tab 查看每条数据的逐项评分。详细解读请参见[查看评测结果](#sec-results)。 + -自动评测（系统自动完成）或人工评测（需要手动标注） +## 创建评测维度 -**4\. 查看结果** +评测维度定义了模型如何被评分的标准。使用前须先创建至少一个评测维度。百炼支持 5 种评测维度类型，请根据业务场景选择合适的类型。 -得分报告 → 通过率统计 → 详细明细 +维度类型创建后不可修改。选错类型需删除维度重新创建，已关联该维度的评测任务不受影响。 -### **快速体验** +根据您的业务场景，选择合适的维度类型： -**评测场景**：评测千问-Max在常识问答任务中的准确性 +**维度类型** -**完整案例**：使用10条测试问题，评估模型回答的语义相似度 +**评分方式** -**体验步骤**： +**适用场景** -#### 1\. 创建评测维度 +**裁判模型费用** -**界面位置**：进入[模型评测](https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.7a0561433XjjyF&tab=model#/efm/model_evaluate)页面，选择**评测维度**Tab，点击右上角**创建评测维度**按钮 +大模型评估-数值型 -填写表单点击**保存**按钮 +裁判模型打分（整数，如 0-5） -**项目** +问答质量、内容生成 -**填写内容** +有 -**维度名称** +大模型评估-分类型 -常识问答准确性 +裁判模型标签（Pass/Fail） -**描述** +内容安全、正确性判断 -评估模型回答常识问题的准确性 +有 -**类型** +规则评估-文本相似度 -选择**大模型评估-数值型** +ROUGE/BLEU/Cosine 等算法 -**裁判模型** +翻译、摘要 -选择**千问-Max** +无 -**评分器模版** +规则评估-字符串匹配 -选择**语义相似度** +相等/不相等/包含 -**评分范围** +Function Calling、NL2SQL -保持默认0~5 +无 -**通过阈值** +人工评估-分类型 -3.0 +人工标注 Pass/Fail -**相关说明**： +创意性写作、专业判断 -关于**评分器模版**的选择，界面上有3个单选按钮，可以选择其中一个（Prompt变量说明参见，和System Prompt的区别请参见） +无 -**模板** +![image](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/9455233871/p1085617.png) -**说明** +在[百炼控制台的模型评测页面](https://bailian.console.aliyun.com/#/efm/model_evaluate/dimension_template)，选择**评测维度** Tab，单击**创建评测维度**。各维度类型的完整配置详解也可参见[评测维度](#)。 -**适用场景** +### 大模型评估 -**是否需要自定义Prompt** +**数值型维度**：选择裁判模型（推荐千问-Max，推理能力强），选择评分器模板（综合评测适用通用对话、语义相似度适用知识问答、自定义评测适用特定业务），设置评分范围（默认 0-5 整数），设置通过阈值（默认 3.0，步长 0.1，评分达到此值判定为 Pass）。 -**综合评测** （默认） +**分类型维度**：选择裁判模型，选择评分器模板（标准匹配判断输出与参考答案是否一致、情感分析识别积极/中性/消极情感、自定义评分器适用自定义场景），设置 Pass 标签和 Fail 标签。两组标签不能有重复项，有重复会阻止提交。 -系统预置模板，从5个维度评分（相关性、文化敏感性、信息丰富性、清晰性、用户参与度） +### 规则评估 -通用对话、客服场景 +**文本相似度维度**：选择相似度算法。支持 7 种算法：ROUGE-1、ROUGE-2、ROUGE-L（适用文本摘要）、BLEU（适用翻译）、Cosine（适用语义理解和开放问答）、Fuzzy Match（适用 OCR 和语音识别）、Accuracy（适用精确匹配场景）。 -不需要，可以直接使用该Prompt或对其进行改写 +**字符串匹配维度**：选择匹配规则，支持相等、不相等、包含三种方式。Function Calling 验证场景通常选择包含，固定答案场景选择相等。 -**语义相似度** +### 人工评估与 Prompt 变量 -系统预置模板，评估输出与参考答案的语义接近程度 +**人工评估-分类型维度**：设置 Pass 标签和 Fail 标签。人工评估不涉及裁判模型，由人工逐条标注。标签设计应简洁明确，覆盖所有可能的评判结果。 -问答系统、知识检索 +大模型评估维度在自定义评分器 Prompt 时，可使用以下变量：${prompt}（用户问题）、${output}（模型回答）、${completion}（参考答案）。自定义 Prompt 须至少包含一个变量，否则系统将阻止提交。 -不需要，可以直接使用该Prompt或对其进行改写 +维度名称最长 20 字符，描述最长 100 字符。 -**自定义评测** +## 创建自定义评测任务 -自己编写Prompt +创建评测任务前，请确认已创建至少一个评测维度，并已在数据管理模块上传评测数据集。在[百炼控制台的模型评测页面](https://bailian.console.aliyun.com/#/efm/model_evaluate/task/creation)，选择**评测任务** Tab，单击**创建评测任务**，选择自定义评测。 -特定业务场景 +![image](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/9455233871/p1085618.png) -需要，根据实际情况进行编写 +### 选择评测模型 -#### 2\. 准备测试数据 +从控制台模型列表中选择要评测的目标模型。支持预置模型和调优后的模型，具体支持的模型请参见[预置模型列表](#)。 -**界面位置**：进入[数据管理](https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.7a0561433XjjyF&tab=model#/efm/model_data)页面，点击右上角**新增数据集**按钮 +### 配置数据来源 -填写表单并点击**确认**按钮 +数据来源支持两种方式： -**项目** +- **评测数据集**：包含 Prompt（用户问题）和 Completion（参考答案），系统调用被评测模型推理生成 Output 后再评分，会产生推理费用。须为评测集（EvaluationSet）类型且已发布版本，在数据管理模块提前上传。 + +- **推理结果集**：已包含模型 Output，系统直接评分不调用模型推理，不产生推理费用。适用于已有模型输出想降低成本的场景。 + -**填写内容** +**对比项** -**维度名称** +**评测数据集** -问答测试数据 +**推理结果集** -**描述** +数据内容 -选择**评测集**类型 +包含 Prompt 和 Completion -> ❗ 模型评测只能使用**评测集**类型的数据集，不支持训练集 +已包含模型 Output -**类型** +推理调用 -上传_案例数据\_问答测试数据.xlsx（ICMS 附件，file\_id=151014，需在线下载）_ +系统调用被评测模型推理 -#### 3\. 创建评测任务 +不调用模型推理 -**界面位置**：进入[模型评测](https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.7a0561433XjjyF&tab=model#/efm/model_evaluate)页面，选择**评测任务**Tab，点击右上角**创建评测任务**按钮 +推理费用 -填写表单并点击**开始评测**按钮 +产生 -**项目** +不产生 -**填写内容** +适用场景 -**维度名称** +首次评测、标准流程 -问答准确性测试 +已有模型输出，降低成本 -**评测对象** +数据要求 -选择**千问-Plus** +评测集类型且已发布版本 -**裁判模型** +按模板上传文件 -选择**千问-Max** +数据量建议：小规模验证 50-100 条，正式评测 200-500 条，全面评估 500 条以上。 -**System Prompt** +### 关联维度与排行设置 -留空，本次测试不需要，和评分器Prompt的区别请参见[System Prompt和评分器Prompt的区别](#b3a7a92de9aie) +从已创建的评测维度中多选要关联的维度，须提前在评测维度页面创建。 -**评分器模版** +推理参数（Temperature、TopP、System Prompt 等）按所选模型动态加载。System Prompt 为被评测模型设定角色定位，大多数场景可留空。 -选择**语义相似度**，数据集选择前面创建的“问答测试数据” +是否参与排行开关默认关闭。开启后须选择一个排行榜，评测结果将加入排行参与排名。排行榜绑定维度为空时系统将阻止提交并显示错误提示。 -**评分范围** +清空评测维度时系统会自动清空排行榜选择。任务名称最长 50 字符。配置完成后，单击**开始评测**提交任务。 -选择前面创建的“常识问答准确性” +## 创建基线评测任务 -**通过阈值** +基线评测使用公开标准数据集自动评测模型基础能力，无需您自行准备数据集或配置评测维度，快速获得基准分数。 -本次测试不参与 +> 基线评测仅北京地域可用。其他地域不显示此选项，属正常现象。 -#### 4\. 查看任务状态 +![image](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/9455233871/p1085620.png) -找到任务“问答准确性测试”，查看**评测状态**列： +### 创建流程 -- **待执行**：在请求高峰时段，评测任务需要排队等待执行 +1. 在[百炼控制台](https://bailian.console.aliyun.com/#/efm/model_evaluate/task/creation)，选择**评测任务** Tab，单击**创建评测任务**。 -- **进行中**：系统正在评测，请耐心等待 +2. 评测方式选择**基线评测**。 -- **评测完成**：评测已完成，可以查看结果 +3. 选择要评测的目标模型。 -- **评测失败**：评测任务执行失败 +4. 选择基线评测数据集。公开数据集分为学科类（C-Eval、MMLU、ARC）、数学类（GSM8K）和推理类（BBH、HellaSwag），按评测需求选择。 -- **评测终止**：评测任务被人工手动终止 +5. 单击**开始评测**提交任务。 -点击页面右上角刷新按钮（![image](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/0659913271/p833282.png)），当任务状态变为**评测完成**后，单击**任务名称**列，进入详情页。 +### 与自定义评测的区别 -- 选择**数据明细**Tab，查看每条数据详细评分 - - **列名** - - **说明** - - **状态** - - 评测状态：待执行、进行中、评测完成、评测失败、评测终止 - - **序号** - - 样本编号 - - **Prompt** - - 原始问题 - - **Completion** - - 参考答案 - - **Output** - - 模型生成的回答 - - **\[评测维度名称\]** - - 和评测维度相同，本次评测维度名称为“常识问答准确性”，本列表示评分结果 +- 基线评测不使用自定义评测维度，系统使用预设标准自动评分。 - **操作** +- 基线评测不支持推理结果集数据来源，仅使用平台预设的公开数据集。 - 用户可执行的操作，例如点击详情按钮，查看完整的问题、答案和评测结果 +- 基线评测任务不可下载评测结果。 -- 选择**指标统计**Tab，查看评测统计 +- 基线评测任务在任务列表中不显示综合得分和维度详情列（显示短横线）。 - **指标名称** +- 基线评测任务不可进入人工标注页面。 - **说明** - - **示例值** - - **综合得分** - - 评测维度的平均分 - - 100 - - **通过率** - - 达到阈值（≥3分）的样本占比 - - 90% - - **评测集总量** - - 测试数据总数 - - 10条 - - **已完成量** - - 已评测完成的数量 - - 10条 - - **未完成量** - - 未评测完成的数量 - - 0条 - - -## **核心概念** - -### **自定义评测和基线评测对比** - -**对比维度** - -[自定义评测](#ca62e68172vvo) - -[基线评测](#5684240babhdp) - -**适用场景** -业务场景评测、自定义标准 +## 查看评测结果 -模型通用能力验证（学科、数学、推理） +评测任务提交后，可在[评测任务列表](https://bailian.console.aliyun.com/#/efm/model_evaluate/task)中查看任务状态和评测结果。 -**评测标准** +![image](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/9455233871/p1085621.png) -自定义[评测维度](#68e71d9a28x86)（5种类型） +### 任务状态 -使用预置评测规则 +评测任务的状态按以下顺序流转：待执行 → 进行中 → 评测完成/评测失败/评测终止。 -**是否需要创建评测维度** +**状态** -必须创建 - -不需要 - -**数据来源** +**说明** -参见[自定义评测-评测数据](#ab05232983k0m) +**可执行操作** -- 评测数据集（自己准备） - -- 推理结果集（自己准备） - +待执行 -预置标准数据集（系统提供），参见[基线评测-评测数据](#354c3ed2840bw) +任务已提交，等待系统调度 -**数据格式** +终止 -Excel（2~3列：Prompt、Completion、Output） +进行中 -无需准备，直接选择 +正在执行评测 -**灵活性** +终止 -高，可自定义一切 +评测完成 -低，使用行业标准 +所有数据评测完毕 -**评测流程** +下载、删除、重命名 -**阶段** +评测失败 -**自定义评测（人工评估）** +数据格式问题或模型不可用 -**自定义评测（自动评估）** +删除 -**基线评测** +评测终止 -**阶段1：创建模型评测任务** +手动终止，已评测部分保留 -开始 → 创建评测维度 → 选择评测模型 → 选择评测数据 +下载、删除 -开始 → 创建评测维度 → 选择评测模型 → 选择评测数据 +### 数据明细与指标统计 -开始 → 选择评测模型 +任务状态变为评测完成后，单击任务名称进入详情页，包含以下两个 Tab： -**阶段2：执行模型评测任务** +**数据明细 Tab**：逐样本展示评测结果，每条数据包含 Prompt（用户问题）、模型 Output（模型回答）、参考 Completion（参考答案）以及各评测维度的评分。 -由您本人或您邀请的评分员对模型的回复效果评价 +**指标统计 Tab**：展示评测的汇总指标，包括综合得分（各维度的平均分）、通过率（评分达到通过阈值的样本占比）以及分数分布图。 -自动执行 +评测结果支持下载，便于离线分析和归档。待执行状态和基线评测任务不支持下载。 -自动执行 +### 结果分析建议 -**阶段3：查看模型评测结果** +分析评测结果时，建议关注分数分布而非仅看综合得分。综合得分是各维度的平均分，可能掩盖维度间的显著差异。例如综合得分 85 分可能是某些维度 95 分与某些维度 75 分的均值，需要逐维度分析才能发现短板。 -查看评测结果 → 结束 +1-3% 的分数差异通常为评测噪声而非模型能力差异，不建议仅凭微小分差做决策。使用人工评估维度的任务须全部数据标注完成后才变为评测完成状态，详细流程请参见[人工标注评测](#sec-manual)。 -查看评测结果 → 结束 +## 排行榜 -查看评测结果 → 结束 +排行榜用于在相同评测维度下对比多个模型的评测表现，帮助您直观判断各模型的优劣排序。 -**如何选择**： +![image](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/9455233871/p1085623.png) -- **首次使用 / 业务场景评测**：自定义评测（更灵活） - -- **调优后验证通用能力**：基线评测（快速对比） - -- **最佳实践**：两者结合使用 - +### 创建排行榜 -### **自定义评测** +在[百炼控制台的模型评测页面](https://bailian.console.aliyun.com/#/efm/model_evaluate/ranking)，选择**排行榜** Tab，单击**创建排行榜**。填写排行榜名称（最长 50 字符），选择评测维度（必填，创建后不可修改，选错需删除重建），可选关联已有的评测任务（须使用相同评测维度的已完成任务）。已绑定到该排行榜的任务不可重复添加。 -#### **支持的模型** +### 排行得分与使用 -支持下列[预置模型](https://help.aliyun.com/zh/model-studio/model-deployment-introduction)（包括基于它们[调优后的模型](https://help.aliyun.com/zh/model-studio/model-deployment-introduction)）： +排行榜得分范围为 0-100，基于关联评测维度的综合评分计算，与评测维度本身的评分范围（如 0-5）不同。排行榜前三名以色标区分：第 1 名金色、第 2 名银色、第 3 名铜色。 -- 千问-QwQ/Max/Plus/Turbo/Coder/Math - -- 千问开源版（Qwen3、Qwen2.5、Qwen2、Qwen1.5） - -- 通义法睿 - -- 第三方文本生成模型（abab6.5g、abab6.5t等） - +在排行榜详情页可直接创建评测任务。从排行榜入口进入时，评测维度和排行榜字段自动锁定，确保新任务与排行榜使用相同的评分标准。 -> 上述列表并不完整且可能随时发生变化，请以[创建评测任务](https://bailian.console.aliyun.com/?tab=model#/efm/model_evaluate/task/creation)页面中**评测模型**显示的列表为准。列表中灰色字体且无**申请**按钮的模型目前暂不支持评测。 +为确保模型对比的公平性，建议排行榜内所有评测任务使用相同的评测数据集。 -#### **评测维度** +## 人工标注评测 -评测维度就是评分标准，决定了如何给模型打分。自定义评测必须先创建评测维度。 +人工标注评测适用于需要人工判断的场景，如创意性写作、专业性内容评审等。使用人工评估-分类型维度创建的评测任务，需要人工逐条为模型推理结果标注 Pass/Fail 标签。基线评测任务不可进入人工标注页面。 -- **评测维度类型**（5种） - - **类型** - - **评分方式** - - **适用场景** - - **成本** - - **推荐度** - - **大模型评估-数值型** - - AI裁判打分（1-5分） - - 问答质量、内容生成质量 - - 中 - - ⭐⭐⭐⭐⭐ - - **规则评估-文本相似度** - - 算法计算相似度 - - 翻译、摘要、改写 - - 低 - - ⭐⭐⭐⭐ - - **大模型评估-分类型** - - AI裁判分类（Pass/Fail） - - 内容安全、正确性判断 - - 中 - - ⭐⭐⭐ - - **规则评估-字符串匹配** - - 精确字符串匹配 - - Function Calling、NL2SQL - - 极低 - - ⭐⭐⭐ - - **人工评估-分类型** - - 人工打标签 - - 创意性、专业判断 - - 高 - - ⭐⭐ - -- **如何快速选择评测维度类型？** - - 一个评测任务可以组合多个评测维度。 - +![image](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/9455233871/p1085624.png) -#### **评测数据** +### 标注流程 -- **数据来源类型** - - **数据类型** - - **说明** - - **工作流程** - - **适用场景** - - **评测数据集** - - 包含问题（prompt）和参考答案（completion） - - 系统调用模型实时推理 → 生成output → 评分器打分 - - - 首次评测 - - - 对比多个模型 - - - 模型尚未生成结果 - - - **推理结果集** - - 已包含模型输出（output） - - 系统直接读取output → 评分器打分（不推理） - - - 模型已生成结果 - - - 降低推理成本 - - - 作为对照组的基准模型 - - -- **数据格式要求**：Excel - -- **评测数据集示例**： - - **Prompt** - - **Completion** - - 什么是云计算？ - - 云计算是按需提供的共享计算资源池 - - Python如何定义函数？ - - 使用def关键字定义函数 - -- **推理结果集示例**： - - 多一列Output - - **Prompt** - - **Completion** - - **Output** - - 什么是云计算？ +1. 在[评测任务列表](https://bailian.console.aliyun.com/#/efm/model_evaluate/task)中，找到使用人工评估维度的评测任务，单击任务名称打开详情。 - 云计算是按需提供的共享计算资源池 +2. 在评测数据页面，逐条查看模型推理结果。每条数据展示 Prompt（用户问题）和模型 Output（模型回答）。 - 云计算是一种通过互联网提供计算资源的服务模式... +3. 根据评测标准为每条数据选择对应的标签（Pass 或 Fail 类别下的具体标签）。支持跳过当前数据，稍后再标注。 -- **数据量建议**： - - **阶段** - - **建议数量** - - **说明** - - 小规模验证 - - 50~100条 - - 验证配置是否正确 - - 正式评测 - - 200~500条 - - 获得可靠的统计结果 - - 全面评估 - - 500+条 - - 覆盖各种边界情况 - - -#### **排行榜** - -**什么是排行榜**： - -- 用于对比多个模型在同一评测维度上的表现 - -- 可视化展示模型优劣排序 - -- 支持多个评测任务的横向对比 +4. 使用上一题、下一题按钮在数据间翻页，直至所有数据标注完成。 -**何时需要排行榜**： - -- 需要对比多个模型的表现（如 GPT-4 vs Claude vs 千问） - -- 想要可视化展示模型在业务场景中的优劣 - -- 需要在团队内部分享模型对比结果 - +### 标注进度与任务状态 -#### **核心变量** +全部数据标注完成后，任务状态自动变为评测完成。标注完成前，任务始终处于进行中状态。 -**适用范围**：本节仅适用于**大模型评估-数值型**和**大模型评估-分类型**评测维度。 +与自动评测相比，人工评估无裁判模型评分费用，但需要人力投入且耗时更长。标签设计的详细说明请参见[创建评测维度](#sec-dimension)。 -在大模型评估时，裁判模型会接收以下三个变量： +## 管理评测任务和维度 -**变量名** +在[百炼控制台的模型评测页面](https://bailian.console.aliyun.com/#/efm/model_evaluate/task)，您可以对评测任务、评测维度和排行榜进行日常管理。 -**说明** +各管理操作的可逆性和影响范围如下表所示。执行不可逆操作前请确认影响。 -**示例** +**操作** -**使用场景** +**可逆性** -`${prompt}` +**影响说明** -原始输入：用户的问题或指令 +终止任务 -什么是云计算？ +不可逆 -所有场景都需要 +已评测数据保留，无法恢复继续 -`${output}` +删除任务 -模型输出：参评模型生成的回答 +不可逆 -云计算是一种通过互联网... +任务及结果永久删除 -所有场景都需要 +重命名 -`${completion}` +可逆 -参考答案：标准答案或期望输出 +仅影响显示名称 -云计算是按需提供的... +从排行榜移除任务 -有标准答案时使用 +可逆 -如何在Prompt中使用： +可重新添加 -``` -请评估以下回答的质量： +删除排行榜 -**用户问题**：${prompt} -**模型回答**：${output} -**参考答案**：${completion} +不可逆 -评分标准： -- 5分：回答完全正确，与参考答案语义一致 -- 4分：回答基本正确，有少量偏差 -- 3分：回答部分正确 -- 2分：回答大部分错误 -- 1分：回答完全错误或答非所问 -``` +不影响已关联的评测任务 -### **基线评测** +删除评测维度 -#### **支持的模型** +不可逆 -> 基线评测**仅支持**[**调优后的模型**](https://help.aliyun.com/zh/model-studio/model-deployment-introduction)**，**不支持预置模型（如千问-Max）。 +排行榜绑定维度为空将阻止新任务 -**为什么只支持调优模型**： +### 评测任务管理 -- 基线评测使用行业标准数据集（如 C-Eval、MMLU）评估模型能力 +- **终止任务**：仅进行中状态可用，操作不可逆。终止后已评测的部分数据保留但无法恢复继续，排行榜中该任务的得分列显示短横线。 -- 主要用于验证模型调优后的效果提升 +- **删除任务**：仅评测完成、评测终止、评测失败三种终态可用，操作不可逆。任务及其评测结果永久删除，已关联排行榜的任务需先从排行榜移除。 -- 可与业界其他模型对比 +- **重命名**：仅影响显示名称，不影响评测结果。 - -**如何确认你的模型是否支持**： - -1. 进入[创建评测任务](https://bailian.console.aliyun.com/?tab=model#/efm/model_evaluate/task/creation)页面 - -2. 选择“基线评测” - -3. 查看“选择模型”下拉列表 +- **下载结果**：下载评测结果数据文件。待执行状态和基线评测任务不支持下载。 -4. 如果列表为空，说明你还没有调优模型，需要先完成模型调优和部署（请参见[模型部署](https://help.aliyun.com/zh/model-studio/model-deployment-introduction)） +- **筛选和搜索**：支持按任务名称搜索、按状态筛选、按创建时间排序。 -#### **评测数据** - -基线评测无需准备评测数据，直接选择系统提供的数据：**学科**、**数学**或**推理**类的标准榜单（相应的评测集、评测逻辑、评测脚本与开源榜单数据保持一致，定期更新）。 - -> **学科**\*\*：\*\*用于评测模型在日常生活常识及学科知识方面的掌握情况。 - -> **数学**\*\*：\*\*用于评测模型解决基础数学问题的能力。 - -> **推理**\*\*：\*\*用于评测模型的中文自然语言推理能力，例如判断两个句子之间的逻辑关系（蕴含、矛盾）。 +### 评测维度管理 -**分类** +删除评测维度操作不可逆。已被排行榜绑定的维度删除后，排行榜绑定维度为空，会阻止在该排行榜下创建新评测任务。删除维度前请确认是否有排行榜在使用。 -**评测数据** +### 排行榜管理 -**说明** - -**学科** - -`C-Eval` - -C-Eval 主要用于评估模型对中文文本的理解和应用能力，它包含了数学、物理、化学、历史、地理、文学等52个不同的学科超过13,000道测试题。 - -`MMLU` - -MMLU 主要用于评估模型在广泛领域的知识掌握情况，它包含了STEM、人文学科、社会科学等57个学科超过57,000道测试题。 - -`ARC` - -ARC 主要用于评估模型在运用多种学科知识进行深度复杂推理的能力，它包含了超过7,900道来自生物学、物理学、化学等学科的测试题。 - -**数学** - -`GSM8K` - -GSM8K 主要用于评估模型解决基础数学问题的能力，它包含了超过8,000个小学数学问题。 - -**推理** - -`HellaSwag` - -HellaSwag 主要用于评估模型在日常生活常识推理方面的能力，它包含了超过70,000道推理测试题。 - -`BBH` - -BBH（Big-Bench Hard）主要用于评估模型的深度复杂推理和多步推理能力，它精选了来自 BIG-Bench 的23个具有挑战性的测试题，涵盖逻辑推理、语言理解和创造性思维等领域。 +删除排行榜不影响已关联的评测任务和评测结果。从排行榜移除任务是可逆操作，移除后可重新添加。 -#### **基线评测特有的报告内容** - -基线评测的结果报告与自定义评测不同，提供以下特有内容： - -1. **分学科得分明细**（C-Eval 和 MMLU） - - 可以查看模型在每个学科的得分，例如： - - - 计算机科学：85% - - - 法律：72% - - - 医学：68% - - - 数学：90% - -2. **能力雷达图** - - 可视化展示模型在不同维度的能力： - - - 知识掌握 - - - 推理能力 - - - 数学能力 - - - 常识理解 - -3. **行业对比** - - 将你的模型与业界标准模型对比： - - - GPT-4：XX分 - - - 你的模型：XX分 - - - Claude：XX分 - +## 计费说明 -### **System Prompt和评分器Prompt的区别** +模型评测的费用由两部分构成：被评测模型的推理费用和裁判模型的评分费用。具体模型单价请参见[预置模型列表](#)中的定价说明。 -在模型评测中，有两种容易混淆的Prompt配置，它们在不同环节发挥作用： +不同维度类型的费用构成如下： -**Prompt类型** +**维度类型** -**配置位置** +**被评测模型推理费** -**作用对象** +**裁判模型评分费** -**作用阶段** +大模型评估（数值型/分类型） -**是否必填** +按 Token 计费 -**费用归属** +按 Token 计费 -**System Prompt** +规则评估（字符串匹配/文本相似度） -创建**评测任务**时 +按 Token 计费 -被评测模型 +无 -模型生成答案时 +人工评估（分类型） -否 +按 Token 计费 -[被评测模型推理费用](#yqzesbsyyqjnq) +无 -**评分器Prompt** +使用推理结果集时 -创建**大模型评估-数值型**和**大模型评估-分类型**评测维度时 +无（不调用模型推理） -裁判模型 +按维度类型决定 -裁判模型给答案打分时 +### 被评测模型推理费用 -是 +使用评测数据集作为数据来源时，系统调用被评测模型进行推理，按 Token 消耗量计费。计算公式：输入 Token 数 / 1M x 输入单价 + 输出 Token 数 / 1M x 输出单价。 -[裁判模型评分费用](#umkkwesx5u3my) +已部署的调优模型评测不额外计费，推理费用已包含在部署算力费用中。 -#### **详细说明** +使用推理结果集作为数据来源时无需执行模型推理，不产生被评测模型推理费用。 -- **System Prompt** - - - **用途**：为被评测模型设定角色定位或行为规范 - - - **示例场景**： - - - 评测客服场景：“你是一位专业的客服人员，请礼貌、准确地回答客户问题。” - - - 评测代码助手：“你是一位编程专家，请提供准确、简洁的代码示例。” - - - **何时使用**：仅在需要给被评测模型设定特定身份或约束时填写，大多数情况下可以留空 - -- **评分器Prompt** - - - **用途**：告诉裁判模型如何评判答案质量、评分标准是什么 - - - **适用范围**：仅**大模型评估-数值型**和**大模型评估-分类型**评测维度需要配置 - - - **配置方式**： - - - 选择系统预置模板（综合评测、语义相似度、情感分析等） - - - 自定义编写（适用于特定业务场景） - - - ：评分器Prompt中可使用 ${prompt}、${output}、${completion} 变量 - - -#### **形象比喻** - -- **System Prompt**：告诉“学生”（被评测模型）考试时应该以什么身份答题 - -- **评分器Prompt**：告诉“阅卷老师”（裁判模型）如何批改试卷、打分标准是什么 - +基线评测计费与自定义评测相同，按推理 Token 消耗计费。 -## **分场景实践案例** +### 裁判模型评分费用 -### **自定义评测****：****大模型评估-数值型****评测维度** +仅大模型评估维度（数值型和分类型）涉及裁判模型评分费用，按 Token 消耗计费。规则评估（字符串匹配和文本相似度）和人工评估不使用裁判模型，无评分费用。 -**适用场景**：需要细粒度评分的场景，如问答质量、内容生成质量、客服对话质量等 +由于模型推理输出长度不确定，系统无法在评测前预估总费用，以实际发生为准。 -**使用建议**： +### 成本优化策略 -- 评分标准要具体化，为每个分数档提供清晰描述 +- **先小规模验证**：使用 50-100 条数据验证配置正确性和评分质量，确认无误后再扩大数据规模，避免配置错误导致的无效消耗。 -- 定期人工抽查高分和低分样本，验证准确性 +- **保存推理结果集复用**：首次评测后下载包含模型 Output 的结果，后续评测使用推理结果集方式，避免重复推理产生费用。 -- 避免所有样本都集中在某个分数段 +- **优先选规则评估**：规则评估无裁判模型费用，是成本最低的评测方式。翻译、摘要、Function Calling 等有确定性标准的场景优先使用。 -**操作步骤**： - -## 1\. 创建评测维度 - -**界面位置**：进入[模型评测](https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.7a0561433XjjyF&tab=model#/efm/model_evaluate)页面，选择**评测维度**Tab，点击右上角**创建评测维度**按钮 - -填写表单点击**保存**按钮 +## 常见问题 -**项目** +**问题**：提交评测任务后状态显示失败。 -**填写内容** - -**维度名称** - -常识问答准确性 - -**描述** - -评估模型回答常识问题的准确性 - -**类型** - -选择**大模型评估-数值型** - -**裁判模型** - -选择**千问-Max** - -**评分器模版** - -选择**语义相似度** - -**评分范围** - -保持默认0~5 - -**通过阈值** - -3.0 - -**相关说明**： - -关于**评分器模版**的选择，界面上有3个单选按钮，可以选择其中一个（Prompt变量说明参见，和System Prompt的区别请参见） - -**模板** - -**说明** - -**适用场景** - -**是否需要自定义Prompt** - -**综合评测** （默认） - -系统预置模板，从5个维度评分（相关性、文化敏感性、信息丰富性、清晰性、用户参与度） - -通用对话、客服场景 - -不需要，可以直接使用该Prompt或对其进行改写 - -**语义相似度** - -系统预置模板，评估输出与参考答案的语义接近程度 - -问答系统、知识检索 - -不需要，可以直接使用该Prompt或对其进行改写 - -**自定义评测** +请依次检查：数据集必须为评测集（EvaluationSet）类型并已发布版本（训练集不可用于评测），模型是否可选（灰色表示暂不支持），数据格式是否正确（须包含 Prompt 和 Completion 列）。 -自己编写Prompt +**问题**：评测完成但评分结果不符合预期，分数集中在某个分数段或区分度低。 -特定业务场景 +首先检查评分器 Prompt 是否有明确的评分标准和正确的变量引用。模糊的评分标准会导致裁判模型评分集中在某个分数段。建议为每个分数档提供清晰的判定条件描述。 -需要，根据实际情况进行编写 +其次确认裁判模型的推理能力是否足够（推荐千问-Max）。LLM 评分器存在位置偏差和自我偏好偏差，建议定期人工抽查校准。优化评分器 Prompt 可参考[Prompt 最佳实践](#)。 -## 2\. 准备测试数据 +**问题**：创建评测维度时选错了维度类型，想修改但找不到入口。 -**界面位置**：进入[数据管理](https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.7a0561433XjjyF&tab=model#/efm/model_data)页面，点击右上角**新增数据集**按钮 +维度类型一经创建不可修改。处理方式：删除该维度后重建。已有任务引用不受影响。 -填写表单并点击**确认**按钮 +**问题**：创建评测任务时选错了被评测模型，想更换模型。 -**项目** +任务一旦提交不可更换目标模型。处理方式：删除任务后重建。已消耗的 Token 费用不可追回。 -**填写内容** +**问题**：配置评测维度时，评分范围和通过阈值容易混淆。 -**维度名称** +评分范围定义裁判模型的打分区间（整数，如 0-5），决定评分粒度。通过阈值是判定 Pass/Fail 的分界线（支持小数，步长 0.1，如 3.0），用于统计通过率。两者独立配置：前者决定"模型能得几分"，后者决定"几分算及格"。 -问答测试数据 +**问题**：创建评测任务时看不到基线评测选项。 -**描述** +基线评测仅限北京地域使用。如果您在其他地域，评测方式只显示自定义评测，这是预期行为。 -选择**评测集**类型 +**问题**：想通过 API 或 SDK 自动化评测流程。 -> ❗ 模型评测只能使用**评测集**类型的数据集，不支持训练集 +模型评测当前仅支持控制台操作，不提供公开 API/SDK。如需编程化评测能力，可参考 PAI Judge Model API 作为替代方案。 -**类型** +**问题**：评测发现模型在特定场景表现不足。 -上传_案例数据\_问答测试数据.xlsx（ICMS 附件，file\_id=151014，需在线下载）_ - -## 3\. 创建评测任务 - -**界面位置**：进入[模型评测](https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.7a0561433XjjyF&tab=model#/efm/model_evaluate)页面，选择**评测任务**Tab，点击右上角**创建评测任务**按钮 - -填写表单并点击**开始评测**按钮 - -**项目** - -**填写内容** - -**维度名称** - -问答准确性测试 - -**评测对象** - -选择**千问-Plus** - -**裁判模型** - -选择**千问-Max** - -**System Prompt** - -留空，本次测试不需要，和评分器Prompt的区别请参见[System Prompt和评分器Prompt的区别](#b3a7a92de9aie) - -**评分器模版** - -选择**语义相似度**，数据集选择前面创建的“问答测试数据” - -**评分范围** - -选择前面创建的“常识问答准确性” - -**通过阈值** - -本次测试不参与 - -## 4\. 查看任务状态 - -找到任务“问答准确性测试”，查看**评测状态**列： - -- **待执行**：在请求高峰时段，评测任务需要排队等待执行 - -- **进行中**：系统正在评测，请耐心等待 - -- **评测完成**：评测已完成，可以查看结果 - -- **评测失败**：评测任务执行失败 - -- **评测终止**：评测任务被人工手动终止 - - -点击页面右上角刷新按钮（![image](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/0659913271/p833282.png)），当任务状态变为**评测完成**后，单击**任务名称**列，进入详情页。 - -- 选择**数据明细**Tab，查看每条数据详细评分 - - **列名** - - **说明** - - **状态** - - 评测状态：待执行、进行中、评测完成、评测失败、评测终止 - - **序号** - - 样本编号 - - **Prompt** - - 原始问题 - - **Completion** - - 参考答案 - - **Output** - - 模型生成的回答 - - **\[评测维度名称\]** - - 和评测维度相同，本次评测维度名称为“常识问答准确性”，本列表示评分结果 - - **操作** - - 用户可执行的操作，例如点击详情按钮，查看完整的问题、答案和评测结果 - -- 选择**指标统计**Tab，查看评测统计 - - **指标名称** - - **说明** - - **示例值** - - **综合得分** - - 评测维度的平均分 - - 100 - - **通过率** - - 达到阈值（≥3分）的样本占比 - - 90% - - **评测集总量** - - 测试数据总数 - - 10条 - - **已完成量** - - 已评测完成的数量 - - 10条 - - **未完成量** - - 未评测完成的数量 - - 0条 - - -### **自定义评测：大模型评估-分类型评测维度** - -**适用场景**：需要进行“是/否”、“通过/不通过”等正反判断的场景，如内容安全、答案正确性等 - -**使用建议**： - -- 在Prompt中详细说明每个标签的判定条件 - -- 明确要求裁判模型只输出标签名称 - -- 定期人工抽检部分样本，确保准确性 - - -**操作步骤**： - -## 1\. 创建评测维度 - -**界面位置**：进入[模型评测](https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.7a0561433XjjyF&tab=model#/efm/model_evaluate)页面，选择**评测维度**Tab，点击右上角**创建评测维度**按钮 - -填写表单点击**保存**按钮 - -**项目** - -**填写内容** - -**维度名称** - -情感分析 - -**描述** - -检测客户的情感 - -**类型** - -选择**自动** - -**裁判模型** - -选择**千问-Max** - -**评分器模版** - -选择**情感分析** - -**评分范围** - -不必修改，使用默认内容 - -**相关说明**： - -关于**评分器模版**的选择，界面上有3个单选按钮，可以选择其中一个（Prompt变量说明参见，和System Prompt的区别请参见） - -**模板** - -**说明** - -**适用场景** - -**是否需要自定义Prompt** - -**标准匹配** （默认） - -系统预置模板，判断模型输出是否与参考答案一致 - -分类标签、函数名、固定答案 - -不需要，可以直接使用该Prompt或对其进行改写 - -**情感分析** - -系统预置模板，分析文本情感倾向（积极/中性/消极） - -用户评论、客服对话、舆情监控 - -不需要，可以直接使用该Prompt或对其进行改写 - -**自定义评分器** - -自己编写Prompt - -自定义场景，如风格判断、合规检查、逻辑校验 - -需要，根据实际情况进行编写 - -## 2\. 准备测试数据 - -**界面位置**：进入[数据管理](https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.7a0561433XjjyF&tab=model#/efm/model_data)页面，点击右上角**新增数据集**按钮 - -填写表单并点击**确认**按钮 - -**项目** - -**填写内容** - -**维度名称** - -情感分析测试数据 - -**描述** - -选择**评测集**类型 - -> ❗ 模型评测只能使用**评测集**类型的数据集，不支持训练集 - -**类型** - -上传_案例数据\_情感分析.xlsx（ICMS 附件，file\_id=151061，需在线下载）_ - -## 3\. 创建评测任务 - -**界面位置**：进入[模型评测](https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.7a0561433XjjyF&tab=model#/efm/model_evaluate)页面，选择**评测任务**Tab，点击右上角**创建评测任务**按钮 - -填写表单并点击**开始评测**按钮 - -**项目** - -**填写内容** - -**维度名称** - -情感分析测试 - -**评测维度** - -选择**情感分析** - -**裁判模型** - -选择**千问-Max** - -**System Prompt** - -留空，本次测试不需要，和评分器Prompt的区别请参见[System Prompt和评分器Prompt的区别](#b3a7a92de9aie) - -**评分器模版** - -选择**语义相似度**，数据集选择前面创建的“情感分析测试数据” - -**评分范围** - -选择前面创建的“情感分析” - -**通过阈值** - -本次测试不参与 - -## 4\. 查看任务状态 - -找到任务“情感分析测试”，查看**评测状态**列： - -- **待执行**：在请求高峰时段，评测任务需要排队等待执行 - -- **进行中**：系统正在评测，请耐心等待 - -- **评测完成**：评测已完成，可以查看结果 - -- **评测失败**：评测任务执行失败 - -- **评测终止**：评测任务被人工手动终止 - - -点击页面右上角刷新按钮（![image](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/0659913271/p833282.png)），当任务状态变为**评测完成**后，单击**任务名称**列，进入详情页。 - -- 选择**数据明细**Tab，查看每条数据详细评分 - - **列名** - - **说明** - - **状态** - - 评测状态：待执行、进行中、评测完成、评测失败、评测终止 - - **序号** - - 样本编号 - - **Prompt** - - 原始问题 - - **Completion** - - 参考答案 - - **Output** - - 模型生成的回答 - - **\[评测维度名称\]** - - 和评测维度相同，本次评测维度名称为“情感分析”，本列表示分析结果 - - **操作** - - 用户可执行的操作，例如点击详情按钮，查看完整的问题、答案和评测结果 - -- 选择**指标统计**Tab，查看评测统计 - - **指标名称** - - **说明** - - **示例值** - - **综合得分** - - 评测维度的平均分 - - 40 - - **通过率** - - Pass的样本占比 - - 40% - - **得分明细 - 数据项分布** - - 分类型评估维度的统计结果分布 - - **评测集总量** - - 测试数据总数 - - 10条 - - **已完成量** - - 已评测完成的数量 - - 10条 - - **未完成量** - - 未评测完成的数量 - - 0条 - - -### **自定义评测：大模型评估-数值型评测维度** - -**适用场景**：需要对模型回答进行多维度综合评分的场景，如回答质量评估、内容安全评分、翻译质量评分等 - -**使用建议**： - -- 合理设置评分范围和通过阈值，建议先小规模测试再批量评测 - -- 选择合适的评分器模版：综合评测适合通用场景，语义相似度适合有标准答案的场景 - -- 自定义评分器Prompt时，需明确评分标准和取值范围 - - -**操作步骤**： - -## 1\. 创建评测维度 - -**界面位置**：进入[模型评测](https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.7a0561433XjjyF&tab=model#/efm/model_evaluate)页面，选择**评测维度**Tab，点击右上角**创建评测维度**按钮 - -填写表单点击**保存**按钮 - -**项目** - -**填写内容** - -**维度名称** - -综合质量评估 - -**描述** - -评估模型回答的综合质量 - -**类型** - -选择**大模型评估-数值型** - -**裁判模型** - -选择**千问-Max** - -**评分器模版** - -选择**综合评测**（默认） - -**Prompt** - -不必修改，使用默认内容 - -**评分范围** - -使用默认值**0**\-**5** - -**通过阈值** - -使用默认值**3.0**，即评分≥3.0的样本判定为Pass - -**相关说明**： - -关于**评分器模版**的选择，界面上有3个单选按钮，可以选择其中一个（Prompt变量说明参见，和System Prompt的区别请参见） - -**模板** - -**说明** - -**适用场景** - -**是否需要自定义Prompt** - -**综合评测** （默认） - -系统预置模板，从相关性、文化敏感性、信息丰富性、清晰性和用户参与度5个维度进行综合评分 - -通用的回答质量评估 - -不需要，可以直接使用该Prompt或对其进行改写 - -**语义相似度** - -系统预置模板，评估模型输出与参考答案之间的语义相似程度 - -有明确参考答案的场景，如知识问答、翻译 - -不需要，可以直接使用该Prompt或对其进行改写 - -**自定义评测** - -自己编写Prompt，需在Prompt中说明评分标准和取值范围 - -自定义场景，如专业领域评估、特定指标评分 - -需要，根据实际情况进行编写 - -关于**评分范围**和**通过阈值**： - -- **评分范围**：设置裁判模型评分的最小值和最大值（整数），默认为0-5。裁判模型将在此区间内为每条评测数据打分 - -- **通过阈值**：大于等于该阈值的评分判定为Pass，低于该阈值判定为Fail。阈值范围受评分范围约束，支持小数（步长0.1），默认为3.0 - - -## 2\. 准备测试数据 - -**界面位置**：进入[数据管理](https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.7a0561433XjjyF&tab=model#/efm/model_data)页面，点击右上角**新增数据集**按钮 - -填写表单并点击**确认**按钮 - -**项目** - -**填写内容** - -**维度名称** - -综合质量评估测试数据 - -**描述** - -选择**评测集**类型 - -> ❗ 模型评测只能使用**评测集**类型的数据集，不支持训练集 - -**类型** - -上传测试数据文件（JSONL格式），每行包含prompt和completion字段 - -## 3\. 创建评测任务 - -**界面位置**：进入[模型评测](https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.7a0561433XjjyF&tab=model#/efm/model_evaluate)页面，选择**评测任务**Tab，点击右上角**创建评测任务**按钮 - -填写表单并点击**开始评测**按钮 - -**项目** - -**填写内容** - -**维度名称** - -综合质量评估测试 - -**评测模型** - -选择**千问-Max** - -**裁判模型** - -选择**千问-Max** - -**System Prompt** - -留空，本次测试不需要，和评分器Prompt的区别请参见[System Prompt和评分器Prompt的区别](#b3a7a92de9aie) - -**评分器模版** - -选择**综合评测**，数据集选择前面创建的"综合质量评估测试数据" - -**评分范围** - -选择前面创建的"综合质量评估" - -**通过阈值** - -本次测试不参与 - -## 4\. 查看任务状态 - -找到任务"综合质量评估测试"，查看**评测状态**列： - -- **待执行**：在请求高峰时段，评测任务需要排队等待执行 - -- **进行中**：系统正在评测，请耐心等待 - -- **评测完成**：评测已完成，可以查看结果 - -- **评测失败**：评测任务执行失败 - -- **评测终止**：评测任务被人工手动终止 - - -点击页面右上角刷新按钮（![image](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/0659913271/p833282.png)），当任务状态变为**评测完成**后，单击**任务名称**列，进入详情页。 - -- 选择**数据明细**Tab，查看每条数据详细评分 - - **列名** - - **说明** - - **状态** - - 评测状态：待执行、进行中、评测完成、评测失败、评测终止 - - **序号** - - 样本编号 - - **Prompt** - - 原始问题 - - **Completion** - - 参考答案 - - **Output** - - 模型生成的回答 - - **\[评测维度名称\]** - - 和评测维度相同，本次评测维度名称为"综合质量评估"，本列显示裁判模型的评分（数值） - - **操作** - - 用户可执行的操作，例如点击详情按钮，查看完整的问题、答案和评测结果 - -- 选择**指标统计**Tab，查看评测统计 - - **指标名称** - - **说明** - - **示例值** - - **综合得分** - - 评测维度的平均分（数值型维度显示的是所有样本评分的算术平均值） - - 3.8 - - **通过率** - - 评分≥通过阈值的样本占比 - - 70% - - **评测集总量** - - 测试数据总数 - - 10条 - - **已完成量** - - 已评测完成的数量 - - 10条 - - **未完成量** - - 未评测完成的数量 - - 0条 - - -### **自定义评测：规则评估-字符串匹配评测维度** - -**适用场景**：答案格式固定，需要精确匹配，如Function Calling、NL2SQL - -**使用建议**： - -- 预处理规范化：统一大小写、去除首尾空格 - -- 对于同义词，建议改用文本相似度评分器 - -- 先用小样本测试匹配规则是否符合预期 - - -**操作步骤**： - -## 1\. 创建评测维度 - -**界面位置**：进入[模型评测](https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.7a0561433XjjyF&=model#/efm/model_evaluate)页面，选择**评测维度**Tab，点击右上角**创建评测维度**按钮 - -填写表单点击**保存**按钮 - -**项目** - -**填写内容** - -**维度名称** - -Function Calling验证 - -**描述** - -检查模型是否正确调用了指定函数 - -**类型** - -选择**规则评估-字符串匹配** - -**文本对比** - -三栏一行：左侧文本框填 `${output}`（模型输出）、中间操作符下拉选**包含**、右侧文本框填 `${completion}`（参考答案）。文本框内输入 `/` + 回车可快速插入 `${prompt}` / `${output}` / `${completion}` 变量。 - - - - - - - - - - - -左侧文本框填写模型输出变量，右侧填写参考答案变量 - - - - - - - - - - - -**匹配规则如何选择**： - -**规则** - -**行为描述** - -**典型应用** - -**相等** - -完全相同（忽略大小写） - -城市名称校验、固定答案 - -**不相等** - -完全不同（忽略大小写） - -禁忌词排查 - -**包含** - -包含给定字符串 - -关键词检查、必要信息验证 - -**开头包含** - -以给定字符串开头 - -前缀校验、格式检查 - -**结尾包含** - -以给定字符串结尾 - -后缀校验、结束符检查 - -**评测数据示例**： - -``` -{"prompt": "今天北京天气怎么样？","completion": "query_weather"} -``` - -如果匹配规则选择“包含”，当模型输出包含 `query_weather` 时，判定为Pass。 - -## 2\. 准备测试数据 - -**界面位置**：进入[数据管理](https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.7a0561433XjjyF&tab=model#/efm/model_data)页面，点击右上角**新增数据集**按钮 - -填写表单并点击**确认**按钮 - -**项目** - -**填写内容** - -**维度名称** - -Function Calling测试数据 - -**描述** - -选择**评测集**类型 - -> ❗ 模型评测只能使用**评测集**类型的数据集，不支持训练集 - -**类型** - -上传_案例数据\_Function\_Calling.xlsx（ICMS 附件，file\_id=151064，需在线下载）_ - -## 3\. 创建评测任务 - -**界面位置**：进入[模型评测](https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.7a0561433XjjyF&tab=model#/efm/model_evaluate)页面，选择**评测任务**Tab，点击右上角**创建评测任务**按钮 - -填写表单并点击**开始评测**按钮 - -**项目** - -**填写内容** - -**维度名称** - -Function Calling测试 - -**评测数据集** - -选择**Function Calling测试数据** - -**裁判模型** - -选择**千问-Max** - -**System Prompt** - -留空，本次测试不需要，更多说明请参见[System Prompt和评分器Prompt的区别](#b3a7a92de9aie) - -**评分器模版** - -选择**综合评测**，数据集选择前面创建的“Function Calling测试数据” - -**评分范围** - -选择前面创建的“Function Calling验证” - -**通过阈值** - -本次测试不参与 - -## 4\. 查看任务状态 - -找到任务“Function Calling测试”，查看**评测状态**列： - -- **待执行**：在请求高峰时段，评测任务需要排队等待执行 - -- **进行中**：系统正在评测，请耐心等待 - -- **评测完成**：评测已完成，可以查看结果 - -- **评测失败**：评测任务执行失败 - -- **评测终止**：评测任务被人工手动终止 - - -点击页面右上角刷新按钮（![image](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/0659913271/p833282.png)），当任务状态变为**评测完成**后，单击**任务名称**列，进入详情页。 - -- 选择**数据明细**Tab，查看每条数据详细评分 - - **列名** - - **说明** - - **状态** - - 评测状态：待执行、进行中、评测完成、评测失败、评测终止 - - **序号** - - 样本编号 - - **Prompt** - - 原始问题 - - **Completion** - - 参考答案 - - **Output** - - 模型生成的回答 - - **\[评测维度名称\]** - - 和评测维度相同，本次评测维度名称为“Function Calling验证”，本列表示分析结果 - - **操作** - - 用户可执行的操作，例如点击详情按钮，查看完整的问题、答案和评测结果 - -- 选择**指标统计**Tab，查看评测统计 - - **指标名称** - - **说明** - - **示例值** - - **综合得分** - - 评测维度的平均分 - - 100 - - **通过率** - - Pass的样本占比 - - 100% - - **评测集总量** - - 测试数据总数 - - 2条 - - **已完成量** - - 已评测完成的数量 - - 2条 - - **未完成量** - - 未评测完成的数量 - - 0条 - - -### **自定义评测：规则评估-文本相似度评测维度** - -**适用场景**：答案表述多样但含义相同的场景，如翻译、摘要、改写 - -**使用建议**： - -- 先在小样本上测试，观察通过率分布，再调整阈值 - -- 关注词序和精确匹配 → 选择BLEU - -- 关注语义理解 → 选择Cosine - -- 需要容错 → 选择Fuzzy Match - -- 关注关键信息覆盖 → 选择ROUGE-L - - -**操作步骤**： - -## 1\. 创建评测维度 - -**界面位置**：进入[模型评测](https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.7a0561433XjjyF&tab=model#/efm/model_evaluate)页面，选择**评测维度**Tab，点击右上角**创建评测维度**按钮 - -填写表单点击**保存**按钮 - -**项目** - -**填写内容** - -**维度名称** - -翻译质量 - -**描述** - -评估中译英的质量 - -**类型** - -选择**规则评估-文本相似度** - -**相似度算法** - -选择`BLEU_4` - -**评分器模版** - -左侧：`${output}` -右侧：`${completion}` - - - - - - - - - - - - - - - - -左侧文本框填写模型输出变量，右侧填写参考答案变量 - -**通过阈值** - -设定为0.4，相似度≥0.4判定为Pass，范围0~1 - -**相似度算法如何选择**： - -**算法** - -**特点** - -**最佳场景** - -**阈值建议** - -**ROUGE-L** - -基于最长公共子序列 - -文本摘要 - -0.4-0.6 - -**BLEU** - -基于n-gram精确匹配，对词序敏感 - -机器翻译 - -0.3-0.5 - -**Cosine** - -向量空间相似度，捕捉语义 - -开放问答、语义理解 - -0.6-0.8 - -**Fuzzy Match** - -基于编辑距离，容错性强 - -OCR、语音识别 - -0.7-0.9 - -**Accuracy** - -完全匹配 - -精确答案验证 - -1.0 - -## 2\. 准备测试数据 - -**界面位置**：进入[数据管理](https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.7a0561433XjjyF&tab=model#/efm/model_data)页面，点击右上角**新增数据集**按钮 - -填写表单并点击**确认**按钮 - -**项目** - -**填写内容** - -**维度名称** - -中译英测试数据 - -**描述** - -选择**评测集**类型 - -> ❗ 模型评测只能使用**评测集**类型的数据集，不支持训练集 - -**类型** - -上传_案例数据\_中译英.xlsx（ICMS 附件，file\_id=151065，需在线下载）_ - -## 3\. 创建评测任务 - -**界面位置**：进入[模型评测](https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.7a0561433XjjyF&tab=model#/efm/model_evaluate)页面，选择**评测任务**Tab，点击右上角**创建评测任务**按钮 - -填写表单并点击**开始评测**按钮 - -**项目** - -**填写内容** - -**维度名称** - -翻译质量评测 - -**评测模型** - -选择**千问-Max** - -**裁判模型** - -选择**千问-Max** - -**System Prompt** - -留空，本次测试不需要，更多说明请参见[System Prompt和评分器Prompt的区别](#b3a7a92de9aie) - -**评分器模版** - -选择**综合评测**，数据集选择前面创建的“中译英测试数据” - -**评分范围** - -选择前面创建的“翻译质量” - -**通过阈值** - -本次测试不参与 - -## 4\. 查看任务状态 - -找到任务“翻译质量评测”，查看**评测状态**列： - -- **待执行**：在请求高峰时段，评测任务需要排队等待执行 - -- **进行中**：系统正在评测，请耐心等待 - -- **评测完成**：评测已完成，可以查看结果 - -- **评测失败**：评测任务执行失败 - -- **评测终止**：评测任务被人工手动终止 - - -点击页面右上角刷新按钮（![image](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/0659913271/p833282.png)），当任务状态变为**评测完成**后，单击**任务名称**列，进入详情页。 - -- 选择**数据明细**Tab，查看每条数据详细评分 - - **列名** - - **说明** - - **状态** - - 评测状态：待执行、进行中、评测完成、评测失败、评测终止 - - **序号** - - 样本编号 - - **Prompt** - - 原始问题 - - **Completion** - - 参考答案 - - **Output** - - 模型生成的回答 - - **\[评测维度名称\]** - - 和评测维度相同，本次评测维度名称为“翻译质量”，本列表示分析结果 - - **操作** - - 用户可执行的操作，例如点击详情按钮，查看完整的问题、答案和评测结果 - -- 选择**指标统计**Tab，查看评测统计 - - **指标名称** - - **说明** - - **示例值** - - **综合得分** - - 评测维度的平均分 - - 100 - - **通过率** - - Pass的样本占比 - - 100% - - **评测集总量** - - 测试数据总数 - - 3条 - - **已完成量** - - 已评测完成的数量 - - 3条 - - **未完成量** - - 未评测完成的数量 - - 0条 - - -### **自定义评测：人工评估-分类型评测维度** - -**适用场景**：需要人工主观判断的场景，如创意性评估、专业质量审核 - -**使用建议**： - -- 当模型输出质量无法仅通过算法或裁判模型精确判断时，选用人工评估 - -- 在创建维度时将每个标签的判定标准写在外部《评测指南》，并培训标注员统一理解 - -- 标签设计要覆盖所有可能输出情况，并尽量使用简洁明确的分类词 - -- 建议多名评分员交叉标注部分样本，检验一致性 - -- 避免一次标注过多数据，分批进行以降低疲劳影响 - - -**操作步骤**： - -## 1\. 创建评测维度 - -**界面位置**：进入[模型评测](https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.7a0561433XjjyF&tab=model#/efm/model_evaluate)页面，选择**评测维度**Tab，点击右上角**创建评测维度**按钮 - -填写表单点击**保存**按钮 - -**项目** - -**填写内容** - -**维度名称** - -内容创意性 - -**描述** - -评估内容创意性 - -**类型** - -选择**人工评估-分类型** - -**Pass** - -创建“优秀”和“良好”两个标签 - -**Fail** - -创建“一般”和“较差”两个标签 - -## 2\. 准备测试数据 - -**界面位置**：进入[数据管理](https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.7a0561433XjjyF&tab=model#/efm/model_data)页面，点击右上角**新增数据集**按钮 - -填写表单并点击**确认**按钮 - -**项目** - -**填写内容** - -**维度名称** - -内容创意性测试数据 - -**描述** - -选择**评测集**类型 - -> ❗ 模型评测只能使用**评测集**类型的数据集，不支持训练集 - -**类型** - -上传_案例数据\_内容创意性.xlsx（ICMS 附件，file\_id=151066，需在线下载）_ - -Completion留空，让模型生成 - -## 3\. 创建评测任务 - -**界面位置**：进入[模型评测](https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.7a0561433XjjyF&tab=model#/efm/model_evaluate)页面，选择**评测任务**Tab，点击右上角**创建评测任务**按钮 - -填写表单并点击**开始评测**按钮 - -**项目** - -**填写内容** - -**维度名称** - -内容创意评测 - -**评测模型** - -选择**千问-Plus** - -**裁判模型** - -选择**千问-Max** - -**System Prompt** - -留空，本次测试不需要，更多说明请参见[System Prompt和评分器Prompt的区别](#b3a7a92de9aie) - -**评分器模版** - -选择**自定义评测**，数据集选择前面创建的“内容创意性测试数据” - -**评分范围** - -选择前面创建的“内容创意性” - -**通过阈值** - -本次测试不参与 - -## 4\. 查看任务状态 - -找到任务“内容创意评测”，查看**评测状态**列，为**进行中**状态。**人工评估必须手动标注**，系统不会自动评分，单击**任务名称**列，进入详情页。 - -- 选择**数据明细**Tab，在**操作**列点击**标注**按钮进行人工标注，所有数据标注完成后，任务的**评测状态**才会变为**评测完成** - - **列名** - - **说明** - - **状态** - - 评测状态：进行中 - - **序号** - - 样本编号 - - **Prompt** - - 原始问题 - - **Completion** - - 参考答案 - - **Output** - - 模型生成的回答 - - **\[评测维度名称\]** - - 和评测维度相同，本次评测维度名称为“内容创意评测”，本列表示分析结果 - - **操作** - - 用户可执行的操作，例如点击详情按钮，查看完整的问题、答案和评测结果 - -- 选择**指标统计**Tab，查看评测统计 - - **指标名称** - - **说明** - - **示例值** - - **综合得分** - - 评测维度的平均分 - - 100 - - **得分明细 - 数据项分布** - - 分类型评估维度的统计结果分布 - - **通过率** - - Pass的样本占比 - - 100% - - **评测集总量** - - 测试数据总数 - - 3条 - - **已完成量** - - 已评测完成的数量 - - 3条 - - **未完成量** - - 未评测完成的数量 - - 0条 - - -### **使用排行榜对比多个模型** - -**适用场景**：需要对比多个模型在相同评测维度下的表现，通过排行榜直观查看模型排名 - -**使用建议**： - -- 对比同一系列不同规格的模型（如 qwen-max、qwen-plus、qwen-turbo） - -- 对比不同供应商的模型（如千问 vs DeepSeek） - -- 对比同一模型的不同版本或配置 - - -**前提条件**：已创建自定义评测维度 - -**操作步骤**： - -## 1\. 创建排行榜 - -**界面位置**：进入[模型评测](https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.7a0561433XjjyF&tab=model#/efm/model_evaluate)页面，选择**排行榜**Tab，点击右上角**创建排行榜**按钮 - -填写表单点击**确定**按钮 - -**项目** - -**填写内容** - -**排行榜名称** - -常识问答准确性排行榜 - -**评测维度** - -选择已创建的评测维度，例如常识问答准确性 - -**关联可选任务** - -可在此时选择已有评测任务，或在下一步添加评测任务 - -**说明**： - -- 每个排行榜最多支持50个评测任务 - -- 排行榜创建后，评测维度不可修改 - -- 同一个排行榜内的所有任务使用相同的评测维度，确保对比的公平性 - - -## 2\. 添加评测任务到排行榜 - -**界面位置**：进入[模型评测](https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.7a0561433XjjyF&tab=model#/efm/model_evaluate)页面，选择**排行榜**Tab，点击排行榜名称进入详情页 - -排行榜支持两种方式**添加评测任务**： - -**方式一：****创建新任务** - -1. 在排行榜详情页点击 **添加评测任务** 按钮 - -2. 点击 **创建新任务** - -3. 系统自动跳转到任务创建页面，并自动关联排行榜： - - - **是否参与排行**：自动勾选且锁定，无法取消 - - - **排行榜**：自动填充当前排行榜名称且锁定 - - - **评测维度**：自动填充排行榜关联的评测维度且锁定 - -4. 填写其他必填项： - - - **任务名称**：输入任务名称，建议包含模型信息便于识别 - - - **评测模型**：选择要评测的模型 - - - **数据来源**：选择评测数据集 - -5. 点击 **开始评测** 按钮 - - -**方式二：****选择已有任务** - -1. 在排行榜详情页点击 **添加评测任务** 按钮 - -2. 点击 **选择已有任务** - -3. 从已完成的评测任务中选择要加入排行榜的任务 - -4. 点击 **确定** 按钮 - - -**注意**： - -- 只有使用相同评测维度的已完成任务才能加入排行榜 - -- 建议使用相同的评测数据集以确保对比结果的准确性 - - -## 3\. 查看排行榜结果 - -**界面位置**：进入[模型评测](https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.7a0561433XjjyF&tab=model#/efm/model_evaluate)页面，选择**排行榜**Tab，点击排行榜名称进入详情页 - -排行榜详情页展示以下信息： - -**列名** - -**说明** - -**排名** - -根据排行榜得分自动计算排名，得分高的排名靠前 - -**任务名称** - -评测任务的名称 - -**评测模型** - -任务使用的模型名称 - -**排行榜得分** - -该任务在当前评测维度下的综合得分，范围0~100 - -**\[评测维度名称\]** - -显示该维度的具体评分，例如“语义相似度”维度显示平均相似度分数 - -**操作** - -删除任务（将任务从排行榜移除，不影响任务本身） - -**说明**： - -- **排行榜得分**会随着任务评测进度实时更新 - -- 评测进行中的任务得分列显示“-” - -- 点击**任务名称**可查看该任务的详细评测数据 - - -### **基线评测** - -**适用场景**：使用行业标准数据集快速验证模型通用能力（学科知识、数学推理、科学常识等） - -**操作步骤**： - -## 1\. 创建评测任务 - -**界面位置**：进入[模型评测](https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.7a0561433XjjyF&tab=model#/efm/model_evaluate)页面，选择**评测任务**Tab，点击右上角**创建评测任务**按钮 - -填写表单并点击**开始评测**按钮 - -**项目** - -**填写内容** - -**维度名称** - -基线评测 - -**评测对象** - -选择**千问-Max** - -**类型** - -选择要评测的模型 - -**裁判模型** - -选择系统预设的评测数据（参见[评测数据](#354c3ed2840bw)） - -## 2\. 查看任务状态 - -找到任务“基线评测”，查看**评测状态**列： - -- **待执行**：在请求高峰时段，评测任务需要排队等待执行 - -- **进行中**：系统正在评测，请耐心等待 - -- **评测完成**：评测已完成，可以查看结果 - -- **评测失败**：评测任务执行失败 - -- **评测终止**：评测任务被人工手动终止 - - -点击页面右上角刷新按钮（![image](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/0659913271/p833282.png)），当任务状态变为**评测完成**后，单击**任务名称**列，进入详情页查看。 - -## **进阶技巧** - -### **评测维度设计最佳实践** - -**单一职责**： - -- 每个评测维度只关注一个评测目标 - -- 避免混合多个标准 - -- 例如：不要在"准确性"维度中同时考核"流畅性" - - -**量化标准**： - -- 尽量使用客观、可量化的标准 - -- 减少主观性 - -- 为每个分数档提供明确的判定条件 - - -**迭代优化**： - -- 根据评测结果反馈，持续优化Prompt - -- 定期人工抽查，验证评测准确性 - -- 对比人工评分和AI评分，调整评测标准 - - -### **Prompt编写技巧** - -请前往阿里云百炼的[Prompt最佳实践](https://help.aliyun.com/zh/model-studio/prompt-engineering-guide)和[插件](https://help.aliyun.com/zh/model-studio/plug-in-overview)学习相关知识，帮助您在不进行[模型调优](https://help.aliyun.com/zh/model-studio/model-training-overview)的情况下激发模型的最大潜力。 - -### **成本优化建议** - -**合理选择评测方式**： - -- 规则评估成本最低，适合格式化输出验证 - -- 大模型评估成本较高，用于需要语义理解的场景 - -- 人工评估成本最高，仅用于必须人工判断的情况 - - -**使用推理结果集**： - -- 对于需要频繁评测的基准模型，将其输出保存为推理结果集 - -- 避免重复调用模型，降低推理成本 - - -**分阶段评测**： - -- 先用小规模数据集（50-100条）验证配置 - -- 确认配置正确后，再扩大到200-500条 - - -**批量评测**： - -- 一次评测多个模型，提高效率 - -- 在同一个评测任务中选择多个模型 - - -### **评测结果分析方法** - -**关注分数分布**： - -- 查看各分数档的样本数量 - -- 识别分数集中的问题（如全部集中在3分） - -- 调整评分标准或阈值 - - -**分析典型样本**： - -- 查看高分样本：了解模型优势 - -- 查看低分样本：识别模型不足 - -- 查看边界样本：优化评测标准 - - -**对比不同模型**： - -- 不要只看总分，要看不同场景下的表现 - -- 识别各模型的强项和弱项 - -- 根据业务优先级选择合适的模型 - - -**追踪模型迭代**： - -- 建立定期评测机制 - -- 记录每次调优后的评测结果 - -- 分析调优方向是否正确 - - -### **常见问题排查** - -**评测结果不符合预期**： - -1. 检查测试数据是否代表业务场景 - -2. 审查评测维度的Prompt是否清晰 - -3. 尝试调整评分范围和阈值 - -4. 考虑更换裁判模型或评分器模板 - - -**评分过于集中**： - -1. 评分标准过于宽泛 → 细化每个分数档的描述 - -2. 测试数据缺乏多样性 → 增加边界和异常样本 - -3. 裁判模型倾向保守 → 更换推理能力更强的模型 - - -**不同评测维度结果冲突**： - -1. 这很正常，说明模型在不同维度有不同表现 - -2. 根据业务优先级，赋予不同维度不同权重 - -3. 不要只看单一维度，要综合决策 - - -**如果模型输出频繁出现以下缺陷，建议您考虑引入**[**知识库**](https://help.aliyun.com/zh/model-studio/rag-introduction)： - -- 模型的输出和参考答案完全无关（模型明显缺失相关的背景知识） - -- 模型的输出和参考答案部分相关（模型有背景知识但已过时） - - -## 计费说明 - -模型评测的费用主要来自两部分：[被评测模型的推理费用](#yqzesbsyyqjnq)和[裁判模型的评分费用](#umkkwesx5u3my)。 - -### **被评测模型的推理费用** - -**模型类型** - -**是否计费** - -**计费说明** - -**预置模型**（如qwen-max、qwen-plus等） - -**是** - -按Token消耗量计费 - -**独立部署的模型**（调优后部署） - -**否** - -不额外计费 - -**被评测模型计费公式**： - -**输入Token包含**： - -- System Prompt（如果配置了） - -- 评测数据中的Prompt（用户问题） - - -**输出Token包含**： - -- 模型生成的回答（Output） - - -### **裁判模型的评分费用（限时免费）** - -仅**大模型评估**（数值型、分类型）涉及到裁判模型的使用。 - -### **完整费用计算示例** - -**场景**：使用qwen-plus评测100条数据，采用**大模型评估-数值型**，裁判模型为qwen-max - -**假设**： - -- 每条Prompt平均50 Token - -- 每条模型Output平均200 Token - -- 每条评分器Prompt平均500 Token（包含评分标准） - -- 每条裁判模型输出平均5 Token - - -**费用计算**： - -1. **被评测模型（qwen-plus）费用**： - - - 输入：100条 × 50 Token = 5,000 Token - - - 输出：100条 × 200 Token = 20,000 Token - - - 假设qwen-plus价格：输入¥0.002/1K Token，输出¥0.006/1K Token - - - 费用 = 5,000/1000 × 0.002 + 20,000/1000 × 0.006 = ¥0.01 + ¥0.12 = **¥0.13** - -2. **裁判模型（qwen-max）费用（限时免费）：￥0** - - -**总费用** = ¥0.13 + ¥0 = **¥0.13** - -### **价格参考** - -**最新价格**：请参见[百炼控制台](https://bailian.console.aliyun.com/cn-beijing?tab=model#/model-market/all) - -**注意**： - -- 价格可能随时调整，请以控制台显示为准 - -- 部分模型可能有限时优惠活动 - - -## 下一步 - -- 如果您对参评模型的效果感到满意，即可开始模型调用，将模型集成到您的业务链路中。 - -- 如果您不满意参评模型的效果，可以选择其他模型重新评测。您也可以考虑学习并通过[阿里云大模型ACA认证](https://edu.aliyun.com/certification/aca13)，该认证配套的免费课程能帮助您系统了解大模型的能力和应用场景，以及如何优化大模型。 +可对模型进行调优后重新评测验证效果（请参见[模型调优](#)）。如果模型缺失特定领域知识，可引入知识库增强模型能力（请参见知识库）。 diff --git a/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-experience/asr-model.md b/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-experience/asr-model.md index 5a9ed14..ccc644c 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-experience/asr-model.md +++ b/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-experience/asr-model.md @@ -96,7 +96,7 @@ WebSocket 不支持 -中、英、日及方言 +多语种及方言 无限制 @@ -180,7 +180,7 @@ WebSocket 不支持 -中、英、日及方言 +多语种及方言 无限制 @@ -212,7 +212,7 @@ WebSocket 不支持 -中、英、日及方言 +多语种及方言 无限制 @@ -362,7 +362,9 @@ HTTP **支持的语言（按版本）**： -- **Fun-ASR-Realtime 主版本**（`fun-asr-realtime`、`fun-asr-realtime-2026-02-28`、`fun-asr-realtime-2025-11-07`）：中文（普通话、粤语、吴语、闽南语、客家话、赣语、湘语、晋语；并支持中原、西南、冀鲁、江淮、兰银、胶辽、东北、北京、港台等，包括河南、陕西、湖北、四川、重庆、云南、贵州、广东、广西、河北、天津、山东、安徽、南京、江苏、杭州、甘肃、宁夏等地区官话口音）、英文、日语 +- **Fun-ASR-Realtime 主版本**（`fun-asr-realtime`、`fun-asr-realtime-2025-11-07`）：中文（普通话、粤语、吴语、闽南语、客家话、赣语、湘语、晋语；并支持中原、西南、冀鲁、江淮、兰银、胶辽、东北、北京、港台等，包括河南、陕西、湖北、四川、重庆、云南、贵州、广东、广西、河北、天津、山东、安徽、南京、江苏、杭州、甘肃、宁夏等地区官话口音）、英语、日语、韩语、越南语、泰语、印尼语、马来语、菲律宾语、印地语、阿拉伯语、法语、德语、西班牙语、葡萄牙语、俄语、意大利语、荷兰语、瑞典语、丹麦语、芬兰语、挪威语、希腊语、波兰语、捷克语、匈牙利语、罗马尼亚语、保加利亚语、克罗地亚语、斯洛伐克语 + +- `fun-asr-realtime-2026-02-28`：中文（普通话、粤语、吴语、闽南语、客家话、赣语、湘语、晋语；并支持中原、西南、冀鲁、江淮、兰银、胶辽、东北、北京、港台等，包括河南、陕西、湖北、四川、重庆、云南、贵州、广东、广西、河北、天津、山东、安徽、南京、江苏、杭州、甘肃、宁夏等地区官话口音）、英语、日语 - `fun-asr-realtime-2025-09-15`：中文（普通话）、英文 diff --git a/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-experience/image-model.md b/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-experience/image-model.md index 067e0b0..5e614b5 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-experience/image-model.md +++ b/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-experience/image-model.md @@ -2,6 +2,34 @@ 选择适合文生图、图片编辑等场景的模型。 +## 从闭源模型迁移到百炼? + +如果你正在使用 Nano Banana、GPT Image、Midjourney 或 Seedream，可参考下表选择对应的百炼模型。 + +**能力档位** + +**闭源模型代表** + +**百炼推荐** + +高质量 + +Nano Banana Pro、GPT Image、Seedream 4.0 + +`wan2.7-image-pro`、`qwen-image-2.0-pro` + +平衡 + +Imagen 4 Ultra、Midjourney v7 + +`wan2.7-image`、`qwen-image-2.0` + +快速低成本 + +FLUX.2 + +`z-image-turbo` + ## 文生图 推荐使用`wan2.7-image-pro`，它在一个模型中集成了文字渲染、品牌色控制、角色一致性多图生成以及图片编辑功能。文生图最高支持4096x4096分辨率，图片编辑最高支持2048x2048分辨率。详细使用方法请参见[文本生成图像](https://help.aliyun.com/zh/model-studio/text-to-image)。 @@ -32,7 +60,7 @@ ## 推荐模型 -**模型ID** +**模型 ID（Model ID）** **适用场景** @@ -108,7 +136,7 @@ qwen-image-2.0-pro的快速版本 ### Wan -**模型ID** +**模型 ID（Model ID）** **文生图** @@ -234,7 +262,7 @@ qwen-image-2.0-pro的快速版本 ### Qwen Image -**模型ID** +**模型 ID（Model ID）** **文生图** @@ -254,6 +282,16 @@ qwen-image-2.0-pro的快速版本 2048x2048 +`qwen-image-2.0-pro-2026-06-22` + +支持 + +支持 + +6 + +2048x2048 + `qwen-image-2.0-pro-2026-04-22` 支持 @@ -406,7 +444,7 @@ qwen-image-2.0-pro的快速版本 ### Z-Image -**模型ID** +**模型 ID（Model ID）** **文生图** diff --git a/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-experience/vision-model.md b/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-experience/vision-model.md index 799435a..da8325e 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-experience/vision-model.md +++ b/skills/bailian-docs-llm-wiki/raw/model-user-guide/model-experience/vision-model.md @@ -2,6 +2,34 @@ 选择适合图像分析、视频理解、OCR等场景的模型。 +## 从闭源模型迁移到百炼? + +如果你正在使用 GPT、Claude 或 Gemini，可参考下表按能力档位选择对应的百炼模型。 + +**能力档位** + +**闭源模型代表** + +**百炼推荐** + +高能力 + +GPT-5.5、Claude Opus 4.7、Gemini 3.1 Pro + +`qwen3.7-plus` + +平衡 + +GPT-5.4、Claude Sonnet 4.6、Gemini 3 Pro + +`qwen3.6-plus` + +轻量低成本 + +GPT-5.4-mini、Gemini 3.1 Flash + +`qwen3.6-flash` + ## 图像与视频理解 推荐从`qwen3.7-plus`开始，它是千问旗舰模型，支持1M上下文、最长2小时视频、Function Calling和内置工具等完整功能。当您的场景稳定后，可以尝试`qwen3.6-flash`来降低成本，它提供接近旗舰的效果，并支持相同的上下文长度和功能集。 @@ -36,11 +64,11 @@ Qwen3.7、Qwen3.6、Qwen3.5和Qwen3-VL系列在非思考模式下支持此功能 ## OCR与文档提取 -`qwen-vl-ocr`专为文档、表格、试卷和手写内容的文字提取而优化。您也可以使用`qwen3.7-plus`或`qwen3.6-flash`进行通用图片文字提取。 +`qwen3.5-ocr` 专为文档、表格、试卷和手写内容的文字提取而优化。您也可以使用`qwen3.7-plus`或`qwen3.6-flash`进行通用图片文字提取。 ## 推荐模型 -**模型ID** +**模型 ID（Model ID）** **上下文** @@ -124,7 +152,7 @@ Qwen3.7、Qwen3.6、Qwen3.5和Qwen3-VL系列在非思考模式下支持此功能 ### Qwen3.7 -**模型ID** +**模型 ID（Model ID）** **输入** @@ -206,7 +234,7 @@ Qwen3.7、Qwen3.6、Qwen3.5和Qwen3-VL系列在非思考模式下支持此功能 ### Qwen3.6 -**模型ID** +**模型 ID（Model ID）** **输入** @@ -328,7 +356,7 @@ Qwen3.7、Qwen3.6、Qwen3.5和Qwen3-VL系列在非思考模式下支持此功能 ### Qwen3.5 -**模型ID** +**模型 ID（Model ID）** **输入** @@ -533,6 +561,10 @@ Qwen3.7、Qwen3.6、Qwen3.5和Qwen3-VL系列在非思考模式下支持此功能 - `qwen2.5-vl-32b-instruct` +- `qwen2.5-vl-7b-instruct` + +- `qwen2.5-vl-3b-instruct` + #### Qwen-Omni diff --git a/skills/bailian-docs-llm-wiki/raw/model-user-guide/release-notes/newly-released-models.md b/skills/bailian-docs-llm-wiki/raw/model-user-guide/release-notes/newly-released-models.md index b557132..fc89f07 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-user-guide/release-notes/newly-released-models.md +++ b/skills/bailian-docs-llm-wiki/raw/model-user-guide/release-notes/newly-released-models.md @@ -3764,6 +3764,16 @@ qwen3-asr-flash-realtime、qwen3-asr-flash-realtime-2025-10-27 推理模型 +2026-07-06 + +美国 + +qwen3.7-plus-us + +千问3.7Plus系列，在强大文本能力的基础上全面升级了视觉-语言能力，同时保持了在编码、工具使用和生产力工作流方面的完整智能体能力。其核心特色为多模态交互混合智能体能力，能够感知真实世界场景、读取屏幕并操作 GUI、基于视觉参考生成代码、端到端导航移动应用。 + +推理模型 + 2026-07-03 美国 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 2fd70bd..4186433 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 @@ -1372,6 +1372,28 @@ qwen3.7-plus 24元 +qwen3.7-plus-us + +> [上下文缓存](https://help.aliyun.com/zh/model-studio/context-cache)享有折扣 + +美国 + +0 [上下文缓存](https://help.aliyun.com/zh/model-studio/context-cache)享有折扣 diff --git a/skills/bailian-docs-llm-wiki/raw/model-user-guide/test-1/model-training-and-deployment-billing.md b/skills/bailian-docs-llm-wiki/raw/model-user-guide/test-1/model-training-and-deployment-billing.md index 21383ae..5639cbc 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-user-guide/test-1/model-training-and-deployment-billing.md +++ b/skills/bailian-docs-llm-wiki/raw/model-user-guide/test-1/model-training-and-deployment-billing.md @@ -636,7 +636,7 @@ GLM-5.2 glm-5.2 -64K +1M ¥28.8 @@ -1177,6 +1177,16 @@ MU1 x 4 ¥104,472 +Qwen-Plus-Character-2025-11-06 + +qwen-plus-character-2025-11-06 + +MU1 x 4 + +¥216 + +¥104,472 + ###### GLM **模型名称** 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 e143106..a0e82ac 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 @@ -45,9 +45,9 @@ 可通过以下两种方式查看模型的免费额度。 -#### 方式一：通过模型用量查看 +#### 方式一：通过免费额度页面查看 -在控制台的[模型用量](https://bailian.console.aliyun.com/?tab=model#/model-usage/free-quota)页面，点击**免费额度**页签，查看所有模型的免费额度余量及过期时间。 +在控制台的[免费额度](https://bailian.console.aliyun.com/?tab=costing-balance#/costing-balance/free-quota)页面，查看所有模型的免费额度余量及过期时间。可按模型类型筛选或搜索模型。 #### 方式二：通过模型广场查看 @@ -80,18 +80,18 @@ #### 如何开启 -##### 方式一：在模型用量页面开启 +##### 方式一：在免费额度页面开启 **为单个模型开启：** -1. 在控制台的[模型用量](https://bailian.console.aliyun.com/?tab=model#/model-usage/free-quota)页面，点击**免费额度**页签。 +1. 在控制台的[免费额度](https://bailian.console.aliyun.com/?tab=costing-balance#/costing-balance/free-quota)页面。 2. 在列表中找到目标模型，在其右侧操作列开启**免费额度用完即停**开关（无免费额度的模型无法开启）。 **批量开启：** -1. 在控制台的[模型用量](https://bailian.console.aliyun.com/?tab=model#/model-usage/free-quota)页面，点击**免费额度**页签。 +1. 在控制台的[免费额度](https://bailian.console.aliyun.com/?tab=costing-balance#/costing-balance/free-quota)页面。 2. 点击**批量操作免费额度用完即停**，在下拉菜单中选择**批量开启**。 @@ -108,9 +108,7 @@ #### 如何关闭 -该功能默认关闭。若已启用**免费额度用完即停**，需等到控制台显示**免费额度用完**后才可关闭。 - -> 控制台显示的免费额度为分钟级更新（需手动刷新页面）。 +该功能默认关闭。开启后可随时关闭，无需等到免费额度用完。可在免费额度页面操作列关闭单个模型的**免费额度用完即停**开关，或经批量操作下拉菜单选择**批量关闭**。 ## 常见问题 @@ -118,7 +116,7 @@ 有通知。余量降至 20% 或完全耗尽时，系统通过短信、站内信、邮件发送通知。 -如需开启或关闭预警、修改预警比例，请前往[我的试用](https://billing-cost.console.aliyun.com/home/myfreetier)进行设置。找到试用规格描述为**百炼大模型推理免费试用**，单击**查看试用详情**，再单击右上角**配置余量到期预警规则**即可修改。 +如需开启或关闭预警、修改预警比例，请前往[我的试用](https://billing-cost.console.aliyun.com/home/myfreetier)进行设置。找到试用规格描述为**百炼大模型推理免费试用**，单击**查看试用详情**，再配置余量到期预警规则即可修改。 ### 免费额度用完会有什么影响？ @@ -126,26 +124,26 @@ **对于已认证用户：** -- 若已开启[免费额度用完即停](https://bailian.console.aliyun.com/?tab=model#/model-usage/free-quota)，免费额度用完后无法继续调用，需要关闭[免费额度用完即停](https://bailian.console.aliyun.com/?tab=model#/model-usage/free-quota)方可继续按量付费。 +- 若已开启[免费额度用完即停](https://bailian.console.aliyun.com/?tab=costing-balance#/costing-balance/free-quota)，免费额度用完后无法继续调用，需要关闭[免费额度用完即停](https://bailian.console.aliyun.com/?tab=costing-balance#/costing-balance/free-quota)方可继续按量付费。 -- 若未开启[免费额度用完即停](https://bailian.console.aliyun.com/?tab=model#/model-usage/free-quota)，正在进行的调用不会中断，超出额度的Token将按控制台中的输入/输出价格计费，费用以按量后付费方式从阿里云账户扣除，可能导致账户欠费。 +- 若未开启[免费额度用完即停](https://bailian.console.aliyun.com/?tab=costing-balance#/costing-balance/free-quota)，正在进行的调用不会中断，超出额度的Token将按控制台中的输入/输出价格计费，费用以按量后付费方式从阿里云账户扣除，可能导致账户欠费。 账户欠费时，即使其他模型仍有免费额度也无法调用。 -调用前建议查询该模型剩余额度，并配置[预算管理](https://help.aliyun.com/zh/user-center/how-to-manage-a-budget)或[账号余额预警](https://help.aliyun.com/zh/user-center/monitor-account-balances)，确保账户有充足[余额](https://usercenter2.aliyun.com/home)，未使用的余额支持[余额提现](https://help.aliyun.com/zh/user-center/balance-withdrawal)。 +调用前建议查询该模型剩余额度，并配置[预算管理](https://help.aliyun.com/zh/user-center/how-to-manage-a-budget)或[账号余额预警](https://help.aliyun.com/zh/user-center/monitor-account-balances)，确保账户有充足[余额](https://billing-cost.console.aliyun.com/home)，未使用的余额支持[余额提现](https://help.aliyun.com/zh/user-center/balance-withdrawal)。 ### 免费额度用完后如何充值？ 阿里云支持支付宝、银联在线支付、网银等多种充值方式，具体可用方式以账号[充值界面](https://billing-cost.console.aliyun.com/fortune/fund-management/recharge)展示为准。更多信息请参考[充值方式介绍](https://help.aliyun.com/zh/user-center/use-alipay-online-banking-to-recharge-online#8e4f4cdcf42rl)。 -充值完成后，账户余额可能有几分钟的更新延迟，请稍后前往[费用与成本](https://usercenter2.aliyun.com/home)查看可用余额。余额到账且无欠费时即可正常调用模型。 +充值完成后，账户余额可能有几分钟的更新延迟，请稍后前往[费用与成本](https://billing-cost.console.aliyun.com/home)查看可用余额。余额到账且无欠费时即可正常调用模型。 ### 如何查看免费额度消耗记录或账单？ 调用结束**几分钟**后即可生成消耗记录。查询步骤： -1. 在[账单详情](https://usercenter2.aliyun.com/finance/expense-report/expense-detail)页面，选择账单月份，**产品名称**选择**大模型服务平台百炼**，单击**搜索**。 +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)图标，找到**用量信息**，勾选**抵扣用量**，单击**确定**。 @@ -167,7 +165,7 @@ ### 如何查看产生费用的模型？ -调用结束**几分钟后**，在[账单详情](https://usercenter2.aliyun.com/finance/expense-report/expense-detail)页面，选择账单月份，**商品名称**选择**阿里云百炼大模型推理**，单击**搜索**。在资产/资源实例ID 列查看产生费用的模型。 +调用结束**几分钟后**，在[账单详情](https://billing-cost.console.aliyun.com/finance/expense-report/expense-detail)页面，选择账单月份，**商品名称**选择**阿里云百炼大模型推理**，单击**搜索**。在资产/资源实例ID （出账粒度）列查看产生费用的模型。 ### 如何查看模型调用记录？ @@ -183,14 +181,14 @@ - 删除已创建的 API-Key：进入阿里云百炼的[API-Key（北京）](https://bailian.console.aliyun.com/?apiKey=1&tab=globalset#/efm/api_key)或[API-Key（新加坡）](https://modelstudio.console.aliyun.com/?tab=globalset#/efm/api_key)页面，删除已创建的 API-Key。删除后将无法通过API调用模型，不再产生调用费用。 -- 设置[高额消费预警](https://usercenter2.aliyun.com/home/alarm-threshold)：当产品日账单超过预警阈值时，每天短信提醒一次（统计截止昨日24点）。 +- 设置[高额消费预警](https://billing-cost.console.aliyun.com/home/alarm-threshold)：当产品日账单超过预警阈值时，每天短信提醒一次（统计截止昨日24点）。 在**预警产品**下拉框中选择具体产品（如**百炼大模型部署**、**百炼大模型推理**、**百炼大模型训练**），在**预警阈值**输入框中填写金额（如`0.01`），然后单击**增加**即可添加预警规则。 ### 还有剩余额度，为何调用失败？ -请检查[阿里云账户](https://usercenter2.aliyun.com/home?spm=a2c4g.11186623.nav-v2-dropdown-my-aliyun.9.f6683048dWvpGu)是否欠费。账户欠费时，即使模型仍有免费额度也无法调用。 +请检查[阿里云账户](https://billing-cost.console.aliyun.com/home?spm=a2c4g.11186623.nav-v2-dropdown-my-aliyun.9.f6683048dWvpGu)是否欠费。账户欠费时，即使模型仍有免费额度也无法调用。 ### 为什么看不到免费额度与有效期？ diff --git a/skills/bailian-docs-llm-wiki/raw/model-user-guide/use-cases/third-party-model-integration-tutorial/deepseek-api.md b/skills/bailian-docs-llm-wiki/raw/model-user-guide/use-cases/third-party-model-integration-tutorial/deepseek-api.md index 4a20402..fe1e76b 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-user-guide/use-cases/third-party-model-integration-tutorial/deepseek-api.md +++ b/skills/bailian-docs-llm-wiki/raw/model-user-guide/use-cases/third-party-model-integration-tutorial/deepseek-api.md @@ -456,6 +456,62 @@ curl -X POST "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services }' ``` +## Anthropic兼容 + +## Python + +### **示例代码** + +``` +import anthropic +import os + +client = anthropic.Anthropic( + # 如果没有配置环境变量，请用阿里云百炼API Key替换：api_key="sk-xxx" + api_key=os.getenv("DASHSCOPE_API_KEY"), + base_url="https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic", +) + +message = client.messages.create( + model="deepseek-v4-pro", + max_tokens=1024, + messages=[ + {"role": "user", "content": "你是谁"} + ], + stream=True, +) + +for event in message: + if event.type == "content_block_delta": + if hasattr(event.delta, "thinking"): + print(event.delta.thinking, end="", flush=True) + if hasattr(event.delta, "text"): + print(event.delta.text, end="", flush=True) +``` + +## HTTP + +### **示例代码** + +## curl + +``` +curl -X POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic/v1/messages \ +-H "Authorization: Bearer $DASHSCOPE_API_KEY" \ +-H "Content-Type: application/json" \ +-H "anthropic-version: 2023-06-01" \ +-d '{ + "model": "deepseek-v4-pro", + "max_tokens": 1024, + "messages": [ + { + "role": "user", + "content": "你是谁" + } + ] +}' +``` + ## **推理强度（reasoning\_effort）** deepseek-v4-pro 和 deepseek-v4-flash 默认开启思考模式。通过`reasoning_effort`参数可以调整推理强度，可选值为`high`和`max`，默认为`high`。 @@ -931,7 +987,7 @@ DeepSeek 模型仅支持文本输入，不支持图片或文档输入。如需 2. 通过API或客户端（如Chatbox）调用模型：请参考本文内容。 -3. 0代码构建大模型应用：请参考[智能体应用](https://help.aliyun.com/zh/model-studio/single-agent-application)或[工作流应用](https://help.aliyun.com/zh/model-studio/workflow-application/)。 +3. 0代码构建大模型应用：请参考[智能体应用（Agent 1.0）](https://help.aliyun.com/zh/model-studio/single-agent-application)或[工作流应用](https://help.aliyun.com/zh/model-studio/workflow-application/)。 如需自行部署DeepSeek，请参考[技术解决方案](https://www.aliyun.com/solution/tech-solution/deepseek-r1-for-platforms)。 diff --git a/skills/bailian-docs-llm-wiki/raw/model-user-guide/use-cases/third-party-model-integration-tutorial/kimi-api.md b/skills/bailian-docs-llm-wiki/raw/model-user-guide/use-cases/third-party-model-integration-tutorial/kimi-api.md index 07119e8..676f6ad 100644 --- a/skills/bailian-docs-llm-wiki/raw/model-user-guide/use-cases/third-party-model-integration-tutorial/kimi-api.md +++ b/skills/bailian-docs-llm-wiki/raw/model-user-guide/use-cases/third-party-model-integration-tutorial/kimi-api.md @@ -617,6 +617,62 @@ curl -X POST "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services } ``` +## Anthropic兼容 + +## Python + +### **示例代码** + +``` +import anthropic +import os + +client = anthropic.Anthropic( + # 如果没有配置环境变量，请用阿里云百炼API Key替换：api_key="sk-xxx" + api_key=os.getenv("DASHSCOPE_API_KEY"), + base_url="https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic", +) + +message = client.messages.create( + model="kimi-k2.6", + max_tokens=1024, + messages=[ + {"role": "user", "content": "你是谁"} + ], + stream=True, +) + +for event in message: + if event.type == "content_block_delta": + if hasattr(event.delta, "thinking"): + print(event.delta.thinking, end="", flush=True) + if hasattr(event.delta, "text"): + print(event.delta.text, end="", flush=True) +``` + +## HTTP + +### **示例代码** + +## curl + +``` +curl -X POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic/v1/messages \ +-H "Authorization: Bearer $DASHSCOPE_API_KEY" \ +-H "Content-Type: application/json" \ +-H "anthropic-version: 2023-06-01" \ +-d '{ + "model": "kimi-k2.6", + "max_tokens": 1024, + "messages": [ + { + "role": "user", + "content": "你是谁" + } + ] +}' +``` + ## **多模态调用示例** kimi-k2.7-code、kimi-k2.6、kimi-k2.5 支持同时处理文本、图像或视频输入，并可通过 `enable_thinking` 参数开启思考模式。以下示例展示如何调用多模态能力。 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 95385a0..88b916c 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/3d-generation.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/3d-generation.md @@ -76,3 +76,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 d92783b..9ccae08 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/application-call.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/application-call.md @@ -1,189 +1,135 @@ # application call -阿里云百炼应用（智能体、[工作流](../concepts/workflow.md)、新版智能体 Agent 2.0）支持通过 API 调用，将你在控制台编排好的应用集成到业务系统中。调用前需先在控制台获取应用 ID 和 [API Key](../concepts/api-key.md)，再依据是否需要即时返回结果，选择 OpenAI 兼容模式的 Responses API（同步/异步）或 DashScope 原生 API（`/completion`）发起请求。 +阿里云百炼平台提供两套 API 来调用智能体和工作流应用：**OpenAI 兼容的 Responses API** 和 **DashScope API**。两者均支持同步/[异步调用](../concepts/async-invocation.md)、多轮对话、[流式输出](../concepts/streaming.md)等核心能力，开发者可根据生态兼容性和功能需求选择合适的接入方式。调用前需先获取 APP ID（以及子[业务空间](../concepts/workspace.md)场景下的 Workspace ID）和 API Key。 ## 前置准备 -调用任一百炼应用都需要以下凭证与配置： +### 获取凭证 -1. **应用 ID（APP ID）**：在[应用管理](https://bailian.console.aliyun.com/?tab=app#/app-center)页面，从应用卡片上复制其 ID。若应用位于子[业务空间](../concepts/workspace.md)，还需同时提供 **Workspace ID**；位于默认[业务空间](../concepts/workspace.md)则仅需 APP ID。详细获取步骤见[获取APP ID和Workspace ID](../../raw/application-api-reference/application-call/obtain-the-app-id-and-workspace-id.md)。 -2. **[API Key](../concepts/api-key.md)**：通过[密钥管理](https://bailian.console.aliyun.com/?tab=app#/api-key)获取，并[配置到环境变量](https://help.aliyun.com/zh/model-studio/configure-api-key-through-environment-variables)（推荐 `DASHSCOPE_API_KEY`）。不建议在生产环境硬编码。 -3. **SDK（可选）**：OpenAI 兼容模式用 [OpenAI SDK](https://help.aliyun.com/zh/model-studio/install-sdk)；DashScope 原生模式用对应语言的 [DashScope SDK](../concepts/dashscope-sdk.md)。 +通过 API 调用应用时，必须提供 **APP ID** 来指定目标应用。如果应用位于子[业务空间](../concepts/workspace.md)，还需提供 **Workspace ID**。详细获取方式参见 [获取APP ID和Workspace ID](../../raw/application-api-reference/application-call/obtain-the-app-id-and-workspace-id.md)。 -> **注意**：目前只能在控制台手动获取 APP ID 和 Workspace ID，不支持通过 API 或 CLI 查询。RAM 子账号默认只能查看其已加入的[业务空间](../concepts/workspace.md)的 ID；查询主账号下全部[业务空间](../concepts/workspace.md)需主账号或被授予 `AliyunBailianFullAccess`/`AliyunBailianControlFullAccess` 权限。 +- **APP ID**：在控制台「应用管理」页面的应用卡片上复制。 +- **Workspace ID**：在调用子[业务空间](../concepts/workspace.md)下的应用或特定地域（德国、华北2、新加坡、日本）的模型时必须提供，可通过控制台右上角图标查看。 -## 两套调用 API +> **注意**：目前只能通过控制台手动获取 APP ID 和 Workspace ID，不支持通过 API 或 CLI 查询。 -百炼应用提供两套 API，按是否需要复用 OpenAI 生态选择： +### 其他前提 -| API 模式 | Endpoint | 适用场景 | 文档 | -| --- | --- | --- | --- | -| **OpenAI 兼容 Responses API** | `POST https://dashscope.aliyuncs.com/api/v2/apps/agent/{APP_ID}/compatible-mode/v1/responses` | 复用现有 OpenAI 代码库与工具链；支持同步/异步、流式、[多模态](../concepts/multimodal.md) | [同步调用 API 参考](../../raw/application-api-reference/application-call/openai-responses-api/synchronous-call-api-reference.md) / [异步调用API参考](../../raw/application-api-reference/application-call/openai-responses-api/asynchronous-call-api-reference.md) | -| **DashScope 原生 API** | `POST https://dashscope.aliyuncs.com/api/v1/apps/{APP_ID}/completion` | 更全面的功能与更高的性能；新版智能体（Agent 2.0）、[工作流](../concepts/workflow.md)、旧版智能体均支持 | [新版智能体应用 API 参考](../../raw/application-api-reference/application-call/application-dashscope-api-reference/new-agent-application-api-reference.md) / [工作流与旧版智能体应用 API](../../raw/application-api-reference/application-call/application-dashscope-api-reference/agent-and-workflow-application-api-reference.md) | +- 已获取 API Key 并配置到环境变量 `DASHSCOPE_API_KEY`。 +- 已创建并发布百炼应用（智能体或工作流）。 +- 如使用 SDK 调用，需安装对应的 SDK（OpenAI SDK 或 [DashScope SDK](../concepts/dashscope-sdk.md)）。 -> **注意**：上述 Endpoint 仅适用于华北2（北京）地域。德国（法兰克福）、新加坡、日本（东京）等地域，或调用子[业务空间](../concepts/workspace.md)下的应用时，请求中必须包含 Workspace ID，该 ID 是对应地域 Base URL 的组成部分。 +## 两套 API 对比 -## OpenAI 兼容模式（Responses API） +| 维度 | Responses API（OpenAI 兼容） | DashScope API | +|------|---------------------------|---------------| +| Endpoint | `POST https://dashscope.aliyuncs.com/api/v2/apps/agent/{APP_ID}/compatible-mode/v1/responses` | `POST https://dashscope.aliyuncs.com/api/v1/apps/{APP_ID}/completion` | +| SDK | OpenAI Python/Java SDK | DashScope Python/Java SDK | +| 多轮对话 | 通过 `input` 数组传递完整历史消息 | 通过 `session_id` 或 `messages` 维护上下文 | +| [异步调用](../concepts/async-invocation.md) | 设置 `background=true` | 暂不支持（仅 Responses API 提供） | +| 适用地域 | 仅华北2（北京） | 仅华北2（北京） | -SDK 调用需配置的 `base_url`： +## Responses API（OpenAI 兼容模式） -``` -https://dashscope.aliyuncs.com/api/v2/apps/agent/{APP_ID}/compatible-mode/v1 -``` - -HTTP 调用 Endpoint： - -``` -POST https://dashscope.aliyuncs.com/api/v2/apps/agent/{APP_ID}/compatible-mode/v1/responses -``` - -### 关键参数 +### 同步调用 -- **app_id**（必选，string）：应用标识。HTTP 调用时放入 URL 中替换 `{APP_ID}`。 -- **input**（必选，string 或 array）：核心输入。简单字符串用于单轮文本对话；消息数组用于多轮对话或[多模态](../concepts/multimodal.md)输入。 - - 消息 `role` 取值：`system`（可选，设定角色/约束）、`user`（必选）、`assistant`（可选，模型回复）。 - - [多模态](../concepts/multimodal.md) `content` 为数组，子对象 `type`：`input_text`（文本）、`input_image`（图像，需配 `image_url`）、`input_file`（文件，需配 `file_url`，仅[智能体应用](../concepts/agent-application.md)支持）。 -- **stream**（可选，boolean）：是否[流式输出](../concepts/streaming-output.md)，默认 `false`。 -- **background**（可选，boolean）：是否异步执行，默认 `false`。 +适用于需要即时获取结果的实时交互场景。完整参数说明参见 [同步调用 API 参考](../../raw/application-api-reference/application-call/openai-responses-api/synchronous-call-api-reference.md)。 -> **注意**：基于 `pre_response_id` 或 `conversation_id` 的上下文功能将在后续支持，目前请在每次请求时传递完整对话历史（Responses API 多轮）。[异步调用](../concepts/async-invocation.md)暂不支持[流式输出](../concepts/streaming-output.md)。 +**核心请求参数：** -### 同步调用 +| 参数 | 类型 | 必选 | 说明 | +|------|------|------|------| +| `input` | string / array | 是 | 请求输入，可为简单字符串或包含多轮对话历史的消息数组 | +| `stream` | boolean | 否 | 是否[流式输出](../concepts/streaming.md)，默认 `false` | +| `background` | boolean | 否 | 是否异步执行，默认 `false` | -适用于即时获取结果的实时交互场景。单轮对话直接传字符串或 messages；多轮对话把完整历史消息数组传给 `input`： +**Python 示例（单轮对话）：** ```python from openai import OpenAI import os -api_key = os.getenv("DASHSCOPE_API_KEY") -app_id = 'APP_ID' # 替换为实际的应用 ID -base_url = f'https://dashscope.aliyuncs.com/api/v2/apps/agent/{app_id}/compatible-mode/v1/' - -client = OpenAI(api_key=api_key, base_url=base_url) - -response = client.responses.create( - input=[ - {"role": "user", "content": "你是谁？"}, - {"role": "assistant", "content": "我是一个AI助手……"}, - {"role": "user", "content": "你能做什么？"} - ], +client = OpenAI( + api_key=os.getenv("DASHSCOPE_API_KEY"), + base_url=f'https://dashscope.aliyuncs.com/api/v2/apps/agent/{APP_ID}/compatible-mode/v1/' ) + +response = client.responses.create(input="你是谁？") print(response.model_dump_json(indent=2)) ``` -[流式输出](../concepts/streaming-output.md)只需设置 `stream=True`。**[工作流](../concepts/workflow.md)应用**需在结束节点或流程输出节点启用「[流式输出](../concepts/streaming-output.md)」开关并重新发布；**[智能体应用](../concepts/agent-application.md)**做图像输入需选用通义千问 VL 系列模型并将文件处理方式设为「自定义处理」后重新发布。 +**多轮对话**需在 `input` 中传递完整的消息历史数组，每条消息包含 `role`（user/assistant/system）和 `content` 字段。 -### [异步调用](../concepts/async-invocation.md) +### [多模态](../concepts/multimodal.md)输入 -适用于耗时较长的任务（生成报告、多步骤工具调用等）。设置 `background=True`，API 立即返回任务 ID，再通过轮询 `retrieve` 查询状态，直到进入终态（`completed`/`failed`/`cancelled`）： +Responses API 支持在 `content` 数组中混合多种输入类型： -```python -import asyncio, os, time -from openai import AsyncOpenAI - -api_key = os.getenv("DASHSCOPE_API_KEY") -app_id = 'APP_ID' -base_url = f'https://dashscope.aliyuncs.com/api/v2/apps/agent/{app_id}/compatible-mode/v1/' -client = AsyncOpenAI(api_key=api_key, base_url=base_url) - -async def main(): - create_resp = await client.responses.create( - input="请为我规划一个为期三天的北京旅游行程。", - background=True - ) - task_id = create_resp.id - while True: - resp = await client.responses.retrieve(task_id) - if resp.status in ['completed', 'failed', 'cancelled']: - break - await asyncio.sleep(2) - print(resp.model_dump_json(indent=2)) - -asyncio.run(main()) -``` +- **图像输入**：通过 `input_image` 类型传入图片 URL。智能体应用需选用通义千问 VL 系列模型并将文件处理方式设为「自定义处理」。 +- **文件输入**：通过 `input_file` 类型传入文件 URL。仅智能体应用支持，需配置「全文引用」或「切片检索」处理方式。 -异步任务也支持**取消**和**删除**操作，详见[异步调用API参考](../../raw/application-api-reference/application-call/openai-responses-api/asynchronous-call-api-reference.md)。 +### [异步调用](../concepts/async-invocation.md) -### 自定义参数与插件参数传递 +对于耗时较长的任务（如生成报告、多步骤工具调用），可设置 `background=true` 开启异步模式，避免请求超时。详细流程参见 [异步调用API参考](../../raw/application-api-reference/application-call/openai-responses-api/asynchronous-call-api-reference.md)。 -- **自定义参数**：在应用「开始」节点创建自定义参数，大模型节点提示词中引用（如 `/city`），发布后通过 `extra_body.biz_params` 传入，参数名与类型须与应用配置一致： - ```python - response = await client.responses.create( - input="你好", - extra_body={"biz_params": {"city": "北京"}}, - background=True - ) - ``` -- **插件参数**：[智能体应用](../concepts/agent-application.md)在应用内选择插件并发布即可；工作流应用需添加插件节点，并在开始节点创建自定义参数传入插件入参，再在大模型节点提示词中引用自定义参数与插件输出参数。 +核心流程： -## DashScope 原生模式（/completion） +1. **创建任务**：请求中设置 `background=true`，API 立即返回任务 ID。 +2. **轮询状态**：通过 `client.responses.retrieve(task_id)` 定期查询任务状态。 +3. **处理结果**：当状态变为 `completed`、`failed` 或 `cancelled` 时获取最终结果。 -请求地址： +> **注意**：异步任务暂不支持[流式输出](../concepts/streaming.md)（`stream=true`）。 -``` -POST https://dashscope.aliyuncs.com/api/v1/apps/{APP_ID}/completion -``` +### 流式输出 -请求体结构： +设置 `stream=true` 可边生成边输出，适用于需要实时展示生成内容的场景。若应用类型为工作流，需在结束节点或流程输出节点中启用「流式输出」开关并重新发布。 -```json -{ - "input": { "prompt": "你是谁？" }, - "parameters": {}, - "debug": {} -} -``` +## DashScope API -### 单轮对话 +DashScope API 提供更全面的功能支持，适合需要深度集成百炼平台能力的场景。支持 Python、Java、PHP、Node.js、C#、Go 等多种语言的 HTTP 调用，以及 Python/Java SDK。详细参数参见 [应用 DashScope API 参考](../../raw/application-api-reference/application-call/application-dashscope-api-reference/agent-and-workflow-application-api-reference.md)。 -Python（[DashScope SDK](../concepts/dashscope-sdk.md)）： +**Python 示例：** ```python -import os -from http import HTTPStatus from dashscope import Application +import os response = Application.call( api_key=os.getenv("DASHSCOPE_API_KEY"), - app_id='APP_ID', # 替换为实际的应用 ID - prompt='你是谁？') - -if response.status_code != HTTPStatus.OK: - print(f'request_id={response.request_id}\ncode={response.status_code}\nmessage={response.message}') -else: - print(response.output.text) + app_id='APP_ID', + prompt='你是谁？' +) +print(response.output.text) ``` -除 Python/Java SDK 外，DashScope 原生 API 还提供 PHP、Node.js、C#、Go 的 HTTP 调用示例，详见[新版智能体应用 API 参考](../../raw/application-api-reference/application-call/application-dashscope-api-reference/new-agent-application-api-reference.md)与[工作流与旧版智能体应用 API](../../raw/application-api-reference/application-call/application-dashscope-api-reference/agent-and-workflow-application-api-reference.md)。 +**多轮对话**通过 `session_id` 维护上下文：首次请求无需传入，响应中会返回 `session_id`；后续请求携带该值即可延续对话。`session_id` 在最后一次请求后 1 小时内有效。 -### 多轮对话 +新版智能体应用（Agent 2.0）的调用方式与上述基本一致，参见 [新版智能体应用 API 参考](../../raw/application-api-reference/application-call/application-dashscope-api-reference/new-agent-application-api-reference.md)。 -- **新版[智能体应用](../concepts/agent-application.md)**：通过 `session_id` 维护上下文。首次请求无需传入，响应中返回新生成的 `session_id`；后续请求携带上一轮的 `session_id` 即可延续对话，有效期 1 小时。 -- **工作流与旧版[智能体应用](../concepts/agent-application.md)**：通过 `session_id` 或 `messages` 启用多轮对话。 +## 参数传递 -```python -response = Application.call( - api_key=os.getenv("DASHSCOPE_API_KEY"), - app_id='APP_ID', - prompt='你是谁？') +### 自定义参数 -responseNext = Application.call( - api_key=os.getenv("DASHSCOPE_API_KEY"), - app_id='APP_ID', - prompt='你有什么技能?', - session_id=response.output.session_id) # 上一轮 response 的 session_id -print(responseNext.output.text) +工作流应用中定义的自定义参数，通过请求体中的 `biz_params` 传递，参数名和类型需与应用内配置保持一致。 + +```python +response = await client.responses.create( + input="你好", + extra_body={"biz_params": {"city": "北京"}}, + background=True +) ``` +### 插件参数 + +智能体或工作流中配置的插件工具参数，同样通过 `biz_params` 传递。工作流需在开始节点创建自定义参数并将其传入插件节点的输入参数中。 + ## 限制与注意事项 -- **地域限制**：本文档涉及的 Responses API 与 DashScope `/completion` 接口均仅适用于华北2（北京）地域。 -- **异步不支持流式**：异步任务（`background=true`）暂不支持 `stream=true`。 -- **多轮上下文**：Responses API 目前不支持基于 `pre_response_id`/`conversation_id` 的上下文，每次请求需传完整历史；DashScope 原生 API 用 `session_id`（有效期 1 小时）或 `messages` 维持多轮。 -- **文件输入仅智能体支持**：`input_file` 仅[智能体应用](../concepts/agent-application.md)可用，且应用内文件处理方式需选「全文引用」或「切片检索」。 -- **应用配置须重新发布**：[流式输出](../concepts/streaming-output.md)、图像输入、插件/自定义参数等能力都需要先在应用内正确配置并**重新发布**后才能生效。 -- **权限**：查询全部[业务空间](../concepts/workspace.md)需主账号或被授予权限的 RAM 子账号；普通 RAM 子账号只能查看其已加入的[业务空间](../concepts/workspace.md)。 +- 两套 API 目前均**仅适用于华北2（北京）地域**。 +- Responses API 的多轮对话暂不支持基于 `pre_response_id` 或 `conversation_id` 的上下文功能，需每次传递完整对话历史。 +- 异步调用仅 Responses API 支持，且不能与流式输出同时使用。 +- RAM 子账号查看业务空间管理页面需要超级管理员权限（`AliyunBailianFullAccess` 或 `AliyunBailianControlFullAccess`）。 +- API Key 不建议硬编码到代码中，应通过环境变量配置以降低泄露风险。 ## 来源文档 @@ -191,15 +137,6 @@ print(responseNext.output.text) - [同步调用 API 参考](../../raw/application-api-reference/application-call/openai-responses-api/synchronous-call-api-reference.md) - [异步调用API参考](../../raw/application-api-reference/application-call/openai-responses-api/asynchronous-call-api-reference.md) - [新版智能体应用 API 参考](../../raw/application-api-reference/application-call/application-dashscope-api-reference/new-agent-application-api-reference.md) -- [工作流与旧版智能体应用 API](../../raw/application-api-reference/application-call/application-dashscope-api-reference/agent-and-workflow-application-api-reference.md) - - - - - - - - - +- [应用 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 87c3ee2..a360863 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 @@ -100,7 +100,7 @@ | API | 说明 | | --- | --- | | UpdateIndex | 更新知识库配置（名称、描述、检索参数、规格类型等） | -| ListIndices | 获取业务空间下的知识库列表 | +| ListIndices | 获取[业务空间](../concepts/workspace.md)下的知识库列表 | | DeleteIndex | 永久删除知识库（不可逆，需先解除应用关联） | | ListIndexFileDetails | 查询知识库下的文件详情 | | ListIndexDocuments | 查询知识库下的文件列表 | @@ -215,3 +215,4 @@ Prompt 模板支持创建、查询、更新、删除和列表操作，用于管 + 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 10607bb..e395064 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 @@ -1,37 +1,33 @@ # file management api -文件管理 API 用于管理上传至百炼平台的文件，提供上传、查询、列举和删除等操作能力。开发者可以通过这些接口将本地文件上传到百炼，并在后续任务（如模型推理、数据处理等）中引用已上传的文件。本文整理该 API 的核心使用方式与注意事项。 +百炼平台提供文件管理 API，用于管理上传至平台的文件资源。该 API 支持文件的上传、查询、列举和删除四类核心操作，是使用百炼平台进行模型微调、知识库构建等场景的基础能力。开发者可通过 [文件管理](../../raw/model-api-reference/file-management-api.md) 接口完成文件全生命周期管理。 -## 支持的操作 +## 核心功能 -文件管理 API 围绕上传至百炼平台的文件提供以下四类核心操作，详见 [文件管理](../../raw/model-api-reference/file-management-api.md)： +根据 [文件管理](../../raw/model-api-reference/file-management-api.md) 文档，文件管理 API 提供以下四类操作： -- **上传文件**：将本地文件上传到百炼平台，上传成功后返回文件的唯一标识，供后续流程引用。 -- **查询文件**：根据文件标识查询单个文件的元数据信息，例如文件名、大小、状态等。 -- **列举文件**：分页列举当前账号下已上传的文件，便于批量管理与检索。 -- **删除文件**：删除不再使用的文件，释放存储空间并保持文件列表整洁。 +- **上传文件**：将本地文件上传至百炼平台，供后续模型训练、知识库导入等场景使用。 +- **查询文件**：根据文件 ID 查询已上传文件的详细信息，包括文件名、大小、上传时间、用途等元数据。 +- **列举文件**：批量获取当前账号下已上传的文件列表，支持分页和筛选。 +- **删除文件**：删除不再需要的文件，释放存储空间。 ## 使用方式 -调用文件管理 API 时，通常遵循"上传 → 拿到文件标识 → 在业务请求中引用 → 用完删除"的流程。上传是所有后续操作的前提，上传后获取到的文件标识是查询、列举、删除以及业务引用的关键凭证，相关说明可参考 [文件管理](../../raw/model-api-reference/file-management-api.md)。 +开发者可通过 HTTP 请求调用文件管理 API。典型的使用流程为： + +1. 调用上传接口将训练数据或知识库文件上传至平台。 +2. 通过列举接口确认文件上传成功，获取文件 ID。 +3. 在模型微调或知识库创建时引用对应的文件 ID。 +4. 任务完成后，按需调用删除接口清理不再使用的文件。 ## 注意事项 -- 文件上传后会有生命周期管理，建议在文件不再被业务使用时及时调用删除接口，避免占用存储配额。 -- 查询与列举接口返回的文件元数据可用于校验文件状态，确保在引用前文件处于可用状态。 -- 文件管理 API 的具体参数、请求方式与返回字段以 [文件管理](../../raw/model-api-reference/file-management-api.md) 中的最新说明为准，本文为概览性整理。 +- 上传的文件需符合平台对文件格式和大小的限制要求，具体限制请参考 [文件管理](../../raw/model-api-reference/file-management-api.md) 中的说明。 +- 删除文件前请确认该文件未被其他任务（如微调任务、知识库）引用，否则可能影响相关任务的正常运行。 +- 文件上传后会分配唯一的文件 ID，后续所有操作均通过该 ID 进行引用。 ## 来源文档 - [文件管理](../../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 c880471..8eeead4 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/frameworks.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/frameworks.md @@ -142,3 +142,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 24c7402..e439af6 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/image-generation.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/image-generation.md @@ -1,109 +1,161 @@ # image generation -百炼平台图像生成类 API 汇总了通义千问、万相、Z-Image、可灵等自研模型，以及一批面向电商、营销、人像场景的创意图像工具。所有接口均通过百炼模型推理网关以 OpenAI 兼容或 DashScope 原生协议调用，统一使用 `Authorization: Bearer ` 鉴权，输入输出以 JSON 承载，部分能力支持流式与异步轮询。 +百炼平台提供丰富的图像生成与编辑API，涵盖文生图、图像编辑、图像翻译、风格迁移、创意工具等多种能力。平台上的图像模型主要分为千问(Qwen-Image)系列、万相(Wan/Wanx)系列、Z-Image、可灵(Kling)系列以及多种垂直场景创意工具，均通过HTTP或[DashScope SDK](../concepts/dashscope-sdk.md)调用。 -## 能力全景 +## 核心模型系列 -按模型族与用途可分为四组： +### 千问-图像（Qwen-Image） -| 分组 | 代表接口 | 主要能力 | -| --- | --- | --- | -| 通义千问图像 | 千问-文生图、千问-图像编辑、千问-图像翻译 | 文生图、图像编辑、图文翻译 | -| 万相图像 | 万相-文生图 V1/V2、万相-图像生成与编辑 2.6/2.7、万相-通用图像编辑 2.5、万相-通用图像编辑、万相-涂鸦作画、万相-图像局部重绘 | 通用文生图、[多模态](../concepts/multimodal.md)编辑、局部重绘、涂鸦生图 | -| 第三方/自研大模型 | Z-Image、可灵-图像生成 | 高质量文生图、艺术风格 | -| 创意工具 | 人像风格重绘、虚拟模特、鞋靴模特、图像画面扩展、创意海报、人物实例分割、AI 试衣 OutfitAnyone、图像背景生成、图像擦除补全、人物写真 FaceChain、创意文字 WordArt 锦书 | 垂类业务化图像处理 | +千问系列覆盖文生图、图像编辑和图像翻译三大能力，擅长复杂文本渲染和图文混合布局。详见[千问-文生图API参考](../../raw/model-api-reference/image-generation/qwen-image-api-reference/qwen-image-api.md)。 -## 通义千问图像 +**文生图模型**： -通义千问图像能力由 Qwen-Image 系列模型提供，统一在 `qwen-image` 模型族下，按任务区分模型名： +| 模型名称 | 简介 | 输出规格 | +|---------|------|---------| +| qwen-image-2.0-pro（推荐） | Pro系列，文字渲染、真实质感更强 | 512x512至2048x2048，png，1-6张 | +| qwen-image-2.0（推荐） | 加速版，兼顾效果与速度 | 同上 | +| qwen-image-max | Max系列，真实感更强，AI痕迹更低 | 固定1张 | +| qwen-image-plus / qwen-image | 擅长多样化艺术风格与文字渲染 | 同上 | -- **千问-文生图**：输入中文/英文 [prompt](../guides/prompt.md) + 可选参考图，输出 1024×1024 等多尺寸图像，支持中文原生理解、双语 [prompt](../guides/prompt.md)、长宽比与风格控制。 -- **千问-图像编辑**：在保留原图主体与构图的前提下，按自然语言指令做局部修改（换背景、改服饰、增减物体等），支持蒙版与参考图。 -- **千问-图像翻译**：面向漫画/图文场景，识别图中文字并翻译为目标语言，同时重绘文字区域以保持视觉一致性。 +**图像编辑**（qwen-image-edit系列）：支持多图输入和多图输出，可精确修改图内文字、增删或移动物体、改变主体动作、迁移图片风格及增强画面细节。详见[千问-图像编辑API参考](../../raw/model-api-reference/image-generation/qwen-image-api-reference/qwen-image-edit-api.md)。 -调用入口通常为 `https://dashscope.aliyuncs.com/compatible-mode/v1/images/generations`（OpenAI 兼容）或 DashScope 原生 `services/aigc/text2image/image-synthesis` 路径，`model` 字段填具体模型名（如 `qwen-image-edit`）。 +**图像翻译**（qwen-mt-image系列）：精准翻译图像中的文字并保留原始排版，支持领域提示、敏感词过滤、术语干预等功能。详见[千问-图像翻译API参考](../../raw/model-api-reference/image-generation/qwen-image-api-reference/qwen-mt-image-api.md)。 -## 万相图像 +### 万相（Wan/Wanx）系列 -万相（Wan）是百炼自研的图像与视频生成模型族，迭代到 2.7 版本，是接口数量最多的一组： +万相系列是百炼平台图像生成的核心模型族，按功能分为文生图和图像生成与编辑两条产品线。 -### 文生图 +**文生图V2版**（纯文本到图片）： -- **万相-文生图 V1**：经典版，支持中文 [prompt](../guides/prompt.md)、尺寸、风格、负面词。 -- **万相-文生图 V2**：升级版，画质与中文语义理解提升，支持更多长宽比与参考图引导。 +| 模型名称 | 简介 | +|---------|------| +| wan2.6-t2i（推荐） | 万相2.6，支持自由尺寸，总像素1280x1280至1440x1440 | +| wan2.5-t2i-preview（推荐） | 万相2.5 preview，支持自由尺寸，单边可达2700 | +| wan2.2-t2i-flash | 极速版，速度提升50% | +| wan2.2-t2i-plus | 专业版，稳定性与成功率提升 | +| wanx2.1-t2i-turbo / wanx2.1-t2i-plus | 万相2.1 | +| wanx2.0-t2i-turbo | 万相2.0 | -### 生成与编辑一体 +详见[万相-文生图V2版API参考](../../raw/model-api-reference/image-generation/wan-image-api-reference/text-to-image-v2-api-reference.md)。 -- **万相-图像生成与编辑 2.6 / 2.7**：同一接口兼顾文生图与图像编辑，2.7 在编辑自然度、文字渲染、多图融合上进一步优化，是当前推荐的通用版本。 -- **万相-通用图像编辑 2.5 / 通用图像编辑**：聚焦"按指令改图"的编辑专用版本，2.5 为较新迭代。 +> **注意**：V1版文生图（wanx-v1/wanx-style-repaint-v1等）已不推荐使用，建议迁移至V2版模型。 -### 局部与创意编辑 +**图像生成与编辑2.7**（最新）： -- **万相-图像局部重绘（Vary Region）**：指定区域 + [prompt](../guides/prompt.md) 做局部重绘，常用于换物、修复。 -- **万相-涂鸦作画**：以用户涂鸦/草图 + [prompt](../guides/prompt.md) 引导生成结构化图像。 -- **万相-通用图像编辑（旧）**：早期版本，建议迁移到 2.5+。 +| 模型名称 | 简介 | +|---------|------| +| wan2.7-image-pro | 专业版，文生图支持4K输出 | +| wan2.7-image | 生成速度更快 | -万相接口大多走 DashScope 原生异步协议：`POST /services/aigc/text2image/image-synthesis` 返回 `task_id`，再轮询 `GET /tasks/{task_id}` 取结果；文生图 V2 等也提供兼容模式同步调用。 +支持文生图、文生组图、图生组图、图像编辑和多图参考生成。详见[万相-图像生成与编辑2.7 API参考](../../raw/model-api-reference/image-generation/wan-image-api-reference/wan-image-generation-and-editing-api-reference.md)。 -## Z-Image 与可灵 +**图像生成与编辑2.6**（wan2.6-image）：支持图像编辑和图文混排输出。如需纯文生图，建议使用wan2.6-t2i。详见[万相-图像生成与编辑2.6 API参考](../../raw/model-api-reference/image-generation/wan-image-api-reference/wan-image-generation-api-reference.md)。 -- **Z-Image**：自研高质量文生图大模型，擅长艺术风格、复杂构图与中文语义，适合营销与设计场景。 -- **可灵-图像生成**：由可灵团队提供的高美感文生图能力，接入百炼网关统一调用。 +**通用图像编辑2.5**（wan2.5-image-edit）：仅需文本指令即可基于单张或多张参考图像实现主体一致的图像编辑和多图融合。详见[万相-通用图像编辑2.5](../../raw/model-api-reference/image-generation/wan-image-api-reference/wan2-5-image-edit-api-reference.md)。 -二者均以文生图为主，参数聚焦于 [prompt](../guides/prompt.md)、负面词、尺寸与采样控制。 +**其他万相工具模型**（仅限北京地域）： +- **涂鸦作画**（wanx-sketch-to-image）：将涂鸦草图转为精细图像，详见[万相-涂鸦作画API参考](../../raw/model-api-reference/image-generation/wan-image-api-reference/wanx-sketch-to-image-api-reference.md) +- **图像局部重绘**（wanx-x-painting）：对指定区域进行内容重绘，详见[万相-图像局部重绘API参考](../../raw/model-api-reference/image-generation/wan-image-api-reference/vary-region-api-reference.md) +- **通用图像编辑**（wanx-image-edit）：支持风格化、内容编辑、扩图、超分等功能，详见[万相-通用图像编辑API参考](../../raw/model-api-reference/image-generation/wan-image-api-reference/wanx-image-edit-api-reference.md) -## 创意图像工具 +> **注意**：wanx-x-painting（局部重绘）当前仅提供免费体验，免费额度用完后不可调用且不支持付费，推荐迁移至千问图像编辑或万相2.1+版本。 -这一组把图像模型封装成业务化接口，输入通常是商品图/人像图 + 简单参数，输出业务可用成图： +### Z-Image -| 接口 | 典型用法 | -| --- | --- | -| 人像风格重绘 | 把人像转为指定风格（油画、动漫、3D 等） | -| 虚拟模特 | 商品图 + 模特参数生成虚拟模特穿着图 | -| 鞋靴模特 | 鞋类商品上脚/上模特展示图 | -| 图像画面扩展（Image Scaling） | 扩展画幅、补全边缘 | -| 创意海报生成 | 文案 + 主体图生成营销海报 | -| 人物实例分割 | 抠取人物前景，供后续合成 | -| AI 试衣 OutfitAnyone | 人像 + 服装图生成试穿图 | -| 图像背景生成 | 商品/主体 + 描述生成新背景 | -| 图像擦除补全 | 擦除指定区域并智能补全 | -| 人物写真 FaceChain | 多张人像生成个性化写真集 | -| 创意文字 WordArt 锦书 | 艺术字、文字排版生成 | +Z-Image（z-image-turbo）是一款轻量级文生图模型，生成速度快，支持中英文字渲染，灵活适配多种分辨率与宽高比。输出像素范围512x512至2048x2048，固定生成1张。详见[Z-Image API参考](../../raw/model-api-reference/image-generation/z-image-generation-api-reference/z-image-api-reference.md)。 -这些接口多走 DashScope 原生协议，部分需要先开通对应模型，再以 `model` 字段区分。 +### 可灵（Kling） -## 调用约定 +| 模型名称 | 能力 | 输出规格 | +|---------|------|---------| +| kling/kling-v3-image-generation | 文生图、单图参考生图 | 1k/2k分辨率，1-9张 | +| kling/kling-v3-omni-image-generation | 文生图、多图参考生图、分镜组图 | 1k/2k/4k分辨率，支持组图2-9张 | -1. **鉴权**：所有接口在请求头携带 `Authorization: Bearer ${API_KEY}`，API_KEY 在百炼控制台"API-KEY 管理"获取。 -2. **协议选择**： - - OpenAI 兼容模式：`https://dashscope.aliyuncs.com/compatible-mode/v1/...`，适合千问文生图等。 - - DashScope 原生模式：`https://dashscope.aliyuncs.com/api/v1/services/aigc/...`，适合万相异步任务、创意工具。 -3. **同步 vs 异步**：创意工具与万相多数为异步——提交任务得 `task_id`，按建议间隔轮询 `GET /api/v1/tasks/{task_id}`，状态为 `SUCCEEDED` 后取 `output.results`。 -4. **图片传输**：输入图支持公网 URL 或 Base64（需 `data:image/...;base64,` 前缀），输出图一般为临时 URL，需及时下载或转存到 OSS。 -5. **尺寸与长宽比**：各模型支持的尺寸集合不同，超范围会报错；万相 V2、千问等支持按 `size` 或 `parameters.size` 指定。 -6. **内容安全**：所有接口内置内容安全审核，违规 [prompt](../guides/prompt.md) 或图片会被拒绝并在响应中返回对应错误码。 +仅限华北2（北京）地域。详见[可灵-图像生成API参考](../../raw/model-api-reference/image-generation/kling-image-api-reference/kling-image-generation-api-reference.md)。 -## 通用错误码 +## 创意工具模型 -| HTTP / 错误码 | 含义 | 处理建议 | -| --- | --- | --- | -| 400 InvalidParameter | 参数缺失或非法 | 校验 `model`、`input`、`parameters` 结构 | -| 401 AccessDenied | API_KEY 无效或无权限 | 重新获取 KEY 并确认已开通对应模型 | -| 429 Throttling | QPS/并发超限 | 退避重试或申请提配额 | -| 409 DataInspectionFailed | 内容安全拦截 | 修改 [prompt](../guides/prompt.md)/图片后重试 | -| 任务状态 `FAILED` | 异步任务失败 | 查看 `output.message` 定位原因 | +以下模型均仅限华北2（北京）地域使用，面向特定垂直场景： -## 选型建议 +| 模型 | 功能 | 计费状态 | +|------|------|---------| +| 人像风格重绘 | 将人物照片转换为多种艺术风格 | 已商业化 | +| image-out-painting | 按宽高比/比例/方向扩展图像画面 | 已商业化（0.18元/张） | +| wanx-background-generation-v2 | 为主体商品生成背景图 | 已商业化 | +| AI试衣（aitryon / aitryon-plus） | 虚拟试衣，支持快速出图和精修 | 已商业化 | +| wanx-virtualmodel / virtualmodel-v2 | 虚拟模特，替换模特和背景 | 仅免费体验 | +| shoemodel-v1 | 鞋靴AI试穿 | 仅免费体验 | +| wanx-poster-generation-v1 | 自动生成海报背景和文字排版 | 仅免费体验 | +| image-instance-segmentation | 人物实例像素级分割 | 仅免费体验 | +| image-erase-completion | 擦除图像中的人物/物体/文字 | 仅免费体验 | +| FaceChain人物写真 | 2张照片训练人物形象，批量生成写真 | 仅免费体验 | +| WordArt锦书 | 创意艺术字生成 | 仅免费体验 | -- **纯中文文生图、追求语义准确**：优先千问-文生图或万相-文生图 V2。 -- **按指令改图（编辑）**：万相-图像生成与编辑 2.7 > 通用图像编辑 2.5；细粒度局部改图用图像局部重绘。 -- **高美感/艺术风格**：Z-Image、可灵-图像生成。 -- **电商/营销垂类**：虚拟模特、鞋靴模特、AI 试衣、创意海报、图像背景生成。 -- **人像玩法**：人像风格重绘、人物写真 FaceChain。 -- **图像后处理**：画面扩展、擦除补全、人物实例分割。 -- **艺术文字**：创意文字 WordArt 锦书。 +> **注意**：标注"仅免费体验"的模型免费额度用完后不可调用且不支持付费。建议在正式业务中使用已商业化的模型（如千问图像编辑、万相2.6+版本）作为替代。 -新接入建议直接使用最新版本（万相 2.7、通用图像编辑 2.5 等），旧版接口保留兼容但不再增强。 +详见各模型的API参考文档：[人像风格重绘API参考](../../raw/model-api-reference/image-generation/image-creative-tools-api-reference/portrait-style-redraw-api-reference.md)、[AI试衣OutfitAnyone](../../raw/model-api-reference/image-generation/image-creative-tools-api-reference/outfitanyone.md)、[图像背景生成API参考](../../raw/model-api-reference/image-generation/image-creative-tools-api-reference/wanx-background-generation-api-reference.md)等。 + +## 调用方式 + +图像API支持两种调用模式： + +**同步调用**（wan2.6+、qwen-image-2.0+等新版模型）：一次请求直接返回结果，流程简单，推荐大多数场景使用。 + +``` +POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation +``` + +**[异步调用](../concepts/async-invocation.md)**（所有模型均支持）：先创建任务获取`task_id`，再轮询查询结果。需要在请求头中添加`X-DashScope-Async: enable`。 + +``` +# 1. 创建任务 +POST https://dashscope.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis +Header: X-DashScope-Async: enable + +# 2. 查询结果 +GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id} +``` + +此外，还支持通过DashScope Python SDK和Java SDK调用。 + +## 关键参数 + +各模型的公共参数包括： + +| 参数 | 说明 | +|------|------| +| `model` | 模型名称，如`wan2.7-image-pro`、`qwen-image-2.0-pro` | +| `prompt` | 文本提示词，描述期望生成的图像内容 | +| `size` | 输出图像尺寸，格式因模型而异（如`1024*1024`、`2K`、`4K`） | +| `n` | 生成图像数量 | +| `negative_prompt` | 反向提示词，排除不需要的元素（部分模型支持） | +| `ref_img` / `image`（content） | 参考图像URL，用于图生图和编辑场景 | +| `watermark` | 是否添加水印，默认为true | + +> **注意**：`size`参数的取值范围因模型版本不同差异较大。例如wan2.6-t2i支持总像素1280x1280至1440x1440范围内自由设定，而qwen-image-2.0-pro支持512x512至2048x2048。调用前请查阅对应模型文档中的size参数说明。 + +## 地域与接入域名 + +- **华北2（北京）**：支持所有图像模型。推荐使用[业务空间](../concepts/workspace.md)专属域名 `https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com` +- **新加坡**：支持部分模型（千问、万相文生图V2、Z-Image等）。域名：`https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com` +- **美国（弗吉尼亚）**：支持部分模型。域名：`https://dashscope-us.aliyuncs.com` + +> **注意**：不同地域拥有独立的API Key与请求地址，不可混用，跨地域调用将导致鉴权失败。创意工具类模型（人像风格重绘、虚拟模特、AI试衣等）大多仅在华北2（北京）地域可用。 + +## 计费与限流 + +- **免费额度**：开通百炼服务后自动发放，通常为500张/模型，有效期90天。主账号与RAM子账号共享。 +- **计费方式**：按成功生成的输出图片数量计费，输入图片和失败请求不收费。 +- **限流**：多数模型的默认限制为任务下发QPS 2、同时处理中任务数1-5。主账号与RAM子账号共享限流额度。 + +详见[常见问题](../../raw/model-api-reference/image-generation/image-faq.md)。 + +## 常见错误与排查 + +- **图片下载失败**（`BadRequest.InputDownloadFailed`）：输入图片URL无法访问，需确保URL完整且支持公网访问，建议上传至OSS等云存储。 +- **任务创建curl执行失败**：Windows环境下`curl`转义规则与Linux/macOS不同，建议使用Postman等工具或按Windows语法调整命令。 +- **鉴权失败**：检查是否使用了正确地域的API Key，不同地域的Key不可混用。 +- **余额不足**：免费额度用尽后需在阿里云控制台充值，或检查模型是否为"仅免费体验"状态。 ## 来源文档 @@ -134,10 +186,3 @@ - [创意文字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 43ddb43..ae6f8d3 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/knowledge.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/knowledge.md @@ -11,13 +11,13 @@ ## 鉴权与 Base URL -所有请求须在请求头携带 `Authorization: Bearer `，并使用业务空间 ID 拼接的 Base URL： +所有请求须在请求头携带 `Authorization: Bearer `，并使用[业务空间](../concepts/workspace.md) ID 拼接的 Base URL： ``` https://{workspaceId}.cn-beijing.maas.aliyuncs.com ``` -其中 `{workspaceId}` 为业务空间 ID。API Key 在控制台 [API Key 页面](https://rag.console.aliyun.com/settings/apikey) 获取，业务空间 ID 在控制台 [业务空间管理](https://bailian.console.aliyun.com/cn-beijing?tab=globalset#/efm/business_management) 获取。 +其中 `{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) 获取。 ## 限流 @@ -46,3 +46,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 18fbebe..5321ab9 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 @@ -220,3 +220,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 0d280d7..dedbd0c 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 @@ -1,218 +1,126 @@ # managed agents api -Managed Agents API 是百炼提供的智能体托管运行时，由平台托管会话、沙箱、工具执行与事件流。开发者通过 REST 或 DashScope SDK 管理智能体（Agent）、运行环境（Environment）、技能（Skill）、文件（File）和会话（Session）等资源，无需自建调度与执行基础设施。详见 [API 总览与认证](../../raw/application-api-reference/managed-agents-api/managed-agents-api-overview.md)。 +Managed Agents API 是百炼平台提供的智能体托管运行时，由平台负责会话管理、沙箱执行、工具调用与事件流推送。开发者通过 REST API 或 SDK 完成 Agent 定义、Environment 配置、Session 创建与事件交互，五分钟即可跑通端到端流程。详细的认证方式与 SDK 版本要求见 [API 总览与认证](../../raw/application-api-reference/managed-agents-api/managed-agents-api-overview.md)。 -## 前提条件与 Endpoint +## 核心概念与资源模型 -1. 开通百炼并创建 API Key（`sk-xxx`），将其配置到环境变量 `DASHSCOPE_API_KEY`。 -2. 在控制台右上角获取工作空间 ID，形如 `ws_xxxxxxxxxxxx`。 -3. Endpoint 按工作空间与地域拼装，当前仅支持 `cn-beijing`： +Managed Agents 围绕五类资源构建： + +- **Agent** — 智能体配置，包含模型、系统提示词、技能挂载。每次更新自动递增版本号，会话创建时锁定当时版本，后续更新不影响已有会话。详见 [Agent](../../raw/application-api-reference/managed-agents-api/agent-api.md)。 +- **Environment** — 运行环境，定义工具调用的沙箱类型与预装依赖，可被多个会话复用。 +- **Session** — 智能体的一次运行实例，绑定 Agent 与 Environment 快照，由平台驱动状态机（`idle` → `running` → `idle` / `terminated`）。 +- **Event** — 会话内的原子消息记录，包括用户消息、工具调用回执、状态变更等，支持 SSE 流式推送。 +- **Skill** — 以 zip 包封装的工具组合，上传后经安全扫描（`checking` → `active` / `rejected`）方可挂载到 Agent，挂载时锁定具体版本号。 +- **File** — 独立文件资源，上传后可挂载到会话沙箱供工具读写，或作为消息附件传给智能体。 + +## 认证与 Endpoint + +API 基地址按工作空间与地域拼装： ``` https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio ``` -全部请求通过 HTTP Header 鉴权，一个 Key 可访问其归属工作空间下的全部资源： +当前仅支持 `cn-beijing` 地域。所有请求通过 HTTP Header 携带 [API Key 鉴权](../concepts/api-key.md)： ``` Authorization: Bearer ``` -请求体为 JSON（`Content-Type: application/json`），每个响应携带 `x-request-id` 头，提工单时附上可加速定位。列表端点支持分页：`limit`（默认 20，最大 100）、`page`（首次不传，后续传上一次响应的 `next_page`，响应不含该字段表示末页）。 - -## SDK - -除直接调用 REST 外，可使用 Python 或 Java SDK 接入： - -- Python：`pip install dashscope`，要求 v1.26.2 及以上 -- Java：引入 `com.alibaba:dashscope-sdk-java`，要求 v2.22.24 及以上 - -旧版本需重新执行安装命令升级。端到端示例见 [快速开始](../../raw/application-api-reference/managed-agents-api/managed-agents-quickstart.md)。 - -## 资源模型 - -| 资源 | 端点前缀 | 说明 | -| --- | --- | --- | -| Agent | `/agents` | 可复用的智能体配置：模型、系统提示词、工具包、技能 | -| Environment | `/environments` | 工具调用的执行沙箱与预装依赖，可被多会话复用 | -| Session and Event | `/sessions` | 智能体的一次运行实例，绑定 Agent 与 Environment 快照 | -| Skill | `/skills` | 以 zip 包封装的工具组合与文档，挂载时锁定具体版本号 | -| File | `/files` | 独立文件资源，可挂载到沙箱供工具读写或作为消息内容 | +API Key 通过百炼控制台获取，一个 Key 可访问其归属工作空间下的全部资源。每次响应携带 `x-request-id` 头，提工单时附上此 ID 可加速定位。 -## 调用流程 +## 主要 API 端点 -一次完整对话分四步（详见 [快速开始](../../raw/application-api-reference/managed-agents-api/managed-agents-quickstart.md)）： - -1. **创建 Agent**：定义模型与系统提示词，得到 `agent_xxx`。Agent 通常创建一次并长期复用。 -2. **创建 Session**：绑定 Agent，得到 `sesn_xxx`。每轮对话新建一个 Session。 -3. **发送 Event**：向 Session 写入用户消息，触发 Agent 进入 `running`。 -4. **订阅 SSE**：通过 `GET /sessions/{session_id}/events/stream` 流式接收回复，直至 Session 回到 `idle`。 - -Bash 示例： - -```bash -export DASHSCOPE_API_KEY="sk-xxx" -export AGENTSTUDIO_URL="https://ws_xxxxxxxxxxxx.cn-beijing.maas.aliyuncs.com/api/v1/agentstudio" - -# 1. 创建 Agent -AGENT_ID=$(curl -s -X POST "$AGENTSTUDIO_URL/agents" \ - -H "Authorization: Bearer $DASHSCOPE_API_KEY" \ - -H "Content-Type: application/json" \ - -d '{"name":"quickstart-assistant","model":{"id":"qwen-plus"},"system":"你是一个有帮助的助手。"}' | jq -r '.id') - -# 2. 创建 Session -SESSION_ID=$(curl -s -X POST "$AGENTSTUDIO_URL/sessions" \ - -H "Authorization: Bearer $DASHSCOPE_API_KEY" \ - -H "Content-Type: application/json" \ - -d "{\"agent\":\"$AGENT_ID\"}" | jq -r '.id') - -# 3. 发送用户消息 -curl -X POST "$AGENTSTUDIO_URL/sessions/$SESSION_ID/events" \ - -H "Authorization: Bearer $DASHSCOPE_API_KEY" \ - -H "Content-Type: application/json" \ - -d '{"input":[{"role":"user","type":"message","content":[{"type":"text","text":"你好，请介绍一下自己"}]}]}' - -# 4. 订阅 SSE -curl -N "$AGENTSTUDIO_URL/sessions/$SESSION_ID/events/stream" \ - -H "Authorization: Bearer $DASHSCOPE_API_KEY" \ - -H "Accept: text/event-stream" -``` - -Python SDK 示例： - -```python -import os -from dashscope.agentstudio import Client, user_message - -client = Client( - api_key=os.environ["DASHSCOPE_API_KEY"], - workspace="ws_xxxxxxxxxxxx", - region="cn-beijing", -) -agent = client.agents.create(name="quickstart-assistant", model="qwen-plus", system_prompt="你是一个有帮助的助手。") -session = client.sessions.create(agent=agent.id) -client.sessions.events.send(session.id, [user_message("你好，请介绍一下自己")]) -with client.sessions.events.stream(session.id) as stream: - for event in stream: - print(event, flush=True) - if event.session_status in ("idle", "terminated"): - break -``` - -## Agent - -Agent 是一份可复用配置，每次更新自动递增 `version` 版本号，会话创建时锁定当时版本。Agent 操作详见 [Agent](../../raw/application-api-reference/managed-agents-api/agent-api.md)。 +### Agent | 操作 | 端点 | 说明 | -| --- | --- | --- | -| 创建 Agent | `POST /agents` | 创建智能体，初始 `version` 为 1 | -| 获取 Agent | `GET /agents/{agent_id}` | 默认返回最新版本；`?version=N` 查询历史版本 | -| 列出 Agent | `GET /agents` | 分页列出，默认不含已归档 | -| 更新 Agent | `POST /agents/{agent_id}` | 全量替换；请求体需带 `version` 作乐观锁，不一致返回 409，成功后递增 | -| 归档 Agent | `POST /agents/{agent_id}/archive` | 软归档；不可用于新建会话，已有会话不受影响 | -| 列出 Agent 版本 | `GET /agents/{agent_id}/versions` | 分页返回全部历史版本 | +|------|------|------| +| 创建 | `POST /agents` | 创建智能体，初始 `version` 为 1 | +| 获取 | `GET /agents/{agent_id}` | 支持 `?version=N` 查询历史版本 | +| 列出 | `GET /agents` | 分页列出，默认不含已归档 | +| 更新 | `POST /agents/{agent_id}` | 全量替换，需带 `version` 作乐观锁 | +| 归档 | `POST /agents/{agent_id}/archive` | 软归档，已有会话不受影响 | +| 列出版本 | `GET /agents/{agent_id}/versions` | 分页返回全部历史版本 | -> **注意**：API 总览文档将更新 Agent 列为 `PATCH /agents/{agent_id}`，而 Agent 专篇文档说明为 `POST /agents/{agent_id}` 并采用全量替换语义。以 Agent 专篇为准，请求体需带 `version` 作乐观锁。 +> **注意**：[API 总览与认证](../../raw/application-api-reference/managed-agents-api/managed-agents-api-overview.md) 中 Agent 更新端点标注为 `PATCH`，而 [Agent](../../raw/application-api-reference/managed-agents-api/agent-api.md) 详情页标注为 `POST`，以各资源详情页为准。Environment 和 Session 的更新端点也存在类似差异。 -## Environment - -运行环境定义工具调用的执行沙箱与预装依赖，独立于智能体管理，可被多个会话复用。详见 [Environment](../../raw/application-api-reference/managed-agents-api/environment-api.md)。 +### Session 与 Event | 操作 | 端点 | 说明 | -| --- | --- | --- | -| 创建 Environment | `POST /environments` | 指定沙箱类型与预装依赖 | -| 获取 Environment | `GET /environments/{environment_id}` | 获取环境详情 | -| 列出 Environment | `GET /environments` | 分页列出，默认不含已归档 | -| 更新 Environment | `POST /environments/{environment_id}` | 全量替换；缺省字段视为清空，运行中会话使用绑定快照不受影响 | -| 归档 Environment | `POST /environments/{environment_id}/archive` | 软归档；默认不再出现在列表中，已绑定会话仍可用 | -| 删除 Environment | `DELETE /environments/{environment_id}` | 硬删除；配置一并清除，不可恢复 | - -> **注意**：API 总览文档将更新 Environment 列为 `PATCH`，Environment 专篇文档说明为 `POST`，以专篇为准。 +|------|------|------| +| 创建 Session | `POST /sessions` | 绑定 Agent 与 Environment，初始状态 `idle` | +| 获取 Session | `GET /sessions/{session_id}` | 含智能体快照与当前状态 | +| 发送 Event | `POST /sessions/{session_id}/events` | 注入用户消息、工具审批、函数结果等 | +| 列出 Event | `GET /sessions/{session_id}/events` | 分页列出事件历史 | +| 订阅 SSE | `GET /sessions/{session_id}/events/stream` | 长连接流式接收实时事件 | +| 归档 Session | `POST /sessions/{session_id}/archive` | 进入 `terminated` 终态 | +| 删除 Session | `DELETE /sessions/{session_id}` | 硬删除，事件历史一并清除 | -## Session and Event +会话状态机详见 [Session and Event](../../raw/application-api-reference/managed-agents-api/session-api.md)。 -Session 是智能体的一次运行实例，绑定 Agent 与 Environment 快照，由平台驱动状态机。Event 是会话内的原子记录，由客户端写入或经订阅服务端推送。详见 [Session and Event](../../raw/application-api-reference/managed-agents-api/session-api.md)。 +### Skill -### 状态机 +技能上传后需通过安全扫描才能挂载。挂载时必须指定具体 `version`（不支持 `latest`），上传新版本不影响已挂载的智能体。详见 [Skill](../../raw/application-api-reference/managed-agents-api/skills-api.md)。 -`status` 字段变化通过 SSE 的 `session_status` 事件推送。 +| 操作 | 端点 | 说明 | +|------|------|------| +| 创建 | `POST /skills` | 用已上传的 zip 包 `file_id` 创建 | +| 上传新版本 | `POST /skills/{skill_id}/versions` | 新 zip 包，已挂载旧版本不受影响 | +| 下载 | `GET /skills/{skill_id}/versions/{version}/content` | 返回 OSS 预签名 URL（2 小时有效） | +| 删除 | `DELETE /skills/{skill_id}` | 删除技能及全部版本 | -| 状态 | 触发条件 | 下一状态 | 可执行操作 | -| --- | --- | --- | --- | -| `idle` | 会话创建完成或上一轮处理结束 | 收到消息 → `running` | 发送消息、归档、删除 | -| `running` | 收到用户消息，智能体开始处理 | 完成 → `idle`；不可恢复 → `terminated` | 中断、审批工具调用、回填函数结果 | -| `terminated` | 归档调用或不可恢复错误 | 终态 | 查询事件历史、删除会话 | +### File -### 会话与事件操作 +文件上传后经安全审核（`checking` → `available` / `rejected` / `type_rejected`），仅 `available` 状态可挂载到会话或作为消息引用。详见 [File](../../raw/application-api-reference/managed-agents-api/files-api.md)。 | 操作 | 端点 | 说明 | -| --- | --- | --- | -| 创建 Session | `POST /sessions` | 绑定 Agent 快照与运行环境，初始状态 `idle` | -| 获取 Session | `GET /sessions/{session_id}` | 含智能体快照与当前状态 | -| 列出 Session | `GET /sessions` | 分页列出工作空间下的会话 | -| 更新 Session | `POST /sessions/{session_id}` | 更新元数据（标题、metadata 等） | -| 归档 Session | `POST /sessions/{session_id}/archive` | 软归档；会话进入 `terminated` 终态 | -| 删除 Session | `DELETE /sessions/{session_id}` | 硬删除；事件历史一并清除，不可恢复 | -| 发送 Event | `POST /sessions/{session_id}/events` | 注入用户消息、中断、工具审批、回填函数结果等 | -| 列出 Event | `GET /sessions/{session_id}/events` | 分页列出事件历史 | -| 订阅 Event SSE | `GET /sessions/{session_id}/events/stream` | 长连接订阅实时事件，含 `session_status` 状态变更 | +|------|------|------| +| 上传 | `POST /files` | `multipart/form-data` 直传 | +| 查询 | `GET /files/{file_id}` | 元数据与审核状态 | +| 列出 | `GET /files` | 支持按会话 ID 过滤 | +| 删除 | `DELETE /files/{file_id}` | 已挂载的内部拷贝不受影响 | -> **注意**：API 总览文档将更新 Session 列为 `PATCH`，Session 专篇文档说明为 `POST`，以专篇为准。 +**文件配额**：单文件上限 20 MB，工作空间总容量上限 100 GB，保留期 30 天。 -## Skill +### Environment -技能以 zip 包封装工具组合与文档，上传后经安全扫描方可挂载到智能体，挂载时锁定具体版本号（不支持 `latest`）。详见 [Skill](../../raw/application-api-reference/managed-agents-api/skills-api.md)。 +| 操作 | 端点 | 说明 | +|------|------|------| +| 创建 | `POST /environments` | 指定沙箱类型与预装依赖 | +| 获取 | `GET /environments/{environment_id}` | 环境详情 | +| 更新 | `POST /environments/{environment_id}` | 全量替换，运行中会话不受影响 | +| 归档 | `POST /environments/{environment_id}/archive` | 软归档，已绑定会话仍可用 | +| 删除 | `DELETE /environments/{environment_id}` | 硬删除，不可恢复 | -### 扫描状态 +## 典型调用流程 -| 状态 | 含义 | -| --- | --- | -| `checking` | 扫描中，暂不可挂载 | -| `active` | 扫描通过，可挂载到智能体 | -| `rejected` | 命中安全风险，不可挂载；版本详情 `additional_properties.error_info` 按文件路径列出问题 | -| `deleted` | 技能已删除 | +一次完整的任务执行分五步，详见 [快速开始](../../raw/application-api-reference/managed-agents-api/managed-agents-quickstart.md)： -### 技能与版本操作 +1. **创建 Agent** — 定义模型与系统提示词，得到 `agent_xxx`（通常只创建一次，长期复用） +2. **创建 Environment** — 定义运行沙箱，得到 `env_xxx`（通常只创建一次，长期复用） +3. **创建 Session** — 绑定 Agent 与 Environment，得到 `sesn_xxx` +4. **发送 Event** — 向 Session 提交用户消息，触发 Agent 进入 `running` +5. **订阅 SSE** — 流式接收执行结果，直至 Session 回到 `idle` -| 操作 | 端点 | 说明 | -| --- | --- | --- | -| 创建 Skill | `POST /skills` | 用已上传的 zip 包 `file_id` 创建技能 | -| 查询 Skill | `GET /skills/{skill_id}` | 获取元数据与最新版本号 | -| 列出 Skill | `GET /skills` | 支持按 `source` 过滤自建/官方 | -| 删除 Skill | `DELETE /skills/{skill_id}` | 删除技能及全部版本；已挂载旧版本的智能体不受影响 | -| 上传 Skill 新版本 | `POST /skills/{skill_id}/versions` | 用新的 zip 包 `file_id` 上传；已挂载旧版本不受影响 | -| 列出 Skill 版本 | `GET /skills/{skill_id}/versions` | 按版本号倒序 | -| 查询 Skill 版本 | `GET /skills/{skill_id}/versions/{version}` | 查询指定版本的元数据与扫描状态 | -| 下载 Skill 包 | `GET /skills/{skill_id}/versions/{version}/content` | 返回 OSS 预签名 URL（2 小时有效） | +## SDK 支持 -## File +Managed Agents 模块通过 [DashScope SDK](../concepts/dashscope-sdk.md) 接入，版本要求： -文件是独立资源，上传一次后可被多个会话挂载至沙箱供工具读写，也可作为消息内容（图像、音频、附件）传给智能体。详见 [File](../../raw/application-api-reference/managed-agents-api/files-api.md)。 +| 语言 | 包名 | 最低版本 | +|------|------|----------| +| Python | `dashscope` | v1.26.2 | +| Java | `dashscope-sdk-java` | v2.22.24 | -### 配额与状态 +## 分页约定 -- 单文件直传上限 **20 MB**；单个工作空间总容量上限 **100 GB**；保留期 **30 天**，超期可能被自动清理。 -- 上传后进入安全审核，`status` 取值 `checking` / `available` / `rejected` / `type_rejected`，仅 `available` 可挂载或作为消息内容引用。 -- 挂载到会话沙箱时服务端做内部拷贝并生成新的 `file_id`，副本元数据带 `scope: {"type":"session","id":"sesn_..."}`，仅对应会话可见。 +列表端点统一支持分页参数：`limit`（默认 20，最大 100）和 `page`（首次不传，后续传上一次响应的 `next_page`）。响应不含 `next_page` 表示已是末页。 -### 文件操作 +## 关键设计要点 -| 操作 | 端点 | 说明 | -| --- | --- | --- | -| 上传 File | `POST /files` | `multipart/form-data` 直传，初始状态 `checking` | -| 查询 File | `GET /files/{file_id}` | 查询元数据与审核状态（不含内容） | -| 列出 File | `GET /files` | 支持按会话 ID 过滤 | -| 删除 File | `DELETE /files/{file_id}` | 硬删除；已挂载到会话的内部拷贝不受影响 | - -## 限制与注意事项 - -- **版本与快照**：Agent、Environment、Skill 更新均不影响已绑定它们的运行中会话；会话使用创建时的快照。 -- **乐观锁**：Agent 更新需在请求体携带当前 `version`，不一致返回 409。 -- **软删除 vs 硬删除**：归档为软操作（`archived_at` 被填入，已绑定会话继续可用）；`DELETE` 为硬操作，配置与事件历史一并清除，不可恢复。 -- **Skill 挂载**：必须指定具体 `version`，不支持 `latest`；上传新版本不影响已挂载的智能体。 -- **File 配额**：单文件 20 MB、工作空间总量 100 GB、保留期 30 天，超期可能被自动清理。 -- **地域**：当前仅支持 `cn-beijing`。 -- **SDK 版本**：Python 需 v1.26.2+，Java 需 v2.22.24+。 +- **版本锁定**：Agent 更新采用乐观锁（请求体带 `version`，不一致返回 409）；会话创建时锁定 Agent 版本，Skill 挂载锁定具体版本号，确保运行中会话不受配置变更影响。 +- **软归档 vs 硬删除**：Agent、Session、Environment 均支持软归档（`archived_at` 标记），归档后不影响已有会话；File 和 Environment 支持硬删除（不可恢复）。 +- **安全扫描**：Skill 和 File 上传后均需经过安全扫描/审核，仅通过后方可使用。 +- **沙箱隔离**：文件挂载到会话时服务端做内部拷贝，生成独立 `file_id`，仅对应会话可见。 ## 来源文档 @@ -225,7 +133,3 @@ Session 是智能体的一次运行实例，绑定 Agent 与 Environment 快照 - [快速开始](../../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 00b0067..f2c97e0 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/model-production.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/model-production.md @@ -1,52 +1,37 @@ # model production -百炼平台提供模型生产（model production）相关的 API，覆盖从[模型调优](../concepts/fine-tuning.md)、模型压缩到[模型部署](../concepts/model-deployment.md)的完整链路。开发者可以通过这些接口对基础模型进行微调定制、压缩优化以及部署上线，形成端到端的模型生产能力。 +百炼平台提供模型生产相关的 API，覆盖从模型微调训练到部署上线的完整流程。开发者可以通过[模型调优](../../raw/model-api-reference/model-production/fine-tuning-jobs-api.md)接口定制专属模型，再通过[模型部署](../../raw/model-api-reference/model-production/deployments-api.md)接口将其发布为在线推理服务。 -## 能力概览 +## 模型调优 -模型生产链路由三个相互衔接的环节组成： +模型调优（Fine-tuning）允许开发者通过微调训练定制专属模型，以适配特定业务场景。调优流程通常包括： -1. **[模型调优](../concepts/fine-tuning.md)（Fine-tuning）**：通过微调训练在基础模型上注入领域知识或特定任务能力，定制出专属模型。 -2. **模型压缩（Compression）**：通过量化等手段压缩模型体积，降低推理时的资源占用与调用成本。 -3. **[模型部署](../concepts/model-deployment.md)（Deployment）**：将微调或导入的[模型部署](../concepts/model-deployment.md)为在线推理服务，供应用调用。 +- **创建调优任务**：指定基础模型、训练数据集和超参数，提交微调训练任务 +- **查询任务状态**：轮询或监听训练任务进度，获取训练指标 +- **管理调优产物**：训练完成后获取调优模型，用于后续部署或评估 -三者构成典型的「调优 → 压缩 → 部署」流水线，详见 [模型调优](../../raw/model-api-reference/model-production/fine-tuning-jobs-api.md) 与 [模型部署](../../raw/model-api-reference/model-production/deployments-api.md)。 +详细的接口定义和参数说明请参考[模型调优](../../raw/model-api-reference/model-production/fine-tuning-jobs-api.md)文档。 -## 支持的能力 +## 模型部署 -- **微调训练**：基于平台支持的基础模型发起调优任务，产出定制模型产物。 -- **模型压缩**：对已有模型执行量化等压缩操作，在精度可接受范围内换取更低的推理成本，参见 [模型压缩](../../raw/model-api-reference/model-production/model-compression-api.md)。 -- **在线部署**：将微调或导入的模型发布为可调用的推理服务。 +模型部署将微调或导入的模型发布为在线推理服务，使其可通过 API 调用进行推理。部署流程通常包括： -## 使用方式 +- **创建部署**：选择调优完成的模型或外部导入的模型，配置推理资源和服务参数 +- **管理部署实例**：查看部署状态、调整资源配置、启停服务 +- **调用推理服务**：部署成功后，通过标准 API 端点发送推理请求 -典型的模型生产流程如下： +详细的接口定义和参数说明请参考[模型部署](../../raw/model-api-reference/model-production/deployments-api.md)文档。 -1. 选定基础模型，调用[模型调优](../concepts/fine-tuning.md) API 创建 fine-tuning 任务，等待训练完成获得定制模型。 -2. 如需降低成本，对定制模型调用模型压缩 API 执行量化压缩。 -3. 调用模型部署 API，将最终模型部署为在线推理服务，获取可调用的接入点。 +## 典型工作流 -## 限制和注意事项 - -- 调优、压缩、部署三类任务的耗时与资源消耗差异较大，建议关注各接口的异步任务状态轮询机制。 -- 压缩会带来精度损失，部署前应结合业务验收结果决定是否启用压缩环节。 -- 部署后的推理服务需关注并发与配额限制，具体上限以部署接口返回为准。 - -> **注意**：当前各原始文档仅给出能力的一句话概述，具体支持的模型清单、参数字段与接口细节请以平台控制台和对应 API 参考文档的实时信息为准。 +1. 准备训练数据集 +2. 通过调优 API 提交微调训务，等待训练完成 +3. 通过部署 API 将调优产物部署为在线服务 +4. 调用部署后的模型端点进行推理 ## 来源文档 - [模型调优](../../raw/model-api-reference/model-production/fine-tuning-jobs-api.md) -- [模型压缩](../../raw/model-api-reference/model-production/model-compression-api.md) - [模型部署](../../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 7c8cd50..8277528 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 @@ -1,143 +1,111 @@ # [more](more.md) about models -本页汇总阿里云百炼模型调用过程中常用的配套 API 与 SDK 能力，涵盖临时 [API Key](../concepts/api-key.md)、异步任务管理与通知、子[业务空间](../concepts/workspace.md)调用、本地文件临时上传、SDK 连接复用等场景。这些能力围绕"安全、高效、可管控"地调用模型服务展开，是标准模型调用之外的关键补充。 +阿里云百炼在模型调用的核心流程之外，提供了一系列辅助能力，涵盖安全认证、异步任务管理、文件上传、子[业务空间](../concepts/workspace.md)隔离以及高并发场景下的连接优化。本文汇总这些进阶用法的关键要点，帮助开发者在生产环境中安全、高效地使用模型服务。 -## 临时 [API Key](../concepts/api-key.md) +## 临时 API Key -在浏览器、移动 App 等不可信环境中直接持有永久 [API Key](../concepts/api-key.md) 存在泄露风险。可通过后端服务调用令牌接口生成临时 [API Key](../concepts/api-key.md)，将其下发到客户端使用，详见 [生成临时API Key](../../raw/model-api-reference/more-about-models/generate-temporary-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](../concepts/api-key.md) 的全部权限（含模型、[知识库](../concepts/knowledge-base.md)的访问限制），无法进一步收窄权限。 -- 默认有效期 60 秒，可通过 `expire_in_seconds` 参数设置，范围为 [1, 1800] 秒；到期自动失效，不能提前删除。 - -请求示例： +**请求方式**： ``` -curl -X POST "https://dashscope.aliyuncs.com/api/v1/tokens?expire_in_seconds=1800" \ --H "Authorization: Bearer $DASHSCOPE_API_KEY" +POST https://dashscope.aliyuncs.com/api/v1/tokens?expire_in_seconds= ``` -正常响应返回 `token`（生成的临时 Key，前缀 `st-`）与 `expires_at`（UNIX 时间戳，秒）。失败时返回 `code`/`message`/`request_id`，常见错误如 `InvalidApiKey`。 +- `expire_in_seconds`：有效期，范围 [1, 1800] 秒，默认 60 秒。 +- 返回的 `token` 字段即为临时 API Key，`expires_at` 为 UNIX 过期时间戳。 +- 临时 API Key 继承生成它的永久 API Key 的全部权限，到期后自动失效，无法手动删除。 -> **注意**：各地域（北京、新加坡、弗吉尼亚）的 [API Key](../concepts/api-key.md) 不互通，临时 Key 与生成它的永久 Key 必须属于同一地域。 +> **注意**：各地域的 API Key 不同，新加坡地域需将 Endpoint 中的 WorkspaceId 替换为实际值。 ## 异步任务管理 -图像生成、视频生成等耗时模型采用异步机制：先创建任务拿到 `task_id`，再查询结果。阿里云百炼提供一组通用的异步任务接口，参见 [异步任务管理 API](../../raw/model-api-reference/more-about-models/manage-asynchronous-tasks.md)。三个接口的限流均为 20 QPS（按主账号 + 子账号维度计算）。 - -| 接口 | 方法与路径 | 用途 | -| --- | --- | --- | -| 查询单个任务 | `GET /api/v1/tasks/{task_id}` | 根据 task_id 查询状态与结果 | -| 批量查询 | `GET /api/v1/tasks/` | 按 time/status/model 等条件分页查询多个任务 | -| 取消任务 | `POST /api/v1/tasks/{task_id}/cancel` | 取消排队中的任务 | +图像生成、视频生成等耗时较长的模型采用[异步调用](../concepts/async-invocation.md)机制。百炼提供了三个通用的[异步任务管理 API](../../raw/model-api-reference/more-about-models/manage-asynchronous-tasks.md)： -任务状态包括 `PENDING`（排队）、`RUNNING`（处理中）、`SUCCEEDED`（成功）、`FAILED`（失败）、`CANCELED`（已取消）、`UNKNOWN`（不存在或未知）。批量查询的时间窗口跨度不能超过 24 小时；不传时间则默认查询最近 24 小时。 +### 查询单个任务 -关键约束： - -- 接口可查询/取消当前 [API Key](../concepts/api-key.md) 所属主账号下的所有任务（含该主账号下任意 [API Key](../concepts/api-key.md) 提交的任务），但无法跨主账号操作。 -- 异步任务完成后通常保留 24 小时（以对应模型 API 文档为准），超时自动清理，届时无法再查询。 -- 取消接口**仅支持 `PENDING` 状态**的任务，其他状态会返回 `UnsupportedOperation`（HTTP 400）。 -- 含多个子任务的任务，只要有一个子任务成功，整体状态即为 `SUCCEEDED`，失败子任务的错误信息在 `output.results` 中单独展示；`task_metrics` 给出 `TOTAL`/`SUCCEEDED`/`FAILED` 统计。 +``` +GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id} +``` -## 异步任务完成通知（避免轮询） +返回 `output.task_status` 标识任务状态：`PENDING` / `RUNNING` / `SUCCEEDED` / `FAILED` / `UNKNOWN`。已完成任务通常保留 24 小时后自动清理。 -频繁轮询结果接口会浪费资源并可能触发 20 QPS 限流。阿里云百炼已接入事件总线 EventBridge，任务完成（无论成功或失败）后主动上报"任务完成事件"，由事件总线推送到您配置的接收端，收到通知后只需查询一次即可拿到结果。详见 [通过HTTP回调URL或MQ接收异步任务完成通知](../../raw/model-api-reference/more-about-models/async-task-api.md)。 +### 批量查询任务状态 -事件关键信息： +``` +GET https://dashscope.aliyuncs.com/api/v1/tasks/?start_time=xxx&end_time=xxx&status=xxx +``` -- 事件源：`acs.dashscope` -- 事件类型：`dashscope:System:AsyncTaskFinish` -- 事件总线默认为 `default`（北京地域的云服务专用总线） -- 事件 `data` 中包含 `task_id`、`task_status`、`start_time`、`end_time`、`region`、`request_id`、`api_key_id`、`user_api_unique_key` 等字段 +支持按时间范围、模型名称、任务状态等条件组合过滤，单次查询时间跨度不超过 24 小时。 -两种常见接收方案： +### 取消任务 -- **HTTP 回调 URL**：提供一个支持公网或 VPC 访问、接收 POST 请求的 HTTP 接口，事件总线直接推送。接入简单，适合大多数通用场景。 -- **RocketMQ 消息队列**：事件总线将事件投递到 RocketMQ，业务方消费消息。支持消息无丢失与失败重试，适合对可靠性要求较高的场景。 +``` +POST https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}/cancel +``` -在事件总线控制台需创建事件规则：事件模式指定 `source=acs.dashscope`、`type=dashscope:System:AsyncTaskFinish`，并可通过 `data.user_api_unique_key` 等字段做过滤（例如只转发某个模型的事件）。事件目标配置为 HTTP 或 RocketMQ。 +仅支持取消 `PENDING` 状态的任务，已开始处理的任务无法取消。 -> **注意**：通知方案不限流、实时性高、不占用业务系统资源，但接入比轮询复杂；轮询方案接入简单但受 20 QPS 限制且实时性低。高并发、大规模或对实时性要求高的任务建议用通知方案。 +以上三个接口的流量限制均为 20 QPS（主账号维度）。 -## 子[业务空间](../concepts/workspace.md)的模型调用 +## 异步任务完成通知 -默认[业务空间](../concepts/workspace.md)的 API Key 可调用所有模型，权限过大且费用难以分账。可将 RAM 用户归入子[业务空间](../concepts/workspace.md)，仅授权必要模型，并要求使用该子空间的 API Key 调用，参见 [子业务空间的模型调用](../../raw/model-api-reference/more-about-models/model-calling-in-sub-workspace.md)。 +频繁轮询任务结果接口会浪费资源且可能触发限流。百炼已接入阿里云事件总线 EventBridge，支持在任务完成后主动推送通知。详见[通过HTTP回调URL或MQ接收异步任务完成通知](../../raw/model-api-reference/more-about-models/async-task-api.md)。 -适用场景： +两种接入方案： -- **模型调用权限管控**：限制某类用户只能调用被授权的模型。 -- **费用分账**：为不同业务/场景创建独立子空间，各自独立出账。 +| 方案 | 适用场景 | 特点 | +|------|----------|------| +| HTTP 回调 URL | 通用场景 | 需要公网或 VPC 可达的 HTTP 接口，接入较简单 | +| RocketMQ | 消息可靠性要求高的场景 | 保证无丢失、支持失败重试，需额外开通 RocketMQ 实例 | -调用方式与默认空间基本一致，区别在于**必须使用该子[业务空间](../concepts/workspace.md)的 API Key**。支持 OpenAI 兼容与 DashScope 两种协议： +事件源为 `acs.dashscope`，事件类型为 `dashscope:System:AsyncTaskFinish`。事件体中 `data.task_status` 和 `data.task_id` 是关键字段，收到通知后只需调用一次查询接口即可获取结果。 -- **OpenAI 兼容**：北京地域 `base_url` 为 `https://dashscope.aliyuncs.com/compatible-mode/v1`；新加坡地域为 `https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1`，需把 `WorkspaceId` 替换为真实[业务空间](../concepts/workspace.md) ID。 -- **DashScope**：北京地域千问大语言模型 HTTP 地址为 `POST https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation`；新加坡地域需在 SDK 中设置 `base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'`。 +## 子[业务空间](../concepts/workspace.md)的模型调用 -准备工作要点： +默认[业务空间](../concepts/workspace.md)的 API Key 拥有所有模型的调用权限。如需按业务线隔离权限或分账，可使用[子业务空间的模型调用](../../raw/model-api-reference/more-about-models/model-calling-in-sub-workspace.md)。 -1. 在子[业务空间](../concepts/workspace.md)创建 API Key 并配置到环境变量 `DASHSCOPE_API_KEY`。 -2. 调用标准模型（如 `qwen-plus`）前，需为该子空间设置模型调用权限。 -3. 在阿里云百炼调优并部署的模型**无需模型调用授权**，但只能由其所在[业务空间](../concepts/workspace.md)的 API Key 调用，且**仅支持 DashScope 协议**，不支持 OpenAI 兼容方式。 +**使用要点**： -> **注意**：北京与新加坡地域的 API Key 不同，切换地域必须更换对应 Key；新加坡地域的 OpenAI 兼容与 DashScope 地址都需要把 `WorkspaceId` 替换为真实[业务空间](../concepts/workspace.md) ID。 +- 必须使用子业务空间自身的 API Key 进行调用。 +- 调用标准模型（如 `qwen-plus`）前，需为该空间设置模型调用权限。 +- 调用在百炼上调优并部署的模型无需额外授权，但仅能由其所在空间的 API Key 调用。 +- 支持 OpenAI 兼容方式和 DashScope 方式调用，但调优后模型仅支持 DashScope 方式。 ## 上传本地文件获取临时 URL -调用[多模态](../concepts/multimodal.md)、图像、视频、音频模型时通常需要传入文件 URL。阿里云百炼提供**免费**临时存储空间，可上传本地文件得到以 `oss://` 为前缀的临时 URL，参见 [上传本地文件获取临时URL](../../raw/model-api-reference/more-about-models/get-temporary-file-url.md)。 - -使用流程： - -1. 获取上传凭证：`GET https://dashscope.aliyuncs.com/api/v1/uploads?action=getPolicy&model={model_name}`，返回 `upload_host`、`upload_dir`、`OSSAccessKeyId`、`Signature`、`policy` 等 OSS 上传凭证。 -2. 用凭证将文件 POST 到 `upload_host`，得到 `oss://{upload_dir}/{file_name}` 形式的临时 URL。 -3. 调用模型时使用该 URL，并**必须在 HTTP 请求头显式添加** `X-DashScope-OssResourceResolve: enable`，否则接口报错。 - -也可用 DashScope 命令行工具一步完成：`dashscope oss.upload --model qwen-vl-plus --file cat.png`（推荐用环境变量传 Key，避免明文暴露）。 +[多模态](../concepts/multimodal.md)、图像、视频、音频模型调用时通常需要传入文件 URL。百炼提供了免费的临时存储空间，支持上传本地文件并获取 `oss://` 前缀的临时 URL，详见[上传本地文件获取临时URL](../../raw/model-api-reference/more-about-models/get-temporary-file-url.md)。 -关键限制： +**关键限制**： -- **文件与模型绑定**：上传时必须指定模型名，且须与后续调用的模型一致，不同模型不能共享文件；不同模型对文件大小限制不同。 -- **文件与主账号绑定**：上传与调用所用的 API Key 必须属于同一阿里云主账号，文件仅限该主账号及对应模型使用。 -- **有效期 48 小时**：到期自动清理，文件不可查询、修改或下载，只能通过 URL 参数在模型调用时使用。 -- **上传凭证接口限流 100 QPS**（按"主账号+模型"维度），且不支持扩容。 +- 文件有效期 48 小时，过期自动清理。 +- 上传时必须指定模型名称，且与后续调用的模型一致，不同模型无法共享文件。 +- 上传与调用的 API Key 必须属于同一阿里云主账号。 +- 单文件不超过 1GB，上传凭证接口限流 100 QPS。 +- 使用 `oss://` 形式的 URL 调用模型时，HTTP 请求头中必须添加 `X-DashScope-OssResourceResolve: enable`。 -> **注意**：临时 URL 有效期仅 48 小时、上传限流 100 QPS 且不可扩容，**请勿用于生产环境**。生产环境建议使用阿里云 OSS 等稳定存储，确保文件长期可用并规避限流。 +> **注意**：临时 URL 不适用于生产环境。生产环境建议使用阿里云 OSS 等稳定存储方案。 -## SDK 连接复用配置 +上传方式包括 Python/Java 代码上传和 DashScope 命令行工具（`dashscope oss.upload`）上传。 -高并发场景下频繁建连会导致请求超时、资源消耗大。[DashScope SDK](../concepts/dashscope-sdk.md) 支持连接复用以降低开销，参见 [DashScope SDK连接复用配置](../../raw/model-api-reference/more-about-models/connection-multiplexing-configuration.md)。 +## [DashScope SDK](../concepts/dashscope-sdk.md) 连接复用配置 -### Java SDK +高并发场景下，频繁创建连接会导致超时和资源消耗过大。[DashScope SDK](../concepts/dashscope-sdk.md) 支持连接复用来优化性能，详见[DashScope SDK连接复用配置](../../raw/model-api-reference/more-about-models/connection-multiplexing-configuration.md)。 -内置连接池机制，默认启用。关键参数（通过 `ConnectionConfigurations` 配置到 `Constants.connectionConfigurations`）： +**Java SDK** 内置连接池，默认启用，核心配置参数： -| 参数 | 含义 | 默认值 | -| --- | --- | --- | -| `connectTimeout` | 建立连接超时 | 120 秒 | -| `readTimeout` | 读取数据超时 | 300 秒 | -| `writeTimeout` | 写入数据超时 | 60 秒 | -| `connectionIdleTimeout` | 空闲连接超时 | 300 秒 | -| `connectionPoolSize` | 连接池最大连接数 | 32 | -| `maximumAsyncRequests` | 全局最大并发请求数 | 32 | -| `maximumAsyncRequestsPerHost` | 单主机最大并发请求数 | 32 | +| 参数 | 默认值 | 说明 | +|------|--------|------| +| `connectionPoolSize` | 32 | 连接池最大连接数 | +| `maximumAsyncRequests` | 32 | 最大并发请求数（需 <= 连接数） | +| `connectTimeout` | 120s | 建立连接超时 | +| `readTimeout` | 300s | 读取数据超时 | +| `connectionIdleTimeout` | 300s | 空闲连接超时 | -建议：`maximumAsyncRequests` 需小于等于 `connectionPoolSize`，`maximumAsyncRequestsPerHost` 需小于等于 `maximumAsyncRequests`，否则可能出现请求阻塞。低延迟场景可缩短 `connectTimeout`；高并发场景适当增大 `connectionPoolSize` 与空闲超时。 +**Python SDK** 通过传入自定义 Session 实现连接复用： -### Python SDK - -通过传入自定义 Session 实现连接复用： - -- **异步（协程）**：用 `aiohttp.ClientSession` 配合 `aiohttp.TCPConnector`，参数 `limit`（总连接数，默认 100）、`limit_per_host`（单主机连接数，默认 0 不限制）、`ssl`（SSL 上下文）。 -- **同步**：用 `requests.Session`，同一 Session 内多次请求复用底层 TCP 连接。 - -推荐用 `with` 语句或 `try/finally` 管理 Session 生命周期，确保连接正确释放；异步架构（asyncio、FastAPI 等）用[异步调用](../concepts/async-invocation.md)方式，传统同步架构用同步方式即可。 - -## 常见限制与注意事项汇总 - -- **限流**：异步任务接口 20 QPS；文件上传凭证接口 100 QPS（不可扩容）；临时 API Key 不可手动删除，靠 TTL 自动失效。 -- **地域隔离**：北京、新加坡、弗吉尼亚的 API Key 不互通；新加坡地域调用地址需带 `WorkspaceId`。 -- **权限继承**：临时 API Key 继承源 Key 全部权限；子业务空间 API Key 的可调模型由该空间授权范围决定；调优部署的模型无需授权但只能由所属空间 Key 调用。 -- **数据保留**：异步任务结果通常保留 24 小时；临时文件 URL 保留 48 小时；超期均自动清理且不可恢复。 -- **生产可用性**：临时文件存储仅供开发/测试，生产环境请用 OSS；通知方案（EventBridge + HTTP/MQ）比轮询更适合高并发场景。 +- 异步场景：使用 `aiohttp.ClientSession` 配合 `aiohttp.TCPConnector`，可配置 `limit`（总连接数，默认 100）和 `limit_per_host`（单主机连接数）。 +- 同步场景：使用 `requests.Session`，同一 Session 内多次请求自动复用 TCP 连接。 ## 来源文档 @@ -149,12 +117,3 @@ curl -X POST "https://dashscope.aliyuncs.com/api/v1/tokens?expire_in_seconds=180 - [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 006119d..bcbd64e 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/more-models.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/more-models.md @@ -13,7 +13,7 @@ | `qwen3.5-ocr` | 图像文字提取（OCR）与结构化字段抽取 | OpenAI 兼容 / DashScope | 北京 / 新加坡 / 美国（弗吉尼亚） | | `gui-plus-2026-02-26` | 界面交互专用模型，通过 `computer_use` 工具操控桌面 GUI | OpenAI 兼容 | 华北2（北京） | -> **注意**：`qwen-deep-research` 当前**仅支持通过 Python DashScope SDK 调用，暂不支持 Java SDK 与 [OpenAI 兼容接口](../concepts/openai-compatible-interface.md)**，且仅支持华北2（北京）地域。如需使用，必须使用该地域的 [API Key](../concepts/api-key.md)。详见 [Qwen-Deep-Research API 参考](../../raw/model-api-reference/more-models/qwen-deep-research-api.md)。 +> **注意**：`qwen-deep-research` 当前**仅支持通过 Python [DashScope SDK](../concepts/dashscope-sdk.md) 调用，暂不支持 Java SDK 与 [OpenAI 兼容接口](../concepts/openai-compatible-interface.md)**，且仅支持华北2（北京）地域。如需使用，必须使用该地域的 [API Key](../concepts/api-key.md)。详见 [Qwen-Deep-Research API 参考](../../raw/model-api-reference/more-models/qwen-deep-research-api.md)。 ## 关键参数 @@ -107,7 +107,7 @@ completion = client.chat.completions.create( - **限流**：各模型有独立的限流条件，`farui-plus` 等模型限流详见[限流](https://help.aliyun.com/zh/model-studio/rate-limit)。 - **上下文与[计费](../concepts/billing.md)**：`farui-plus` 上下文 12k、最大输入 12k、最大输出 2k，输入成本 20 元/百万 [Token](../concepts/token.md)；`tongyi-intent-detect-v3` 上下文 8,192、最大输入 8,192、最大输出 1,024，输入 0.4 元、输出 1 元/百万 [Token](../concepts/token.md)，开通后 90 天内赠送 100 万 [Token](../concepts/token.md) 免费额度。 -- **协议限制**：`qwen-deep-research` 仅支持 Python DashScope SDK；`gui-plus-2026-02-26` 仅在华北2（北京）地域提供。 +- **协议限制**：`qwen-deep-research` 仅支持 Python [DashScope SDK](../concepts/dashscope-sdk.md)；`gui-plus-2026-02-26` 仅在华北2（北京）地域提供。 - **SDK 线程安全**：DashScope Java SDK 的 `Generation` 等对象非线程安全，需自行管理同步机制或及时关闭进程。 - **图像像素阈值**：Qwen-OCR 的 `min_pixels`/`max_pixels` 影响识别精度与耗时，过小会放大、过大会缩小，建议按示例值设置。 - **翻译记忆与术语**：Qwen-MT 的 `terms` 强制覆盖译法，`tm_list` 仅作参考；两者可叠加使用以提升专业领域一致性。 @@ -131,3 +131,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 79f8b09..9ec9824 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/more.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/more.md @@ -124,3 +124,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 ad9ca45..6b5a329 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 @@ -226,3 +226,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 08c4c8a..a217ff3 100644 --- a/skills/bailian-docs-llm-wiki/wiki/api/preparations.md +++ b/skills/bailian-docs-llm-wiki/wiki/api/preparations.md @@ -16,7 +16,7 @@ ### 权限与时效 - API Key 的调用权限由其归属[业务空间](../concepts/workspace.md)决定，同一空间内的 API Key 权限相同，无需为不同模型类型分别创建。 -- 默认[业务空间](../concepts/workspace.md)的 API Key 可调用所有标准模型；子业务空间的 API Key 仅可调用已授权的模型。 +- 默认[业务空间](../concepts/workspace.md)的 API Key 可调用所有标准模型；子[业务空间](../concepts/workspace.md)的 API Key 仅可调用已授权的模型。 - API Key 没有失效日期，手动删除后即失效。如需临时授权，可生成有效期 60 秒的临时 API Key。 ### 配置环境变量 @@ -32,7 +32,7 @@ 百炼支持两类 SDK 接入方式，具体安装方法参见[安装SDK](../../raw/model-api-reference/preparations/install-sdk.md)。 -### DashScope SDK（官方 SDK） +### [DashScope SDK](../concepts/dashscope-sdk.md)（官方 SDK） | 语言 | 安装方式 | 版本要求 | |------|---------|---------| @@ -92,7 +92,7 @@ ## 快速上手清单 1. 在百炼控制台创建 API Key 并保存到环境变量 `DASHSCOPE_API_KEY` -2. 根据使用语言安装 DashScope SDK 或 OpenAI 兼容 SDK +2. 根据使用语言安装 [DashScope SDK](../concepts/dashscope-sdk.md) 或 OpenAI 兼容 SDK 3. 选择目标模型，参考对应 API 文档发起首次调用 4. 遇到调用报错时，根据错误码对照排查 @@ -108,3 +108,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 c3f298f..bd4ec51 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 @@ -41,3 +41,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 c81b6d7..bdf6cba 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 @@ -209,3 +209,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 4e307d3..df5cd01 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 @@ -96,3 +96,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 dad71da..683ee2d 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 @@ -1,10 +1,10 @@ # video generation api -百炼平台提供多套视频生成异步 API，覆盖文生视频、图生视频、参考生视频、视频编辑、关键帧生视频、数字人、动作生成、风格转换等场景。底层模型包括万相（Wan）系列、HappyHorse、Pixverse、Vidu、Kling、AnimateAnyone、LivePortrait、EMO、Emoji 等。所有接口均采用「创建任务 → 轮询获取」的异步调用模式，单次请求耗时通常在 1–5 分钟。 +百炼平台提供多套视频生成异步 API，覆盖文生视频、图生视频、参考生视频、视频编辑、关键帧生视频、数字人、动作生成、风格转换等场景。底层模型包括万相（Wan）系列、HappyHorse、Pixverse、Vidu、Kling、AnimateAnyone、LivePortrait、EMO、Emoji 等。所有接口均采用「创建任务 → 轮询获取」的[异步调用](../concepts/async-invocation.md)模式，单次请求耗时通常在 1–5 分钟。 ## 调用模式 -视频生成任务耗时较长，API 统一采用异步调用，流程分两步： +视频生成任务耗时较长，API 统一采用[异步调用](../concepts/async-invocation.md)，流程分两步： 1. **创建任务**：`POST /api/v1/services/aigc/video-generation/video-synthesis`（不同模型 endpoint 路径略有差异），携带 `X-DashScope-Async: enable` 头，返回 `task_id`。 2. **轮询获取**：`GET /api/v1/tasks/{task_id}`，根据 `output.task_status`（`PENDING` / `RUNNING` / `SUCCEEDED` / `FAILED` / `CANCELED`）判断结果，成功后从 `output.video_url` 取视频地址。 @@ -12,10 +12,10 @@ ### 地域与域名 - 必须保证模型、Endpoint URL、API Key 属于**同一地域**，跨地域调用会失败。 -- 华北2（北京）、新加坡地域推荐使用业务空间专属域名以获得更好性能与稳定性： +- 华北2（北京）、新加坡地域推荐使用[业务空间](../concepts/workspace.md)专属域名以获得更好性能与稳定性： - 北京：`https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com` - 新加坡：`https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com` -- `{WorkspaceId}` 在百炼控制台「业务空间详情」页查看，旧域名 `dashscope.aliyuncs.com` / `dashscope-intl.aliyuncs.com` 仍可用。 +- `{WorkspaceId}` 在百炼控制台「[业务空间](../concepts/workspace.md)详情」页查看，旧域名 `dashscope.aliyuncs.com` / `dashscope-intl.aliyuncs.com` 仍可用。 ### 鉴权 @@ -178,3 +178,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-vs-model-evaluation.md b/skills/bailian-docs-llm-wiki/wiki/comparisons/app-vs-model-evaluation.md new file mode 100644 index 0000000..02011a7 --- /dev/null +++ b/skills/bailian-docs-llm-wiki/wiki/comparisons/app-vs-model-evaluation.md @@ -0,0 +1,64 @@ +# 应用评测与模型评测对比 + +百炼平台提供两套独立的评测体系：**应用评测**面向智能体应用和工作流应用的端到端输出质量评估，**模型评测**面向文本生成类模型的基础能力评估。两者在评测对象、数据集格式、评分机制和使用场景上存在本质差异，开发者需根据自身需求选择合适的评测路径。 + +## 关键维度对比 + +| 对比维度 | 应用评测 | 模型评测 | +|---------|---------|---------| +| 评测对象 | 智能体应用、工作流应用 | 文本生成类模型（含调优模型） | +| 核心目标 | 评估应用端到端输出质量 | 评估模型推理能力，辅助选型或验证调优效果 | +| 评测方式 | 自动评测（大模型生成评测集并评分）、手动评测（人工逐条标注） | 自定义评测（自有数据集 + 自定义维度）、基线评测（公开标准数据集） | +| 评测集格式 | 旧版：`.xls`/`.xlsx`（对话分析）、`.jsonl`（知识问答）；新版：按应用出入参自动生成模板 | 统一格式：Prompt（用户问题）+ Completion（参考答案）两列 | +| 评测集创建 | 支持自动生成（知识问答类型，限 qwen-max/qwen-plus）和手动上传 | 在数据管理模块上传评测集（EvaluationSet）类型数据 | +| 评分机制 | 评估器体系：LLM 评估器（语义理解）、Code 评估器（规则判断）、预置模板 | 评测维度体系：大模型评估（数值型/分类型）、规则评估（文本相似度/字符串匹配）、人工评估 | +| 评分配置单元 | 评估器（最多 10 个/任务，建议 3-5 个组合） | 评测维度（按需配置，类型创建后不可修改） | +| 裁判模型 | 由评估器内部选择模型 | 推荐千问-Max | +| 规则评分算法 | Code 评估器自定义 Python 函数 | 内置 7 种算法（ROUGE-1/2/L、BLEU、Cosine、Fuzzy Match、Accuracy）+ 字符串匹配 | +| 人工标注 | 标签系统（分类/布尔值/数字/文本四种类型），支持快速标注模式 | 人工评估维度（Pass/Fail 分类型） | +| 排行榜 | 不支持 | 支持（相同维度下横向对比多模型，得分 0-100） | +| 横向对比 | 自动评测最多同时评测 8 个应用 | 通过排行榜对比多个模型 | +| 结果下载 | 支持 | 支持（基线评测除外） | +| 基线评测 | 不支持 | 支持（C-Eval、MMLU、ARC、GSM8K、BBH、HellaSwag），仅北京地域 | +| 版本管理 | 新版/旧版两套界面并存 | 统一界面 | +| 操作方式 | 控制台 | 仅控制台（无公开 API/SDK） | +| 前置要求 | 自动评测需已发布应用并配置知识库，需开通应用观测 | 无特殊前置，上传数据集即可 | + +## 评分体系差异 + +应用评测和模型评测虽然都支持"大模型评分"和"规则评分"，但实现方式不同： + +- **应用评测**的评估器是独立可复用的组件，同一评估器可在不同评测任务间共享。LLM 评估器和 Code 评估器各有优势，建议组合使用以覆盖语义理解和精确规则两个层面。 +- **模型评测**的评测维度在创建时即绑定评分方式，类型不可修改。规则评估提供开箱即用的标准算法（ROUGE、BLEU 等），无需编写代码，适合翻译、摘要等有确定性标准的场景。 + +## 计费差异 + +两套评测体系的费用结构相似，均包含推理费用和评分费用，但细节有所不同： + +- **应用评测**：调用大模型的 Token 费用正常计费，Code 评估器无额外费用。 +- **模型评测**：被评测模型推理费用按 Token 计费（使用推理结果集时不产生），大模型评估维度额外产生裁判模型费用，规则评估和人工评估无裁判模型费用。已部署的调优模型评测不额外计费。 + +两者共同的成本优化策略：先小规模验证（50-100 条），确认配置无误后再扩大规模。模型评测还支持保存推理结果集复用，避免重复推理。 + +## 适用场景建议 + +**选择应用评测**： +- 已构建完整的智能体或工作流应用，需要评估端到端输出质量 +- 需要领域专家介入进行人工标注和多维度质量评估 +- 需要结合应用观测进行线上真实数据的持续质量监控 +- 评测关注点是应用整体表现而非底层模型能力 + +**选择模型评测**： +- 处于技术选型阶段，需要在多个候选模型间做横向对比 +- 对模型进行了微调/调优，需要量化对比调优前后的能力变化 +- 需要使用公开基准数据集（C-Eval、MMLU 等）快速了解模型基础能力 +- 评测关注点是模型本身的推理和生成能力 + +**组合使用**：在实际项目中，建议先通过模型评测选定基础模型，再通过应用评测验证集成到应用后的端到端效果，形成"模型选型 → 应用构建 → 应用评测 → 持续监控"的完整闭环。 + +## 被对比主题页 + +- [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-vs-model-monitoring.md b/skills/bailian-docs-llm-wiki/wiki/comparisons/app-vs-model-monitoring.md new file mode 100644 index 0000000..291634a --- /dev/null +++ b/skills/bailian-docs-llm-wiki/wiki/comparisons/app-vs-model-monitoring.md @@ -0,0 +1,66 @@ +# 应用监控与模型监控对比 + +百炼平台提供两套互补的可观测能力：**应用观测**聚焦应用内部调用链路的端到端追踪，帮助开发者理解智能体、工作流等应用的执行过程；**模型监控**则聚焦模型维度的运行指标与成本核算，保障模型调用的稳定性与经济性。两者观测粒度、数据来源和使用场景各有侧重，开发者需要根据排查目标选择合适的工具，也可配合使用以获得从应用到模型的全链路可观测性。 + +## 关键维度对比 + +| 维度 | 应用观测 | 模型监控 | +| --- | --- | --- | +| **观测对象** | 应用（智能体应用、工作流应用、高代码应用） | 模型（所有模型，含调优后的自定义模型） | +| **核心目标** | 追踪应用内部调用链路，定位延时瓶颈与逻辑问题 | 监控模型运行状态与用量，保障稳定性与控制成本 | +| **数据粒度** | 单次请求的完整 Trace / Span 链路 | 按"模型 + [业务空间](../concepts/workspace.md)"维度的聚合指标 | +| **数据更新频率** | 分钟级 | 普通监控小时级，高级监控分钟级 | +| **数据保留时长** | 最长 30 天调用记录 | 用量统计保留 30 天，更早数据需到费用与成本页面查询 | +| **关键指标** | 延时、Token 量（输入/输出）、首 Token 耗时、调用次数、失败率 | 调用总量、失败率、平均调用时长、首包时长、RPM、TPM、Token 消耗 | +| **指标分类** | 按节点类型（CHAIN、LLM、RETRIEVER 等）查看 | 按安全、成本、性能、错误四类分类查看 | +| **链路追踪** | 支持，可展开查看完整 Span 树及每个节点的输入输出 | 不支持链路追踪，仅提供模型级聚合数据 | +| **日志能力** | Trace 详情中可查看 Prompt 内容与模型输出 | 需额外开通推理日志，仅北京地域部分模型支持 | +| **告警能力** | 不支持 | 支持主动告警（仅北京、新加坡地域） | +| **数据导出** | 支持导出为 JSONL 或 EXCEL | 不支持直接导出（需通过费用与成本页面获取账单数据） | +| **数据标注** | 支持对 Span 数据添加标签（布尔值/分类/数字/文本） | 不支持 | +| **与评测集联动** | 支持将 Span 数据直接加入评测集 | 不支持 | +| **地域限制** | 无特殊地域限制 | 高级监控限北京/新加坡/弗吉尼亚，告警限北京/新加坡，日志限北京 | +| **费用** | 功能免费，OpenTelemetry 存储另计 | 功能免费，高级监控的底层存储可能产生费用 | +| **开通方式** | 需手动配置：授权服务角色 → 开通 OpenTelemetry → 初始化 LogStore | 普通监控自动采集；高级监控和日志需手动开通 | +| **操作方式** | 仅控制台，无 API | 仅控制台，无 API | +| **用量/计费统计** | 不涉及计费统计 | 提供按模型类型的用量统计（Token/张/秒），可用于成本核算 | + +## 适用场景建议 + +### 应用观测适用于 + +- **应用调试与优化**：需要查看智能体或工作流应用内部各环节（检索、重写、模型推理、插件调用等）的执行顺序与耗时，定位性能瓶颈。 +- **Prompt 审查**：需要查看每次调用的具体 Prompt 内容与模型输出，排查回答质量问题。 +- **评测数据积累**：将线上真实调用数据标注后加入评测集，用于持续改进应用效果。 +- **单次请求排障**：通过 Request ID / Trace ID / Span ID 精确定位某一次调用的异常环节。 + +### 模型监控适用于 + +- **模型稳定性保障**：监控模型调用失败率、限流错误（429）、内容安全错误等指标，及时发现服务异常。 +- **成本管理**：按[业务空间](../concepts/workspace.md)和模型维度统计 Token 消耗和调用量，核算各模型的使用成本。 +- **容量规划**：通过 RPM（每分钟请求数）、TPM（每分钟 Token 数）等指标评估负载水平，预判扩容需求。 +- **主动告警**：设置 Token 消耗或错误率阈值，在异常发生时第一时间收到通知，避免静默故障。 +- **合规审计**：开通推理日志后可回溯历史对话的输入输出，满足内容审计需求。 + +### 建议组合使用 + +在生产环境中，建议同时开启应用观测和模型监控：应用观测负责应用层面的链路追踪与调试，模型监控负责基础设施层面的稳定性与成本管理。当模型监控发现某模型失败率上升时，可在应用观测中按时间范围筛选相关 Trace，进一步定位是应用逻辑问题还是模型服务问题。 + +## 技术选型参考 + +| 排查目标 | 推荐工具 | +| --- | --- | +| 某次调用为什么返回了错误答案 | 应用观测（查看 Trace 中各节点的输入输出） | +| 某个模型最近的失败率是否正常 | 模型监控（查看错误类指标） | +| 应用整体响应变慢，瓶颈在哪个环节 | 应用观测（对比各 Span 延时） | +| 本月 Token 消耗是否超出预算 | 模型监控（查看用量统计与费用概览） | +| 需要对线上 bad case 做标注并加入评测集 | 应用观测（数据标注 + 添加到评测集） | +| 模型调用量突增需要告警 | 模型监控（配置告警规则） | +| 回溯某次模型调用的完整输入输出 | 模型监控（推理日志，仅北京地域部分模型） | + +## 被对比主题页 + +- [application monitoring](../guides/application-monitoring.md) +- [model monitoring](../guides/model-monitoring.md) + + diff --git a/skills/bailian-docs-llm-wiki/wiki/comparisons/knowledge-vs-memory.md b/skills/bailian-docs-llm-wiki/wiki/comparisons/knowledge-vs-memory.md new file mode 100644 index 0000000..6412c41 --- /dev/null +++ b/skills/bailian-docs-llm-wiki/wiki/comparisons/knowledge-vs-memory.md @@ -0,0 +1,62 @@ +# 知识库与记忆库对比 + +百炼平台同时提供知识库（Knowledge Base）和记忆库（Memory Library）两种数据增强能力，二者均旨在为大模型补充上下文之外的信息，但设计目标截然不同：知识库基于 RAG 技术为模型注入组织级的私有文档与结构化数据，解决的是"模型不知道企业专有知识"的问题；记忆库基于长期记忆 API 为模型注入用户级的历史偏好与行为信息，解决的是"模型跨会话遗忘用户上下文"的问题。理解二者的差异与互补关系，是构建高质量智能体应用的关键。 + +## 关键维度对比 + +| 维度 | 知识库 | 记忆库 | +| --- | --- | --- | +| **核心定位** | 基于 RAG 为模型补充私有文档与最新信息，提升特定领域问答准确性 | 基于长期记忆 API 解决跨会话上下文丢失，持久化用户偏好与历史信息 | +| **数据来源** | 手动上传文档（PDF/Word/Markdown/Excel/CSV/图片/音视频等） | 从对话中自动提取，或通过 `custom_content` 直接写入 | +| **存储内容** | 文档切片（经向量化与索引） | 记忆片段（关键事件/信息）+ 用户画像（结构化属性） | +| **知识库/记忆库类型** | 文档搜索、数据查询、图片问答、音视频搜索（创建时选定不可更改） | 记忆片段 + 用户画像，二者可独立或组合使用 | +| **检索机制** | 向量 + 关键词混合检索 → Rerank 排序 → 加权返回 | 语义检索（基于 `messages` 内容匹配相关记忆） | +| **支持模型** | 千问全系列 + 第三方文本生成模型（DeepSeek、Llama、Yi 等） | 不绑定特定模型，检索结果注入 Prompt 后可配合任意模型使用 | +| **API 端点** | `bailian.cn-beijing.aliyuncs.com`（阿里云百炼 SDK） | `dashscope.aliyuncs.com/api/v2/apps/memory/*`（DashScope API） | +| **认证方式** | 阿里云 AccessKey（`ALIBABA_CLOUD_ACCESS_KEY_ID/SECRET`） | DashScope API Key（`DASHSCOPE_API_KEY`） | +| **接入方式** | 控制台 + 阿里云百炼 SDK（`alibabacloud_bailian20231229`） | API 直连 + OpenClaw 记忆插件（零侵入） | +| **用户隔离** | [业务空间](../concepts/workspace.md)（Workspace）级别 | `user_id` 级别，不同 `user_id` 完全隔离 | +| **数据有效期** | 持久存储，手动管理生命周期 | 可配置：7 / 30 / 180 天或永不过期（按记忆规则设定） | +| **计费方式** | 标准版 0.03 元/小时（1 QPS）；旗舰版 0.2 元/RCU/小时（50–10,000 QPS） | 随 DashScope API 调用计费 | +| **地域限制** | 仅中国站华北2（北京） | 无特殊地域限制 | +| **绑定上限** | 单服务最多绑定 15 个知识库 | 无明确上限，按 `user_id` 隔离 | + +## 适用场景 + +### 适合使用知识库的场景 + +- **企业知识问答**：将产品手册、内部文档、政策法规等导入知识库，构建领域专属问答系统。 +- **结构化数据查询**：通过 NL2SQL 对 Excel/CSV 数据执行自然语言查询。 +- **[多模态](../concepts/multimodal.md)内容检索**：对图片、音视频内容做结构化索引与语义搜索。 +- **客服与技术支持**：基于官方文档回答用户技术问题，降低幻觉率。 + +### 适合使用记忆库的场景 + +- **个性化助手**：记住用户的饮食偏好、作息习惯、工作风格等，提供个性化服务。 +- **连续对话体验**：跨多次会话保持上下文连贯，无需用户重复描述背景。 +- **用户画像构建**：自动提取年龄、职业、兴趣等结构化属性，实现精准推荐。 +- **智能体长期陪伴**：教育辅导、健康管理等需要持续跟踪用户状态的场景。 + +### 二者组合使用 + +在实际生产中，知识库与记忆库往往互补：知识库提供"组织知道什么"（企业文档、产品信息），记忆库提供"对这个用户了解什么"（偏好、历史）。例如，一个客服智能体可以同时挂载知识库获取产品技术文档，并通过记忆库记住该用户的历史工单和沟通偏好，从而给出既准确又个性化的回答。 + +## 技术选型建议 + +| 选型考量 | 推荐方案 | +| --- | --- | +| 需要检索大量静态文档 | 知识库 | +| 需要跨会话记住用户信息 | 记忆库 | +| 需要[多模态](../concepts/multimodal.md)内容（图片/音视频）检索 | 知识库 | +| 需要零侵入接入已有 Agent | 记忆库（OpenClaw 插件） | +| 需要精细控制检索参数（TopK、Rerank、阈值等） | 知识库 | +| 需要自动提取和管理用户画像 | 记忆库 | +| 需要高并发（>1 QPS） | 知识库旗舰版（最高 10,000 QPS） | +| 需要同时具备领域知识 + 用户个性化 | 知识库 + 记忆库组合 | + +## 被对比主题页 + +- [knowledge base](../guides/knowledge-base.md) +- [memory library overview](../guides/memory-library-overview.md) + + diff --git a/skills/bailian-docs-llm-wiki/wiki/comparisons/model-optimization-comparison.md b/skills/bailian-docs-llm-wiki/wiki/comparisons/model-optimization-comparison.md index c7c4867..e03e46d 100644 --- a/skills/bailian-docs-llm-wiki/wiki/comparisons/model-optimization-comparison.md +++ b/skills/bailian-docs-llm-wiki/wiki/comparisons/model-optimization-comparison.md @@ -1,58 +1,91 @@ -# 模型优化方式对比：微调 / 压缩 / 高速推理 +# 模型优化方案对比：微调、压缩与高速推理 -百炼平台为开发者提供三类模型优化手段：**模型微调（Fine-tuning）**、**模型压缩（Model Compression）** 与 **高速推理（TPM 预留 / PTU 部署）**。三者目标不同——微调解决"模型不贴合业务"，压缩解决"部署太贵/太慢"，高速推理解决"高峰期被限流"。它们互不冲突，常组合使用：微调 → 压缩 → 专属部署。本文从目标、输入输出、支持模型、API 端点、计费、典型场景等维度做横向对比，帮助开发者做技术选型。 +在百炼平台上部署和使用大模型时，开发者经常面临三类优化需求：让模型更懂业务（微调）、让模型更省资源（压缩）、让模型更快响应（高速推理/TPM 预留）。三者目标不同、流程各异，但常常需要组合使用。本文从核心目标、前置条件、操作流程、成本模型等维度对三种方案做系统对比，帮助开发者快速完成技术选型。 -## 关键维度对比 +## 核心维度对比 -| 维度 | 模型微调（Fine-tuning） | 模型压缩（Model Compression） | 高速推理（TPM 预留 / PTU） | -| --- | --- | --- | --- | -| 核心目标 | 注入领域知识、对齐业务指令与偏好 | 降低推理显存与成本、提升吞吐 | 锁定专属推理容量、规避公共限流 | -| 输入（前置产物） | 自有训练数据（ChatML JSONL / ZIP 等） | 已存在的全精度自定义微调模型 | 已可调用的模型（公共或微调后均可） | -| 输出（产出） | 新的自定义微调模型 | 量化后的低精度模型 | 专属模型 code（容量预留实例） | -| 支持模型范围 | Qwen3/3.5/3.6、千问VL、wan2.7-image(pro)、wan2.5/2.2 视频、CosyVoice 等 | 仅"支持压缩的模型"列表中的自定义微调模型（如 qwen3.5-flash-2026-02-23）；已量化模型不可二次压缩 | 控制台展示的模型为准，含 Qwen3.7-Max/Plus、Qwen3.6-Flash、GLM-5.2/5.1、DeepSeek-v4-Pro/Flash、Kimi-K2.6 等 | -| 训练/压缩方法 | CPT、SFT、DPO；每种分全参与 LoRA | 量化（量化模板含目标部署规格 MU5/MU8 等） | 不涉及训练，仅容量预留 | -| 数据要求 | CPT 需 1000万+ Token 无标签文本；SFT 需 1000+ 条问答对；DPO 需 100+ 组正负样本对 | 部分模板要求校准数据集（"内部上传"且"已发布"），OpenAPI 用 `custom_calibration_file_ids` 传入 | 无训练数据；仅需填写输入/输出 TPM、购买时长等参数 | -| API 端点 | `POST /api/v1/files`（上传）、`POST /api/v1/fine-tunes`（建任务）、`GET /api/v1/fine-tunes/`（轮询）、`POST /api/v1/deployments`（部署） | OpenAPI 创建压缩任务（控制台或 OpenAPI 调用） | 创建后获取"专属模型 code"，调用 `/compatible-mode/v1/chat/completions`，把 `model` 参数替换为该 code | -| 计费方式 | 按 Token 用量计费：`费用 = 训练数据 Token 总数 × 循环次数 × 训练单价` | 压缩功能**限时免费**；产出模型部署后按所选部署单元标准规格计费 | 预付费按 kTPM（按天），预留容量内调用不额外收费；超出自动降级按量计费，不中断；缩容退订按 1.5 倍系数结算 | -| 是否可逆/迭代 | 可多次微调迭代 | 产出模型**不支持**继续训练或二次压缩，需回上游重训 | 可续费、缩容、退订；到期 2 小时内可续费，14 小时后删除不可恢复 | -| 控制台入口 | 模型 → 模型调优 | 模型 → 模型训练 → 模型压缩 | 模型 → 高速推理 / TPM 预留 | -| 部署形态 | 部署为在线服务（`plan` 可选 `lora` 等） | 部署到更小规格单元（MU5、MU8 等） | 专属容量实例（TPM 预留）或专属部署实例（PTU） | +| 维度 | 微调（Fine-tuning） | 模型压缩（Model Compression） | 高速推理（TPM 预留） | +|------|---------------------|-------------------------------|----------------------| +| **核心目标** | 注入领域知识、学会遵循特定指令、对齐人类偏好 | 降低模型精度以减少显存占用，降低部署成本 | 锁定专属推理吞吐量，保障业务高峰不被限流 | +| **优化层面** | 模型能力（质量） | 模型体积（效率） | 推理资源（容量） | +| **前置条件** | 高质量训练数据集（SFT 1000+ 条，CPT 1000 万+ Token） | 已有支持压缩的自定义微调模型 | 无特殊前提，选定模型即可购买 | +| **输入** | JSONL 格式训练数据（ChatML / ZIP 包） | 自定义微调模型 + 可选校准数据集 | 业务流量预估（RPM、平均 Token 数） | +| **输出** | 微调后的自定义模型 | 量化后的低精度模型 | 专属模型 code（替换 API 中的 model 参数） | +| **操作方式** | 控制台可视化 + DashScope API | 控制台可视化 + OpenAPI | 控制台购买 + API 中替换 model 参数 | +| **代码改动** | 部署后替换 model 参数 | 部署后替换 model 参数 | 仅替换 model 参数为专属 code | +| **支持模型范围** | Qwen 全系列、千问VL、Wan 图像/视频、CosyVoice 语音 | 当前仅 qwen3.5-flash-2026-02-23 微调模型 | 千问3.7/3.6、GLM-5.x、DeepSeek-v4、Kimi-K2.6 等 | +| **支持模态** | 文本、视觉、图像生成、视频生成、语音合成 | 文本生成 | 文本生成 | +| **计费方式** | 按训练 Token 用量 x 循环次数 x 单价 | 压缩本身限时免费；部署按规格计费 | 预付费锁定容量；超额自动降级为按量计费 | +| **典型耗时** | 数小时至数天（取决于数据量和模型规模） | 任务排队后自动完成 | 即买即用（短暂预热） | +| **可逆性** | 可基于同一基座模型重新训练 | 不可逆：产出模型不支持继续训练或二次压缩 | 可随时扩缩容或退订 | -## 各方案适用场景建议 +## 方案流程对比 -### 模型微调 +### 微调流程 -- 业务有自有数据，通用模型在垂直行业（金融/医疗/法律）输出不达标； -- 需抑制幻觉、对齐安全合规偏好（DPO）； -- 客服、代码助手、Agent 工具调用等需遵循特定指令格式； -- 需多模态定制（视觉理解、图像/视频生成、专属音色）。 +1. 准备训练数据（JSONL / ZIP），上传至百炼数据管理 +2. 选择基座模型、训练方式（CPT / SFT / DPO）和超参数 +3. 启动训练任务，观察 Loss 曲线 +4. 训练完成后部署模型 +5. 通过标准 API 调用微调后模型 -### 模型压缩 +### 压缩流程 -- 已有微调模型，但部署成本高、吞吐不足； -- 部署规格过大，希望迁到 MU5/MU8 等更小单元； -- 对延迟敏感的在线推理，希望降低显存占用； -- 注意：压缩后不可继续训练或二次压缩，迭代要回到上游全精度模型。 +1. 确认已有支持压缩的微调模型 +2. 创建压缩任务，选择源模型和量化模板 +3. 按需配置校准数据 +4. 等待压缩完成 +5. 将产出模型部署到更小规格的部署单元 -### 高速推理（TPM 预留 / PTU） +### TPM 预留流程 -- 业务流量可预估，且**不能接受公共限流**； -- 营销活动、API 对外开放等高峰场景； -- 对极致性能与隔离有更高要求时选 PTU 专属部署； -- 仅需替换 `model` 参数为专属 code，接入零改动。 +1. 使用容量计算器估算所需 TPM（基于 RPM、平均 Token 数、缓存命中率） +2. 创建 TPM 预留，选择模型和容量 +3. 支付预付费用，获取专属模型 code +4. 将 API 中 `model` 参数替换为专属 code +5. 通过监控面板跟踪使用率，按需扩缩容 -## 技术选型参考 +## 适用场景建议 -| 业务诉求 | 推荐路径 | -| --- | --- | -| 模型答得不对/不懂行业知识 | 微调（CPT → SFT → DPO） | -| 微调后太贵、推理慢 | 先微调，再压缩到 MU5/MU8 | -| 高峰期被限流、要求稳定容量 | TPM 预留（或 PTU） | -| 既懂行业、又便宜、又稳 | 微调 → 压缩 → 专属部署（PTU）组合使用 | -| 只想降本不改模型 | 资源包/节省计划 或 压缩部署规格 | -| 流量波动大、短期试用 | 按量付费，无需微调或预留 | +### 选择微调的场景 -三者并非互斥：微调产出更贴合业务的模型，压缩把该模型变便宜变快，高速推理为最终上线模型锁定稳定容量。建议按"**业务问题 → 微调；成本问题 → 压缩；容量问题 → 预留**"的顺序定位诉求，再决定是否组合使用。 +- 模型在特定领域（金融、医疗、法律）的回答质量不够，需要注入专业知识 +- 需要模型学会特定的指令格式或工具调用方式（如 Agent 场景） +- 模型输出存在幻觉或安全合规问题，需要通过 DPO 对齐偏好 +- 需要定制图像/视频生成风格或专属语音音色 + +### 选择压缩的场景 + +- 已有微调模型，希望降低部署成本（例如从 MU1x2 降至 MU8x1） +- 对推理延迟有一定容忍度，但对成本敏感 +- 模型规模较大，需要部署到更小规格的计算单元 + +### 选择 TPM 预留的场景 + +- 业务流量可预估，高峰期不能接受限流或排队 +- 需要稳定的推理吞吐保障（如生产环境的在线服务） +- 希望费用可控且可预测，避免按量计费的波动 + +## 组合使用建议 + +三种方案并非互斥，实际生产中常常组合使用： + +1. **微调 + 压缩**：先通过 SFT 让模型掌握业务能力，再通过压缩降低部署成本。适合对模型质量有定制需求、同时关注成本的场景。注意压缩后不可再训练，建议在微调效果稳定后再压缩。 + +2. **微调 + TPM 预留**：先微调获得定制模型并部署，再通过 TPM 预留锁定推理吞吐。适合既需要定制能力、又需要稳定服务保障的生产场景。 + +3. **三者结合**：微调 → 压缩 → 以更低成本部署 → 对部署后的模型购买 TPM 预留。这是成本与性能兼顾的完整优化路径。 + +## 决策参考 + +| 你的核心诉求 | 推荐方案 | +|-------------|---------| +| 模型回答质量不够 / 需要领域适配 | 微调 | +| 部署成本太高 / 显存不够 | 压缩 | +| 高峰期被限流 / 需要稳定吞吐 | TPM 预留 | +| 质量 + 成本双优化 | 微调 → 压缩 | +| 质量 + 稳定性双保障 | 微调 → TPM 预留 | +| 全链路优化 | 微调 → 压缩 → TPM 预留 | ## 被对比主题页 @@ -61,5 +94,3 @@ - [model high speed inference](../guides/model-high-speed-inference.md) - - 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 43c0569..05778fc 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,54 +1,81 @@ -# 多模态生成能力对比：图像 / 3D / 视频 +# [多模态](../concepts/multimodal.md)内容生成 API 对比 -百炼平台在「内容生成」方向同时提供图像、3D、视频三类多模态生成 API。三者底层模型不同、调用模式不同、产物形态不同，但都通过 DashScope 网关统一鉴权、统一编排。本文把它们放在一起对比，帮助开发者根据业务诉求（静态图 / 立体资产 / 动态影像）和工程约束（延迟、地域、异步轮询成本）做出技术选型。 +百炼平台提供图像生成、视频生成和 3D 模型生成三大类[多模态](../concepts/multimodal.md)内容生成能力。三者在输入形式、输出产物、模型生态、调用方式和适用场景上存在显著差异。本文从开发者技术选型角度，对这三类 API 进行系统对比，帮助快速定位最适合业务需求的接口。 -## 关键维度对比 +## 核心维度对比 -| 维度 | 图像生成 (image-generation) | 3D 生成 (3d-generation) | 视频生成 (video-generation-api) | +| 维度 | 图像生成 | 视频生成 | 3D 模型生成 | | --- | --- | --- | --- | -| 产物形态 | 单张 / 多张静态图片（PNG/JPG 临时 URL） | 带贴图的 GLB 模型（PBR 材质）或无贴图基础模型 + 预览渲染图 | 视频文件（MP4 等，临时 URL） | -| 底层模型族 | 通义千问图像、万相、Z-Image、可灵、创意工具系列 | Tripo 系列（`Tripo/Tripo-H3.1`、`Tripo/Tripo-P1.0`） | 万相 2.7、HappyHorse、Pixverse、Vidu、Kling、AnimateAnyone、LivePortrait、EMO、Emoji 等 | -| 主要输入方式 | 文本 [prompt](../guides/prompt.md)；可选参考图、蒙版、涂鸦、商品图 | 文生 3D（[prompt](../guides/prompt.md)）、单图生 3D（image）、多图生 3D（4 视角 images） | 文生视频、图生视频（首帧/首尾帧）、参考生视频、关键帧生视频、视频编辑、音频驱动数字人 | -| 输入格式 | 文本 + 公网 URL 或 Base64 图像；JSON 承载 | 文本 + 公网 URL 图像（JPEG/PNG） | 文本 + 公网 URL 图像/视频；JSON 承载 | -| API 端点 | OpenAI 兼容 `compatible-mode/v1/images/generations`；或 DashScope 原生 `services/aigc/text2image/image-synthesis` | `POST /api/v1/services/aigc/video-generation/3d-generation` + `GET /api/v1/tasks/{task_id}` | `POST /api/v1/services/aigc/video-generation/video-synthesis`（路径因模型略异）+ `GET /api/v1/tasks/{task_id}` | -| 调用模式 | 同步（OpenAI 兼容）或异步轮询（万相/创意工具，返回 task_id 后轮询） | 仅异步：必须带 `X-DashScope-Async: enable` 头，返回 task_id 后轮询 | 仅异步：必须带 `X-DashScope-Async: enable` 头，返回 task_id 后轮询 | -| 典型耗时 | 秒级（同步）/ 十秒级（异步） | 较长，轮询间隔建议约 15 秒 | 1–5 分钟 | -| 地域限制 | 无特殊限制，按 API Key 所属地域 | **仅华北2（北京）**，需使用北京地域 API Key | 模型、Endpoint URL、API Key 必须同一地域；北京/新加坡推荐业务空间专属域名 | -| 鉴权 | `Authorization: Bearer ` | 同左 | 同左 | -| 产物有效期 | 临时 URL，需及时下载或转存 OSS | GLB 等下载链接有效期 **2 小时** | 视频 URL 临时链接，需及时下载 | -| 计费方式 | 按调用次数 / 图数，不同模型单价不同 | 按任务类型（text-to-3d / image-to-3d / multi-image-to-3d）与生成数量计 | 按任务次数 / 视频时长，不同模型单价不同 | -| 内容安全 | 内置审核，违规 [prompt](../guides/prompt.md)/图片返回 `DataInspectionFailed` | 内置审核，失败任务返回 `code`/`message` | 内置审核，违规输入任务转 `FAILED` | -| 典型场景 | 营销海报、电商模特、艺术风格图、图像编辑/局部重绘、试衣、写真 | 商品 3D 展示、游戏/AR 资产、设计原型、虚拟试穿立体资产 | 短视频素材、广告片、数字人播报、视频风格化、动作生成 | +| **输入形式** | 文本 [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 生成 | +| --- | --- | --- | --- | +| 文本直接生成 | 支持（文生图，模型最丰富） | 支持（文生视频） | 支持（文生 3D） | +| 图片驱动生成 | 支持（图生图、图像编辑、风格迁移） | 支持（图生视频、首帧驱动） | 支持（单图/多图生 3D） | +| 多参考输入 | 支持（多图参考生成、组图） | 支持（多参考图/视频驱动） | 支持（4 视角多图，前/左/后/右） | +| 内容编辑 | 支持（局部重绘、扩图、超分、文字替换） | 支持（视频重绘、风格转换、口型替换） | 不支持 | +| 文字渲染 | 支持（中英文字渲染是优势能力） | 不适用 | 不适用 | +| 数字人/动作 | 不适用 | 支持（AnimateAnyone、LivePortrait、EMO、数字人 S2V） | 不适用 | +| 材质与质量控制 | 分辨率、张数可配置 | 分辨率、时长、种子可配置 | 贴图质量（standard/detailed）、几何精度（standard/ultra）、PBR 材质开关 | + +## 计费模式对比 + +| 维度 | 图像生成 | 视频生成 | 3D 生成 | +| --- | --- | --- | --- | +| 计费单位 | 按张计费（部分模型如扩图 0.18 元/张） | 按任务/时长计费 | 按任务计费 | +| 免费体验 | 部分创意工具模型仅提供免费体验额度 | 部分模型提供免费体验 | 需在控制台开通服务 | +| 商业化状态 | 核心模型已商业化，部分垂直工具仅免费体验 | 核心模型已商业化 | 已商业化 | -## 各方案适用场景建议 +## 适用场景建议 -### 图像生成 +**选择图像生成 API 的场景：** -适合产物是**静态图片**、追求高吞吐和低延迟的业务：电商模特图、营销海报、艺术风格插画、人像写真、图像编辑（换背景/改服饰/局部重绘）等。接口数量最多、模型族最丰富，从通义千问（中文语义准确）到万相（通用文生图+编辑一体）再到 Z-Image/可灵（高美感艺术风）和创意工具（虚拟模特、AI 试衣、画面扩展等垂类业务化封装），可选范围最广。如果只需"出图"且希望秒级返回，优先选 OpenAI 兼容模式的同步接口（如千问-文生图）。 +- 需要快速生成营销素材、产品展示图、海报、插画等静态视觉内容 +- 需要对已有图片进行精细编辑（局部修改、扩图、风格迁移、文字替换） +- 电商场景下的商品背景生成、虚拟试衣、虚拟模特 +- 需要在图片中精准渲染中英文文字 +- 对响应速度要求高（秒级返回） -### 3D 生成 +**选择视频生成 API 的场景：** -适合需要**立体可旋转资产**的场景：商品 3D 展示、游戏与 AR 资产、设计原型。当前由 Tripo 系列提供，输入灵活（文生、单图、多图），输出 PBR 材质 GLB 可直接进渲染引擎。但有几个硬约束：仅北京地域、仅异步调用、产物链接 2 小时过期、task_id 24 小时内可查。新接入建议直接用 `Tripo/Tripo-H3.1`（高精度，最高 200 万面）或 `Tripo/Tripo-P1.0`（速度更快，最高 2 万面）。 +- 需要生成短视频广告、产品展示动画、创意视频内容 +- 数字人驱动场景（虚拟主播、AI 说话人、音频驱动口型） +- 需要将静态图片转为动态视频（图生视频） +- 需要对已有视频进行风格化处理或口型替换 +- 多关键帧控制的精细视频生成需求 -### 视频生成 +**选择 3D 模型生成 API 的场景：** -适合产物是**动态影像**的场景：短视频素材、广告片、数字人播报、视频风格化、动作生成。底层模型最多元（万相 2.7 主力 + HappyHorse/Pixverse/Vidu/Kling + 数字人/动作/表情类专模型），能力覆盖文生、图生、参考生、关键帧、视频编辑、风格转换。代价是耗时最长（1–5 分钟/任务）、参数最复杂（不同模型对 `size`/`duration`/参考图数量支持差异大）、对地域与业务空间域名要求最严。需要关键帧级镜头控制选 Pixverse/Vidu；需要数字人或口型驱动选 EMO/LivePortrait/AnimateAnyone/wan-s2v；通用文/图生视频首选万相 2.7。 +- 需要快速生成 3D 资产用于游戏、AR/VR、电商 3D 展示 +- 从产品照片自动生成可交互的 3D 模型 +- 需要带 PBR 材质的高精度 3D 模型（最高 200 万面） +- 3D 内容创作流水线中的原型快速生成 -## 技术选型参考 +## 技术选型决策参考 -1. **先定产物形态**：静态图 → 图像生成；立体资产 → 3D 生成；动态视频 → 视频生成。三者不可互相替代，但可串联（如先图像生成出商品图，再用 3D 单图生 3D，最后用图生视频做动态展示）。 -2. **再看延迟容忍**：秒级 → 图像同步接口；十秒级 → 图像异步 / 3D；分钟级 → 视频。 -3. **核对地域与权限**：3D 仅北京；视频需模型/Endpoint/Key 同地域；图像最宽松。投产前确认 API Key 已开通对应模型。 -4. **评估工程成本**：3D 与视频都强制异步轮询，需实现任务状态机（PENDING → RUNNING → SUCCEEDED/FAILED）和产物及时下载/转存逻辑，链路比图像同步调用重得多。 -5. **关注产物有效期**：图像、3D（2 小时）、视频的临时 URL 都需在拿到后立即下载或转存到 OSS，避免链接失效。 -6. **内容安全合规**：三类接口都内置审核，违规输入会被拦截并返回错误码，业务侧需做好失败兜底与重试策略。 +1. **产物类型决定方向**：需要静态图选图像生成，需要动态内容选视频生成，需要三维资产选 3D 生成。 +2. **响应时间敏感度**：图像生成响应最快（秒级），视频和 3D 均为分钟级异步任务。如果业务对实时性要求高，优先考虑图像生成。 +3. **模型丰富度**：图像生成的模型和子能力最为丰富，视频生成次之，3D 生成目前仅有 Tripo 系列 2 款模型。 +4. **地域限制**：3D 生成仅限北京地域，图像和视频生成的核心模型多地域可用。部署在海外的服务需注意地域兼容性。 +5. **集成复杂度**：图像生成部分模型支持同步调用，集成最简单；视频和 3D 均需实现异步轮询逻辑，建议封装统一的任务管理层。 +6. **组合使用**：三类 API 可串联使用。例如先用图像生成产出高质量概念图，再用图生视频将其动态化，或用单图/多图生成 3D 模型，构建完整的[多模态](../concepts/multimodal.md)内容生产流水线。 ## 被对比主题页 - [image generation](../api/image-generation.md) -- [3d generation](../api/3d-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/concepts/api-key.md b/skills/bailian-docs-llm-wiki/wiki/concepts/api-key.md index 6babd5d..067245b 100644 --- a/skills/bailian-docs-llm-wiki/wiki/concepts/api-key.md +++ b/skills/bailian-docs-llm-wiki/wiki/concepts/api-key.md @@ -1,71 +1,95 @@ -# API Key +# API Key 鉴权 -API Key 是调用阿里云百炼平台所有模型与应用服务的唯一鉴权凭证，由百炼控制台创建和管理，用于在 HTTP 请求或 SDK 调用中标识调用方身份并验证权限。 +API Key 是调用阿里云百炼平台模型服务和应用接口的唯一鉴权凭证，用于标识调用者身份并控制访问权限。开发者在调用任何百炼 API 之前，必须先在控制台创建 API Key 并妥善保管。 + +## API Key 的类型 + +百炼目前存在三类 API Key，它们的格式、Base URL 和计费方式互不相通： + +| 类型 | 格式 | 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 与 Base URL 会导致意外扣费或 401/403 报错。 ## 创建与获取 -在百炼控制台的密钥管理页面创建 API Key，操作要求具备主账号权限，或子账号拥有"管理员"或"API-Key"页面权限。创建时需选择归属的[业务空间](workspace.md)（建议选默认空间），并可配置 IP 白名单和模型访问范围。 +在百炼控制台的 API Key 管理页面创建，操作权限要求： -自 2026 年 3 月 25 日起，华北2（北京）地域新创建的 API Key 均归属主账号，前缀为 `sk-ws`。API Key 仅在创建时展示一次明文，关闭弹窗后无法再次查看，请立即复制保存。 +- 使用主账号，或具备"管理员"或"API-Key"页面权限的子账号。 +- 不同地域的控制台入口不同（华北2/新加坡/日本/德国使用 `bailian.console.aliyun.com`，美国使用 `modelstudio.console.aliyun.com`）。 -不同地域的控制台入口不同，且各地域（北京、新加坡、弗吉尼亚、法兰克福、东京）的 API Key 不互通，使用时须确保地域匹配。 +创建时可选择归属[业务空间](workspace.md)并配置权限（全部模型或自定义 IP 白名单 + 模型范围）。升级后新创建的 API Key 以 `sk-ws` 开头，**仅在创建时展示一次明文**，关闭弹窗后无法再次查看，请立即复制保存。 -## 权限机制 +自 2026 年 3 月 25 日起，华北2（北京）地域所有新创建的 API Key 均归属主账号，并支持设置 IP 访问白名单。 -API Key 的调用权限由其归属的[业务空间](workspace.md)决定： +## 权限模型 -- **默认[业务空间](workspace.md)**的 API Key 可调用所有标准模型，无法设置模型级限制。 -- **子业务空间**的 API Key 仅可调用该空间已授权的模型，支持按模型调用、模型训练、模型部署三个维度做精细化授权，并支持请求数限流和 [Token](token.md) 限流。 -- 同一业务空间内的 API Key 权限相同，无需为不同模型类型（文生文、文生图、语音合成）分别创建。 -- 单个 API Key 只能归属一个地域内的一个业务空间和一个用户，且不能转移。 +单个 API Key 只能归属一个地域内的一个[业务空间](workspace.md)和一个用户，且不能转移。其核心权限规则： -## 环境变量配置 +- API Key 的可调用模型和限流与**归属[业务空间](workspace.md)**的权限保持一致，不受用户控制台权限影响。 +- 默认业务空间的 API Key 可调用所有标准模型；子业务空间的 API Key 仅可调用已授权的模型。 +- 无需为不同模型类型（文生文、文生图、语音合成）分别创建 API Key。 +- API Key 没有失效日期，手动删除后即失效。 -建议将 API Key 配置到环境变量 `DASHSCOPE_API_KEY`，避免在代码中硬编码造成泄露风险。SDK（DashScope SDK 和 OpenAI 兼容 SDK）会自动读取该变量。 +### API Key 状态变化 -- **Linux/macOS**：在 `~/.bashrc` 或 `~/.zshrc` 中追加 `export DASHSCOPE_API_KEY="your-key"`，然后 `source` 生效。 -- **Windows**：通过系统属性设置系统变量，或使用 `setx` / `[Environment]::SetEnvironmentVariable` 命令。 +| 触发操作 | 影响 | +| --- | --- | +| 主动删除 API Key | 失效，不可恢复 | +| 将 RAM 账号移出业务空间 | 该账号的 API Key 失效（重新加入后恢复） | +| 在 RAM 控制台删除账号/角色 | API Key 永久失效，不可恢复 | -设置后需重启 IDE 或终端以加载新变量。使用 `sudo` 运行脚本时需加 `-E` 参数继承用户环境变量。 +## 配置环境变量 -## 临时 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` 设置。 -在浏览器、移动 App 等不可信环境中，应通过后端服务生成临时 API Key，避免永久 Key 泄露。 +设置后已打开的 IDE 或终端不会自动加载新变量，需重启相关程序。使用 `sudo` 运行脚本时默认不继承用户环境变量，需加 `-E` 参数。 -- 有效期默认 60 秒，可通过 `expire_in_seconds` 参数设置，范围 1 至 1800 秒。 -- 临时 Key 继承生成它的永久 Key 的全部权限，无法进一步收窄。 -- 到期后自动失效，不能提前删除。 -- 生成的临时 Key 前缀为 `st-`。 +## 临时 API Key -请求示例： +在浏览器、移动端等不可信环境中，直接暴露永久 API Key 存在安全风险。百炼支持通过后端服务生成有限时效的临时 API Key： ``` -curl -X POST "https://dashscope.aliyuncs.com/api/v1/tokens?expire_in_seconds=1800" \ --H "Authorization: Bearer $DASHSCOPE_API_KEY" +POST https://dashscope.aliyuncs.com/api/v1/tokens?expire_in_seconds= ``` -## [Token](token.md) Plan 专属 API Key +- `expire_in_seconds`：有效期，范围 [1, 1800] 秒，默认 60 秒。 +- 临时 API Key 继承生成它的永久 API Key 的全部权限，到期后自动失效，无法手动删除。 +- 各地域的 API Key 不互通，请求时需使用对应地域的 Endpoint。 + +## 在框架中使用 -[Token](token.md) Plan 团队版使用独立的 API Key（前缀 `sk-sp-`），与百炼通用 API Key（前缀 `sk-`）体系完全隔离，配合专属 Base URL 使用。两类 Key 不可混用，MCP 服务仍需使用百炼通用 API Key。 +百炼支持的主流框架均以 API Key 进行鉴权： -## 有效性与安全注意事项 +- **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。 -- API Key 没有自动失效日期，手动删除后即永久失效。 -- 将 RAM 账号移出业务空间会使其 API Key 失效，重新加入后可恢复。 -- 在 RAM 控制台删除账号或角色会导致 API Key 永久失效、不可恢复。 -- 生产环境建议按环境（dev/test/prod）划分业务空间，对 API Key 做隔离管理。 +不同框架对环境变量名的约定可能不一致（如 `DASHSCOPE_API_KEY` 与 `AI_DASHSCOPE_API_KEY`），需确保配置文件中的占位符与实际变量名一致。 + +## 安全建议 + +- 不要在客户端代码中硬编码永久 API Key，前端场景使用临时 API Key。 +- 按环境（dev/test/prod）划分业务空间，实现 API Key 权限隔离。 +- 定期审计 API Key 使用情况，及时删除不再使用的 Key。 +- 华北2（北京）地域可为 API Key 设置 IP 访问白名单，进一步收缩访问范围。 ## 关联主题页 - [preparations](../api/preparations.md) -- [qwen api reference](../api/qwen-api-reference.md) -- [application call](../api/application-call.md) -- [frameworks](../api/frameworks.md) -- [more](../api/more.md) - [more about models](../api/more-about-models.md) -- [token plan guide](../guides/token-plan-guide.md) -- [managed agents api](../api/managed-agents-api.md) - [security and compliance](../guides/security-and-compliance.md) -- [bailian application calling](../guides/bailian-application-calling.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) 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 a7fac30..46d1de7 100644 --- a/skills/bailian-docs-llm-wiki/wiki/concepts/async-invocation.md +++ b/skills/bailian-docs-llm-wiki/wiki/concepts/async-invocation.md @@ -1,83 +1,74 @@ # 异步调用 -异步调用是百炼平台针对耗时较长的生成类任务（如图像生成、视频生成、3D 模型生成）所采用的统一调用模式。其核心流程为「创建任务获取 task_id → 轮询或回调获取结果」，避免长时间阻塞 HTTP 连接。 - -## 适用场景 - -异步调用适用于所有处理时间超出常规 HTTP 超时的模型服务，包括但不限于： - -- **3D 模型生成**：文生 3D、图生 3D、多图生 3D（Tripo 系列） -- **视频生成**：文生视频、图生视频、视频编辑、数字人等（万相、可灵、PixVerse、Vidu 系列） -- **图像生成**：万相文生图、图像编辑、创意工具等（部分接口支持同步，大多数走异步） +异步调用是百炼平台针对耗时较长的生成类任务所采用的标准调用模式，流程为「创建任务 → 轮询获取结果」，适用于视频生成、3D 模型生成、部分图像生成等场景。 ## 调用流程 -### 1. 创建任务 +异步调用统一分为两步： -向对应模型的 API 端点发送 POST 请求，必须携带请求头： +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` 判断任务状态。 -``` -X-DashScope-Async: enable -``` +## 任务状态流转 -缺少此请求头会报错 `current user api does not support synchronous calls`。 +异步任务的状态枚举如下： -成功后响应中返回 `task_id`，该 ID 是后续查询结果的唯一凭证。 +| 状态 | 含义 | +| --- | --- | +| `PENDING` | 排队中，任务已提交但尚未开始处理 | +| `RUNNING` | 处理中 | +| `SUCCEEDED` | 任务成功完成，可从响应中获取产物 | +| `FAILED` | 任务失败，响应中包含错误码和错误信息 | +| `CANCELED` | 任务已取消 | +| `UNKNOWN` | 任务不存在或已超过有效期 | -### 2. 查询结果 +正常流转路径为 `PENDING` → `RUNNING` → `SUCCEEDED` 或 `FAILED`。 -通过通用查询接口轮询任务状态： +## 适用场景 -``` -GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id} -``` +百炼平台以下能力采用异步调用模式： -建议轮询间隔约 15 秒，直到状态变为终态。 +- **视频生成**：万相（Wan）系列、HappyHorse、Pixverse、Vidu、Kling 等所有视频生成接口，单次生成耗时通常 1-5 分钟。 +- **3D 模型生成**：Tripo 系列模型的文生 3D、图生 3D、多图生 3D 接口。 +- **图像生成**：部分图像生成与编辑接口（如万相文生图 V1 版、涂鸦作画等）。 +- **模型调优**：微调训练任务通过轮询或监听方式获取训练进度和结果。 -## 任务状态 +## 关键参数与配置 -| 状态 | 含义 | -| --- | --- | -| `PENDING` | 排队中，等待处理 | -| `RUNNING` | 正在处理 | -| `SUCCEEDED` | 任务成功，可获取结果 | -| `FAILED` | 任务失败，查看错误信息 | -| `CANCELED` | 已被取消 | -| `UNKNOWN` | 任务不存在或超过有效期 | +### 请求头 -## 异步任务管理接口 +| 参数 | 必填 | 说明 | +| --- | --- | --- | +| `X-DashScope-Async` | 是 | 固定值 `enable`，开启异步模式 | +| `Authorization` | 是 | `Bearer $DASHSCOPE_API_KEY`，鉴权令牌 | -百炼提供三个通用的任务管理接口（限流均为 20 QPS）： +### 轮询策略 -| 接口 | 方法与路径 | 用途 | -| --- | --- | --- | -| 查询单个任务 | `GET /api/v1/tasks/{task_id}` | 根据 task_id 查询状态与结果 | -| 批量查询 | `GET /api/v1/tasks/` | 按时间/状态/模型等条件分页查询 | -| 取消任务 | `POST /api/v1/tasks/{task_id}/cancel` | 取消排队中（PENDING）的任务 | +- 建议轮询间隔约 **15 秒**，避免过于频繁触发限流。 +- 查询接口默认 RPS 限制为 **20**，如需更高频率可配置异步任务回调通知。 +- `task_id` 有效期为 **24 小时**，超时后查询返回 `UNKNOWN` 状态。 -## 避免轮询：任务完成通知 +### 地域与域名 -频繁轮询会浪费资源并可能触发限流。百炼已接入阿里云事件总线 EventBridge，任务完成后主动推送通知，支持两种接收方式： +调用异步接口时需确保模型、Endpoint URL、API Key 属于同一地域。推荐使用[业务空间](workspace.md)专属域名： -- **HTTP 回调 URL**：事件总线直接向公网接口 POST 推送，接入简单 -- **RocketMQ 消息队列**：消息投递到 MQ 供业务消费，支持失败重试，可靠性更高 +- 华北2（北京）：`https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com` +- 新加坡：`https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com` -事件关键字段：事件源 `acs.dashscope`，事件类型 `dashscope:System:AsyncTaskFinish`，事件数据包含 `task_id`、`task_status`、`region` 等。 +旧域名 `dashscope.aliyuncs.com` 仍可使用。 -## 关键约束与注意事项 +## 最佳实践 -- **task_id 有效期 24 小时**：超时后无法再查询，状态返回 `UNKNOWN` -- **请勿重复创建任务**：拿到 task_id 后直接轮询即可 -- **同地域要求**：模型端点、[API Key](api-key.md) 必须属于同一地域 -- **产物链接时效**：生成结果的下载 URL 通常有效期 2 小时，需及时下载或转存 -- **取消限制**：仅支持取消 `PENDING` 状态的任务 -- **子任务机制**：含多个子任务的请求，只要有一个子任务成功，整体即为 `SUCCEEDED`；失败子任务的错误在 `output.results` 中单独展示 +1. **避免重复创建任务**：创建成功后保存 `task_id`，通过轮询获取结果即可，不要对同一请求重复提交。 +2. **及时下载产物**：生成产物（视频、3D 模型等）的下载链接通常有时效限制（如 2 小时），请及时保存。 +3. **使用回调替代轮询**：对于高频调用场景，建议配置异步任务回调通知，减少轮询请求开销。 +4. **处理失败状态**：任务失败时响应中包含 `code` 和 `message` 字段，可参照百炼错误码文档排查问题。 ## 关联主题页 - [3d generation](../api/3d-generation.md) - [video generation api](../api/video-generation-api.md) -- [more about models](../api/more-about-models.md) - [image generation](../api/image-generation.md) +- [model production](../api/model-production.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 c552654..d8ad6a4 100644 --- a/skills/bailian-docs-llm-wiki/wiki/concepts/dashscope-sdk.md +++ b/skills/bailian-docs-llm-wiki/wiki/concepts/dashscope-sdk.md @@ -1,106 +1,85 @@ # DashScope SDK -DashScope SDK 是阿里云百炼平台提供的原生开发工具包，用于通过编程方式调用百炼平台上的大模型服务和应用。SDK 封装了 DashScope API 的认证、请求构建与响应解析，支持 Python 和 Java 两种语言。 +DashScope SDK 是阿里云百炼平台的官方原生 SDK，提供对百炼全部模型能力和应用服务的编程访问接口。相比 [OpenAI 兼容接口](openai-compatible-interface.md)，DashScope SDK 的功能集最完整、参数支持最丰富，是需要使用百炼平台全部能力时的首选接入方式。 -## 定位与适用场景 +## 支持的语言与安装 -百炼平台同时支持 OpenAI 兼容 SDK 和 DashScope 原生 SDK 两种接入方式： - -- **OpenAI 兼容 SDK**：迁移成本低，适合已有 OpenAI 代码库的场景，但功能覆盖受协议约束。 -- **DashScope SDK**：功能集最完整，参数支持最丰富，适合需要使用百炼原生全部能力的场景。 - -当模型仅支持 DashScope 协议（如 Qwen-Audio、Qwen-Deep-Research）或需要使用原生独有参数时，必须使用 DashScope SDK。 - -## 在百炼平台的使用场景 - -### 模型 API 调用 - -通过 DashScope SDK 可调用百炼平台上的文本生成、图像生成、语音合成/识别、向量/排序等模型。以文本生成为例，DashScope 原生接口提供最完整的采样参数与插件支持。 - -### 应用调用 +| 语言 | 安装方式 | 版本要求 | +| --- | --- | --- | +| Python | `pip install -U dashscope` | Python >= 3.8 | +| Java | Maven/Gradle 引入 `com.alibaba:dashscope-sdk-java`（建议 >= 2.12.0） | - | -百炼应用（智能体、工作流）通过 DashScope SDK 的 `Application.call` 方法调用，请求发送至 `/api/v1/apps/{APP_ID}/completion` 端点。相比 OpenAI 兼容模式，DashScope 原生 API 在功能覆盖和性能方面具有优势。 +Node.js 目前没有官方 DashScope SDK，需通过 `axios` 等 HTTP 库直接调用 REST API，或使用 OpenAI 兼容 SDK 接入。 -### 专用模型调用 +## 鉴权与环境配置 -部分专用模型（如法律模型 `farui-plus`、深度研究模型 `qwen-deep-research`）仅支持或推荐通过 DashScope SDK 调用。 +DashScope SDK 使用 API Key 进行鉴权。推荐将 API Key 配置到环境变量 `DASHSCOPE_API_KEY`，SDK 会自动读取该变量，避免在代码中硬编码： -## 安装方式 +- **Linux/macOS**：在 `~/.bashrc` 或 `~/.zshrc` 中添加 `export DASHSCOPE_API_KEY="your-key"`，然后 `source` 生效。 +- **Windows**：通过系统属性设置系统变量，或使用 `setx` / PowerShell 命令。 -### Python +也可在调用时通过 `api_key` 参数显式传入。注意不同地域（北京、新加坡等）的 API Key 不通用，切换地域时需同步更换。 -```bash -pip install -U dashscope -``` +## 使用场景 -要求 Python >= 3.8。 +### 应用调用 -### Java +通过 `Application.call` 方法调用百炼上创建的智能体应用和工作流应用。Python 示例： -通过 Maven 或 Gradle 引入依赖： +```python +from dashscope import Application -```xml - - com.alibaba - dashscope-sdk-java - +response = Application.call( + app_id='YOUR_APP_ID', + prompt='你好' +) +print(response.output.text) ``` -建议版本 >= 2.12.0。 - -## 关键配置 - -### 认证 +Java 通过 `ApplicationParam.builder()` 构建参数，调用 `Application.call(param)` 完成请求。两种应用类型的调用接口完全一致，支持多轮对话（通过 `session_id` 或手动拼接历史消息）。 -SDK 通过 [API Key](api-key.md) 进行鉴权，推荐将密钥配置到环境变量 `DASHSCOPE_API_KEY`，SDK 会自动读取： - -```bash -export DASHSCOPE_API_KEY='your-api-key' -``` +### 文本生成（Qwen 系列） -也可在调用时通过 `api_key` 参数显式传入。 +DashScope 原生接口是百炼为 Qwen 系列模型提供的四种调用方式之一（另有 OpenAI 兼容、Anthropic 兼容、OpenAI Responses）。当需要使用最全的采样参数、插件或业务字段时，建议优先选择 DashScope 原生接口。 -### 基础端点 +### 专用模型 -DashScope 原生 API 的基础域名为 `https://dashscope.aliyuncs.com`。不同地域的端点有所差异： +多个专用模型支持通过 DashScope SDK 调用： -| 地域 | 端点 | -| --- | --- | -| 华北2（北京） | `https://dashscope.aliyuncs.com` | -| 新加坡 | `https://dashscope-intl.aliyuncs.com` | +- **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**：图像文字提取与结构化抽取。 -百炼还推出了[业务空间](workspace.md)专属域名，建议迁移以获得更好的推理性能与稳定性。 +### 文本向量与排序 -### 常用调用参数 - -- `model`（string，必选）：指定模型名称。 -- `prompt` / `messages`（必选）：输入内容，单轮对话用 `prompt`，多轮对话用 `messages` 数组。 -- `stream`（bool，可选）：是否开启流式输出。 -- `api_key`（string，可选）：显式指定 [API Key](api-key.md)，优先级高于环境变量。 +DashScope SDK 支持调用文本向量模型（如 text-embedding-v4）将文本转换为数值向量，也支持通过排序模型（如 qwen3-rerank）对候选文档进行相关性排序，广泛应用于语义搜索和 RAG 场景。 ## 与 [OpenAI 兼容接口](openai-compatible-interface.md)的对比 -| 维度 | DashScope SDK | OpenAI 兼容 SDK | +| 维度 | DashScope SDK | OpenAI 兼容接口 | | --- | --- | --- | -| 功能完整度 | 最全，支持全部原生参数和插件 | 受 OpenAI 协议约束，部分参数不暴露 | -| 迁移成本 | 需学习 DashScope API 结构 | 改三个参数即可复用现有 OpenAI 代码 | -| 模型覆盖 | 全部百炼模型 | 大部分模型（Qwen-Audio 等除外） | -| 生态兼容 | 百炼原生 | 可复用 OpenAI 生态工具链 | +| 功能完整度 | 最全，支持百炼全部参数和插件 | 保证协议一致性，可能不暴露全部百炼参数 | +| 迁移成本 | 需学习百炼原生 API | 可直接复用现有 OpenAI 代码和生态工具 | +| 语言支持 | Python、Java | Python、Java、Node.js、Go | +| 内置工具 | 按各接口自行定义 | Responses 接口内置联网搜索、代码解释器等 | + +如果项目已有 OpenAI SDK 集成且无需百炼专属参数，使用 OpenAI 兼容接口迁移成本更低；如果需要使用百炼平台的全部能力或调用仅 DashScope 支持的模型，建议使用 DashScope SDK。 -## 注意事项 +## 常见问题 -- 不同地域的 [API Key](api-key.md) 不通用，切换地域时需同步更换。 -- `qwen-deep-research` 当前仅支持 Python DashScope SDK，不支持 Java SDK。 -- Node.js 和 Go 语言目前无 DashScope 原生 SDK，建议使用 OpenAI 兼容 SDK 或直接发起 HTTP 请求。 -- 设置环境变量后需重启 IDE 或终端窗口才能生效。 +- **环境变量不生效**：设置环境变量后需重启 IDE 或终端；使用 `sudo` 运行脚本时需加 `-E` 参数以继承用户环境变量。 +- **模型不可用**：确认模型名称拼写正确，注意大小写，不要混用开源社区名与百炼模型 ID。 +- **地域限制**：部分模型（如 qwen-deep-research）仅在特定地域可用，需使用对应地域的 API Key。 ## 关联主题页 -- [qwen api reference](../api/qwen-api-reference.md) -- [application call](../api/application-call.md) - [bailian application calling](../guides/bailian-application-calling.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) +- [vector and sort](../api/vector-and-sort.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 fd508fc..ded5950 100644 --- a/skills/bailian-docs-llm-wiki/wiki/concepts/function-calling.md +++ b/skills/bailian-docs-llm-wiki/wiki/concepts/function-calling.md @@ -1,52 +1,74 @@ -# 函数调用 +# 函数调用（Function Calling） -函数调用（Function Calling）是大模型根据用户意图自动选择并调用外部工具（API、代码、数据库等），再将工具返回结果纳入上下文继续生成回复的能力。它是构建智能体、[工作流](workflow.md)和多工具协同场景的核心机制，使大模型能够突破自身在获取实时信息、精确计算和操作外部系统上的局限。 +函数调用（Function Calling）是大模型与外部工具交互的核心机制：开发者在请求中声明可用的函数（工具）定义，模型根据用户输入自主判断是否需要调用某个函数，并输出结构化的调用参数，由应用侧执行后将结果回传模型以生成最终回答。 -## 在百炼平台的使用方式 +## 工作原理 -百炼平台在多个层次提供函数调用能力，开发者可按集成形态和接口协议选择： +函数调用的典型流程分为三步： -### 1. 通过模型 API 直接定义工具 +1. **声明工具**：开发者在 API 请求中通过 `tools` 字段传入函数名称、描述和参数 JSON Schema。 +2. **模型决策**：模型分析用户输入与工具描述，判断是否需要调用工具。如需调用，模型输出 `tool_calls`（包含函数名与参数），而非直接生成文本回答。 +3. **执行与回传**：应用侧根据 `tool_calls` 执行实际函数，将返回结果以 `tool` 角色消息追加到对话历史，再次请求模型生成最终回答。 -在 OpenAI 兼容 Chat Completions 接口中，通过请求体的 `tools` 字段按 OpenAI function call 协议自定义工具 schema，模型在响应中返回 `tool_calls`，调用方执行后回传结果，模型继续生成。DashScope 原生接口对参数支持最完整，适合需要最全采样参数或业务字段的场景。Anthropic 兼容 Messages 接口同样支持思考（thinking）与工具调用。 +模型本身不执行函数，仅负责决策和参数生成；实际执行完全在应用侧完成。 -> 仅 OpenAI 兼容 Responses 接口内置联网搜索、代码解释器、网页内容提取等工具，开箱即用；Chat Completions 与 Messages 接口如需这些能力，需自行定义工具或通过协议接入。 +## 在百炼平台的使用场景 -### 2. 通过插件调用 +### OpenAI 兼容 Chat Completions 接口 -百炼插件本质上是「工具集合」，一个插件下可包含多个工具。模型根据用户输入、工具名称与工具描述判断是否调用、调用哪个工具，应用内部完成调用后将结果与用户内容合并再次输入模型。插件支持智能体应用、[工作流](workflow.md)应用与 Assistant API 三种调用形态，每个智能体最多可添加 10 个工具。 +通过标准 `tools` 和 `tool_choice` 字段定义函数，支持非流式与流式调用。开发者只需将 `api_key`、`base_url`、`model` 替换为百炼的值，即可复用现有 OpenAI function call 代码。支持的模型包括 Qwen 系列商业版与开源版、DeepSeek、Kimi、GLM 等。 -### 3. 通过 MCP 服务 +### OpenAI 兼容 Responses 接口 -模型上下文协议（MCP）提供统一的标准协议接入外部工具。智能体根据输入对话自动判断是否调用 MCP 服务，单个智能体最多同时添加 5 个 MCP 服务。[工作流](workflow.md)中每个 MCP 节点只能使用一个工具，需手动指定输入参数并把输出传递到下一个节点。MCP 服务不能在直接调用千问 API 时接入，只能在智能体或工作流应用中使用。 +Responses 接口在函数调用基础上进一步内置了联网搜索、代码解释器、网页内容提取等工具，开箱即用，无需自行定义。平台自动管理对话历史，简化了多轮工具调用的上下文维护。 -### 4. 在实时多模态与托管智能体中 +### Anthropic 兼容 Messages 接口 -Qwen-Omni-Realtime API 通过 WebSocket 长连接支持工具调用（Function Calling），与语音、视频、图像交互融合。Managed Agents API 由平台托管会话、沙箱与工具执行，开发者通过 Agent、Environment、Skill、Session 等资源管理工具调用生命周期，无需自建调度与执行基础设施。 +兼容 Anthropic Messages API 的工具调用协议，支持 thinking 与 tool use，适合从 Anthropic 生态迁移的开发者。 + +### DashScope 原生接口 + +百炼原生接口提供最完整的参数支持，适合需要使用全部采样参数、插件或业务字段的场景。 + +### 插件系统 + +百炼插件本质上是对函数调用的平台级封装。每个插件包含一个或多个工具，在智能体应用中由模型自动判断是否调用。支持官方插件（如代码解释器、夸克搜索、计算器）、三方插件和自定义插件。单个智能体应用最多可添加 10 个工具。 + +### MCP 服务 + +模型上下文协议（MCP）为函数调用提供了标准化的工具接入通道。通过 MCP，智能体可接入海量第三方工具而无需逐一编写接口。单个智能体最多同时添加 5 个 MCP 服务。 + +### 实时[多模态](multimodal.md)交互 + +Qwen-Omni-Realtime API 在 WebSocket 长连接中支持函数调用。模型在实时语音对话过程中可触发工具调用，客户端执行后通过 `conversation.item.create` 回传结果，再发送 `response.create` 让模型继续生成响应。 + +### Managed Agents API + +托管智能体运行时中，函数调用通过 Event 机制实现。用户消息、工具调用回执、函数执行结果等均以事件形式在会话中流转，支持 SSE 流式推送。 ## 关键参数与配置 -- **`tools` / `tool_choice`**：在 Chat Completions 与 Messages 接口中定义可用工具及调用策略（`auto`、`required`、指定函数名等）。 -- **`model`**：不同模型对工具调用的兼容性有差异，Qwen 系列中 `qwen-turbo` / `qwen-plus` / `qwen-max` / `qwen-vl-max` / `qwen-vl-plus` 均支持插件调用；最新兼容性以控制台实际执行结果为准。 -- **工具 ID**：通过 API 调用插件工具时需正确传递工具 ID（如 `calculator`、`code_interpreter`），可在插件详情页「插件工具」下获取。 -- **MCP 配置**：`mcpServers` 结构中 `type`（`stdio` / `streamable-http`）、`command`/`args`、`url`、`env` 等决定服务部署与连接方式。 -- **提示词**：模型需明确指令才能准确调用工具，建议在提示词中写明工具名称与能力；若仍无效可更换更强的推理模型（如千问 3 系列）。 +| 参数 | 说明 | +| --- | --- | +| `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` | 是否允许模型在单次响应中并行调用多个函数 | -## 限制和注意事项 +## 注意事项 -- **功能完整度差异**：兼容接口为保证协议一致性，可能不暴露百炼原生的全部参数；如需最全工具相关参数建议改用 DashScope 原生接口。 -- **对话历史管理**：仅 Responses 接口自动维护历史，迁移到其他接口时需自行管理上下文长度，避免超出模型[上下文窗口](context-window.md)。 -- **Token 消耗增加**：调用工具会将工具返回内容作为上下文传入模型，导致输入 Token 增加，并可能间接增加输出 Token，需关注计费与限流。 -- **调用准确性依赖提示词**：模型需明确指令才能准确调用工具，建议在提示词中写明工具名称与能力；若仍无效可更换更强的推理模型。 -- **网络与本地资源**：MCP 服务托管在函数计算 FC，无固定出口公网 IP，无法访问用户本地数据库；Python 代码解释器不支持对外访问网络及上传本地文件。 +- **Token 消耗**：工具定义和工具返回结果都会占用上下文窗口中的 Token，工具数量较多时需注意输入 Token 的增长。 +- **模型兼容性**：不同模型对函数调用的支持程度不同，建议使用 Qwen-Plus、Qwen-Max 等较强的推理模型以获得更准确的调用决策。 +- **描述质量**：函数名称和描述的清晰度直接影响模型的调用准确性，建议在描述中明确说明函数用途、参数含义和返回值格式。 +- **接口差异**：Responses 接口内置工具开箱即用，Chat Completions 和其他接口需自行定义工具；从不同平台迁移时应先确认目标接口对 `tools` 参数的支持情况。 ## 关联主题页 -- [qwen api reference](../api/qwen-api-reference.md) - [omni realtime api](../api/omni-realtime-api.md) -- [model context protocol](../guides/model-context-protocol.md) +- [qwen api reference](../api/qwen-api-reference.md) - [plug in](../guides/plug-in.md) -- [managed agents api](../api/managed-agents-api.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 de4f985..c3c3f0c 100644 --- a/skills/bailian-docs-llm-wiki/wiki/concepts/multimodal.md +++ b/skills/bailian-docs-llm-wiki/wiki/concepts/multimodal.md @@ -1,71 +1,74 @@ # 多模态 -多模态是指模型同时处理和生成文本、图像、音频、视频、3D 等多种信息形态的能力。百炼平台围绕多模态提供了从理解到生成的完整模型矩阵和 API 体系，开发者可按业务场景灵活组合不同模态的能力。 +多模态（Multimodal）指模型同时处理和生成多种信息形态（文本、图像、音频、视频、3D 等）的能力。百炼平台围绕多模态提供了从理解、生成到检索排序的完整模型矩阵，开发者可按场景选择对应的模型和 API。 -## 多模态能力矩阵 +## 百炼平台的多模态能力谱 -百炼平台的多模态能力按输入/输出模态可分为以下几类： +百炼平台的多模态能力覆盖以下维度： -| 能力方向 | 输入模态 | 输出模态 | 代表模型/接口 | -|---------|---------|---------|-------------| -| 视觉理解 | 图像/视频 + 文本 | 文本 | qwen3.7-plus（支持图像分析、最长 2 小时视频理解） | -| 实时多模态交互 | 语音/视频/图像 | 语音 + 文本 | Qwen-Omni-Realtime 系列 | -| 图像生成与编辑 | 文本/图像 | 图像 | 万相 2.7、Z-Image、千问-文生图 | -| 视频生成与编辑 | 文本/图像/音频/视频 | 视频 | 万相 2.7、HappyHorse、PixVerse、Vidu、可灵 | -| 3D 模型生成 | 文本/图像 | GLB 模型 | Tripo-H3.1、Tripo-P1.0 | -| 语音合成 | 文本 | 音频 | CosyVoice、MiniMax-speech | -| 数字人/人像动画 | 图像 + 音频 | 视频 | wan2.2-s2v、AnimateAnyone、EMO | +| 维度 | 典型场景 | 代表模型 | +|------|----------|----------| +| 多模态理解 | 图像分析、视频理解、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 | + +## 多模态理解 + +视觉理解模型接受图像或视频作为输入，与文本提示配合完成分析、问答、OCR 等任务。推荐从 qwen3.7-plus 开始——它支持 1M 上下文、最长 2 小时视频输入、每张图片最高 1600 万像素，同时具备 Function Calling 和结构化输出能力。图像 Token 计算公式为 `h x w / (32 x 32) + 2`。 ## 实时多模态交互 -Qwen-Omni-Realtime 系列通过 WebSocket 长连接实现低延迟的语音、视频、图像实时对话，是百炼平台最具代表性的多模态能力之一。 +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.5-omni-realtime`：最新版本，支持语义 VAD、联网搜索、静默超时主动引导 -- `qwen3-omni-flash-realtime`：支持回复风格控制 -- `qwen-omni-turbo-realtime`：轻量版，部分参数不可调 +## 多模态生成 -**交互模式**： -- **VAD 模式**（默认）：服务端自动检测语音起止，适合自然对话。关键参数包括 `threshold`（灵敏度，默认 0.5）、`silence_duration_ms`（静音判定，默认 800ms）、`idle_timeout_ms`（静默超时，5000-30000ms） -- **Manual 模式**：客户端显式控制音频提交与响应触发，适合按下即说场景 +### 图像生成 -**接入地址**：`wss://dashscope.aliyuncs.com/api-ws/v1/realtime`（北京），新加坡使用[业务空间](workspace.md)专属域名。 +百炼提供千问（Qwen-Image）、万相（Wan/Wanx）、Z-Image 等多个图像生成模型系列。wan2.7-image-pro 支持文生图最高 4K 输出、文字渲染和角色一致性；z-image-turbo 速度快且成本低，适合只需生成不需编辑的场景；qwen-image-2.0-pro 支持负向提示词和多张变体。 -## 图像生成与编辑 +### 视频生成 -百炼提供多层次的图像多模态能力： +视频生成 API 覆盖文生视频、图生视频、参考生视频、视频编辑、数字人等场景，底层模型包括万相（Wan）、HappyHorse、Pixverse、Vidu、Kling 等。所有接口采用[异步调用](async-invocation.md)模式（创建任务 → 轮询获取），单次生成通常耗时 1-5 分钟。 -- **通用文生图**：万相 2.7（推荐）、Z-Image、千问-文生图，支持中文语义、多尺寸、风格控制 -- **图像编辑**：万相-通用图像编辑 2.5/2.7，支持按自然语言指令局部修改 -- **创意工具**：虚拟模特、AI 试衣、创意海报、图像背景生成等垂类接口 +### 3D 生成 -调用协议分两种：OpenAI 兼容模式（同步）和 DashScope 原生异步模式（提交任务 → 轮询结果）。 +基于 Tripo 模型实现文生 3D、单图生 3D 和多图生 3D，产出带 PBR 材质贴图的 GLB 模型。同样采用[异步调用](async-invocation.md)模式，仅限北京地域使用。 -## 视频生成 +## 多模态检索与排序 -视频生成全部采用异步调用模式，统一流程为创建任务后轮询 `task_id` 获取结果，处理时间通常 1-5 分钟。 +多模态向量模型（qwen3-vl-embedding）将文本、图像和视频映射到同一语义空间，支持跨模态检索。向量类型分为独立向量（逐项对比）和融合向量（综合理解多模态内容）。 -**主要能力**：文生视频、图生视频（首帧/首尾帧）、参考生视频（保持角色一致性）、视频编辑、动作迁移、数字人。万相 2.7 是当前推荐版本，支持多模态输入（文本、图像、音频、视频混合）和多镜头叙事。 +多模态排序模型（qwen3-vl-rerank）可对文本、图片、视频混合的候选文档进行相关性排序，最多支持 100 条文本、40 张图片或 4 段视频的单次排序请求，适用于 RAG 流程中的精排阶段。 -## 3D 生成 +## 调用方式差异 -基于 Tripo 模型，支持文生 3D、单图生 3D、多图生 3D，输出 GLB 格式 PBR 材质模型。同样采用异步调用，建议轮询间隔 15 秒。仅限华北2（北京）地域。 +不同多模态能力的调用方式有所不同： -## 关键开发要点 +| 能力类型 | 调用方式 | 响应模式 | +|----------|----------|----------| +| 多模态理解（视觉） | [OpenAI 兼容接口](openai-compatible-interface.md) / [DashScope SDK](dashscope-sdk.md) | 同步流式 | +| 实时交互 | WebSocket 长连接 | 双向实时 | +| 图像/视频/3D 生成 | HTTP REST + 异步头 | 异步轮询 | +| 向量与排序 | [OpenAI 兼容接口](openai-compatible-interface.md) / [DashScope SDK](dashscope-sdk.md) | 同步 | -1. **协议选择**：实时交互走 WebSocket；图像/视频/3D 生成多为异步 REST（`X-DashScope-Async: enable`）；部分图像接口支持 OpenAI 兼容同步调用 -2. **鉴权统一**：所有接口使用 `Authorization: Bearer `，[API Key](api-key.md) 在百炼控制台获取 -3. **图片传输**：输入支持公网 URL 或 Base64，输出为临时 URL（需及时下载） -4. **Prompt 技巧**：不同模态的 Prompt 设计有各自最佳实践——文生图侧重「主体 + 场景 + 风格」，文生视频增加「运动 + 运镜」，万相 2.7 还支持多镜头分镜描述 -5. **地域限制**：3D 生成、部分第三方视频模型（PixVerse、Vidu、可灵）仅限北京地域 +开发者在接入多模态能力时需注意：模型、Endpoint URL 与 API Key 必须属于同一地域，跨地域调用会失败。推荐使用[业务空间](workspace.md)专属域名（`{WorkspaceId}.cn-beijing.maas.aliyuncs.com`）以获得更好的性能与稳定性。 ## 关联主题页 - [omni realtime api](../api/omni-realtime-api.md) - [model experience](../guides/model-experience.md) -- [image generation](../api/image-generation.md) - [video generation api](../api/video-generation-api.md) -- [use cases](../guides/use-cases.md) +- [image generation](../api/image-generation.md) - [3d generation](../api/3d-generation.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 aa70503..dd1c83d 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,56 @@ # OpenAI 兼容接口 -OpenAI 兼容接口是阿里云百炼平台提供的一组遵循 OpenAI API 协议规范的 RESTful 接口，开发者可直接使用 OpenAI 官方 SDK 或任何兼容 OpenAI 协议的客户端工具接入百炼模型服务，通常只需替换 `api_key`、`base_url` 和 `model` 三个参数即可完成迁移。 +OpenAI 兼容接口是阿里云百炼平台提供的一组遵循 OpenAI API 协议规范的接口，开发者只需将 `api_key`、`base_url`、`model` 三个参数替换为百炼的值，即可复用现有 OpenAI SDK 和生态工具直接调用百炼模型服务，实现最低成本的迁移接入。 -## 接口族与覆盖能力 +## 覆盖的接口类型 -百炼的 OpenAI 兼容接口不是单一端点，而是一组覆盖多种能力的接口族，调用路径统一位于 `compatible-mode/v1` 下： +百炼兼容的 OpenAI 接口覆盖以下能力，调用路径均挂载在 `compatible-mode/v1` 下： | 接口 | HTTP 路径 | 典型场景 | -|------|-----------|----------| -| Chat Completions | `POST /chat/completions` | 多轮对话、function call、流式输出 | +| --- | --- | --- | +| Chat Completions | `POST /chat/completions` | 多轮对话、function call、[流式输出](streaming.md) | | 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 接口是其演进版本，内置联网搜索、代码解释器和网页内容提取，并通过 `previous_response_id` 自动维护上下文。 +其中 Chat Completions 是最常用的接口，支持 Qwen 全系列、DeepSeek、Kimi、GLM、MiniMax 等模型；Responses 接口作为 Chat Completions 的演进版本，额外内置联网搜索、代码解释器和网页内容提取，并由平台自动管理对话历史。 -## 使用场景 +## 接入三要素 -### SDK 与代码迁移 +所有兼容接口的迁移都围绕以下三个参数： -已有 OpenAI SDK 代码只需修改三个参数即可切换到百炼： +- **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` 等。 + +### 各地域 Base URL + +| 地域 | Base URL | +| --- | --- | +| 华北2（北京） | `https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1` | +| 新加坡 | `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 接口） | + +### 订阅套餐专属 Base URL + +| 方案 | Base URL | +| --- | --- | +| Token Plan 团队版 | `https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1` | +| Coding Plan | `https://coding.dashscope.aliyuncs.com/v1` | + +## 调用示例 + +以 Python 为例，使用 OpenAI SDK 调用百炼 Qwen 模型： ```python -from openai import OpenAI import os +from openai import OpenAI client = OpenAI( api_key=os.getenv("DASHSCOPE_API_KEY"), @@ -37,61 +60,25 @@ completion = client.chat.completions.create( model="qwen3.7-plus", messages=[{"role": "user", "content": "你是谁？"}] ) +print(completion.choices[0].message.content) ``` -### 客户端与开发工具接入 - -Claude Code、Cursor、Continue、Cline、Cherry Studio 等 AI 编程工具和桌面客户端均通过 OpenAI 兼容协议接入百炼。配置时在各工具的设置文件中将 Base URL 指向百炼的 `compatible-mode/v1` 端点，填入百炼 [API Key](api-key.md) 即可。 - -### 专用模型调用 - -除通义千问主对话模型外，翻译模型（qwen-mt-plus）、OCR 模型（qwen3.5-ocr）、意图理解模型（tongyi-intent-detect-v3）、界面交互模型（gui-plus）等专用模型同样支持通过 OpenAI 兼容接口调用。 - -## 关键参数与配置 - -### 鉴权三要素 - -| 参数 | 说明 | -|------|------| -| `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)详情页获取 | -| `model` | 模型名称，如 `qwen3.7-plus`、`qwen3.7-max`、`deepseek-v4-pro` 等 | - -### 各地域 Base URL - -| 地域 | Base URL | -|------|----------| -| 华北2（北京） | `https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1` | -| 新加坡 | `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` | - -> 弗吉尼亚地域使用固定域名，不带 `{WorkspaceId}`；其余地域均需替换为真实[业务空间](workspace.md) ID。 - -### [计费](billing.md)方案与域名差异 - -百炼提供按量[计费](billing.md)、Coding Plan、[Token](token.md) Plan 团队版三种方案，每种方案有独立的 Base URL 和 API Key，不能混用： - -- **按量[计费](billing.md)**：使用上述业务空间专属域名 -- **Coding Plan**：`https://coding.dashscope.aliyuncs.com/v1` -- **[Token](token.md) Plan 团队版**：`https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1` - -## 与其他接口的关系 +Node.js 和 curl 的用法同理，只需替换对应的 api_key、base_url 和 model 即可。 -百炼同时提供三种协议风格的接口： +## 在不同场景中的使用 -- **OpenAI 兼容接口**：迁移成本最低，生态兼容最广，适合已有 OpenAI 代码的项目 -- **Anthropic 兼容接口**：兼容 Anthropic Messages API，Base URL 以 `/apps/anthropic` 结尾，适合使用 Claude Code 等 Anthropic 生态工具 -- **DashScope 原生接口**：功能集最完整，参数支持最丰富，适合需要使用百炼全部能力的场景 +- **模型直接调用**：通过 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 兼容接口为保证协议一致性，可能不暴露百炼原生的全部参数。如需最全的采样参数或插件能力，应使用 DashScope 原生接口。 -- 联网搜索、代码解释器、网页内容提取为 Responses 接口专属内置能力，Chat Completions 接口不内置这些工具。 -- 仅 Responses 接口自动维护对话历史，其他接口需由调用方在 `messages` 中手动管理上下文。 -- 部分模型（如 Qwen-Audio、qwen-deep-research）不支持 OpenAI 兼容协议，仅支持 DashScope SDK 调用。 -- API Key 与 Base URL 必须属于同一地域、同一计费方案，否则会报 `401` 错误。 +- **功能完整度**：兼容接口为保证协议一致性，可能不暴露百炼原生 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 错误。 ## 关联主题页 @@ -100,6 +87,7 @@ Claude Code、Cursor、Continue、Cline、Cherry Studio 等 AI 编程工具和 - [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) -- [omni realtime api](../api/omni-realtime-api.md) +- [token plan guide](../guides/token-plan-guide.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 601c825..15f0832 100644 --- a/skills/bailian-docs-llm-wiki/wiki/concepts/rag.md +++ b/skills/bailian-docs-llm-wiki/wiki/concepts/rag.md @@ -1,77 +1,79 @@ # 检索增强生成（RAG） -检索增强生成（Retrieval-Augmented Generation，RAG）是一种让大模型在生成回答前先从外部知识源中检索语义相关内容的技术，从而弥补模型训练数据的滞后性，提升回答的准确性和时效性。在百炼平台中，RAG 是知识库、[智能体应用](agent-application.md)和工作流应用的核心底层能力。 +检索增强生成（Retrieval-Augmented Generation，RAG）是一种将外部知识检索与大模型生成相结合的技术范式，通过在推理时动态检索相关文档片段并注入上下文，使大模型能够基于私有数据和最新信息生成更准确的回答。百炼平台以 RAG 为核心技术构建了知识库服务体系，覆盖从数据导入、向量化、检索召回到问答生成的完整链路。 -## 工作原理 +## 核心流程 -RAG 的典型流水线包含三个阶段： +百炼 RAG 的标准流水线分为四个阶段： -1. **索引（Indexing）**：将文档经过解析、切片后，通过向量模型转换为数值向量并存入向量索引。 -2. **检索（Retrieval）**：用户提问时，将查询文本同样向量化，从索引中召回语义最相关的文档片段，并可通过排序模型（Rerank）进行二次精排。 -3. **生成（Generation）**：将召回的知识片段与用户问题拼接为上下文，送入大模型生成最终回答。 +1. **文档解析与切片**：将非结构化文档（PDF、Word、Markdown 等）解析为文本，按语义切分为片段（推荐智能切分，单切片上限 6,000 Token）。 +2. **向量化**：使用 Embedding 模型将切片转换为数值向量并存入向量索引。推荐 text-embedding-v4（Qwen3-Embedding 系列，支持 100+ 语种，维度可选 64–2048）。 +3. **检索与排序**：接收用户 Query 后，经 Query 改写 → 向量 + 关键词混合检索 → Rerank 排序 → 加权返回相关切片。 +4. **生成回答**：将检索到的切片与用户问题拼接为 Prompt，送入大模型生成最终回答。 -## 在百炼平台中的使用场景 +## 在百炼平台的使用方式 -### 知识库集成 +### 知识库服务（托管式） -百炼知识库是 RAG 能力的主要载体，支持文档搜索、数据查询、图片问答、音视频搜索四种类型。创建知识库后，可通过以下方式将其集成到业务中： +在百炼控制台创建知识库，平台托管全部 RAG 流程。支持四种知识库类型： -- **[智能体应用](agent-application.md)**：在应用配置页添加知识库，设置相似度阈值和权重。Agent 2.0 架构下，知识库作为工具由智能体自主规划调用。 -- **工作流应用**：将知识库节点拖入画布，配置输入变量和 TopK 参数，连接大模型节点。 -- **API 调用**：通过百炼 SDK 直接调用知识检索或知识问答服务。 +- **文档搜索类**：企业文档、产品手册等非结构化数据问答 +- **数据查询类**：结构化 Excel/CSV，支持 NL2SQL +- **图片问答类**：基于 multimodal-embedding-v1 的视觉检索 +- **音视频搜索类**：语音识别 + 视频帧提取，按时间轴结构化 -### 文件问答 +平台提供两条独立服务线： +- **知识检索**（`POST /api/v1/indices/knowledge/search`）：仅返回排序后的切片，适合自定义生成流程 +- **知识问答**（`POST /api/v2/apps/knowledge/chat`）：端到端问答，支持极速模式和 Agentic 多轮规划搜索，通过 SSE [流式输出](streaming.md) -[智能体应用](agent-application.md)支持切片检索（RAG）模式的文件问答：上传的文件被切分为片段，提问时检索最相关的切片，[Token](token.md) 消耗通常远小于全文引用模式，适合长文档问答和精确定位信息来源。 +### 框架集成（自建式） -### 多渠道接入 +通过开源框架在应用侧构建 RAG： -通过 AppFlow 或本地部署，RAG 应用可接入网站、企业微信、微信公众号、钉钉等渠道，实现基于私有知识库的智能客服和问答服务。 +- **LlamaIndex**（Python）：使用 `DashScopeCloudIndex` 创建云端知识库，`DashScopeCloudRetriever` 执行检索，支持 `SimilarityPostprocessor` 和 `DashScopeRerank` 后处理 +- **Spring AI Alibaba**（Java）：在 Spring Boot 3.x 中集成百炼知识库检索能力 +- **本地 RAG**：检索在本地执行，生成调用通义千问 API，适合需要灵活切分和自定义嵌入模型的场景 -### 框架集成 +### 渠道接入 -百炼支持通过主流开源框架构建 RAG 应用： - -- **LlamaIndex（Python）**：使用 `DashScopeCloudIndex` 创建云端知识库，通过 `as_retriever()` 或 `as_query_engine()` 实现检索与问答。 -- **Spring AI Alibaba（Java）**：在 Spring Boot 工程中集成百炼知识库检索能力，通过配置 [API Key](api-key.md) 和 Workspace ID 即可调用。 +RAG 应用可通过 AppFlow 无代码连接流接入网站、企业微信、微信公众号、钉钉等渠道。 ## 关键参数与配置 -### 索引阶段 +### 检索参数 -| 参数 | 说明 | -|------|------| -| 文档解析方式 | 电子文档解析（最快）、文档智能解析（识别插图）、大模型文档解析（深度理解图表）等 | -| 切片方式 | 推荐智能切分，基于语义相关性自适应切分，单切片最大 6,000 [Token](token.md) | -| 向量模型 | text-embedding-v4（最高 2048 维）、text-embedding-v3（最高 1024 维）等 | -| Meta 信息抽取 | 为切片附加元数据，支持常量、变量、大模型抽取、正则抽取四种方式 | +| 参数 | 取值范围 | 说明 | +| --- | --- | --- | +| 向量检索 TopK | 1–100（默认 50） | 向量语义召回切片数 | +| 关键词检索 TopK | 1–100（默认 50） | 关键词匹配召回切片数 | +| 排序模型 | qwen3-rerank / qwen3-rerank(hybrid) / qwen3-vl-rerank | [多模态](multimodal.md)库须选 vl-rerank | +| 相似度阈值 | 0.01–1.0 | 过滤低分切片，过高会丢弃全部结果 | +| 最大召回数量 | 1–20 | 最终返回切片数 | -### 检索阶段 +### 向量模型选择 -| 参数 | 说明 | -|------|------| -| 召回片段数（TopK） | 越大参考越多但噪声可能增加，单次最大召回 20 个切片 | -| 相似度阈值 | 越高越严格（噪声减少但可能丢失相关内容），设为 0 时不剔除 | -| 排序模型 | 推荐 qwen3-rerank（文本）或 qwen3-vl-rerank（[多模态](multimodal.md)），对召回结果二次精排 | -| 混合检索 | 支持向量检索 + 关键词检索组合，提升召回覆盖率 | -| Query 改写 | 根据多轮对话历史自动补全用户查询，需在创建知识库时开启 | +| 模型 | 向量维度 | 单行最大 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 | - | 视觉理解（富文本文档） | -### 生成阶段 +### 索引配置注意事项 -| 参数 | 说明 | -|------|------| -| 大模型选择 | qwen-max（性能优秀）、qwen-plus（均衡）、qwen-turbo（速度快成本低） | -| 检索模式 | 极速模式（单轮检索直接生成）或多轮智能模式（Agentic，自动意图识别和知识库路由） | +- **Meta 信息抽取**和**多轮对话改写**在知识库创建后无法更改，必须在创建时配置 +- 切片方式推荐智能切分，基于语义相关性自适应选择切片点 +- 多知识库权重仅在同类型知识库之间生效 ## 效果优化 -当 RAG 效果不理想时，可从以下维度排查： +当召回不完整或回答不准确时，建议按以下方向排查： -- **检索无效**：补充缺失内容、优化源文件排版、统一实体表述、启用多轮对话改写。 -- **召回不相关**：使用标签过滤或元数据进行结构化搜索。 -- **切片不完整**：采用智能切分策略，人工检查异常切片。 -- **重排不佳**：适当降低相似度阈值、增大召回片段数。 -- **模型理解有误**：更换更强模型（如从开源版换到千问 Max/Plus）、优化系统提示词。 +1. **补充知识**：优化源文件排版，统一实体表述，启用多轮对话改写 +2. **改善召回**：为文件添加标签或 Meta 元数据做前置过滤 +3. **优化切片**：改用智能切分，人工修正异常切片 +4. **调整排序**：通过命中测试反复调整相似度阈值与 K 值；对列举/总结/比较类问题适当提高 K +5. **升级模型**：生成模型可选 qwen-max（效果优先）、qwen-plus（均衡）、qwen-turbo（速度优先） ## 关联主题页 @@ -80,6 +82,6 @@ RAG 的典型流水线包含三个阶段： - [use cases](../guides/use-cases.md) - [frameworks](../api/frameworks.md) - [vector and sort](../api/vector-and-sort.md) -- [llm application](../guides/llm-application.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 new file mode 100644 index 0000000..9de23d0 --- /dev/null +++ b/skills/bailian-docs-llm-wiki/wiki/concepts/streaming.md @@ -0,0 +1,92 @@ +# 流式输出 + +流式输出（Streaming）是指模型在生成过程中逐步返回部分结果，而非等待全部生成完毕后一次性返回。该机制显著降低了用户感知的首字延迟，适用于需要实时展示生成内容的交互场景。 + +## 工作原理 + +在非流式模式下，客户端发送请求后需等待模型完成全部推理，才能收到完整响应。流式模式下，服务端通过 Server-Sent Events（SSE）或 WebSocket 将生成结果拆分为多个数据块（chunk）逐个推送，客户端可边接收边渲染，实现打字机效果。 + +## 适用场景 + +百炼平台在多个层面支持流式输出： + +- **模型 API 调用**：通过 OpenAI 兼容的 Chat Completions 接口或 DashScope 原生接口调用 Qwen 系列模型时，均可启用流式输出。 +- **应用调用**：通过 Responses API（OpenAI 兼容模式）或 DashScope API 调用智能体应用和工作流应用时，支持流式返回生成内容。 +- **实时[多模态](multimodal.md)交互**：Qwen-Omni-Realtime API 基于 WebSocket 长连接实现实时语音/视频对话，本身即为流式交互架构，响应以事件流形式持续推送。 + +## 关键参数与配置 + +### HTTP 接口（Chat Completions / DashScope / 应用调用） + +| 参数 | 类型 | 说明 | +|------|------|------| +| `stream` | boolean | 设为 `true` 启用流式输出，默认 `false` | +| `stream_options.include_usage` | boolean | 设为 `true` 时，流式响应的最后一个 chunk 中包含 token 用量统计 | + +### 工作流应用的额外要求 + +调用工作流应用时，若使用 Responses API 并设置 `stream=true`，需在百炼控制台的工作流编辑器中，对结束节点或流程输出节点启用「流式输出」开关，并重新发布应用，否则流式不会生效。 + +### 实时[多模态](multimodal.md)接口（WebSocket） + +Qwen-Omni-Realtime API 的响应天然以事件流形式返回，无需额外设置 `stream` 参数。服务端通过 `response.audio.delta`、`response.text.delta` 等事件持续推送音频和文本增量数据。 + +## 使用示例 + +### Python（OpenAI 兼容 Chat Completions） + +```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" +) + +stream = client.chat.completions.create( + model="qwen-plus", + messages=[{"role": "user", "content": "介绍一下流式输出的原理"}], + stream=True, + stream_options={"include_usage": True} +) + +for chunk in stream: + if chunk.choices and chunk.choices[0].delta.content: + print(chunk.choices[0].delta.content, end="", flush=True) +``` + +### Python（DashScope 应用调用） + +```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 +) + +for response in responses: + if response.output and response.output.text: + print(response.output.text, end="", flush=True) +``` + +## 注意事项 + +- [异步调用](async-invocation.md)（`background=true`）与流式输出互斥，不能同时启用。 +- 流式模式下，每个 chunk 的 `finish_reason` 字段为 `null`，仅最后一个 chunk 返回 `stop` 或其他终止原因。 +- 使用流式输出时，建议客户端实现超时和断线重连机制，以应对网络不稳定情况。 +- 不同兼容接口（OpenAI Chat Completions、Responses、Anthropic Messages、DashScope）均支持 `stream` 参数，用法一致。 + +## 关联主题页 + +- [application call](../api/application-call.md) +- [omni realtime api](../api/omni-realtime-api.md) +- [qwen api reference](../api/qwen-api-reference.md) +- [bailian application calling](../guides/bailian-application-calling.md) +- [toolkits and frameworks](../api/toolkits-and-frameworks.md) + + diff --git a/skills/bailian-docs-llm-wiki/wiki/concepts/token.md b/skills/bailian-docs-llm-wiki/wiki/concepts/token.md index 1738e5a..356511c 100644 --- a/skills/bailian-docs-llm-wiki/wiki/concepts/token.md +++ b/skills/bailian-docs-llm-wiki/wiki/concepts/token.md @@ -1,72 +1,74 @@ -# Token +# Token 计量 -Token 是大语言模型处理文本的基本计量单位，也是百炼平台模型调用[计费](billing.md)的核心度量。模型在推理时将输入文本拆分为 Token 序列进行处理，并以 Token 为单位生成输出；平台据此分别统计输入 Token 和输出 Token 的消耗量，作为[计费](billing.md)依据。 +Token 是百炼平台中衡量文本处理量的基本单位，用于模型推理计费、用量统计、吞吐量管理等核心场景。一个 Token 大致对应一个中文字或一个英文单词片段，实际切分由模型的分词器决定。 -## 基本概念 +## 计费中的 Token -在大语言模型中，Token 并非严格对应一个汉字或一个英文单词。对于中文文本，一个 Token 通常对应 1-2 个汉字；对于英文文本，一个 Token 大约对应 3-4 个字符。模型的上下文窗口大小（如 32K、128K、256K）同样以 Token 为单位衡量。 +百炼平台的模型推理默认按量付费，核心计费维度就是输入 Token 和输出 Token： -百炼平台将 Token 分为两类进行独立计量： +- **输入 Token**：发送给模型的 [prompt](../guides/prompt.md)、上下文、系统指令等文本经分词后的 Token 总量。 +- **输出 Token**：模型生成的回复文本对应的 Token 总量。 +- **思考 Token**：部分模型（如开启深度思考模式）会产生额外的思考过程 Token，可能按独立单价计费。 -- **输入 Token**：用户发送给模型的 Prompt、系统指令、历史对话等内容所消耗的 Token 数量。 -- **输出 Token**：模型生成的回复文本所消耗的 Token 数量。 +不同模型的输入/输出单价差异较大。以千问系列为例，qwen3-max 在 32K 以内输入单价为 2.5 元/百万 Token，输出为 10 元/百万 Token；超过 32K 后阶梯上升。部分模型还支持 Batch 调用（输入输出均半价）和上下文缓存（输入 Token 享折扣），两者不可同时生效。 -## Token 与[计费](billing.md) +模型训练同样按 Token 计费，费用等于训练数据 Token 总量乘以循环次数再乘以训练单价。 -百炼平台对文本生成类模型按输入和输出 Token 分别计价，不同模型的单价差异较大。以千问系列为例： +## Token 与用量统计 -| 模型 | 输入单价（每百万 Token） | 输出单价（每百万 Token） | -|------|------------------------|------------------------| -| qwen3.7-max | 12 元 | 36 元 | -| qwen3.7-plus | 2 元 | 8 元 | -| qwen3.6-flash | 更低 | 更低 | +百炼按[业务空间](workspace.md)维度统计 Token 消耗，开发者可在控制台的**模型用量**页面查看各模型的 Token 用量汇总，数据延迟约 1 小时。不同模型类型的统计单位有所不同： -关键计费规则： +| 模型类型 | 统计单位 | +|---------|---------| +| 大语言模型（文本生成/深度思考/视觉理解） | Token | +| 全模态模型 | Token | +| 向量模型 | Token（按输入文本） | +| 语音模型 | 秒、字符或 Token（视模型而定） | +| 图像生成模型 | 张 | +| 视频生成模型 | 秒 | -- **阶梯计费**：部分模型（如 qwen3-max、qwen-plus）按单次请求的输入 Token 总量所在区间确定单价，同一请求内所有 Token 按对应阶梯统一结算。 -- **Batch 调用优惠**：支持 Batch 的模型，输入和输出 Token 单价均为实时推理的 50%。 -- **上下文缓存折扣**：命中缓存的输入 Token 可享受折扣（如缓存命中部分按 20% 折算），但与 Batch 调用互斥。 -- **免费额度**：新用户开通百炼时自动获得各模型的免费 Token 额度，有效期 30-90 天。 +如需账号级 Token 总量，需在费用与成本页面导出账单查看。 -其他模型类型的计量单位有所不同：图像生成按张数计费，视频生成按秒数计费，语音模型视情况按时长、字符数或 Token 数计费。 +## 应用观测中的 Token 追踪 -## Token 消耗监控 +在应用观测功能中，每次调用的 Token 消耗会被自动采集并展示，包括： -百炼平台提供多层次的 Token 消耗监控能力： +- Token 总量（全部/输入/输出） +- 平均单次请求 Token 量 +- 平均首 Token 耗时（流式场景下衡量响应速度的关键指标） -- **用量统计**：在模型用量页面按[业务空间](workspace.md)维度汇总各模型的 Token 消耗，数据延迟约 1 小时，支持查看最近 30 天数据。 -- **模型监控**：提供 TPM（Tokens Per Minute）等实时性能指标，高级监控可达分钟级精度。监控看板包含平均单次请求 Token 量、Token 总量等指标。 -- **应用观测**：对[智能体应用](agent-application.md)、工作流应用等，可追踪每次调用的 Token 消耗（输入/输出），并按分钟级频率同步，支持按 Token 总量筛选调用记录。 -- **告警**：支持设置 Token 消耗阈值，异常时触发告警通知。 +开发者可按 Token 总量、输入 Token、输出 Token 等字段筛选调用记录，快速定位高消耗请求。 -## Token 与容量规划 +## 模型监控中的 Token 管理 -在生产环境中，TPM（Tokens Per Minute）是衡量模型推理吞吐能力的关键指标。百炼提供多种容量保障方案： +模型监控提供分钟级的 Token 追踪能力，在成本类监控指标中可查看平均单次请求调用量。结合 TPM（Tokens Per Minute）指标，开发者能评估模型的吞吐消耗趋势，及时发现异常用量。 -- **TPM 预留**：为指定模型预留专属 TPM 容量，按 kTPM（千 Token/分钟）预付费，预留容量内独享资源，超出部分自动降级为按量计费。 -- **PTU 预置吞吐部署**：通过预留资源保障特定 TPM 吞吐能力，支持长输入阶梯系数和前缀缓存折扣。 -- **模型单元部署**：支持 PD 分离模式，将 Prefill 和 Decode 拆分到不同节点以降低首 Token 延迟。 +## TPM 预留与吞吐管理 -## Token Plan 订阅服务 +TPM（Tokens Per Minute）是衡量模型推理吞吐量的核心指标。百炼支持 TPM 预留功能，开发者可为指定模型锁定专属吞吐量。影响实际 Token 容量消耗的关键参数包括： -百炼还提供 Token Plan 团队版订阅服务，采用 Credits 计量体系（本质上基于 Token 消耗换算），面向团队和企业用户。套餐按坐席购买，月度额度从 25,000 到 250,000 Credits 不等，支持文本生成和图像生成模型。Token Plan 使用专属 [API Key](api-key.md)（sk-sp-xxx 格式）和独立 Base URL，与按量计费体系完全隔离。 +- **缓存折扣**：命中缓存的输入 Token 按折扣系数消耗容量，不同模型折扣率不同（如千问系列 20%、DeepSeek-v4-Pro 8%）。 +- **长输入阶梯系数**：部分模型在输入超过一定长度后，Token 容量消耗系数会提升。 + +## Token Plan 订阅套餐 + +百炼提供 Token Plan 团队版和 Coding Plan 两类订阅套餐，以 Credits 或调用次数统一计量。Token Plan 中，Credits 消耗由模型类型、Token 用量、思考模式及工具调用等因素共同决定。套餐的抵扣顺序为：坐席月度额度 > 共享用量包 > 服务暂停。 ## 成本优化建议 -- 合理选择模型：简单任务使用 flash 级模型可大幅降低 Token 成本。 -- 利用上下文缓存：对高频相似请求启用前缀缓存，降低输入 Token 费用。 -- 使用 Batch 调用：对时效性要求不高的场景，Batch 调用可节省 50% Token 费用。 -- 购买节省计划或资源包：预估用量后通过承诺消费或预购 Token 获取折扣。 -- 开启免费额度用完即停：防止免费额度耗尽后产生意外的 Token 计费。 +- **善用免费额度**：开通百炼时自动发放的免费额度可抵扣模型实时推理的 Token 费用，有效期 30~90 天。 +- **选择合适的节省计划**：AI 通用型节省计划通过承诺月消费金额换取 Token 单价折扣，最高 5.3 折。 +- **利用上下文缓存**：重复的系统提示或长上下文可通过缓存降低输入 Token 费用。 +- **关注阶梯计费**：输入 Token 超过一定阈值后单价上升，合理控制上下文长度有助于降低成本。 +- **开启用完即停**：避免免费额度耗尽后产生意外的 Token 扣费。 ## 关联主题页 - [test 1](../guides/test-1.md) -- [token plan guide](../guides/token-plan-guide.md) -- [model monitoring](../guides/model-monitoring.md) -- [model deployment 1](../guides/model-deployment-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) -- [get started with models](../guides/get-started-with-models.md) +- [qwen api reference](../api/qwen-api-reference.md) diff --git a/skills/bailian-docs-llm-wiki/wiki/concepts/workspace.md b/skills/bailian-docs-llm-wiki/wiki/concepts/workspace.md index a38d328..d857522 100644 --- a/skills/bailian-docs-llm-wiki/wiki/concepts/workspace.md +++ b/skills/bailian-docs-llm-wiki/wiki/concepts/workspace.md @@ -1,63 +1,54 @@ # 业务空间 -业务空间（Workspace）是阿里云百炼平台中进行精细化权限管理、资源隔离和账单分账的最小管理单元。每个业务空间归属于特定地域，不能跨地域存在，各地域的默认业务空间也是相互独立的空间。 +业务空间（Workspace）是阿里云百炼平台进行精细化权限管理和账单分账的最小管理单元。每个业务空间按地域隔离，单个业务空间不能跨地域存在，各地域的默认业务空间也是独立的空间。 -## 核心定位 +## 核心作用 -业务空间在百炼平台中承担三个核心职责： +业务空间在百炼平台中承担以下职责： -- **权限隔离**：以业务空间为边界划分用户角色与资源访问权限，实现多地域、多用户的组织架构管控。 -- **资源管控**：对模型调用、模型训练、模型部署进行空间级的精细化授权和限流。 -- **成本分账**：用量统计按业务空间维度汇总，便于不同团队或项目独立核算费用。 +- **权限隔离**：以业务空间为边界划分用户角色与资源访问范围，实现多地域、多用户的组织架构管理。 +- **成本管控**：用量统计、费用概览、模型限流均按业务空间维度汇总，是账单分账的基础单元。 +- **资源归属**：API Key、应用、数据集、模型调用记录等资源均归属于特定业务空间。 -## 角色体系 +## 角色与权限体系 -每个业务空间内定义了三种角色，权限范围自上而下递减： +业务空间的权限管理围绕三种角色展开： | 角色 | 权限范围 | | --- | --- | -| 超级管理员 | 阿里云主账号或拥有 `AliyunBailianFullAccess` 策略的 RAM 用户，可跨空间管理用户、模型授权、限流和 [API Key](api-key.md) | -| 业务空间管理员 | 拥有该空间「权限管理」页面访问权限的 RAM 用户，可管理空间内用户与资源 | -| 普通用户 | 根据分配的权限使用被授权的空间、页面和资源 | +| **超级管理员** | 阿里云主账号或拥有 `AliyunBailianFullAccess` 策略的 RAM 用户，可跨空间管理用户、模型授权、限流和 API Key | +| **业务空间管理员** | 拥有特定业务空间「权限管理」页面访问权限的 RAM 用户，可管理该空间内的用户与资源 | +| **普通用户** | 根据分配的权限访问和使用被授权的空间、页面及资源 | -## 默认业务空间与子业务空间 +默认业务空间成员可查看所有业务空间的模型调用情况；子业务空间成员仅能查看当前空间数据，无法切换查看其他业务空间。 -- **默认业务空间**：每个地域自动创建，所有模型均可调用、调优和部署，无法设置模型调用限制、训练限制或部署限制。 -- **子业务空间**：由管理员手动创建，可对模型调用、训练、部署进行精细化授权，并设置请求数限流和 [Token](token.md) 限流。适合按环境（dev/test/prod）或业务线划分以实现权限隔离和成本管控。 +## 模型管控能力 -## 模型与 [API Key](api-key.md) 管理 +在非默认业务空间中，超级管理员可对模型进行三类精细化授权（默认业务空间无法设置这些限制）： -业务空间内可对模型进行三类精细化授权： +- **限制模型调用**：控制模型是否可在该空间调用（控制台与 API），并设置请求数限流和 Token 限流。 +- **限制模型训练**：控制模型是否可在该空间进行调优及调优后部署。 +- **限制模型部署**：控制模型是否可在该空间直接部署。 -- **限制模型调用**：控制模型是否可在该空间内调用（控制台和 API），并设置请求数和 [Token](token.md) 限流。 -- **限制模型训练**：控制模型是否可在该空间内进行调优及调优后部署。 -- **限制模型部署**：控制模型是否可在该空间内直接部署。 +## API Key 与业务空间 -单个 [API Key](api-key.md) 只能归属一个地域内的一个业务空间和一个用户，且不能转移。API Key 的可调用功能与模型限流继承归属业务空间的权限设置，不受用户控制台权限影响。将 RAM 用户移出业务空间会使其 API Key 失效（重新加入后恢复）。 +单个 API Key 只能归属一个地域内的一个业务空间和一个用户，且不能转移。API Key 的可调用功能与模型限流与归属业务空间的权限保持一致，不受用户控制台权限管理的影响。将 RAM 账号移出业务空间会使其 API Key 失效（重新加入后恢复），在 RAM 控制台删除账号则会使 API Key 永久失效。 -## 在不同场景中的使用 +## 监控与观测 -### 用量统计与监控 +- **模型监控**：系统自动采集主账号下所有业务空间的模型调用数据，监控列表按「模型 + 业务空间」维度生成。 +- **用量统计**：模型用量数据按业务空间维度统计，不支持按阿里云账号维度统计。如需账号级汇总，需通过费用与成本页面导出账单。 +- **应用观测**：应用观测范围限定于当前业务空间内已发布的应用，添加观测时需确认应用属于当前空间。 -模型用量数据按业务空间维度统计，不支持按阿里云账号维度汇总。模型监控列表按"模型 + 业务空间"维度生成，默认业务空间成员可查看所有空间的调用情况，子业务空间成员仅能查看当前空间数据。 +## 数据管理 -### 数据管理 +业务空间统一管理其下的大模型相关数据集（训练集和评测集），用于模型调优和评测。数据管理与数据处理能力仅适用于华北2（北京）地域。 -训练集和评测集统一归属于业务空间下管理，用于模型调优和评测。数据管理与数据处理能力仅适用于华北2（北京）地域。 +## 生产环境实践建议 -### 应用观测 - -应用观测功能监控业务空间内的[智能体应用](agent-application.md)、工作流应用和高代码应用的调用链路与指标。被观测应用必须属于当前业务空间且已发布。 - -### Prompt 工程 - -Prompt 模板、样例库等功能在业务空间内管理和关联。部分 Prompt 功能仅适用于特定地域，使用前需确认目标业务空间所在地域。 - -## 生产环境最佳实践 - -- **空间规划**：推荐按环境（dev/test/prod）划分业务空间实现隔离，或按业务线划分便于权限与成本管理。 -- **限流策略**：将主账号总配额按比例分配给各业务空间并预留缓冲。例如总配额 1000 QPM，可分配 prod 600 / test 200 / dev 100，预留 100。 -- **API Key 管理**：避免使用默认业务空间的 API Key（权限过大），为不同团队创建子业务空间并仅授权必要模型。 +- **空间规划**：推荐按环境（dev/test/prod）或按业务线划分业务空间，实现权限与成本的精细化管理。 +- **限流策略**：将主账号总配额按比例分配给各业务空间并预留缓冲。例如总配额 1000 QPM，可分配 prod 600、test 200、dev 100，预留 100。 +- **安全合规**：AI 安全护栏、模型监控、应用观测等功能建议使用主账号一次性开通，避免子账号权限不全导致开启失败。 ## 关联主题页 @@ -65,8 +56,7 @@ Prompt 模板、样例库等功能在业务空间内管理和关联。部分 Pro - [model monitoring](../guides/model-monitoring.md) - [model data overview](../guides/model-data-overview.md) - [security and compliance](../guides/security-and-compliance.md) -- [more about models](../api/more-about-models.md) -- [prompt](../guides/prompt.md) - [application monitoring](../guides/application-monitoring.md) +- [application call](../api/application-call.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 8e6501e..b3b8835 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/application-evaluation.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/application-evaluation.md @@ -147,3 +147,4 @@ + 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 384d6c9..29807b9 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/application-monitoring.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/application-monitoring.md @@ -116,3 +116,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 f138a89..bc0ce6c 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 @@ -25,9 +25,9 @@ > **注意**：OpenAPI 接口权限不通过[业务空间](../concepts/workspace.md)角色授予，必须由阿里云主账号在 RAM 控制台为 RAM 用户添加专用系统策略。 -## 业务空间权限管理 +## [业务空间](../concepts/workspace.md)权限管理 -百炼按地理区域划分资源和业务空间，**单个业务空间不能跨地域存在**，即使是各地域的默认业务空间，也是不同的空间。业务空间是精细化权限管理的最小单元，可管理以下维度（默认业务空间无法设置这些限制）： +百炼按地理区域划分资源和[业务空间](../concepts/workspace.md)，**单个[业务空间](../concepts/workspace.md)不能跨地域存在**，即使是各地域的默认业务空间，也是不同的空间。业务空间是精细化权限管理的最小单元，可管理以下维度（默认业务空间无法设置这些限制）： - **限制模型调用**：管理某个模型可否在该业务空间调用（控制台 & API），并设置该模型的请求数限流和 [Token](../concepts/token.md) 限流。默认业务空间所有模型均可调用且无法限流。 - **限制模型训练**：管理某个模型可否在该业务空间进行调优和调优后部署。默认业务空间所有支持调优的模型均可调优及部署。 @@ -125,3 +125,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 f9a3097..d9dc759 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 @@ -120,3 +120,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 589e4ea..6a6ade0 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/application-support.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/application-support.md @@ -79,3 +79,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 4d9d585..9abc5f8 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 @@ -95,3 +95,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 79587f4..c7bc575 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 @@ -183,3 +183,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 a8b2ad2..f4ad4ad 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 @@ -1,102 +1,116 @@ # data connection overview -数据连接是阿里云百炼平台管理外部数据源的统一入口。通过创建数据连接器，百炼应用可以安全地访问企业数据库、文档系统和对象存储中的数据，在对话中实时查询和引用这些数据。详细概念与操作流程参见[数据连接](../../raw/application-user-guide/data-connection-overview/data-connection.md)。 +数据连接是阿里云百炼平台管理外部数据源的统一入口。通过创建数据连接器，百炼应用可以安全地访问企业数据库、文档系统和对象存储中的数据，并在对话中实时查询和引用。平台提供了涵盖非结构化文档、结构化表格和多种数据库的连接器类型，满足不同数据接入场景。 ## 连接器类型 -数据连接器按数据存储和访问方式，分为**平台托管**与**流处理**两大类，共 7 种连接器类型： +数据连接器按数据的存储和访问方式分为**平台托管**和**流处理**两大类，详见[数据连接](../../raw/application-user-guide/data-connection-overview/data-connection.md)。 -| 类别 | 连接器类型 | 数据存储方式 | 适用场景 | -| --- | --- | --- | --- | -| 平台托管 | 文件 | 百炼平台或自有 OSS | 上传管理非结构化文档（PDF、Word、Markdown 等） | -| 平台托管 | 表格 | 百炼平台或自有 OSS | 导入和查询结构化表格数据（CSV、Excel 等） | -| 流处理 | MySQL | 数据保留在原数据库，实时访问 | 连接 MySQL 数据库，执行 SQL 查询 | -| 流处理 | PostgreSQL | 数据保留在原数据库，实时访问 | 连接 PostgreSQL 数据库，执行 SQL 查询 | -| 流处理 | PolarDB-X 2.0 | 数据保留在原数据库，实时访问 | 连接阿里云 PolarDB-X 2.0 分布式数据库 | -| 流处理 | 语雀 | 数据保留在语雀，实时访问 | 访问语雀文档和知识库 | -| 流处理 | OSS | 数据保留在 OSS，实时访问 | 访问对象存储中的文件 | +### 平台托管 -> **注意**：MySQL、PostgreSQL、PolarDB-X 2.0 三种数据库连接器仅通过**从 DMS 导入数据源**方式创建时才支持执行 SQL 查询；通过**创建自定义数据源**方式添加的连接器不支持直接执行 SQL。 +| 连接器类型 | 数据存储方式 | 适用场景 | +|-----------|-------------|---------| +| 文件 | 百炼平台或自有 OSS | 上传和管理非结构化文档（PDF、Word、Markdown 等） | +| 表格 | 百炼平台或自有 OSS | 导入和查询结构化表格数据（CSV、Excel 等） | + +### 流处理 + +| 连接器类型 | 数据存储方式 | 适用场景 | +|-----------|-------------|---------| +| MySQL | 数据保留在原数据库，实时访问 | 连接 MySQL 数据库，执行 SQL 查询（仅 DMS 导入方式支持） | +| PostgreSQL | 数据保留在原数据库，实时访问 | 连接 PostgreSQL 数据库，执行 SQL 查询（仅 DMS 导入方式支持） | +| PolarDB-X 2.0 | 数据保留在原数据库，实时访问 | 连接阿里云 PolarDB-X 2.0 分布式数据库（仅 DMS 导入方式支持） | +| 语雀 | 数据保留在语雀，实时访问 | 访问语雀文档和知识库（仅支持公网版本） | +| OSS | 数据保留在 OSS，实时访问 | 访问对象存储中的文件 | + +> **注意**：MySQL、PostgreSQL 和 PolarDB-X 2.0 连接器，仅通过"从 DMS 导入数据源"方式创建时才支持执行 SQL 查询。通过"创建自定义数据源"方式添加的连接器不支持直接执行 SQL。 ## 前置条件 -创建数据连接器前需满足： +创建连接器前需要确保以下条件： -- **账号权限**：主账号或具有数据连接管理权限的 RAM 用户。RAM 用户需主账号授权，授权方法参见[数据连接](../../raw/application-user-guide/data-connection-overview/data-connection.md)中的权限管理说明。 -- **数据源准备**： - - 文件/表格连接器：准备好要上传的文件，或已创建 OSS Bucket。 - - MySQL 连接器：已有 MySQL 实例（阿里云 RDS 或自建），并确保网络可达。 - - PostgreSQL 连接器：已有 PostgreSQL 实例，且已将 `wal_level` 参数设置为 `logical`。 - - PolarDB-X 2.0 连接器：已有阿里云 PolarDB-X 2.0 实例，所在地域支持私网访问。 - - 语雀连接器：已有语雀知识库（仅支持公网版本），并获取个人访问 Token。 - - OSS 连接器：已创建 OSS Bucket，并开通向量检索服务。 +- **账号权限**：需主账号或具有数据连接管理权限的 RAM 用户。 +- **数据源准备**（按连接器类型）： + - **文件/表格**：准备好上传文件或已创建 OSS Bucket。 + - **MySQL**：已有数据库实例（阿里云 RDS 或自建），网络可达。 + - **PostgreSQL**：已有实例且 `wal_level` 参数设置为 `logical`；自建实例还需配置 `listen_addresses` 允许 `100.64.0.0/16` 网段访问。 + - **PolarDB-X 2.0**：已有阿里云 PolarDB-X 2.0 实例，所在地域支持私网访问。 + - **语雀**：已有语雀知识库（仅公网版本），并获取个人访问 Token。 + - **OSS**：已创建 OSS Bucket 并开通向量检索服务。 -## 关键参数与差异 +## 创建连接器 -### MySQL vs PostgreSQL +在百炼控制台的[数据连接](https://bailian.console.aliyun.com/cn-beijing/?tab=app#/connector/list)页面点击"创建连接器"，选择连接器类型并完成配置。各类型的关键配置参数如下。 -| 差异项 | MySQL | PostgreSQL | -| --- | --- | --- | -| 默认端口 | 3306 | 5432 | -| 额外必填字段 | 无 | 需填写 dbName（数据库名称） | -| 连通性检测服务 | EventBridge | DTS（数据传输服务） | -| 特殊配置要求 | 无 | 需将 `wal_level` 修改为 `logical` | +### 文件连接器与表格连接器 -PostgreSQL 自建实例还需配置 `listen_addresses`，允许 `100.64.0.0/16` 网段访问：在 `pg_hba.conf` 顶部添加 `host [数据库名] [用户名] 100.64.0.0/16 md5`，并 `sudo systemctl reload postgresql` 重载配置。 +两者配置流程相似，均需填写连接器名称、描述，并选择存储位置： -### PolarDB-X 2.0 与 MySQL 的差异 +- **平台存储**：使用百炼平台提供的存储空间。文件连接器限时免费提供最大 100,000 个文件、1 TB 额度；表格连接器提供 1 TB 免费额度，用完后按量付费。 +- **自有 OSS 存储**：需首次完成授权，目标 Bucket 需添加 `bailian-connector-access` 标签（值为 `ReadAndWrite`）。 -- **网络类型**：仅支持私网，不支持公网。 -- **数据源**：仅支持阿里云 PolarDB-X 2.0 实例，不支持自建数据库。 -- **SLR 授权**：首次使用需显式同意 DTS 与 PolarDB-X 服务管理角色（DMS 方式还需 DMS 角色）的授权。 +### 数据库连接器配置对比 -### OSS 连接器限制 +根据[数据连接](../../raw/application-user-guide/data-connection-overview/data-connection.md)原文档，三种数据库连接器的关键配置差异如下： -- 目标 Bucket 需添加 `bailian-datahub-access` 标签（值为 `read`）。 -- 不支持归档、冷归档或深度冷归档存储类型的 Bucket。 -- 支持内容加密的 Bucket 和私有 Bucket。 -- 如需使用开启 Referer 防盗链的 Bucket，须将域名 `*.console.aliyun.com` 添加到白名单 Referer 中。 -- 未开通向量检索服务时，无法使用 `searchOSSFile` 与 `searchOSSFileByFileName` 工具查询文件。 +| 配置项 | MySQL | PostgreSQL | PolarDB-X 2.0 | +|-------|-------|-----------|---------------| +| 默认端口 | 3306 | 5432 | 自动获取 | +| 网络类型 | 公网/私网 | 公网/私网 | 仅私网 | +| 数据源方式 | 自定义 / DMS 导入 | 自定义 / DMS 导入 | 自定义 / DMS 导入 | +| 额外必填字段 | 无 | 需填写 dbName | 无 | +| 连通性检测服务 | EventBridge | DTS | EventBridge | +| 特殊前置配置 | 无 | `wal_level` 设为 `logical` | 无 | +| 支持自建数据库 | 是 | 是 | 否 | +| SLR 授权 | EventBridge + RDS + DMS | 无额外说明 | DTS + PolarDB-X（DMS 方式还需 DMS 角色） | -### 自有 OSS 存储授权（文件/表格连接器） +### 语雀连接器 -文件与表格连接器选择"使用自有 OSS 存储"时，目标 Bucket 需添加 `bailian-connector-access` 标签（值为 `ReadAndWrite`），首次使用需按界面提示完成授权。 +填写连接器名称和描述后，需到语雀开放 API 页面获取 Tenant access token 并填入，点击"连接检测"验证 Token 有效性。 -## 使用方式 +### OSS 连接器 -### 创建连接器 +选择要连接的 OSS Bucket，需首次完成授权并为目标 Bucket 添加 `bailian-datahub-access` 标签（值为 `read`）。 -1. 访问数据连接页面，单击右上角**创建连接器**。 -2. 选择连接器类型，填写基本信息（连接器名称、描述）和存储位置。 - - **描述**会用于指导应用调用的准确度，建议写明数据内容和用途。 - - 文件/表格连接器需选择**使用平台存储**或**使用自有 OSS 存储**。 - - 数据库连接器需配置数据来源（创建自定义数据源 / 从 DMS 导入数据源）、网络类型（公网/私网）、数据库连接信息（实例、地址、端口、用户名、密码）。 -3. 单击**确认**完成创建。 +> **注意**：OSS 连接器不支持归档、冷归档或深度冷归档存储类型的 Bucket。如需使用开启 Referer 防盗链的 Bucket，须将 `*.console.aliyun.com` 添加到白名单 Referer 中。使用 OSS 连接器需开通向量检索服务，否则无法使用 `searchOSSFile` 和 `searchOSSFileByFileName` 工具。 -### 导入数据 +## 导入数据 -**导入文件**：进入文件连接器详情 → 选择类目 → 导入数据 → 选择本地上传 → 配置解析方式与标签 → 确认。 +### 导入文件 -解析方式可选默认设置或自定义设置，包括电子文档解析、文档智能解析、大模型文档解析、Qwen VL 解析、音视频解析等。具体说明见[数据连接](../../raw/application-user-guide/data-connection-overview/data-connection.md)。 +进入文件连接器详情页，在左侧选择或新建类目后点击"导入数据"。支持以下解析方式： -**导入表格**：进入表格连接器详情 → 选择或新建数据表 → 选择直接上传 Excel 或自定义表头 → 导入数据。 +| 解析方式 | 适用文件类型 | 特点 | +|---------|------------|------| +| 电子文档解析 | 文档 | 不支持解析插图与图表 | +| 文档智能解析 | 文档 | 识别插图文本并生成摘要，参与知识库检索 | +| 大模型文档解析 | 文档 | 支持用户对插图和图表内容提问 | +| Qwen VL 解析 | 图片 | 可选千问 VL 模型，通过 Prompt 指定识别内容 | +| 音视频解析 | 音频/视频 | 语音识别 + 视频帧提取 + 剧情解析（视频） | -## 限制和注意事项 +可选为文件配置标签，通过 API 调用时在请求参数 `tags` 中指定标签可提高检索效率。 -- 平台存储额度：文件连接器提供最大 100,000 个文件、1 TB 存储（限时免费）；表格连接器提供 1 TB 免费额度，超出后按量付费。 -- 文件导入后作为独立副本存储，与原始数据无关联；仅支持查看最近 90 天内导入的文件，超期无法查看但不会被删除。 -- 导入的文件仅供当前业务空间的用户使用，百炼不会将其用于商业用途或对外公开。 -- 平台不支持直接导入 JSON、CSV、YAML 格式文件，需先转换为 XLSX 或 XLS 格式。 -- 数据表结构（列名、描述、类型）一旦确定无法修改；上传文件表结构必须与数据表结构完全一致，否则导入失败。 -- 流量高峰或并发较高时，文件解析可能因资源排队而延长耗时，偶现解析超时，需耐心等待或稍后重试。 -- 公网连接数据库时，请务必将指定 IP 段加入数据库实例的白名单中；生产环境建议使用私网连接。 +### 导入表格 -## 来源文档 +进入表格连接器详情页，在"数据表管理"下选择或新建数据表，支持两种方式： -- [数据连接](../../raw/application-user-guide/data-connection-overview/data-connection.md) +- **直接上传 Excel**：平台自动识别表头创建数据表结构。 +- **自定义表头**：手动配置列名（必填）、描述（选填）和类型（必填）。 +> **注意**：数据表结构一旦确定无法修改，上传文件的表结构必须与数据表完全一致。若字段类型设为 `image_url`，需确保链接是公开可访问的图片 URL。 +## 使用限制与注意事项 +- 文件连接器导入的文件仅供当前[业务空间](../concepts/workspace.md)用户使用，平台不会用于商业用途或对外公开。 +- 导入的文件仅支持查看最近 **90 天**内的记录，超期后不可查看但不会被删除。 +- 流量高峰或并发较高时，文件解析可能因资源排队而延长耗时，如遇超时请稍后重试。 +- 数据库连接器在公网模式下需将指定 IP 段加入数据库实例白名单。 +- 平台不支持直接导入 JSON、CSV、YAML 格式文件到文件连接器，需先转换为 XLSX 或 XLS 格式。 +更多配置细节请参考[数据连接](../../raw/application-user-guide/data-connection-overview/data-connection.md)原始文档。 + +## 来源文档 + +- [数据连接](../../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 452796f..67992cb 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/fine-tuning.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/fine-tuning.md @@ -164,3 +164,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 ead5e91..c738661 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,83 +1,56 @@ # get started with models -阿里云百炼是一站式大模型开发与应用平台，集成千问（Qwen）及 DeepSeek、Kimi、GLM 等第三方模型，提供兼容 OpenAI 的 API 与可视化应用构建能力。本页汇总从开通账号、选择模型、配置 Base URL 到首次调用与限流控制的完整上手路径，面向开发者快速跑通第一次模型调用。 +阿里云百炼是一站式大模型开发平台，兼容 OpenAI 接口规范，集成千问（Qwen）全系列及 DeepSeek、Kimi、GLM 等第三方模型。开发者只需获取 API Key 并配置 Base URL，即可通过几行代码调用文本生成、视觉理解、图像生成、语音合成等[多模态](../concepts/multimodal.md)能力。本文梳理从账号开通到首次 API 调用的完整流程，以及地域选择、接入域名和限流等关键注意事项。 -## 平台定位与核心能力 +## 支持的模型与能力 -百炼同时面向开发者与业务人员：开发者可通过兼容 OpenAI 的 API 在几行代码内调用大模型；业务人员可通过可视化工具搭建智能体、[工作流](../concepts/workflow.md)与 RAG 知识库应用。平台还提供[模型调优](../concepts/fine-tuning.md)（SFT/CPT/DPO）、模型部署（资源专享推理服务）与模型评测能力，详见 [什么是阿里云百炼](../../raw/model-user-guide/get-started-with-models/what-is-model-studio.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 格式与千问一致 | -百炼模型覆盖文本、图像、音频、视频、3D、全模态与向量/[重排序](../concepts/rerank.md)等多种能力，按模态归类如下，完整列表以模型广场为准： +**[多模态](../concepts/multimodal.md)能力**： -- **文本生成**：千问系列由强到成本最低包括 `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`、`mimo-v2.5-pro`，API 格式与千问一致。 -- **图像与视频**：理解模型（`qwen3.7-plus`、`qwen3.5-omni-plus`、`kimi-k2.7-code`）和生成模型（`wan2.7-image-pro`、`qwen-image-2.0-pro`、`happyhorse-1.1-t2v/i2v/r2v`、`happyhorse-1.0-video-edit`）。 -- **3D 生成**：`Tripo/Tripo-H3.1`、`Tripo/Tripo-P1.0`。 -- **音频与语音**：语音合成 `cosyvoice-v3.5-plus`、`MiniMax/speech-2.8-hd`；音乐生成 `fun-music-v1`；语音识别 `fun-asr-realtime`、`fun-asr`、`qwen3.5-omni-plus-realtime`；端到端语音对话 `qwen3.5-omni-plus-realtime`。 -- **全模态**：`qwen3.5-omni-plus-realtime`、`qwen3.5-omni-plus`。 -- **向量与[重排序](../concepts/rerank.md)**：`text-embedding-v4`、`tongyi-embedding-vision-plus`、`qwen3-rerank`。 +- **视觉理解**：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 -千问系列选型建议：Max 适合复杂多步骤任务，Plus 在效果/速度/成本上均衡（多数场景推荐），Flash 适合低延迟简单任务。详见 [选择模型](../../raw/model-user-guide/get-started-with-models/models.md)。 +## 快速开始：首次 API 调用 -## 地域、服务部署范围与接入域名 - -调用百炼前需确定三件事，三者关系见 [选择地域、服务部署范围和接入域名](../../raw/model-user-guide/get-started-with-models/regions.md)： - -- **地域**：决定接入点与数据存储位置，就近选择可降低延迟。可选华北2（北京，`cn-beijing`）、新加坡（`ap-southeast-1`）、德国法兰克福（`eu-central-1`）、日本东京（`ap-northeast-1`）、美国弗吉尼亚（`us-east-1`）。 -- **服务部署范围**：决定推理执行位置。无数据驻留限制可选"全球"；要求数据不出中国内地选"中国内地"；要求不经过中国内地选"国际"；另有美国/欧盟/日本境内限定范围。 -- **接入域名**：影响并发上限与超时。推荐生产环境使用**业务空间专属域名** `{WorkspaceId}.{region}.maas.aliyuncs.com`（请求超时 3600 秒、SLA 99.9%、支持 HTTP/SSE/WebSocket/WebRTC）；存量业务可用 `dashscope.aliyuncs.com` 等中心化域名；试用域名 `trial.{region}.maas.aliyuncs.com` 仅限快速验证，不建议生产。 - -> **注意**：各地域的 API Key、模型列表、接入域名**不能跨地域混用**。美国（弗吉尼亚）暂不支持业务空间专属域名，需使用 `dashscope-us.aliyuncs.com`；德国、日本地域通过业务空间区分服务部署范围，调用前需先在业务空间管理页创建并选择部署范围。美国地域使用带 `-us` 后缀的模型名（如 `qwen-plus-us`）可限定美国境内推理，不带后缀默认全球推理。 - -功能支持也存在地域差异：批量推理、[模型调优](../concepts/fine-tuning.md)、应用开发仅在华北2（北京）与新加坡支持；模型告警仅北京与新加坡支持。 +完整步骤参见[首次调用千问API](../../raw/model-user-guide/get-started-with-models/first-api-call-to-qwen.md)。 -## Base URL 与计费方案 +### 1. 开通服务与获取 API Key -Base URL 必须与同一计费方案的 API Key 配套使用，错配会报 401。各方案的 OpenAI 兼容地址（以华北2北京为例）： +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） -| 计费方案 | Base URL（OpenAI 兼容） | 适用场景 | -| --- | --- | --- | -| 按量付费 - Dashscope 域名 | `https://dashscope.aliyuncs.com/compatible-mode/v1` | 存量业务兼容，可跨业务空间调用 | -| 按量付费 - 业务空间专属 | `https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1` | 生产推荐，更高吞吐与时延隔离 | -| 按量付费 - 试用域名 | `https://trial.cn-beijing.maas.aliyuncs.com/compatible-mode/v1` | 快速验证，限流小 | -| Token Plan | `https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1` | Claude Code/Codex 交互式，不可用于后端服务 | -| Coding Plan | `https://coding.dashscope.aliyuncs.com/v1` | AI 编码套餐，需用专属 API Key | +### 2. 配置 API Key 到环境变量 -完整地址表（含 Anthropic 兼容地址与各地域）见 [Base URL总览](../../raw/model-user-guide/get-started-with-models/base-url.md)。从 Dashscope 域名迁移到业务空间专属域名只需在 API Key 创建弹窗或业务空间管理页复制 API Host 替换原域名，业务代码无需改动。 - -## 上手步骤：从开通到第一次调用 - -### 1. 账号与凭证 - -1. 注册阿里云账号并完成实名认证。 -2. 使用**主账号**前往百炼控制台开通服务（同意协议即开通）。 -3. 在 API Key 页面创建 API Key。 -4. 北京、新加坡、东京、法兰克福地域需在业务空间管理页获取 `WorkspaceId`，填入 Base URL。 - -建议将 API Key 写入环境变量 `DASHSCOPE_API_KEY`，避免代码硬编码： +建议将 API Key 存入环境变量 `DASHSCOPE_API_KEY`，避免在代码中硬编码： ```bash -# Linux/macOS 永久（zsh） +# macOS / Linux +export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY" + +# 永久生效（macOS zsh） echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.zshrc source ~/.zshrc -# Windows CMD 永久 -setx DASHSCOPE_API_KEY "YOUR_DASHSCOPE_API_KEY" ``` -### 2. 安装 SDK +### 3. 调用示例（[OpenAI 兼容接口](../concepts/openai-compatible-interface.md)） -百炼兼容 OpenAI 接口规范，可直接用 OpenAI SDK，也可用 DashScope SDK。Python ≥ 3.8： - -```bash -pip install -U openai # 或 -pip install -U dashscope -``` - -### 3. 发起首次调用 - -以 OpenAI Python SDK 调用千问为例（北京地域，业务空间专属域名）： +**Python**： ```python import os @@ -89,12 +62,28 @@ client = OpenAI( ) completion = client.chat.completions.create( model="qwen3.7-plus", - messages=[{"role": "user", "content": "你是谁？"}], + messages=[{'role': 'user', 'content': '你是谁？'}] ) print(completion.choices[0].message.content) ``` -curl 调用： +**Node.js**： + +```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**： ```bash curl -X POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/chat/completions \ @@ -103,35 +92,73 @@ curl -X POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/ -d '{"model":"qwen3.7-plus","messages":[{"role":"user","content":"你是谁？"}]}' ``` -完整的环境变量配置、Python/Node.js/curl 示例及 Windows 系统属性配置步骤见 [首次调用千问API](../../raw/model-user-guide/get-started-with-models/first-api-call-to-qwen.md)。不熟悉编程可使用 Chatbox 等图形化客户端。 +> **注意**：以上示例均使用华北2（北京）地域的 Base URL，需将 `{WorkspaceId}` 替换为实际的[业务空间](../concepts/workspace.md) ID。不同地域的 Base URL 不通用。 -## 限流与用量控制 +## 地域、服务部署范围与接入域名 -限流按**主账号维度**计算，账号下所有 RAM 子账号、业务空间和 API Key 的调用量合并计算；不同模型限流额度相互独立。超出时请求被拒，通常一分钟内自动恢复。常见错误与处理见 [限流](../../raw/model-user-guide/get-started-with-models/rate-limit.md)： +百炼目前在 5 个地域提供服务，详细说明参见[选择地域、服务部署范围和接入域名](../../raw/model-user-guide/get-started-with-models/regions.md)。 -| 错误信息 | 触发类型 | 处理建议 | -| --- | --- | --- | -| `Requests rate limit exceeded` | RPM 限流 | 降低调用频率 | -| `Allocated quota exceeded` | TPM 限流 | 缩短输入或限制输出长度 | -| `Request rate increased too quickly` | 频率激增保护 | 匀速调度、指数退避、请求队列 | +### 地域选择指南 -> **注意**：除 RPM/TPM 外，系统可能按秒级 RPS（RPM/60）与 TPS（TPM/60）执行，即使分钟级总量未超限，瞬时高峰也可能触发限流。Batch API 调用不受实时限流约束，但需排队处理。 +| 数据合规需求 | 推荐地域 | 服务部署范围 | +|-------------|---------|------------| +| 数据不出中国内地 | 华北2（北京） | 中国内地 | +| 数据不出美国 | 美国（弗吉尼亚） | 美国 | +| 数据不出欧盟 | 德国（法兰克福） | 欧盟 | +| 数据不出日本 | 日本（东京） | 日本 | +| 无合规限制，追求最大资源池 | 美国/德国/日本 | 全球 | +| 数据不经过中国内地 | 新加坡 | 国际 | -避免限流的策略：优先选 `qwen-plus` 等高限流模型；稳定版/最新版比带日期快照版限流更宽松；配置备选模型在 429 时自动切换；长对话或大文档拆分为小批次；非实时场景使用批量推理；默认额度不足时在控制台"限流提额"页提升临时 TPM（有效期 30 天，目前仅北京与新加坡支持）。 +> **注意**：各地域的 API Key 相互独立，不能跨地域使用。部分功能（模型调优、应用开发）仅在华北2（北京）地域支持。 -限流仅约束速率，不限制累计用量。要控制费用：在账单费用卡片设置月度消费限额与告警；对新用户免费额度模型开启"免费额度用完即停"；定期查看模型监控（调用数据约一小时后更新，高峰期可能延迟）。 +### 接入域名类型 -## 计费要点 +百炼提供三种接入域名，详见[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 | 无 | + +生产环境强烈建议使用**业务空间专属域名**，迁移仅需替换 Base URL 中的域名部分，无需修改业务逻辑。 + +此外百炼还提供 Coding Plan 和 Token Plan 专属域名，仅限 Claude Code、Codex 等 AI 编码工具使用，不能用于后端服务。 + +## 限流机制 + +限流按**主账号维度**计算，账号下所有 RAM 子账号、业务空间和 API Key 的调用量合并统计。不同模型的限流额度相互独立。详细规则参见[限流](../../raw/model-user-guide/get-started-with-models/rate-limit.md)。 + +### 限流指标 + +- **RPM**（Requests Per Minute）：每分钟请求数 +- **TPM**（Tokens Per Minute）：每分钟 Token 消耗（含输入与输出） -开通百炼免费，调用、微调、部署模型时产生费用，按分钟出账。新用户在华北2（北京）地域有专属免费额度：未认证用户用完即停、需认证充值后续费；已认证用户用完自动转按量付费，可开启"免费额度用完即停"避免意外扣费。Coding Plan 为固定月费套餐，需使用其专属 Base URL 与 API Key，否则按量付费。 +稳定版/最新版模型通常拥有更高的限流额度。以华北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 | -- Base URL 与 API Key 必须属同一计费方案，错配报 401；API Key 不能跨地域使用。 -- 业务空间专属域名仅限该空间 API Key 调用；Dashscope 与试用域名可跨业务空间调用。 -- 模型调用统计约一小时后才在模型监控可见。 -- 删除 API Key、停止调用、下线按算力计费的部署实例、开启免费额度用完即停，是控制费用的有效组合。 -- 模型名称带日期的快照版本限流比稳定版/最新版更严格，生产环境优先用不带日期的稳定名称。 +> **注意**：即使每分钟总量未超限，短时间内请求爆发也可能触发秒级限流（RPS = RPM/60）。收到 `Request rate increased too quickly` 时，需平滑请求速率。 + +### 应对限流的策略 + +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)查看调用量统计（调用约一小时后可见） ## 来源文档 @@ -143,7 +170,3 @@ curl -X POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/ - [Base URL总览](../../raw/model-user-guide/get-started-with-models/base-url.md) - - - - 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 bcbb618..f5d2ef6 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（检索增强生成）技术，为大模型补充私有数据与最新信息，提升特定领域问答的准确性。它覆盖知识库创建、数据导入、检索召回、问答生成、日志监控与计费计量的完整链路，支持文档搜索、数据查询、图片问答、音视频搜索等多模态场景，并可经控制台或开放 API 接入业务系统。 +阿里云百炼知识库基于 RAG（检索增强生成）技术，为大模型补充私有数据与最新信息，提升特定领域问答的准确性。它覆盖知识库创建、数据导入、检索召回、问答生成、日志监控与计费计量的完整链路，支持文档搜索、数据查询、图片问答、音视频搜索等[多模态](../concepts/multimodal.md)场景，并可经控制台或开放 API 接入业务系统。 ## 支持的模型与知识库类型 @@ -15,7 +15,7 @@ - **图片问答类**：仅支持 `multimodal-embedding-v1`（1024 维）向量模型。 - **音视频搜索类**：对语音做识别、对视频做帧提取与剧情解析，按时间轴结构化对齐。 -向量模型方面，文档搜索、数据查询、音视频搜索类支持 `text-embedding-v4` 或 `text-embedding-v3`（均为 512 维），维度不可更改；视觉理解场景会自动切换为 `qwen3-vl-embedding`（qwen3 多模态向量）。详见 [知识库配额与限制](../../raw/application-user-guide/knowledge-base/rag-knowledge-base-specifications.md)。 +向量模型方面，文档搜索、数据查询、音视频搜索类支持 `text-embedding-v4` 或 `text-embedding-v3`（均为 512 维），维度不可更改；视觉理解场景会自动切换为 `qwen3-vl-embedding`（qwen3 [多模态](../concepts/multimodal.md)向量）。详见 [知识库配额与限制](../../raw/application-user-guide/knowledge-base/rag-knowledge-base-specifications.md)。 ## 创建与数据导入 @@ -50,7 +50,7 @@ | --- | --- | --- | | 初步向量检索 TopK | 1–100（默认 50） | 向量语义召回切片数 | | 初步关键词检索 TopK | 1–100（默认 50） | 关键词匹配召回切片数 | -| 排序模型 | qwen3-rerank / qwen3-rerank(hybrid) / qwen3-vl-rerank | 多模态库只能选 vl-rerank | +| 排序模型 | qwen3-rerank / qwen3-rerank(hybrid) / qwen3-vl-rerank | [多模态](../concepts/multimodal.md)库只能选 vl-rerank | | 排序模式 | 问答 / 相似 / 自定义高级 | 问答模式按 QA 匹配度，相似模式按语义相似度 | | 相似度阈值 | 0.01–1.0 | 过滤排序后低分切片，过高会丢弃全部结果 | | 最大召回数量 | 1–20 | 最终返回切片数 | @@ -73,7 +73,7 @@ 知识库提供开放 API，便于自动化操作与外部接入。注意 **API 指南仅适用于文档搜索类知识库**。 -前置步骤：子账号需获取 `AliyunBailianDataFullAccess` 策略并加入业务空间；安装阿里云百炼 SDK（`alibabacloud_bailian20231229`）；配置 `ALIBABA_CLOUD_ACCESS_KEY_ID`、`ALIBABA_CLOUD_ACCESS_KEY_SECRET`、`WORKSPACE_ID` 环境变量。接入地址示例：`bailian.cn-beijing.aliyuncs.com`。 +前置步骤：子账号需获取 `AliyunBailianDataFullAccess` 策略并加入[业务空间](../concepts/workspace.md)；安装阿里云百炼 SDK（`alibabacloud_bailian20231229`）；配置 `ALIBABA_CLOUD_ACCESS_KEY_ID`、`ALIBABA_CLOUD_ACCESS_KEY_SECRET`、`WORKSPACE_ID` 环境变量。接入地址示例：`bailian.cn-beijing.aliyuncs.com`。 典型流程：申请上传租约（ApplyFileUploadLease）→ 上传文件到预签名 URL → 添加文件（AddFile）→ 查询解析状态（DescribeFile）→ 创建索引（CreateIndex）→ 提交索引任务（SubmitIndexJob）→ 查询任务状态（GetIndexJobStatus）→ 检索（Retrieve）。详见 [知识库API指南](../../raw/application-user-guide/knowledge-base/rag-knowledge-base-api-guide.md)。 @@ -92,8 +92,8 @@ | 知识库数量（RDS 数据源） | 100 | | 知识库数量（其他数据源） | 无限制 | | 平台存储容量 | 标准版 100 GB / 旗舰版 9,999 GB | -| 类目数量（每业务空间） | 500 | -| 文件数量（每业务空间） | 100,000 | +| 类目数量（每[业务空间](../concepts/workspace.md)） | 500 | +| 文件数量（每[业务空间](../concepts/workspace.md)） | 100,000 | | 单知识库文件数 | 非结构化无硬性上限 / 结构化 1 篇 | | 数据表数量 | 1,000 | | ADB-PG 单表行数 / 单行大小 | 10,000,000 / 100 KB | @@ -147,3 +147,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 35212f6..78cffde 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/llm-application.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/llm-application.md @@ -1,132 +1,119 @@ # llm application -百炼提供智能体（Agent）、[工作流](../concepts/workflow.md)（Workflow）和高代码应用三种核心应用构建模式，配合知识库、MCP、插件等能力，帮助开发者快速构建可解决真实业务问题的 LLM 应用。三种模式在开发方式、可控性和适用人群上互补，可单独使用或组合集成。 +阿里云百炼提供三种核心应用构建模式——智能体（Agent）、工作流（Workflow）和高代码应用，用于突破大模型在处理私有知识、获取实时信息、遵循固定流程及规划复杂任务等方面的原生局限。三种模式分别面向零代码、低代码和专业代码开发者，通过集成知识库检索增强、外部工具调用、记忆等核心能力，帮助快速构建解决真实业务问题的 AI 应用。 ## 应用类型与选型 -百炼应用分为三类，详细对比见 [应用类型介绍](../../raw/application-user-guide/llm-application/application-introduction.md)。 +百炼应用分为三类，开发门槛与灵活度依次递增： -| 维度 | 智能体（Agent） | [工作流](../concepts/workflow.md)（Workflow） | 高代码应用 | -| --- | --- | --- | --- | +| 对比维度 | 智能体（Agent） | 工作流（Workflow） | 高代码应用 | +|---------|----------------|-------------------|-----------| | 开发方式 | 自然语言配置（零代码） | 可视化节点编排（低代码） | Python 编码（专业代码） | -| 核心特点 | 由大模型根据提示词自主规划 | 由预定义节点精确控制流程 | 完全由代码定义逻辑 | +| 核心特点 | AI 自主决策、动态规划 | 预定义流程精确控制 | 完全由代码控制 | | 适合人群 | 业务人员、产品经理 | IT 运维、业务分析师 | AI 工程师、开发者 | -| 适用场景 | 智能客服、知识问答、任务助理 | 报告生成、订单处理、审批流 | 私有算法部署、深度定制 | +| 典型场景 | 智能客服、知识问答、任务助理 | 自动化报告、订单处理、审批流 | 私有算法部署、复杂系统集成 | -- **智能体**适合需要 AI 自主决策、动态规划的场景。 -- **[工作流](../concepts/workflow.md)**适合流程固定、要求稳定可复现的场景。 -- **高代码应用**适合需要深度定制、部署私有算法的场景。 +详细的选型说明参见 [应用类型介绍](../../raw/application-user-guide/llm-application/application-introduction.md)。 ## 智能体应用 -智能体由提示词驱动，能够自主理解用户意图并调用知识库、MCP 等工具完成任务。当前推荐使用新版智能体（Agent 2.0），它将知识库、MCP 统一为工具，由智能体自主规划调用顺序，并能完整展示每轮"规划-执行-反思"链路，详见 [新版智能体应用](../../raw/application-user-guide/llm-application/new-single-agent-application.md)。 +### Agent 2.0（推荐） -> **注意**：旧版智能体与新版本基于不同技术架构，彼此不兼容，**不支持**直接升级、降级或版本切换。如需体验新版，需在控制台重新创建一个新版智能体应用。 +新版智能体（Agent 2.0）将知识库、MCP 等多种能力统一为工具，由智能体自主思考和规划调用顺序，能完整展示每一轮"规划-执行-反思"链路。与旧版相比，新版在规划调度、过程透明度和适用场景广度上均有显著提升。 -### 关键配置 +核心能力配置： -- **模型选择**：推荐选用具备强工具调用能力的模型（如 `千问-Max` 系列）。可配置最长回复长度、`temperature`、`enable_thinking`（开启思考模式以提升反思效果，仅支持思考模式模型）。 -- **系统提示词**：定义智能体角色、行为指令与能力边界；支持嵌入自定义变量（通过 `/` 引用）。 -- **预解析文件**：关闭时文件 URL 作为上下文传递给智能体自主决策；开启时由预置解析器返回文本内容。千问-VL 系列模型即使关闭预解析，也能直接解析图片和视频。 -- **内置工具**：`bash`、`write`、`read`、`edit`、`glob`、`grep`、`download_file`，在隔离沙箱中运行，默认关闭、按需开启。 -- **知识库**：作为工具由智能体自主规划调用；支持通过标签限定查询范围以提升准确性。 -- **MCP**：外部工具以 MCP 协议接入，支持动态、非固定顺序调用；插件可一键转换为 MCP。 -- **记忆**：短期记忆支持 0–30 轮上下文；长期记忆计划在后续迭代支持。 -- **ReAct 最大轮次**：1–50，限制单次会话工具调用次数，超出后自动退出并生成最终回复。 +- **模型选择**：推荐具备强工具调用能力的模型（如千问-Max 系列）。支持配置最长回复长度、temperature、enable_thinking（思考模式）等参数。 +- **提示词**：支持静态文本和自定义变量（通过 `/` 插入），定义角色、行为指令和能力边界。 +- **内置工具**：提供沙箱环境中的 `bash`、`write`、`read`、`edit`、`glob`、`grep`、`download_file` 等工具，默认关闭，按需开启。 +- **知识库**：作为工具由智能体自主规划调用，支持通过标签限定查询范围。 +- **MCP**：外部工具以 MCP 协议接入，支持动态非固定顺序调用。插件可一键转换为 MCP 服务。 +- **应用组件**：可将其他智能体或工作流发布为组件后作为工具接入。 +- **技能（Skill）**：可添加能力包，智能体自动识别匹配任务并调用。 +- **记忆**：支持短期记忆（0-30 轮上下文），长期记忆计划未来支持。 +- **预解析文件**：控制上传文件处理方式，千问-VL 系列模型即使关闭预解析也能直接解析图片和视频。 -### 创建流程 +**ReAct 最大轮次**（1-50）用于限制单次会话中工具调用最大次数，超出后自动生成最终回复。 -1. 控制台 → 应用管理 → 创建应用 → 智能体应用 → Agent 2.0。 -2. 填写名称 → 配置模型、系统提示词、工具、知识库等。 -3. 右侧对话框调试。 -4. 右上角"发布"（发布是后续 API 调用与集成的前提）。 +详细配置参见 [新版智能体应用（Agent 2.0）](../../raw/application-user-guide/llm-application/new-single-agent-application.md)。 -旧版智能体的能力与配置可参考 [智能体应用](../../raw/application-user-guide/llm-application/single-agent-application.md)。 +> **注意**：旧版智能体（Agent 1.0）与新版基于不同技术架构，不支持直接升级或切换。如需使用新版功能，需在控制台重新创建 Agent 2.0 应用。 -## 工作流应用 - -工作流通过可视化节点编排将复杂任务拆分为有序步骤，逻辑确定、可复现，详见 [工作流应用](../../raw/application-user-guide/llm-application/workflow-application.md)。 +### Agent 1.0（旧版） -### 核心节点 +旧版智能体通过知识库（RAG）和插件两类核心能力扩展模型。知识库检索到的文本会占用模型上下文窗口，需注意调整检索策略避免超限。自定义插件有 5 秒超时限制。 -- **开始/结束**：定义输入/输出参数。开始节点预置 `query`（用户输入）、`historyList`（对话历史）、`imageList`（图片）等变量。 -- **大模型节点**：执行 LLM 推理，配置模型、提示词、用户提示词、记忆等。 -- **意图分类节点**：根据输入分流到不同下游分支，支持多意图。 -- **变量处理节点**：文本输出或变量加工。 -- **智能体群组节点**：将任务分解给多个已发布的子智能体协同完成。 +旧版智能体的能力详情参见 [智能体应用](../../raw/application-user-guide/llm-application/single-agent-application.md)。 -### 会话变量 +## 工作流应用 -会话变量作为全局变量在工作流全生命周期内记录参数，可在各节点中引用，在画布右上角配置。 +工作流通过可视化节点编排将复杂任务串联为稳定可控的执行链路。核心节点包括： -### 典型案例 +- **开始/结束节点**：定义输入输出参数结构，预置 `query`、`historyList`、`imageList` 等变量。 +- **大模型节点**：配置模型、提示词和用户提示词，支持变量插入（`${sys.query}`）。 +- **意图分类节点**：根据用户意图分流到不同处理分支。 +- **智能体群组节点**：将多个子智能体组合，由决策模型分派任务。 +- **变量处理节点**：静态文本输出或变量转换。 +- **会话变量**：全局变量，贯穿工作流全生命周期，可跨节点引用。 -- **诈骗信息识别**：开始 → 大模型（提示词判定诈骗嫌疑）→ 结束。 -- **智能导购**：意图分类分流到手机/电视/冰箱大模型分支，未命中走变量处理。 -- **日程管理助手**：通过智能体群组节点串联"信息收集"和"数据整理"两个子智能体。 +工作流支持记忆功能（本节点缓存或自定义缓存），适用于诈骗识别、智能导购、日程管理等多步骤场景。详细节点说明和案例参见 [工作流应用](../../raw/application-user-guide/llm-application/workflow-application.md)。 ## 高代码应用 -高代码应用基于完整 Python 项目结构部署 AI 后端服务，详见 [高代码应用](../../raw/application-user-guide/llm-application/rich-code-application.md)。 +面向专业开发者，支持基于完整 Python 项目结构部署 AI 后端服务。关键特性： -- **部署方式**：Serverless Function（无状态、快速拉起、低成本）或 K8s（高性能、有状态、长程任务，需开通 ACK）。 -- **代码提交**：使用预置模板（基础对话 Agent / 工具调用 Agent / 深度研究 Agent）或上传本地 `.whl` 代码包。 -- **MCP 工具接入**：控制台直接关联知识库、工作流、插件等 MCP 服务。 -- **前端体验**：直接体验、自定义交互卡片、自定义前端 WebUI（基于 AgentScope Spark Design）。 -- **网关**：应用稳定后建议开启网关，通过自定义域名和路由在生产环境访问；推荐关闭测试域名的公网访问。 -- **运维**：自动集成日志、可观测、API 网关等企业级能力；支持重新部署、调整资源、停止服务。 +- **部署方式**：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)。 ## 文件问答 -文件问答是智能体应用内的文件处理能力，支持三种处理模式，详见 [文件问答](../../raw/application-user-guide/llm-application/file-q-a.md)。 +智能体应用支持上传文件（文档、图片、音视频）进行智能问答，提供三种处理模式： -| 模式 | 机制 | 适用场景 | -| --- | --- | --- | -| 全文引用 | 解析整个文件作为上下文（受 token 限制截断） | 文档总结、全文翻译、风格润色 | -| 切片检索（RAG） | 文件切片后按相关性检索最相关片段 | 长文档问答、精确定位信息来源 | -| 自定义处理 | 文件信息交由模型自主调用工具处理 | 图片风格转换、视频分析后生成报告 | +| 模式 | 原理 | 适用场景 | +|------|------|---------| +| 全文引用 | 解析文件内容整体传入模型 | 文档总结、全文翻译、风格润色 | +| 切片检索（RAG） | 切分文件为片段，检索最相关内容 | 长文档问答、精确定位信息来源 | +| 自定义处理 | 文件信息交由模型自主调用工具处理 | 图片风格转换、视频分析等 | -- **文件格式**：文档（doc/docx/ppt/xls/pdf/md/txt 等）、图片（png/jpg/bmp/gif）、视频（mp4/mkv/mov 等）、音频（mp3/wav/flac 等）。 -- **限制**：单会话最多 10 个文件，单文件不超过 10MB；聊天窗口上传的文件仅在当前会话有效。生产环境推荐使用文件上传 API 获取 `session_file_id`（有效期 24 小时）。 -- **千问-VL 系列**：具备多模态能力，可自定义"模型处理"或"模型处理+规划"两种图片处理方式。 -- **API 限制**：调用遵循所属智能体应用的统一限流，默认 100 次/分钟，与文件问答共享配额。 +支持的文件格式包括 `.doc`/`.docx`/`.pdf`/`.xlsx`/`.md`/`.txt` 等文档，`.png`/`.jpg` 等图片，`.mp4`/`.mkv` 等视频和 `.mp3`/`.wav` 等音频。单会话最多 10 个文件，单文件不超过 10MB（API 方式可支持更大文件）。 -## 支持的模型 +关键参数： +- **全文引用**：可配置单文件最大解析长度（token）和最大拼装长度（token），超出部分从末尾截断。 +- **切片检索**：可配置召回片段数和最大拼装长度，超限时按相关性得分从低到高丢弃。 -智能体与文件问答支持千问系列（Max/Plus/Turbo/Long、千问3-Coder-Plus、千问开源系列）、千问-QwQ、DeepSeek 等文本模型，以及千问VL-Max/Plus/OCR 等视觉理解模型。高代码应用通过代码自行接入任意模型。 +文件问答的详细使用方法参见 [文件问答](../../raw/application-user-guide/llm-application/file-q-a.md)。 -> **注意**：模型支持情况可能存在数据延迟，以智能体应用内显示为准。 +## 发布与集成 -## 计费说明 +所有应用类型均需先在控制台发布后才能进行 API 调用或第三方集成。发布时会展示自上次发布以来的配置变更差异。 -- **模型调用**：按所选模型的输入/输出 Token 计费。知识库召回内容会增加输入 Token，可能推高调用费用。 -- **知识库**：按量付费，详见知识库计费说明。 -- **MCP/工具**：部分官方 MCP（文生图、文生视频、语音合成等）按模型调用计费；部分第三方 MCP 调用产生第三方费用，百炼不另行收费。 -- **高代码应用**：部署后开始计费，函数、网关、存储、模型调用均产生费用，以阿里云账单为准。 -- **文件上传**：上传操作本身不收费；基于文件问答消耗 Token 按模型标准计费。切片检索模式输入 Token 消耗通常远小于全文引用。 -- **长期记忆**：数据存储不收费；记忆体内容占用 Token 暂不计费。 +- **智能体应用**：支持通过 API/SDK 调用，也可发布到钉钉、微信公众号等平台，或发布为可复用组件。RAM 账号发布前需确认拥有 `ram:CreateServiceLinkedRole` 权限。 +- **工作流应用**：发布后通过工作流应用 API 调用。 +- **高代码应用**：部署后通过触发器或 API 网关访问。 -## 限制与注意事项 +## 计费说明 -- 应用**必须先发布**才能通过 API 调用或集成到业务系统。 -- RAM 账号创建的应用发布前需具备 `ram:CreateServiceLinkedRole` 权限。 -- 自定义插件超时限制为 5 秒。 -- 智能体未按预期调用工具时，排查：技能是否正确挂载、系统提示词是否清晰引导、用户意图是否相关、是否触及 ReAct 轮次上限。 -- 文件问答在 API 调用时**无法**动态切换处理模式，按控制台保存的配置执行。 -- 文件问答 API 仅适用于中国大陆版（北京地域）。 -- 高代码应用的部署地域应与网关所在地域相同。 +百炼应用创建本身不收费，费用主要来自以下方面： + +- **模型调用**：按模型类型和 Token 用量计费。上传文件的问答会额外消耗输入 Token（全文引用模式消耗最大，切片检索模式相对较少）。 +- **知识库**：按量付费，检索到的文本切片会增加模型输入 Token 消耗。 +- **MCP/插件**：部分官方 MCP（文生图、文生视频等）按模型调用计费；涉及第三方 API 的费用由第三方收取。 +- **高代码应用**：部署后函数计算、API 网关、存储等资源均会产生费用。 +- **长期记忆**：数据存储不收费，记忆体内容占用的 Token 暂不计费。 ## 来源文档 - [应用类型介绍](../../raw/application-user-guide/llm-application/application-introduction.md) -- [新版智能体应用](../../raw/application-user-guide/llm-application/new-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/workflow-application.md) - [文件问答](../../raw/application-user-guide/llm-application/file-q-a.md) - - - - 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 e68a8f4..cf9bb67 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 @@ -154,3 +154,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 c8ecc8a..248dd1d 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/model-compression.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/model-compression.md @@ -94,3 +94,4 @@ + 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 c9f749a..a2afd31 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 @@ -104,3 +104,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 77aaf2b..88eaa4e 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 @@ -161,3 +161,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 9c1a925..acb3bf6 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,87 +1,136 @@ # model deployment 1 -百炼平台支持将预置模型或调优后的模型部署为资源专享的推理服务，提供预置吞吐（PTU）、模型单元、按 Token 用量三种计费方式，并支持通过控制台或 API 创建、查询、删除部署服务。本文汇总模型部署的计费规则、PTU 长输入与缓存能力、模型导入要求，以及 API/命令行快速部署流程。 +百炼平台的模型部署功能为预置模型和调优后模型提供独立的、资源专享的推理服务，支持预置吞吐（PTU）、模型单元和按 Token 用量三种计费方式。开发者可通过控制台或 API 完成部署，并可将本地训练的 LoRA 模型从 OSS 导入平台后进行部署。 -## 计费方式 +## 计费方式概览 -部署服务创建后，计费方式无法更改，如需切换必须先下线已部署的模型再重新部署。三种计费方式的对比如下，详细单价请参考 [模型部署](../../raw/model-user-guide/model-deployment-1/model-deployment-introduction.md)。 +百炼提供三种计费方式，创建后不可更改，如需切换须先下线再重新部署。详见[模型部署](../../raw/model-user-guide/model-deployment-1/model-deployment-introduction.md)。 -| 计费方式 | 适用场景 | 扩缩容方式 | 计费粒度 | -| --- | --- | --- | --- | -| 预置吞吐（PTU） | 高负载生产环境，需稳定吞吐、低延迟 | 自助增减吞吐量 | 按使用时长 + 输入/输出 TPM | -| 模型单元 | 私有模型部署，性能指标自定义，支持 PD 分离 | 自助增减模型单元数量 | 按使用时长 × 模型单元数量 | -| 按 Token 用量 | 调优后模型效果验证，不使用不计费 | 控制台提交申请，人工审核 | 按输入/输出 Token 数 | +| 计费方式 | 适用场景 | 性能特点 | 扩缩容 | +|---------|---------|---------|--------| +| **预置吞吐（PTU）** | 高负载生产环境，流量可预估 | 平台预置吞吐/并发，TPS 通常提升 1.5~2.0 倍 | 自助增减吞吐量 | +| **模型单元** | 调优后大规模推理，需自定义性能指标 | 延迟/吞吐可自定义，支持 PD 分离模式 | 自助增减单元数量 | +| **按 Token 用量** | 调优后效果验证，对并发和延迟要求不高 | 不使用不计费，价格优势最高 | 控制台提交申请，人工审核 | -PTU 模式下，当输入超过最长输入 Token 或购买的 TPM 量时，调用自动切换为按量付费模式，此时响应头会包含 `x-dashscope-ptu-overflow:true`。模型单元模式支持 PD 分离部署（Prefill/Decode 拆到不同节点），可降低首 Token 延迟、提高吞吐。按 Token 用量模式仅支持部分经过 LoRA 调优后的模型，且一个月内不使用将自动释放。 +### 预置吞吐（PTU） -> **注意**：预付费 PTU 按天计费，无法提前退费；模型单元预付费首月内提前退订，日单价按 1.2 倍计费。 +费用公式：`费用 = 使用时长 × (输入 TPM 单价 × 输入 TPM + 输出 TPM 单价 × 输出 TPM)` -## PTU 长输入与缓存 +- 支持后付费（按小时）和预付费（按天）两种结算方式。 +- 预付费订单支付后实时生效，无法提前终止；22:00 后下单到期日自动顺延 1 天。 +- 超出购买的 TPM 量或输入超过模型上限时，自动切换为按量付费模式（响应头包含 `x-dashscope-ptu-overflow:true`）。 +- 支持的模型包括千问3.7-Max、千问3.7-Plus、千问-Flash、DeepSeek-v4 系列、GLM-5.2 等。 -PTU 部署支持长输入请求和前缀缓存，通过阶梯容量系数和缓存折扣管理额度消耗，详见 [预置吞吐长输入与缓存](../../raw/model-user-guide/model-deployment-1/ptu-long-input-and-cache.md)。 +### 模型单元 -- **长输入**：部分模型支持超过 32K token 的输入，超出部分按更高阶梯系数折算 TPM 消耗。例如 glm-5.1 在 [32K, 200K] 区间输入系数为 1.33、输出系数为 1.17。 -- **前缀缓存**：命中缓存的输入 token 按折扣系数消耗额度（glm-5.1 为 0.2，deepseek-v4-pro 为 0.08，qwen3.7-plus-2026-05-26 为 0.2）。 -- **自动转按量计费**：超出 PTU 额度或输入超过模型上限（千问 128K / DeepSeek 64K）时，请求自动转为按量计费，无需修改调用代码。 +费用公式：`费用 = 使用时长（小时）× 模型单元数量 × 模型单元单价` -API 响应中通过以下字段标识计费方式：`service_tier`（值为 `ptu-standard` 表示使用 PTU 额度，`default` 或不返回表示按量计费）、`provisioned_tokens`（折算后实际消耗的 PTU 额度）、`cached_tokens`（前缀缓存命中的 token 数）。各字段在不同 API 格式（OpenAI Chat 兼容、OpenAI Responses、Anthropic 兼容、DashScope）下的 JSON 路径存在差异，Anthropic 兼容格式暂不返回 `cached_tokens`。 +- 支持后付费（按小时）和预付费（包月）。首月内提前退订，日单价按 1.2 倍计费。 +- 模型单元规格从 MU1 到 MU9 不等，不同规格对应不同算力和性能。 +- 部分模型支持 PD 分离模式（Prefill/Decode 分离），可降低首 Token 延迟、提高吞吐。 +- 支持配置推理模式（Instruct 非思考 / Thinking 思考模式）、最长上下文、服务限流（RPM/TPM）。 +- 后付费方式的算力资源先买到先得，购买不成功全额退款。 -创建或扩容 PTU 部署前，建议在控制台的"容量计算器"中填写 RPM、平均输入/输出长度、预估缓存命中率，以评估额度需求，避免额度不足导致请求转为按量计费。 +### 按 Token 用量 + +费用公式：`费用 = 输入 Token 数 × 输入单价 + 输出 Token 数 × 输出单价` + +- 仅支持部分基础模型完成 SFT 高效训练（LoRA）后的自定义模型。 +- 一个月内不使用将自动释放。 + +## PTU 长输入与前缀缓存 + +PTU 部署支持长输入请求和前缀缓存，适用于长文档分析和多轮对话场景。详见[预置吞吐长输入与缓存](../../raw/model-user-guide/model-deployment-1/ptu-long-input-and-cache.md)。 + +### 长输入阶梯系数 + +部分模型（如 glm-5.1）在输入超过 32K token 后，按更高的阶梯系数折算 TPM 消耗： + +| 模型 | 输入上限 | 缓存折扣 | 阶梯系数 | +|------|---------|---------|---------| +| glm-5.1 | 200K | 0.2（命中部分按 20% 折算） | [0,32K): 1.0; [32K,200K]: 输入 1.33 / 输出 1.17 | +| deepseek-v4-pro | 256K | 0.08（命中部分按 8% 折算） | 无阶梯（1.0） | +| qwen3.7-plus-2026-05-26 | 256K | 0.2（命中部分按 20% 折算） | 无阶梯（1.0） | + +### 前缀缓存 + +命中缓存的输入 token 按折扣系数消耗额度，可显著降低多轮对话场景的成本。通过 API 响应中的 `cached_tokens` 字段（值大于 0）确认缓存是否生效。 + +超出 PTU 额度或超过模型输入上限（千问 128K / DeepSeek 64K）时，请求自动转为按量计费，无需修改调用代码。 + +### 容量计算器 + +建议在创建或扩容前，使用控制台的容量计算器估算长输入场景的额度需求。输入参数包括每分钟请求数（RPM）、平均输入/输出长度和预估缓存命中率。 ## 模型导入 -部署调优后的 LoRA 模型前，需先将本地训练的模型从 OSS 导入到百炼平台，详见 [模型导入](../../raw/model-user-guide/model-deployment-1/model-import.md)。 +百炼支持将本地训练的 LoRA 模型从 OSS 导入平台，导入后可进行部署、增量训练等操作。详见[模型导入](../../raw/model-user-guide/model-deployment-1/model-import.md)。 -导入前提条件： +### 支持的基础模型 -- 已创建 OSS Bucket 并添加 `bailian-datahub-access` 标签（标签值为 `read`），不支持归档/冷归档/深度冷归档存储类型。 -- 模型文件需直接放在 OSS Bucket 的子目录下（不支持访问根目录文件），导入后使用百炼提供的免费存储空间。 -- 首次导入需主账号或子账号完成 OSS 服务关联角色授权（`AliyunServiceRoleForSFMDataHubOSSImport`）。 +当前仅支持导入 LoRA 微调版本，不支持全参微调模型。支持的基础模型系列包括：千问3（32B/14B/8B/4B）、千问3-VL-8B、千问2.5（72B/32B/14B/7B）、千问2.5-VL（72B/7B）。 -导入要求与限制： +### 导入要求 - **必需文件**：`adapter_model.safetensors`（权重）和 `adapter_config.json`（配置）。 -- **rank 限制**：rank 值必须为 8、16、32 或 64，且同一模型所有 LoRA 层使用相同 rank。 -- **词汇表**：训练过程中添加新 token 或修改 vocab 的模型无法导入，必须与基础模型完全一致。 -- **对话模板**：修改 `chat_template` 配置的模型无法导入，需与开源基础模型默认配置一致。 -- **VIT 冻结**：VL 模型必须冻结 Vision Transformer 部分，若 adapter 中包含 `visual` 开头的权重参数则无法导入。 +- **rank 值**：必须为 8、16、32 或 64 之一，且所有 LoRA 层使用相同 rank。 +- 不支持修改词汇表或 chat_template 的模型。 +- VL 模型必须冻结 VIT 部分（adapter 文件中不能包含 `visual` 相关权重）。 + +### OSS 授权 + +首次导入需完成 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（北京）地域。 -支持导入的基础模型包括千问3系列（32B/14B/8B/4B-Instruct-2507、千问3-VL-8B-Instruct）和千问2.5系列（72B/32B/14B/7B-Instruct、千问2.5-VL-72B/7B-Instruct）。 +### 创建部署 -## API 部署流程 +API 端点：`POST https://dashscope.aliyuncs.com/api/v1/deployments` -通过 API 或命令行部署模型适用于华北2（北京）地域，完整流程参考 [使用 API或命令行进行模型部署](../../raw/model-user-guide/model-deployment-1/model-deployment-quick-start.md)。 +三种计费方式的关键参数差异： -### 1. 创建部署 +| 参数 | 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` | - | 可选：服务限流 | - | -调用 `POST https://dashscope.aliyuncs.com/api/v1/deployments`，通过 `plan` 字段指定计费方式： +### 查询与删除 -- **PTU**：`plan=ptu`，需提供 `ptu_capacity.input_tpm` 和 `ptu_capacity.output_tpm`。 -- **模型单元**：`plan=mu`，需提供 `deploy_spec`（如 `MU1`）、`capacity`（副本数），可选 `enable_thinking`、`max_context_length`、`rpm_limit`、`tpm_limit`。 -- **按 Token 用量**：`plan=lora`，`capacity` 参数设置无效但必须填写，扩缩容需在控制台提交申请。 +- 查询状态：`GET /api/v1/deployments/{deployed_model}`，`status` 为 `RUNNING` 表示部署完成。 +- 删除服务：`DELETE /api/v1/deployments/{deployed_model}`，执行后立即开始下线且不可恢复。 -返回结果中的 `deployed_model` 为专属服务的唯一 ID，后续查询、调用、删除均使用此 ID。 +### 推理调用 -### 2. 查询状态 +部署完成后，使用 [DashScope SDK](../concepts/dashscope-sdk.md) 或兼容的 OpenAI API 格式发起推理请求。确保 API Key 所在的[业务空间](../concepts/workspace.md)与模型部署所在的[业务空间](../concepts/workspace.md)一致。 -调用 `GET https://dashscope.aliyuncs.com/api/v1/deployments/{deployed_model}`，当返回 `status` 为 `RUNNING` 时表示服务部署完成。其他状态包括 `PENDING`、`DELETING` 等。 +## API 响应中的额度字段 -### 3. 执行推理 +PTU 部署的 API 响应包含以下关键字段： -部署完成后，使用 DashScope SDK 或 OpenAI 兼容接口调用，`model` 参数填入 `deployed_model`（专属服务 ID）。需确保 API Key 所在业务空间与模型部署所在业务空间相同。 +| 字段 | 说明 | +|------|------| +| `service_tier` | `ptu-standard` 表示使用 PTU 额度；`default` 或不返回表示按量计费 | +| `provisioned_tokens` | 折算后实际消耗的 PTU 额度（含阶梯系数和缓存折扣） | +| `cached_tokens` | 前缀缓存命中的 token 数 | -### 4. 删除服务 +上述字段在不同 API 格式（OpenAI Chat、OpenAI Responses、Anthropic、DashScope）下的 JSON 路径有所不同，具体位于 `usage.prompt_tokens_details` 和 `usage.completion_tokens_details`（或 `output_tokens_details`）下。 -调用 `DELETE https://dashscope.aliyuncs.com/api/v1/deployments/{deployed_model}`，删除后服务立即开始下线且不可恢复，停止计费。 +> **注意**：Anthropic 兼容格式暂不返回 `cached_tokens` 字段，可通过 `provisioned_tokens` 间接判断缓存效果。 -## 限制与注意事项 +## 常见问题 -- **地域限制**：API 部署目前仅适用于华北2（北京）地域。 -- **权限要求**：API Key 归属业务空间需拥有目标模型的部署权限（报错 `Workspace xxx does not have deployment privilege for model xxxx` 时需在业务空间管理中授权）；API Key 归属账号需在对应业务空间中拥有操作权限（报错 `Workspace access denied` 时需在权限管理中确认用户列表）。 -- **计费生效**：部署成功后立即开始计费，即使未发起调用，建议先确认计费规则再执行部署。 -- **模型单元资源**：后付费方式算力资源先到先得，购买不成功会全额退款。 -- **欠费处理**：后付费账户欠费后，资源保留并计费 24 小时，期间服务可正常使用；超过 24 小时停止计费，底层资源将被删除但部署任务保留，补足欠费后重新分配资源。 -- **效果一致性**：导入的 LoRA 模型在百炼平台推理效果可能与本地 vLLM/SGLang 不一致，建议调整 `temperature`（1.0）、`top_p`（1.0）、`top_k`（None 或 >100）、`presence_penalty`（0）、`repetition_penalty`（1.0）等参数对齐。 +- **部署后报权限不足**：检查 API Key 归属[业务空间](../concepts/workspace.md)是否拥有目标模型的部署权限，并确认归属账号在该业务空间中有操作权限。 +- **导入模型与本地推理效果不一致**：百炼推理引擎参数默认值可能不同，建议显式设置 `temperature=1.0`、`top_p=1.0`、`repetition_penalty=1.0` 以对齐 vLLM 默认行为。 +- **PTU 利用率超过 100%**：长输入阶梯系数使折算消耗高于原始 token 数，超出部分自动转按量计费，不影响可用性。 +- **OSS 导入报错 10041495**：主账号需先开通 OSS 服务。 ## 来源文档 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 1e75cd3..76f13d7 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,120 +1,134 @@ # model evaluation introduction -模型[评测](../concepts/evaluation.md)是百炼平台提供的模型质量验证工具，用于基于数据集对大语言模型进行多维度量化评估。它支持自动[评测](../concepts/evaluation.md)和人工[评测](../concepts/evaluation.md)两种模式，最终生成综合得分、通过率和分数分布等评测报告，帮助开发者在[模型选型](../concepts/model-selection.md)、调优验证、能力量化与持续监控等场景中以数据驱动决策。详细介绍可参考[模型评测](../../raw/model-user-guide/model-evaluation-introduction/model-evaluation-overview.md)。 +模型评测是百炼平台提供的模型能力评估功能，支持自定义评测和基线评测两种方式，通过评测维度对模型推理结果进行打分和对比，帮助开发者选择最优模型或验证调优效果。当前仅支持文本生成类模型的评测，评测结果以报告和排行榜形式呈现。 -## 支持的评测类型 +## 使用场景 -模型评测分为两类，开发者应根据评测目的选择合适的方式。 +- **模型选型对比**：使用相同的评测数据集和维度评测多个候选模型，通过排行榜横向对比综合得分和通过率，用数据驱动选型决策。 +- **调优效果验证**：对模型调优前后分别执行评测，对比评分变化，量化调优带来的能力提升。 +- **能力量化评估**：生成包含综合得分、通过率和分数分布的评测报告，为团队协作提供客观数据支撑。 +- **持续质量监控**：建立定期评测机制，使用相同评测条件追踪模型表现趋势，及时发现能力下降。 -### 自定义评测 - -适用于业务场景评测与自定义评分标准。需要先创建评测维度，再准备评测数据（Excel 格式）。具体说明见[模型评测](../../raw/model-user-guide/model-evaluation-introduction/model-evaluation-overview.md)。 - -- **评测维度类型（5 种）**： - - **大模型评估-数值型**：AI 裁判按 1–5 分打分，适合问答质量、内容生成质量评估，推荐度最高。 - - **规则评估-文本相似度**：算法计算相似度，适合翻译、摘要、改写，成本较低。 - - **大模型评估-分类型**：AI 裁判做 Pass/Fail 分类，适合内容安全、正确性判断。 - - **规则评估-字符串匹配**：精确字符串匹配，适合 Function Calling、NL2SQL，成本极低。 - - **人工评估-分类型**：人工打标签，适合创意性、专业判断，成本较高。 - -一个评测任务可以组合多个评测维度。 - -### 基线评测 - -适用于验证模型通用能力（学科、数学、推理），使用系统预置的标准榜单数据集，无需自备评测数据，也无需创建评测维度。 +## 自定义评测与基线评测 -> **注意**：基线评测**仅支持调优后的模型**，不支持预置模型（如千问-Max）。若创建任务时模型列表为空，需先完成[模型调优](../concepts/fine-tuning.md)与部署。 +百炼平台提供两种评测方式，详见[模型评测](../../raw/model-user-guide/model-evaluation-introduction/model-evaluation-overview.md)。 -基线评测提供预置数据集，包括： +### 自定义评测 -- **学科类**：C-Eval（52 个学科、13,000+ 题）、MMLU（57 个学科、57,000+ 题）、ARC（7,900+ 题）。 -- **数学类**：GSM8K（8,000+ 小学数学问题）。 -- **推理类**：HellaSwag（70,000+ 推理题）、BBH（23 个高难度推理题）。 +使用开发者自有数据集和自定义维度进行评测，支持三种评分方式： -## 关键参数 +| 评分方式 | 说明 | 适用场景 | 裁判模型费用 | +|---------|------|---------|------------| +| 大模型评估（AI 自动评测） | 由裁判模型（推荐千问-Max）对回答进行评分。数值型输出整数分，分类型输出 Pass/Fail | 问答质量、内容安全等需语义理解的场景 | 有 | +| 规则评估（自动化指标） | 使用 ROUGE、BLEU、Cosine 等算法或字符串匹配直接计算 | 翻译、摘要、Function Calling 等有确定性标准的场景 | 无 | +| 人工评估（人工标注） | 人工逐条查看推理结果并标注 Pass/Fail | 创意性写作、专业领域判断等机器难以准确评价的场景 | 无 | -### 评分器 Prompt 中的核心变量 +### 基线评测 -仅适用于**大模型评估-数值型**和**大模型评估-分类型**评测维度，裁判模型会接收以下三个变量： +使用公开标准数据集（C-Eval、MMLU、ARC、GSM8K、BBH、HellaSwag）快速评测模型基础能力，无需自行准备数据集或配置维度。 -| 变量名 | 说明 | 使用场景 | -| --- | --- | --- | -| `${prompt}` | 原始输入（用户问题或指令） | 所有场景必填 | -| `${output}` | 模型输出（参评模型生成的回答） | 所有场景必填 | -| `${completion}` | 参考答案（标准答案或期望输出） | 有标准答案时使用 | +> **注意**：基线评测仅北京地域可用。其他地域控制台不显示此选项，属正常行为。基线评测不支持结果下载，也不支持推理结果集数据来源。 -### System Prompt 与评分器 Prompt 的区别 +## 评测流程 -| Prompt 类型 | 配置位置 | 作用对象 | 是否必填 | 费用归属 | -| --- | --- | --- | --- | --- | -| System Prompt | 创建**评测任务**时 | 被评测模型 | 否 | 被评测模型推理费用 | -| 评分器 Prompt | 创建**大模型评估**评测维度时 | 裁判模型 | 是 | 裁判模型评分费用 | +端到端流程分为四个阶段： -形象比喻：System Prompt 告诉"学生"（被评测模型）以什么身份答题；评分器 Prompt 告诉"阅卷老师"（裁判模型）如何批改试卷。 +1. **准备数据集**：在数据管理模块上传评测集（EvaluationSet）类型的数据，包含 Prompt（用户问题）和 Completion（参考答案）两列。 +2. **创建评测维度**：定义评分标准和方式，从 5 种维度类型中选择（大模型评估-数值型/分类型、规则评估-文本相似度/字符串匹配、人工评估-分类型）。维度类型创建后不可修改。 +3. **创建评测任务**：选择被评测模型、关联数据集和维度，可选参与排行榜。 +4. **查看结果**：在指标统计 Tab 查看综合得分和通过率，在数据明细 Tab 查看逐条评分。 -### 评分器模板 +需注意区分两个核心概念：**评分器 Prompt** 配置于评测维度，指导裁判模型如何打分；**System Prompt** 配置于评测任务，为被评测模型设定角色定位，通常可留空。 -系统预置三种模板（创建评测维度时选择）： +## 评测维度配置 -- **综合评测**（默认）：从相关性、文化敏感性、信息丰富性、清晰性、用户参与度 5 个维度评分，适合通用对话、客服场景。 -- **语义相似度**：评估输出与参考答案的语义接近程度，适合问答系统、知识检索。 -- **自定义评测**：自行编写 Prompt，适合特定业务场景。 +根据[模型评测](../../raw/model-user-guide/model-evaluation-introduction/model-evaluation-overview.md)文档，支持以下 5 种维度类型： -## 使用方式 +| 维度类型 | 评分方式 | 适用场景 | +|---------|---------|---------| +| 大模型评估-数值型 | 裁判模型打分（整数，如 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}`（参考答案），须至少包含一个变量。 -1. **准备工作**：定义评测维度（评分标准）→ 准备测试数据（问题和答案）。 -2. **创建评测任务**：选择模型 → 选择数据 → 选择维度 → 决定是否参与排行榜。 -3. **执行评测**：自动评测（系统自动完成）或人工评测（需手动标注）。 -4. **查看结果**：得分报告 → 通过率统计 → 详细明细。 +### 规则评估算法选择 -### 自定义评测数据 +文本相似度支持 7 种算法：ROUGE-1、ROUGE-2、ROUGE-L（文本摘要）、BLEU（翻译）、Cosine（语义理解和开放问答）、Fuzzy Match（OCR 和语音识别）、Accuracy（精确匹配）。字符串匹配支持相等、不相等、包含三种方式。 -自定义评测支持两种数据来源类型： +## 数据来源配置 -- **评测数据集**：包含 Prompt 和 Completion 两列，系统调用模型实时推理生成 Output 再评分，适用于首次评测、对比多个模型、模型尚未生成结果的场景。 -- **推理结果集**：已包含 Output 列，系统直接读取 Output 评分（不推理），适用于模型已生成结果、降低推理成本、作为对照组基准模型的场景。 +创建评测任务时可选择两种数据来源： -数据格式为 Excel，数据量建议：小规模验证 50–100 条，正式评测 200–500 条，全面评估 500+ 条。 +| 对比项 | 评测数据集 | 推理结果集 | +|-------|-----------|-----------| +| 数据内容 | 包含 Prompt 和 Completion | 已包含模型 Output | +| 推理调用 | 系统调用被评测模型推理 | 不调用模型推理 | +| 推理费用 | 产生 | 不产生 | +| 适用场景 | 首次评测、标准流程 | 已有模型输出，降低成本 | -> **注意**：模型评测只能使用**评测集**类型的数据集，不支持训练集。 +数据量建议：小规模验证 50-100 条，正式评测 200-500 条，全面评估 500 条以上。 -### 任务状态 +## 排行榜 -评测任务状态包括：**待执行**（高峰时段排队）、**进行中**（系统正在评测）、**评测完成**（可查看结果）、**评测失败**、**评测终止**（人工手动终止）。 +排行榜用于在相同评测维度下横向对比多个模型。创建时须选择评测维度（创建后不可修改），得分范围为 0-100（基于关联维度综合评分计算，与维度本身评分范围不同）。为确保公平性，建议所有任务使用相同数据集。 -### 结果查看 +## 评测结果分析 -任务完成后进入详情页： +据[模型评测](../../raw/model-user-guide/model-evaluation-introduction/model-evaluation-overview.md)文档的建议： -- **数据明细** Tab：查看每条数据的 Prompt、Completion、Output 及对应评测维度的评分。 -- **指标统计** Tab：查看综合得分（评测维度的平均分）、通过率（达到阈值的样本占比）、评测集总量、已完成量、未完成量。 +- 关注**分数分布**而非仅看综合得分。综合得分是各维度平均分，可能掩盖维度间差异。 +- **1-3% 的分数差异**通常为评测噪声，不建议仅凭微小分差做决策。 +- 使用人工评估维度的任务须全部数据标注完成后才变为评测完成状态。 +- 评测结果支持下载（待执行状态和基线评测任务除外）。 -基线评测的结果报告还提供分学科得分明细、能力雷达图和与业界标准模型的行业对比。 +## 计费说明 -## 限制和注意事项 +评测费用由两部分构成： -- **模型支持范围**：自定义评测支持千问系列（QwQ/Max/Plus/Turbo/Coder/Math）、千问开源版（Qwen3/Qwen2.5/Qwen2/Qwen1.5）、通义法睿及部分第三方文本生成模型；列表可能随时变化，以创建任务页面显示为准，灰色且无"申请"按钮的模型暂不支持评测。完整说明见[模型评测](../../raw/model-user-guide/model-evaluation-introduction/model-evaluation-overview.md)。 -- **基线评测仅支持调优模型**：不支持预置模型，需先完成[模型调优](../concepts/fine-tuning.md)与部署。 -- **数据集类型限制**：自定义评测仅支持评测集，不支持训练集。 -- **评分器 Prompt 适用范围**：仅大模型评估类型（数值型、分类型）需要配置，规则评估和人工评估类型不涉及。 -- **费用归属**：System Prompt 产生被评测模型推理费用，评分器 Prompt 产生裁判模型评分费用，使用时需关注成本。 -- **排行榜使用**：用于对比多个模型在同一评测维度上的表现，需在创建任务时选择参与。 +| 维度类型 | 被评测模型推理费 | 裁判模型评分费 | +|---------|----------------|--------------| +| 大模型评估（数值型/分类型） | 按 Token 计费 | 按 Token 计费 | +| 规则评估（字符串匹配/文本相似度） | 按 Token 计费 | 无 | +| 人工评估（分类型） | 按 Token 计费 | 无 | +| 使用推理结果集时 | 无 | 按维度类型决定 | -## 来源文档 +推理费用计算公式：输入 Token 数 / 1M x 输入单价 + 输出 Token 数 / 1M x 输出单价。已部署的调优模型评测不额外计费（推理费用已含在部署算力费用中）。 -- [模型评测](../../raw/model-user-guide/model-evaluation-introduction/model-evaluation-overview.md) +### 成本优化策略 +1. **先小规模验证**：使用 50-100 条数据验证配置正确性，确认无误后再扩大规模。 +2. **保存推理结果集复用**：首次评测后下载含模型 Output 的结果，后续评测使用推理结果集方式避免重复推理。 +3. **优先选规则评估**：无裁判模型费用，适用于翻译、摘要、Function Calling 等有确定性标准的场景。 +## 限制与注意事项 +- 当前仅支持文本生成类模型评测。 +- 维度类型创建后不可修改，选错需删除重建。 +- 评测任务提交后不可更换目标模型，选错需删除重建（已消耗 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 d9f45ec..cc7f030 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/model-experience.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/model-experience.md @@ -1,181 +1,222 @@ # model experience -百炼平台模型体验中心提供覆盖文本、视觉、音频、视频、3D、向量等多种模态的模型服务，开发者可根据业务场景按需选型并快速接入。本页按模态维度汇总各类模型的核心能力、推荐选型和关键参数，帮助开发者在一个页面内完成全景了解。 +百炼平台模型体验中心提供覆盖文本、视觉、音频、视频、图片、3D、向量等全模态的模型服务。开发者可通过模型广场快速试用和接入各类模型，支持 OpenAI 兼容 API、WebSocket 实时流式、HTTP 异步任务等多种调用方式。本文按模态分类梳理各场景的推荐模型、核心能力与关键参数，帮助开发者快速选型。 ## 文本生成 -文本生成模型适用于聊天机器人、内容生成、摘要总结、文档处理、AI Agent 等场景。推荐从 `qwen3.7-plus` 入手，能力与成本均衡，拥有 1M [上下文窗口](../concepts/context-window.md)和完整内置工具支持。如需最强推理能力，可选择 `qwen3.7-max`；追求低成本则可用 `qwen3.6-flash`，效果接近旗舰模型。 +文本生成是最常用的模型能力，覆盖聊天机器人、内容生成、摘要总结、AI 编程、Agent 开发等场景。详细信息参见[文本生成](../../raw/model-user-guide/model-experience/text-generation-model.md)。 + +### 推荐模型 + +- `qwen3.7-max`：旗舰推理模型，1M 上下文，最强推理能力，成本较高。 +- `qwen3.7-plus`：能力与成本均衡的首选，1M 上下文，完整工具调用和内置工具支持。 +- `qwen3.6-flash`：效果接近旗舰、成本更低，1M 上下文，适合确认效果后降本。 +- `deepseek-v4-pro` / `deepseek-v4-flash`：第三方模型，1M 上下文，支持思考模式和 Function Calling。 ### 核心能力 | 能力 | 说明 | |------|------| -| 思考模式 | 通过 `enable_thinking` 参数开启逐步推理，适用于多步数学计算、代码调试等场景。所有 Qwen3 及以上模型均支持 | -| Function Calling | 所有通用模型均支持自定义工具调用 | -| 内置工具 | 联网搜索、代码解释器、网页抓取等，无需复杂配置 | -| 结构化输出 | 返回有效 JSON，适合信息提取场景 | -| 批量推理 | 大量请求且对延迟要求不高的场景，可降低成本 | - -### 主要推荐模型 +| 思考模式 | 通过 `enable_thinking` 参数开启，所有 Qwen3 及以上模型均支持 | +| Function Calling | 自定义工具调用，所有通用模型均支持 | +| 内置工具 | 联网搜索、代码解释器、网页抓取等，无需额外配置 | +| 结构化输出 | 获取有效 JSON 返回 | +| 批量推理 | 大量请求且对延迟要求不高时降低成本 | -| 模型 ID | 上下文 | 定位 | -|---------|--------|------| -| `qwen3.7-max` | 1M | 最强推理能力 | -| `qwen3.7-plus` | 1M | 能力与成本均衡（推荐起步） | -| `qwen3.6-flash` | 1M | 低成本，效果接近旗舰 | -| `deepseek-v4-pro` / `deepseek-v4-flash` | 1M | 三方模型 | +### 闭源模型迁移参考 -从 GPT、Claude 或 Gemini 迁移时，可按能力档对位选择：高能力对应 `qwen3.7-max`，平衡对应 `qwen3.7-plus`，轻量对应 `qwen3.6-flash`。详细模型列表和功能对比参见[文本生成](../../raw/model-user-guide/model-experience/text-generation-model.md)。 +| 能力档位 | 闭源代表 | 百炼推荐 | +|----------|----------|----------| +| 高能力 | GPT-5.5、Claude Opus 4.7 | `qwen3.7-max` | +| 平衡 | GPT-5.4、Claude Sonnet 4.6 | `qwen3.7-plus`、`deepseek-v4-pro` | +| 轻量低成本 | GPT-5.4-mini、Claude Haiku 4.5 | `qwen3.6-flash`、`deepseek-v4-flash` | ## 视觉理解 -视觉理解模型支持图像分析、视频理解和 OCR 文档提取。推荐从 `qwen3.7-plus` 开始，支持 1M 上下文、最长 2 小时视频、Function Calling 和内置工具。 +视觉理解模型支持图像分析、视频理解、OCR 等场景。推荐从 `qwen3.7-plus` 开始，它支持 1M 上下文、最长 2 小时视频、每张图片最高 1600 万像素。详细信息参见[视觉理解](../../raw/model-user-guide/model-experience/vision-model.md)。 ### 关键参数 -- **图像分辨率**：大多数模型支持每张图片最高 1600 万像素，[Token](../concepts/token.md) 数按 `h x w / (32 x 32) + 2` 计算 -- **视频支持**：最长 2 小时 / 2GB（Qwen3.7、Qwen3.6、Qwen3.5 系列），最长 1 小时 / 2GB（Qwen3.5-Omni 系列，同时支持音频输入） -- **OCR 专用**：`qwen-vl-ocr` 针对文档、表格、手写内容优化 +- **图像分辨率**：大多数模型支持每张图片最高 1600 万像素，Token 计算公式为 `h x w / (32 x 32) + 2`。 +- **视频支持**：`qwen3.7-plus`、`qwen3.6-flash` 等支持最长 2 小时 / 2GB 视频输入。 +- **OCR**：`qwen3.5-ocr` 专为文档、表格、手写内容优化。 -详细参数和完整模型列表参见[视觉理解](../../raw/model-user-guide/model-experience/vision-model.md)。 +### 推荐模型 + +| 模型 | 上下文 | 最大视频时长 | Function Calling | 结构化输出 | +|------|--------|-------------|------------------|-----------| +| `qwen3.7-plus` | 1M | 2 小时 | 支持 | 支持 | +| `qwen3.6-flash` | 1M | 2 小时 | 支持 | 支持 | +| `qwen3.5-ocr` | -- | -- | -- | -- | ## 视频生成与编辑 -百炼提供文生视频、图生视频、参考生视频、视频编辑和角色动画等能力。 +视频生成模型支持文生视频、图生视频、参考生视频、视频编辑和角色动画等场景。详细信息参见[视频生成与编辑](../../raw/model-user-guide/model-experience/video-generate-edit-model.md)。 -### 按场景选型 +### 推荐模型 | 场景 | 推荐模型 | 最大分辨率 | 最大时长 | -|------|---------|-----------|---------| +|------|----------|-----------|----------| | 文生视频 | `happyhorse-1.1-t2v` | 1080P | 3-15 秒 | | 首帧生视频 | `happyhorse-1.1-i2v` | 1080P | 3-15 秒 | -| 首尾帧生视频（长视频串联） | `wan2.7-i2v-2026-04-25` | 1080P | 2-15 秒 | -| 参考生视频（角色一致性） | `happyhorse-1.1-r2v` | 1080P | 3-15 秒 | +| 首尾帧生视频 | `wan2.7-i2v-2026-04-25` | 1080P | 2-15 秒 | +| 参考生视频 | `happyhorse-1.1-r2v` | 1080P | 3-15 秒 | | 视频编辑 | `happyhorse-1.0-video-edit` | 1080P | 3-15 秒 | | 动作迁移 | `wan2.2-animate-move` | 720P | 2-30 秒 | -如需传入自定义音频文件，推荐使用 Wan 2.7 系列。详细说明参见[视频生成与编辑](../../raw/model-user-guide/model-experience/video-generate-edit-model.md)。 +如需传入自定义音频文件，推荐使用 `wan2.7-t2v-2026-06-12`（文生视频）或 `wan2.7-i2v-2026-04-25`（图生视频）。首尾帧模型可串联多个片段实现长视频叙事。 ## 图片生成与编辑 -推荐使用 `wan2.7-image-pro`，集成了文字渲染、品牌色控制、角色一致性多图生成和图片编辑功能，文生图最高 4096x4096，编辑最高 2048x2048。 +图片生成模型支持文生图、图片编辑、文字渲染、角色一致性多图生成等场景。详细信息参见[图片生成与编辑](../../raw/model-user-guide/model-experience/image-model.md)。 + +### 推荐模型 -| 模型 ID | 适用场景 | 最大分辨率 | -|---------|---------|-----------| -| `wan2.7-image-pro` | 文字渲染、品牌色、角色一致性、多图编辑 | 4096x4096 | -| `z-image-turbo` | 快速生成、低成本、写实人像 | 2048x2048 | -| `qwen-image-2.0-pro` | 负向提示词、最多 6 张变体 | 2048x2048 | +| 模型 | 场景 | 文生图 | 编辑 | 最大分辨率 | +|------|------|--------|------|-----------| +| `wan2.7-image-pro` | 文字渲染、品牌色、角色一致性 | 支持 | 支持 | 4096x4096 | +| `z-image-turbo` | 快速生成、低成本、写实人像 | 支持 | 不支持 | 2048x2048 | +| `qwen-image-2.0-pro` | 负向提示词、最多 6 张变体 | 支持 | 支持 | 2048x2048 | -详细使用方式参见[图片生成与编辑](../../raw/model-user-guide/model-experience/image-model.md)。 +- `z-image-turbo` 生成速度快 10 倍、价格约为 `wan2.7-image-pro` 的 1/5，适合只需生成不需编辑的场景。 +- 需要负向提示词时使用 `qwen-image-2.0-pro`。 ## 3D 模型生成 -通过 Tripo 模型支持文生 3D、单图生 3D 和多图生 3D 三种模式，输出 GLB 格式的 PBR 材质模型。 +通过 Tripo 模型支持文生 3D、单图生 3D 和多图生 3D 三种模式。详细信息参见[Tripo 3D模型生成](../../raw/model-user-guide/model-experience/tripo-3d-generation-guide.md)。 + +### 模型选型 | 模型 | 最高面数 | 速度 | 适用场景 | -|------|---------|------|---------| +|------|---------|------|----------| | `Tripo/Tripo-H3.1` | 200 万面 | 较慢 | 影视级渲染、高精度数字资产 | -| `Tripo/Tripo-P1.0` | 2 万面 | 更快 | 快速预览、游戏/AR 场景 | +| `Tripo/Tripo-P1.0` | 2 万面 | 更快 | 快速预览、游戏/AR、实时应用 | -> **注意**：3D 生成为异步任务，通常需要数分钟，建议轮询间隔 15 秒。该服务仅在华北2（北京）地域可用。 +> **注意**：Tripo 3D 模型生成仅适用于华北2（北京）地域，必须使用该地域的 API Key。 -调用流程为提交任务获取 `task_id`，再轮询任务状态直到 `SUCCEEDED`。详细 API 示例参见[Tripo 3D模型生成](../../raw/model-user-guide/model-experience/tripo-3d-generation-guide.md)。 +### 使用方式 -## 语音合成（TTS） +调用为异步任务模式：先 POST 创建任务获取 `task_id`，再轮询 GET 获取结果。轮询间隔建议 15 秒。输出产物为 GLB 格式的 3D 模型文件，可直接导入 Blender、Unity 等工具。通过 `texture_quality` 参数控制贴图质量（`standard` / `detailed`），`Tripo-H3.1` 还支持 `geometry_quality` 控制几何精度。 -语音合成模型将文本转换为自然语音，支持标准内置音色和自定义音色两种模式。 +## 语音合成 -### 选型要点 +语音合成模型将文本转换为自然语音，支持标准合成、声音复刻和声音设计。详细信息参见[语音合成](../../raw/model-user-guide/model-experience/tts-model.md)。 -- **标准语音合成**（内置音色）：推荐 `cosyvoice-v3-plus` 或 `MiniMax/speech-2.8-hd`，选择即用 -- **声音复刻**（从音频样本复刻）：推荐 `cosyvoice-v3.5-plus` 或 `MiniMax/speech-2.8-hd` -- **声音设计**（文字描述创建音色）：推荐 `cosyvoice-v3.5-plus` -- **指令控制**（自然语言控制语速、情绪）：CosyVoice 系列和 Qwen3-TTS-Instruct 系列支持 +### 推荐模型 -### 接入方式 +| 模型 | 接入方式 | 声音复刻 | 声音设计 | 指令控制 | +|------|---------|---------|---------|---------| +| `cosyvoice-v3.5-plus` | WebSocket / HTTP | 支持 | 支持 | 支持 | +| `cosyvoice-v3-plus` | WebSocket / HTTP | 支持 | 支持 | 不支持 | +| `MiniMax/speech-2.8-hd` | HTTP | 支持 | 不支持 | 不支持 | -- **WebSocket**：流式输入和输出，延迟最低，适用于实时交互场景 -- **HTTP**：发送完整文本，支持流式返回音频，适用于有声阅读等场景 +### 关键决策 -详细说明参见[语音合成](../../raw/model-user-guide/model-experience/tts-model.md)。 +- **WebSocket vs HTTP**：WebSocket 支持流式输入输出、延迟最低，适合实时对话；HTTP 适合有声阅读等非实时场景。 +- **声音复刻**：已有目标人物录音时使用，合成语音与原始说话人高度相似。 +- **声音设计**：无录音素材时使用，通过文字描述创建全新音色。 +- **指令控制**：用自然语言动态控制语速、情绪和风格，CosyVoice 系列和 Qwen3-TTS-Instruct 系列支持。 ## 语音转语音（S2S） -S2S 模型提供端到端的"语音输入到语音输出"能力，相比 ASR + LLM + TTS 的 Pipeline 方案延迟更低，且能感知语调和情绪。 +S2S 模型支持语音对话、语音翻译、同声传译等"语音输入到语音输出"场景。详细信息参见[语音转语音](../../raw/model-user-guide/model-experience/s2s-model.md)。 + +### S2S vs Pipeline + +| 维度 | S2S 单模型 | Pipeline（ASR + LLM + TTS） | +|------|-----------|---------------------------| +| 延迟 | 低（单模型流式处理） | 较高（3 阶段串行） | +| 音频理解 | 端到端，能感知语调和情绪 | 先转文本，音频细微信息丢失 | +| 音色定制 | 预设音色 | 支持声音克隆和声音设计 | + +### 按场景选模型 | 场景 | 推荐模型 | API | |------|---------|-----| -| 语音助手 / 客服对话 | `qwen3.5-omni-plus-realtime` | WebSocket | -| 成本敏感的对话 | `qwen3.5-omni-flash-realtime` | WebSocket | -| 同声传译 / 直播翻译 | `qwen3.5-livetranslate-flash-realtime` | WebSocket | -| 视频配音 / 播客翻译 | `qwen3-livetranslate-flash` | HTTP | +| 语音助手/客服对话 | `qwen3.5-omni-plus-realtime` | WebSocket | +| 成本敏感对话 | `qwen3.5-omni-flash-realtime` | WebSocket | +| 同声传译/直播翻译 | `qwen3.5-livetranslate-flash-realtime` | WebSocket | +| 视频配音/播客翻译 | `qwen3-livetranslate-flash` | HTTP | -Qwen3.5-Livetranslate 支持 60 种语言互译。当需要自定义音色时，应选择 Pipeline 路线。详细对比参见[语音转语音](../../raw/model-user-guide/model-experience/s2s-model.md)。 +翻译语言覆盖方面，Qwen3.5-Livetranslate 支持 60 种语言，Qwen3.5-Omni 支持 29 种输出语言，Qwen3-Omni-Flash 支持 11 种。 ## 语音识别（ASR） -语音识别模型将语音转换为文本，支持实时识别和录音文件识别。 +语音识别模型支持实时语音识别和录音文件转写。详细信息参见[语音识别](../../raw/model-user-guide/model-experience/asr-model.md)。 -### 选型决策 +### 推荐模型 -| 维度 | 推荐 | -|------|------| -| 实时识别 + 热词增强 | `fun-asr-realtime`（WebSocket） | -| 非实时识别 + 说话人分离 | `fun-asr`（HTTP，最长 12 小时 / 2GB） | -| 实时识别 + Prompt 上下文 | `qwen3.5-omni-plus-realtime`（WebSocket） | -| 情感识别 | `qwen3-asr-flash-realtime` / `qwen3-asr-flash-filetrans` | +| 模型 | 模式 | 精度增强 | 情感识别 | 说话人分离 | +|------|------|---------|---------|-----------| +| `fun-asr-realtime` | 实时 | 热词 | 不支持 | 不支持 | +| `fun-asr` | 非实时 | 热词 | 不支持 | 支持 | +| `qwen3.5-omni-plus-realtime` | 实时 | Prompt 上下文 | 支持 | 不支持 | +| `qwen3.5-omni-plus` | 非实时 | Prompt 上下文 | 支持 | 不支持 | + +### 选型要点 -Fun-ASR 系列支持热词（预配置术语列表），Qwen3.5-Omni 系列支持 Prompt 上下文注入（每次请求自适应，无需预配置）。详细说明参见[语音识别](../../raw/model-user-guide/model-experience/asr-model.md)。 +- **热词 vs Prompt 上下文**：热词适合稳定术语表（Fun-ASR），Prompt 上下文无需预配置、模型自适应（Qwen3.5-Omni）。 +- **说话人分离**：仅 Fun-ASR 非实时模型支持。 +- **情感识别**：Qwen-ASR 和 Qwen3.5-Omni 系列支持。 ## 音乐生成 -Fun-Music 支持通过提示词描述或自定义歌词生成完整歌曲（含人声）或纯音乐，输出 MP3 或 WAV 格式。 +Fun-Music 模型支持通过提示词或自定义歌词生成完整歌曲或纯音乐。详细信息参见[音乐生成](../../raw/model-user-guide/model-experience/fun-music.md)。 | 模型 | 特点 | |------|------| -| `fun-music-v1` | 支持 [prompt](prompt.md) 或 lyrics 输入，支持选择男/女声 | -| `fun-music-preview` | [prompt](prompt.md) 必选，不支持 gender 参数 | +| `fun-music-v1` | 支持 `prompt` 和 `lyrics`（至少传一个），支持性别选择 | +| `fun-music-preview` | `prompt` 必选，`lyrics` 可选，不支持性别选择 | -> **注意**：该模型目前处于邀测阶段，仅在华北2（北京）地域可用，需申请开通。 +> **注意**：Fun-Music 目前处于邀测阶段，需在模型广场申请开通，且仅在华北2（北京）地域可用。 -详细 API 调用示例参见[音乐生成](../../raw/model-user-guide/model-experience/fun-music.md)。 +支持 MP3 和 WAV 两种输出格式，可通过 `is_instrumental=true` 生成纯音乐。 -## 向量与[重排序](../concepts/rerank.md) +## 向量与重排序 -向量（Embedding）和[重排序](../concepts/rerank.md)（Rerank）模型用于语义搜索、RAG 检索和跨模态匹配。 +向量和重排序模型支持语义搜索、RAG 检索、跨模态匹配等场景。详细信息参见[向量与重排序](../../raw/model-user-guide/model-experience/embedding-rerank-model.md)。 -### 文本 Embedding +### 推荐模型 -推荐 `text-embedding-v4`，支持 64 至 2048 维（默认 1024），最大 8192 [Token](../concepts/token.md)。维度选择建议：大规模搜索选 256/512 维，通用场景选 1024 维，高精度选 1536/2048 维。 +| 模型 | 类型 | 维度 | 最大 Token | 场景 | +|------|------|------|-----------|------| +| `text-embedding-v4` | 文本 Embedding | 64~2048 | 8,192 | 文本搜索、RAG、聚类 | +| `qwen3-vl-embedding` | [多模态](../concepts/multimodal.md) Embedding | 256~2560 | 32,000 | 图文混合检索 | +| `qwen3-rerank` | 重排序 | - | 4,000/条 | 文本搜索结果重排序 | +| `qwen3-vl-rerank` | 重排序 | - | 8,000/条 | [多模态](../concepts/multimodal.md)搜索结果重排序 | -### [多模态](../concepts/multimodal.md) Embedding +维度选择建议：大规模搜索选 256 或 512 维，通用场景选 1024 维（默认），高精度需求选 1536 或 2048 维。 -- **融合向量**（图文混合检索）：`qwen3-vl-embedding` -- **独立向量**（跨模态搜索）：`tongyi-embedding-vision-plus` +## 全模态 -### [重排序](../concepts/rerank.md) +全模态模型能同时理解文本、音频、图片和视频，并输出文本和语音。详细信息参见[全模态](../../raw/model-user-guide/model-experience/omni.md)。 -- **纯文本**：`qwen3-rerank`，支持 100+ 语言，最多 500 个文档 -- **[多模态](../concepts/multimodal.md)**：`qwen3-vl-rerank`，支持文本、图片和视频混合排序 +### 三大系列 -详细说明参见[向量与重排序](../../raw/model-user-guide/model-experience/embedding-rerank-model.md)。 +| 系列 | 定位 | 输入 | +|------|------|------| +| Qwen3.5-Omni | 旗舰，能力最全，支持 Function Calling 和联网搜索 | 文本、音频、图片、视频 | +| Qwen3-Omni-Flash | 轻量低成本，支持思考模式 | 文本、音频、图片、视频 | +| Qwen3.5-Livetranslate | 专业翻译，60 种语言，约 3 秒延迟 | 音频 | -## 全模态（Omni） - -全模态模型同时理解文本、音频、图片和视频，并输出文本和语音。三个模型系列分别定位不同场景： +### 按场景选型 -- **Qwen3.5-Omni**：旗舰，能力最全，支持 Function Calling 和联网搜索 -- **Qwen3-Omni-Flash**：轻量低成本，支持深度推理（思考模式） -- **Qwen3.5-Livetranslate**：专业翻译，60 种语言，约 3 秒延迟 +| 场景 | 推荐模型 | +|------|---------| +| 实时语音/视频对话 | `qwen3.5-omni-plus-realtime`（WebSocket） | +| 音视频内容分析 | `qwen3.5-omni-plus`（HTTP） | +| 轻量音视频分析 | `qwen3-omni-flash`（HTTP） | +| 实时语音翻译 | `qwen3.5-livetranslate-flash-realtime`（WebSocket） | +| 声音复刻 | `qwen3.5-omni-plus`（HTTP / WebSocket） | -内容分析场景中，Qwen3.5-Omni 支持音频最长 3 小时、视频最长 1 小时。详细使用场景和模型对比参见[全模态](../../raw/model-user-guide/model-experience/omni.md)。 +> **注意**：联网搜索与 Function Calling 不可同时开启。Qwen3-Omni-Flash 的思考模式下不支持生成语音。 -## 通用注意事项 +## 限制和注意事项 -- **[上下文窗口](../concepts/context-window.md)**：100 万 [Token](../concepts/token.md) 约相当于 70 万个汉字。`qwen3.7-plus` 和 `qwen3.6-flash` 均支持 1M 上下文，常规任务 128k-256k 已足够 -- **API 兼容性**：Qwen3.5-Omni 和 Qwen-ASR 等模型支持 OpenAI 兼容的 HTTP API，可降低迁移成本 -- **模型版本锁定**：生产环境建议使用带日期后缀的快照版本（如 `qwen3.7-plus-2026-05-26`）以获得确定性行为 -- **区域限制**：部分服务（如 Tripo 3D、Fun-Music）仅在华北2（北京）地域可用 +- 各模型的上下文窗口、输入限制和计费信息请前往模型广场查看。 +- 部分模型和功能存在地域限制（如 Tripo 仅限北京、Fun-Music 仅限北京）。 +- 旧版模型（如 Qwen2.5 系列、Wan 2.1 系列等）不再作为首选推荐，新项目建议使用最新版本。 +- 第三方模型（DeepSeek、GLM、MiniMax、Kimi 等）的功能支持范围与 Qwen 系列有差异，选型时需对照功能矩阵确认。 ## 来源文档 @@ -192,8 +233,3 @@ 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 2d14abb..9f9946a 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,95 +1,54 @@ # model high speed inference -TPM 预留为指定模型锁定专属推理吞吐量，确保业务高峰期不受公共限流影响。本文介绍百炼平台高速推理方案的选型、TPM 预留的创建与接入、监控管理以及常见问题，帮助开发者在不能接受限流的场景下获得稳定的容量保障。详见 [TPM 预留](../../raw/model-user-guide/model-high-speed-inference/tpm-reservation.md)。 +百炼平台提供 TPM（Tokens Per Minute）预留功能，允许开发者为指定模型锁定专属推理吞吐量，确保业务高峰期不受公共资源限流影响。预留容量内的调用不额外收费，超出部分自动降级为按量计费，服务不中断。 -## 方案对比与选型 +## 方案选型 -百炼为推理调用提供多种容量与计费方案，常见包括按量付费、资源包与节省计划、TPM 预留、PTU 专属部署。不同方案在计费单位、容量保障强度、超额处理方式与接入改动上各有侧重。 +百炼平台提供多种推理容量方案，开发者应根据业务特点选择合适的方式。详细对比参见 [TPM 预留](../../raw/model-user-guide/model-high-speed-inference/tpm-reservation.md) 中的方案对比表。核心区别如下： -| 方案 | 计费单位 | 容量保障 | 适用场景 | 超额处理 | 代码改动 | -| --- | --- | --- | --- | --- | --- | -| 按量付费 | 按 token | 无（共享公共池） | 流量波动大/短期 | 自动服务，受公共限流 | 无需改动 | -| 资源包/节省计划 | 预付费额度 | 承诺用量折扣（非专属容量） | 费用优化 | 超出转按量 | 无需改动 | -| TPM 预留 | 按 kTPM 预付费 | 专属容量刚性兑付 | 流量可预估、不能接受限流 | 超出自动降级公共池按量，不中断 | 替换 model 参数即可 | -| PTU（模型部署） | 按 kTPM 预付费 | 专属部署实例 | 高吞吐高性能 | 超出转按量 | 替换 model 参数即可 | +| 方案 | 容量保障 | 适用场景 | 代码改动 | +|------|---------|---------|---------| +| 按量付费 | 无（共享公共池） | 流量波动大/短期使用 | 无需改动 | +| 资源包/节省计划 | 承诺用量折扣（非专属） | 费用优化 | 无需改动 | +| TPM 预留 | 专属容量刚性兑付 | 流量可预估、不能接受限流 | 替换 model 参数 | +| PTU 专属部署 | 专属部署实例 | 高吞吐高性能 | 替换 model 参数 | -当业务流量可预估且不能接受限流时，优先选择 TPM 预留；对极致性能与隔离有更高要求时，可考虑 PTU 专属部署。 +TPM 预留的核心优势在于：容量专属不共享、超额自动降级不中断、只需替换 `model` 参数即可接入。 ## 支持的模型 -TPM 预留目前分区域开放，具体支持的模型以控制台展示为准。下表列出参考价格（预付费-按天，单位：输入/输出 Per 10,000 TPM）。 +TPM 预留目前支持华北2（北京）和新加坡两个区域，覆盖以下模型（价格为 Per 10,000 TPM）： -### 华北2（北京） +**华北2（北京）**：千问3.7-Max、千问3.7-Plus、千问3.6-Flash、GLM-5.2、GLM-5.1、DeepSeek-v4-Flash、DeepSeek-v4-Pro、Kimi-K2.6。 -| 模型名称 | 输入（Per 10,000 TPM） | 输出（Per 10,000 TPM） | -| --- | --- | --- | -| 千问3.7-Max-2026-05-20 | ¥121.00 | ¥362.90 | -| 千问3.7-Plus-2026-05-26 | ¥20.20 | ¥80.60 | -| 千问3.6-Flash-2026-04-16 | ¥12.10 | ¥72.60 | -| GLM-5.2 | ¥80.60 | ¥282.20 | -| GLM-5.1 | ¥60.50 | ¥241.90 | -| DeepSeek-v4-Flash | ¥10.10 | ¥20.20 | -| DeepSeek-v4-Pro | ¥121.00 | ¥241.90 | -| Kimi-K2.6 | ¥65.50 | ¥272.20 | +**新加坡**：与北京区域模型相同，价格略高。 -### 新加坡 +具体价格以 [TPM 预留](../../raw/model-user-guide/model-high-speed-inference/tpm-reservation.md) 中的价目表或百炼控制台实际展示为准。 -| 模型名称 | 输入（Per 10,000 TPM） | 输出（Per 10,000 TPM） | -| --- | --- | --- | -| 千问3.7-Max-2026-05-20 | ¥188.90 | ¥566.60 | -| 千问3.7-Plus-2026-05-26 | ¥30.20 | ¥120.90 | -| 千问3.6-Flash-2026-04-16 | ¥18.90 | ¥113.30 | -| GLM-5.2 | ¥105.80 | ¥332.40 | -| GLM-5.1 | ¥105.80 | ¥332.40 | -| DeepSeek-v4-Flash | ¥15.10 | ¥30.20 | -| DeepSeek-v4-Pro | ¥181.30 | ¥362.60 | +## 容量换算参数 -> **注意**：上表仅为参考价格，**详细费用以百炼控制台为准**。模型列表与价格会动态调整，请以创建页面实际展示为准。 +不同模型在缓存折扣和长输入阶梯系数上存在差异，影响实际容量消耗： -## 关键参数与容量换算 +- **缓存折扣**：GLM-5.2（25%）、GLM-5.1（20%）、DeepSeek-v4-Pro（8%）、Qwen 系列（20%）。DeepSeek-v4-Flash 和 Kimi-K2.6 不支持缓存。 +- **长输入阶梯系数**：GLM-5.1 在 32K 以上输入时系数提升（输入 1.33/输出 1.17），其余模型无阶梯。 -部分模型支持长输入阶梯系数和缓存折扣，TPM 容量计算器会自动应用这些参数。 +创建预留时，控制台右侧的 TPM 容量计算器会自动应用这些参数，帮助估算所需额度。 -| 模型 | 输入长度上限 | 缓存折扣 | 长输入阶梯系数 | -| --- | --- | --- | --- | -| glm-5.2 | 1 Million | 0.25（缓存命中部分按 25% 折算） | 无阶梯（1.0） | -| glm-5.1 | 200K | 0.2（缓存命中部分按 20% 折算） | [0, 32K)：输入 1.0 / 输出 1.0；[32K, 200K]：输入 1.33 / 输出 1.17 | -| deepseek-v4-pro | 256K | 0.08（缓存命中部分按 8% 折算） | 无阶梯（1.0） | -| deepseek-v4-flash | 256K | 不支持缓存 | 无阶梯（1.0） | -| Kimi-K2.6 | 256K | 不支持缓存 | 无阶梯（1.0） | -| Qwen 系列 | 256K | 0.2（缓存命中部分按 20% 折算） | 无阶梯（1.0） | +## 创建与接入 -容量计算器输入参数说明： +### 创建 TPM 预留 -- **每分钟请求数（RPM）**：业务高峰期每分钟请求数，RPM 越大建议 TPM 同比增大。 -- **平均输入长度（token）**：输入越长，阶梯系数越大，建议输入 TPM 越高。 -- **平均输出长度（token）**：输出越长，建议输出 TPM 越高。 -- **预估缓存命中率（%）**：命中率越高，输入容量消耗越慢，建议输入 TPM 越低；仅影响输入 TPM。 +1. 登录百炼控制台，进入 TPM 预留页面，点击**创建 TPM 预留**。 +2. 填写预留名称、选择模型、设置输入/输出 TPM（单位 kTPM）、购买时长等参数。 +3. 确认费用后提交支付。创建成功后系统自动生成**专属模型 code**。 -## 创建与接入 TPM 预留 +> **注意**：创建 TPM 预留需一次性支付预付费用。建议先使用容量计算器估算所需 TPM 并确认费用。 -前提条件：已开通百炼模型服务、已创建业务空间。登录[百炼控制台](https://bailian.console.aliyun.com/#/efm/tpm_reservation)后单击 **创建 TPM 预留**，参考 [TPM 预留](../../raw/model-user-guide/model-high-speed-inference/tpm-reservation.md) 的流程完成配置。 +### 接入专属模型 code -创建时需填写以下参数： - -| 参数 | 是否必填 | 说明 | -| --- | --- | --- | -| 预留名称 | 是 | 自定义名称，便于识别，≤ 50 个字符 | -| 选择模型 | 是 | 选择需预留容量的模型，提交后自动生成专属模型 code | -| 付费周期 | 是 | 按天 | -| 输入TPM | 是 | 预留输入吞吐量，单位 kTPM（1 kTPM = 1,000 Tokens/分钟），起步和步长因模型而异 | -| 输出TPM | 是 | 预留输出吞吐量，单位 kTPM，起步和步长因模型而异 | -| 购买时长 | 是 | 预留有效时长，支持多种选择 | -| 到期自动续费 | 否 | 到期前一天 08:00 自动扣款续费，默认开启 | -| 单次续费时长 | 否 | 与购买时长取值一致 | - -创建成功后，在详情页 **概览** Tab 复制 **专属模型 code**，并将 API 请求中的 `model` 参数替换为该 code： +将 API 请求中的 `model` 参数替换为专属模型 code 即可使用预留容量： ```python -# 短时间内请求量快速拉升时，系统需要短暂预热以匹配所需算力 -# 预热期间部分请求可能出现延迟波动，预热完成后恢复稳定。 -# 请做好请求排队或重试机制。 - import dashscope response = dashscope.Generation.call( @@ -97,77 +56,54 @@ response = dashscope.Generation.call( model="your-dedicated-model-code", # 替换为专属模型 code messages=[{"role": "user", "content": "你好"}], ) -print(response.output.text) ``` -```bash -# 短时间内请求量快速拉升时，系统需要短暂预热以匹配所需算力 -# 预热期间部分请求可能出现延迟波动，预热完成后恢复稳定。 -# 请做好请求排队或重试机制。 -curl -X POST https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions \ - -H "Authorization: Bearer $DASHSCOPE_API_KEY" \ - -H "Content-Type: application/json" \ - -d '{"model":"your-dedicated-model-code","messages":[{"role":"user","content":"你好"}]}' -``` +短时间内请求量快速拉升时，系统需要短暂预热，期间部分请求可能出现延迟波动，建议做好请求排队或重试机制。 + +### TPM 容量计算器 -## 计费与退订规则 +创建页面右侧提供容量计算器，输入以下参数后自动输出推荐的输入/输出 TPM： -- 部署成功即开始计费，预留容量内的调用不额外收费。 -- 预付费一次性支付，从购买成功起连续生效。 -- 缩容与退订退费：已使用部分按 1.5 倍系数结算，公式为 `退款 = 降量部分预付费 - (降量部分预付费 × 已用时长/购买时长 × 1.5)`。 -- 超出保障额度后自动降级为标准按量计费，服务不中断，可在详情页 **超额降级统计** 中查看降级次数。 +- **每分钟请求数（RPM）**：业务高峰期每分钟请求数 +- **平均输入/输出长度（token）**：每条请求的平均 token 数 +- **预估缓存命中率（%）**：命中率越高，输入容量消耗越低 -实例到期后的状态流转： +## 管理与运维 -- 到期后 **2 小时内**：实例运行中，可继续调用，可续费。 -- 到期后 **2~14 小时**：实例已停止，不可调用，仍可续费。 -- 到期 **14 小时后**：实例已删除，不可恢复。 +### 查看监控 -## 查看与管理 +在预留详情页可查看使用率趋势、配额用量、超额降级统计等监控数据。频繁降级时建议扩容。详见 [TPM 预留](../../raw/model-user-guide/model-high-speed-inference/tpm-reservation.md) 中的管理操作说明。 -在控制台预留列表页，以模型卡片形式展示所有预留实例，支持按模型、时间、状态筛选。进入详情页后包含三个 Tab，详见 [TPM 预留](../../raw/model-user-guide/model-high-speed-inference/tpm-reservation.md)： +### 扩缩容 -- **概览**：基本信息（预留名称、专属模型 code、基础模型、输入/输出容量）、近 7 天统计卡片（生效预留数、TPM 总量与峰值用量、平均利用率）、使用率趋势、超额降级统计。 -- **监控**：利用率、配额用量（输入/输出）、配额内/外调用次数、缓存命中量等详细监控数据。 -- **API 接入**：展示专属模型 code 和调用示例。 +在详情页点击**扩缩容**，调整输入/输出 TPM。变配期间服务不中断。 -### 管理操作 +### 续费与退订 -- **扩缩容**：在详情页概览 Tab 的预留列表中单击 **扩缩容**，调整输入/输出 TPM，变配期间服务不中断。 -- **续费**：单击 **续订** 选择续费时长并完成支付；如已开启 **到期自动续费**，系统在到期前一天 08:00 自动扣款续费。 -- **退订**：单击 **退订** 跳转至费用中心完成退订流程。退订不可恢复，专属模型 code 失效，已有请求回退至公共资源处理。 +- **续费**：支持手动续订和到期自动续费（到期前一天 08:00 自动扣款）。 +- **退订**：退订不可恢复，专属模型 code 失效，请求回退至公共资源。已使用部分按 1.5 倍系数结算：`退款 = 降量部分预付费 - (降量部分预付费 × 已用时长/购买时长 × 1.5)`。 -预留实例状态说明： +### 实例状态 | 状态 | 说明 | -| --- | --- | -| 运行中 | 正常运行，可使用专属模型 code 调用 | +|------|------| +| 运行中 | 正常运行，可调用 | | 待生效 | 已创建，等待生效 | -| 变配中 | 正在执行扩缩容，期间服务不中断 | -| 已停止 | 因欠费等原因停止，续费后可恢复 | -| 已过期 | 到期且未续费，资源已释放 | +| 变配中 | 扩缩容中，服务不中断 | +| 已停止 | 到期后 2~14 小时，续费可恢复 | +| 已过期 | 到期 14 小时后，资源已释放 | | 已取消 | 退订完成，不可恢复 | ## 常见问题 -**Q: 超出预留容量时会怎样？** -超出预留容量的请求自动降级为按量计费处理，服务不中断。可在详情页概览 Tab 的 **超额降级统计** 中查看降级次数和时间。频繁降级时建议扩容。 +**超出预留容量时会怎样？** 超出部分自动降级为按量计费，服务不中断。可在详情页的超额降级统计中查看降级情况。 -**Q: 专属模型 code 怎么获取？** -创建 TPM 预留后系统自动生成专属模型 code，在 TPM 预留详情页的 **概览** Tab 可复制。必须将 API 请求中的 `model` 参数替换为此 code 才能使用预留容量。 +**如何判断是否需要扩容？** 查看 TPM 用量趋势图和超额降级统计，利用率持续接近 100% 或频繁降级时建议扩容。 -**Q: 预留到期后会怎样？** -预留到期后专属模型 code 失效，后续请求自动回退到公共资源处理（按量计费）。建议提前开启 **到期自动续费** 避免服务影响。 - -**Q: 如何判断是否需要扩容？** -在详情页概览 Tab 查看 TPM 用量趋势图和超额降级统计。如果利用率持续接近 100% 或频繁出现降级，建议扩容输入/输出 TPM。 +**预留到期后会怎样？** 专属模型 code 失效，请求回退到公共资源按量计费。建议提前开启到期自动续费。 ## 来源文档 - [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 20035cd..12a6e35 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/model-monitoring.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/model-monitoring.md @@ -57,7 +57,7 @@ **模型监控表格**列出各模型的模型 Code、[业务空间](../concepts/workspace.md)、调用总量、调用失败量、失败率、平均调用时长、平均首包时长（除模型 Code、[业务空间](../concepts/workspace.md)外均可排序），操作列提供**监控**、**日志**入口。 -> 默认[业务空间](../concepts/workspace.md)成员可查看所有[业务空间](../concepts/workspace.md)的模型调用情况；子[业务空间](../concepts/workspace.md)成员仅能查看当前空间数据，无法切换查看其他业务空间。 +> 默认[业务空间](../concepts/workspace.md)成员可查看所有[业务空间](../concepts/workspace.md)的模型调用情况；子[业务空间](../concepts/workspace.md)成员仅能查看当前空间数据，无法切换查看其他[业务空间](../concepts/workspace.md)。 进入目标模型的**监控**详情页后，可查看 4 类监控指标： @@ -72,7 +72,7 @@ 模型监控提供三个层次的成本管理能力（详见[模型监控](../../raw/model-user-guide/model-monitoring/model-telemetry.md)）： -- **汇总**：按业务空间维度汇总历史 Token 消耗，可按时间范围和 [API Key](../concepts/api-key.md) 筛选；调用统计页签的"调用量"区域可查看最近 30 天的 Token 消耗。 +- **汇总**：按[业务空间](../concepts/workspace.md)维度汇总历史 Token 消耗，可按时间范围和 [API Key](../concepts/api-key.md) 筛选；调用统计页签的"调用量"区域可查看最近 30 天的 Token 消耗。 - **追踪**：记录每一次模型调用的 Token 消耗（需开通推理日志，仅北京地域部分模型）。 - **告警**：设置 Token 消耗阈值，异常消耗时立即告警。 @@ -163,3 +163,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 404089e..c4c5c8b 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/plug-in.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/plug-in.md @@ -146,3 +146,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 457a517..0b3d954 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/prompt.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/prompt.md @@ -1,109 +1,96 @@ # prompt -阿里云百炼平台围绕 Prompt 工程提供了一整套能力，覆盖从模板化管理、自动优化到基于样例的反馈优化全流程，帮助开发者把固定结构 Prompt 与动态变量分离、复用并持续提升模型输出质量。相关能力均位于控制台「应用开发 > 组件管理 > 提示词」页面下。 - -> **注意**：Prompt 模板相关功能（Prompt 模板概述、自定义 Prompt 模板）文档明确标注仅适用于华北2（北京）地域，使用前请确认目标[业务空间](../concepts/workspace.md)所在地域。 - -## 核心能力一览 - -| 能力 | 入口 | 是否[计费](../concepts/billing.md) | 关键用途 | -| --- | --- | --- | --- | -| Prompt 模板（预置 + 自定义） | 提示词页面 | 模板管理不额外[计费](../concepts/billing.md) | 把 Prompt 结构与变量分离，统一管理、复用 | -| Prompt 自动优化 | 提示词 > 自动优化 | 不[计费](../concepts/billing.md) | 用大模型重写原始 Prompt，结构更优、指令更清晰 | -| Prompt 样例库 | 样例库页面 | 不收存储费，但增加调用 [Token](../concepts/token.md) | Few-shot 检索样例注入上下文，提升特定领域输出一致性 | -| Prompt 反馈优化 | 提示词 > 反馈优化 | 涉及推理调用 | 基于输入输出样例 + [评测](../concepts/evaluation.md)数据多轮自动评估、反思、优化 | +阿里云百炼提供了一套完整的 Prompt 工程工具链，帮助开发者高效管理和优化提示词。核心能力包括 Prompt 模板（预置与自定义）、Prompt 自动优化、Prompt 样例库以及基于输入输出样例的 Prompt 反馈优化。这些功能覆盖了从模板创建、结构优化到少样本学习引导的完整流程，适用于文本生成、图片生成、智能客服等多种场景。 ## Prompt 模板 -Prompt 模板将 Prompt 的固定结构与动态变量分离，分为预置模板和自定义模板两类，[工作流](../concepts/workflow.md)程统一为：创建模板 → 通过模板 ID 获取模板 → 用业务数据填充变量生成最终 Prompt → 发送给目标模型。详见 [Prompt模板概述](../../raw/application-user-guide/prompt/prompt-template.md)。 +Prompt 模板将提示词的固定结构与动态变量分离，实现可复用的统一管理。模板分为**预置模板**和**自定义模板**两类，详见 [Prompt模板概述](../../raw/application-user-guide/prompt/prompt-template.md)。 -### 预置与自定义对比 +### 预置模板 -- **预置模板**：阿里云百炼提供，覆盖创意文案、办公助理等通用场景，效果稳定、不支持修改，适合 Prompt 设计经验不足的场景。 -- **自定义模板**：用户自行设计，支持修改和迭代，适合金融风控、医疗咨询等复杂或对输出格式有严格要求的场景。可基于预置模板复制（生成「名称_副本_时间戳」），也可从零创建。详见 [自定义Prompt模板](../../raw/application-user-guide/prompt/prompt-custom-template.md)。 +由百炼平台提供，涵盖营销文案、摘要抽取、文案润色、商品评论等通用场景，已经过优化，效果稳定，无需额外开发即可通过控制台或 API 调用。预置模板不支持修改，但可通过"复制模板"创建自定义副本后编辑。 -### 创建方式 +### 自定义模板 -控制台创建自定义模板支持两种输入模式： +支持两种创建方式： -- **自定义创建**：已有现成 Prompt，直接粘贴到文本框，可单击「优化 Prompt」做简单润色后保存。 -- **基于 Prompt 工程创建**：选择 ICIO / CRISPE / RASCEF 等框架，按框架结构填写指令、背景、输出格式等字段，再单击「优化 Prompt」生成结构化 Prompt。 +- **控制台创建**：在"提示词"页面直接创建，或从预置模板复制后修改。支持"自定义创建"和"基于 Prompt 工程创建"两种输入模式。 +- **API 创建**：通过 `CreatePromptTemplate` 接口创建，需要提供 `workspaceId`（[业务空间](../concepts/workspace.md) ID）。 -也可通过 API 创建：先获取 Workspace ID，再调用 `CreatePromptTemplate` 接口。 +自定义模板支持文本生成和图片生成两种类型。文本生成模板可选择 ICIO、CRISPE、RASCEF 等 Prompt 工程框架进行结构化设计；图片生成模板支持分别定义正向和负向提示词。具体创建流程参见 [自定义Prompt模板](../../raw/application-user-guide/prompt/prompt-custom-template.md)。 -### Prompt 工程框架 +### 模板使用方式 -平台内置框架为复杂任务提供结构化思维模型，选择建议如下： +**控制台**：在模板卡片上点击"创建应用"，模板内容自动填充到智能体应用的提示词编辑框中。提示词最大支持 6144 个字符。 -| 框架 | 适用场景 | -| --- | --- | -| ICIO | 简单、明确的任务执行，如数据分析、内容生成、文本摘要 | -| CRISPE | 需要 AI 扮演特定角色的交互，如智能客服、创意写作、面试模拟 | -| RASCEF | 涉及多步骤的复杂业务流程，如项目规划、战略分析、流程设计 | +**API/SDK**：通过 `GetPromptTemplate` 接口拉取模板内容（需 `workspaceId` 和 `promptTemplateId`），将业务数据填入模板变量后生成最终 Prompt，再发送给目标模型。返回内容包含 `variables`（变量列表）、`content`（模板内容）等字段。 -### 图片生成模板 +> **注意**：Prompt 模板功能目前仅适用于**华北2（北京）**地域。 -图片生成模板支持分别定义正向 Prompt（应该包含的内容）和负向 Prompt（应排除的内容），用于控制画面内容与风格。 +## Prompt 自动优化 -### 使用与调用 +当手动编写高质量 Prompt 成本较高时，可使用自动优化功能。该功能利用大模型对原始 Prompt 进行分析和重写，优化策略包括： -- **控制台**：单击模板的「使用 prompt > 创建应用」，模板内容自动填充到[智能体应用](../concepts/agent-application.md)的提示词编辑框（最大 6144 字符），随后选择模型调试。 -- **API / SDK**：通过 `GetPromptTemplate` 接口，传入 `workspaceId` 和 `promptTemplateId` 拉取模板内容（含 `variables`、`content` 等字段），在代码中填充变量后调用模型。相比字符串拼接，接口方式可实现逻辑与内容分离、集中管理与协作、版本一致性保障。 +- **结构重组**：调整整体结构使其更符合逻辑 +- **角色扮演引导**：为模型设定明确的专家角色 +- **指令增强**：将模糊指令具体化、步骤化 +- **安全与边界注入**：增加输出格式、内容限制等边界条件 -## Prompt 自动优化 +操作路径：**应用开发 > 组件管理 > 提示词 > 自动优化**。优化结果可直接复制使用或保存为模板。该功能**不计费**，且提交的数据不会被存储或用于模型训练。详见 [Prompt自动优化](../../raw/application-user-guide/prompt/optimize-prompt.md)。 -当手动编写高质量 Prompt 耗时或缺乏经验时，可让大模型对原始 Prompt 进行结构重组、角色扮演引导、指令增强、安全与边界注入等重写，生成结构更优、效果更稳定的新版本。详见 [Prompt自动优化](../../raw/application-user-guide/prompt/optimize-prompt.md)。 +## Prompt 反馈优化 -操作步骤：进入「提示词 > 自动优化」页面 → 在「原始 prompt」框输入内容 → 单击「优化」查看「优化后 prompt」 → 复制使用或「保存为模板」。该功能不[计费](../concepts/billing.md)，提交的数据不会被存储或用于模型训练。优化失败常见原因包括输入超长超出 [Token](../concepts/token.md) 限制、触发内容审核、网络或服务临时不可用。 +相比普通自动优化，Prompt 反馈优化基于用户提供的**输入输出样例**进行多轮自动化评估和迭代，生成更贴合实际业务场景的 Prompt。其工作流程为： -## Prompt 样例库（Few-shot 检索） +1. 选择推理模型（推荐千问-max） +2. 输入初始 Prompt（描述任务目标） +3. 上传样例数据（建议 5-10 条，每种场景至少 1 条） +4. 上传评测数据（建议至少 20 条，数据越多效果越好） +5. 系统自动进行多轮评测与优化 -针对特定领域专业任务，通用大模型可能难以生成精准或符合预设格式的回答。样例库采用少样本学习思路：从预定义的高质量问答对中检索相关样例注入模型上下文，引导其生成更准确、风格更一致的回复，适用于智能客服、特定领域知识问答、格式化内容生成。详见 [使用Prompt样例库优化模型输出](../../raw/application-user-guide/prompt/prompt-sample-optimization.md)。 +优化后的 Prompt 包含三部分：原始 Prompt、添加的样例（few-shot）、以及自动生成的内容提示（对分类边界等的补充说明）。优化结果可保存为模板或直接创建智能体应用。详见 [基于大模型输入输出样例的Prompt自动优化](../../raw/application-user-guide/prompt/prompt-feedback-optimization.md)。 -> **注意**：Prompt 样例库功能已不再维护，官方推荐将样例库数据迁移到 RAG 表格库。 +## Prompt 样例库 -### 创建与关联 +> **注意**：Prompt 样例库功能已不再维护，推荐将样例库数据迁移到 RAG 表格库中。 -1. 在「样例库」页面新建样例库，支持手动输入或批量导入（小于 20MB 的 Excel，单次最多 100 条）。 -2. 在同[业务空间](../concepts/workspace.md)的[智能体应用](../concepts/agent-application.md)配置中打开「样例库」开关，关联样例库（单应用最多 5 个，采用多路召回策略）。 -3. 可选调整召回片段数（默认 5，最多 10），发布应用使配置生效。 +Prompt 样例库采用少样本学习（Few-shot learning）思路，从预定义的高质量问答对中检索相关样例注入模型上下文，引导模型生成更准确、风格更一致的回复。适用于智能客服、特定领域知识问答、格式化内容生成等场景。 ### 使用限制 -- 单样例库最多 300 条样例；超过建议按业务主题拆分多个库。 -- 单应用最多关联 5 个样例库；单次请求最多召回 10 个片段注入上下文。 -- 批量导入支持 20MB 以内 Excel，单次最多 100 条。 +| 限制项 | 上限 | +|--------|------| +| 单个样例库容量 | 300 条样例 | +| 单应用关联样例库数 | 5 个 | +| 单次召回片段数 | 最多 10 个 | +| 批量导入文件大小 | 20MB（Excel） | +| 单次导入条数 | 100 条 | -### [计费](../concepts/billing.md) +### 计费说明 -样例库本身不收存储或管理费用，但召回样例会增加大模型调用 [Token](../concepts/token.md) 消耗。总输入 [Token](../concepts/token.md) ≈ 用户查询 [Token](../concepts/token.md) + 所有召回样例总 [Token](../concepts/token.md) + 系统指令 [Token](../concepts/token.md)。 +样例库功能本身不收费，但启用后会增加大模型调用的 Token 消耗。总输入 Token 约等于：用户查询 Token + 所有召回样例的总 Token + 系统指令 Token。 -## Prompt 反馈优化 +详见 [使用Prompt样例库优化模型输出](../../raw/application-user-guide/prompt/prompt-sample-optimization.md)。 -相较于纯重写式的自动优化，反馈优化把用户提供的输入输出样例和[评测](../concepts/evaluation.md)数据作为评估标准，对 Prompt 在推理模型上的表现进行多轮自动化评估、反思和优化，最终生成包含原始指令、few-shot 样例和内容提示三部分的优化 Prompt，在用户实际场景中回复质量更高。详见 [基于大模型输入输出样例的Prompt自动优化](../../raw/application-user-guide/prompt/prompt-feedback-optimization.md)。 +## Prompt 工程框架 -### 操作步骤 +百炼平台内置三种 Prompt 工程框架，可在创建自定义文本生成模板时选用： -在「提示词 > 反馈优化」页面单击「新增优化任务」： +| 框架 | 组成要素 | 适用场景 | +|------|----------|----------| +| **ICIO** | 指令、背景信息、补充数据、输出格式 | 简单明确的任务，如数据分析、内容生成、文本摘要 | +| **CRISPE** | 角色与能力、背景信息、任务、输出风格、输出范围 | 需要 AI 扮演特定角色的交互，如客服、创意写作 | +| **RASCEF** | 角色、行动、步骤、上下文、示例、格式 | 多步骤复杂业务流程，如项目规划、战略分析 | -1. **选择推理模型**：在该模型上进行多轮 Prompt [评测](../concepts/evaluation.md)，推荐选择千问-max。 -2. **输入初始 Prompt**：只需描述任务目标。 -3. **样例选择（可选）**：支持直接上传或从样例库选择；建议 5~10 条数据，且每种场景至少一条。样例会被添加到优化后的 Prompt 中。 -4. **上传评测数据**：作为评估最优 Prompt 的标准，建议至少 20 条，数据越多效果越好。 -5. **开始优化**：完成后可保存为 Prompt 模板或直接创建[智能体应用](../concepts/agent-application.md)。 +## 常见问题 -### 典型场景 +**使用 `GetPromptTemplate` 接口和直接在代码中拼接字符串有什么区别？** -以汽车论坛文章分类为例，初始 Prompt 要求按 6 个类别输出 JSON，但模型分类不准确。用户提供手动分类的样例数据与评测数据后，反馈优化生成的 Prompt 在评测集上推理结果由错误转为正确（如质量投诉与销量关系的文本被正确分类为「销量表现」）。 +通过接口管理 Prompt 的优势在于：逻辑与内容分离（可在控制台更新 Prompt 无需重新部署代码）、集中管理与协作（团队共享和版本管理）、一致性保障（避免手动维护导致的不一致）。 -## 限制与注意事项 +**Prompt 自动优化失败的可能原因？** -- **地域限制**：Prompt 模板（预置/自定义）相关功能仅适用于华北2（北京）地域。 -- **字符与 [Token](../concepts/token.md)**：[智能体应用](../concepts/agent-application.md)提示词输入框最大支持 6144 字符；自动优化输入过长会因超出 [Token](../concepts/token.md) 限制而失败。 -- **数据安全**：自动优化提交的数据不会被存储或用于模型训练。 -- **功能维护状态**：Prompt 样例库已不再维护，建议迁移至 RAG 表格库；反馈优化仍为推荐路径。 -- **[计费](../concepts/billing.md)影响**：模板管理与自动优化不额外[计费](../concepts/billing.md)；样例库本身免费但增加调用 Token；反馈优化涉及推理模型多轮调用，会产生相应 Token 费用。 -- **调用失败排查**：若 API 调用返回错误码，参见平台错误码文档定位。 +输入内容超出 Token 限制、触发安全审核策略、或网络/服务临时不可用。 ## 来源文档 @@ -114,12 +101,3 @@ Prompt 模板将 Prompt 的固定结构与动态变量分离，分为预置模 - [基于大模型输入输出样例的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 cfa6ed0..5b90cc6 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/release-notes.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/release-notes.md @@ -1,102 +1,90 @@ # release notes -百炼平台模型与功能的迭代记录汇总，涵盖模型上架/下线、功能动态、计费调整等内容。本页基于 [模型平台功能更新](../../raw/model-user-guide/release-notes/model-release-notes.md) 与 [模型上下架与更新](../../raw/model-user-guide/release-notes/newly-released-models.md) 两篇原始文档整理，便于开发者快速了解平台近期能力变化与可用模型清单。 +百炼平台持续迭代模型能力与平台功能，本页汇总平台功能更新与模型上下架动态。功能更新涵盖模型调优、部署、评测、观测、API 扩展及 SDK 支持等模块；模型动态则记录各类模型（推理、视觉、视频生成、语音、3D 等）的上架时间与能力说明。完整时间线请参阅 [模型平台功能更新](../../raw/model-user-guide/release-notes/model-release-notes.md) 和 [模型上下架与更新](../../raw/model-user-guide/release-notes/newly-released-models.md)。 -## 模型上下架 +## 推理与文本生成模型 -模型上架以华北2（北京）地域为主，服务部署范围覆盖中国内地。下线规则与清单详见[模型下线机制说明](https://help.aliyun.com/zh/model-studio/model-depreciation)。 +百炼持续引入和升级推理模型，覆盖自研千问系列与第三方直供模型： -近期重点上架模型（按时间倒序，摘自 [模型上下架与更新](../../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（阶跃星辰）等均已上架。 -| 时间 | 类型 | 模型规格 | 说明 | -| --- | --- | --- | --- | -| 2026-07-01 | 参考生视频 | wan2.7-r2v-2026-06-12 | 万相2.7 参考生视频快照，支持主体参考、音色定制、多宫格故事板生成剧本化视频 | -| 2026-07-01 | 文生视频 | wan2.7-t2v-2026-06-12 | 万相2.7 文生视频快照，能力与 wan2.7-t2v 一致 | -| 2026-06-25 | 图像生成 | qwen-image-2.0-pro-2026-06-22 | Qwen-Image-2.0 最新快照，文字渲染与写实质感增强，支持 1k token 指令 | -| 2026-06-22 | 文生/图生/参考生视频 | happyhorse-1.1-t2v/i2v/r2v | HappyHorse 1.1 系列，支持有声视频，3~15 秒 720P/1080P | -| 2026-06-18 | 推理模型 | kimi/kimi-k2.7-code-highspeed | 月之暗面高速编程模型，速度提升 5~6 倍 | -| 2026-06-16 | 文字提取 | qwen3.5-ocr | 基于 Qwen3.5，128K 上下文，支持多轮对话与多种卡证信息抽取 | -| 2026-06-15 | 推理模型 | kimi/kimi-k2.7-code | 以编码为中心的智能体模型，仅支持思考模式 | -| 2026-06-10 | 推理模型 | qwen3.7-max-2026-06-08 | Qwen3.7 Max 快照，新增视觉模态理解与多模态交互混合智能体能力 | -| 2026-06-08 | 参考生视频 | pixverse/pixverse-v6-r2v | 爱诗 V6 参考生视频，支持多宫格分镜拼接图转视频 | -| 2026-06-01 | 推理模型 | qwen3.7-plus | 文本能力 + 视觉-语言能力升级，支持 GUI 操作与移动应用导航 | +详细模型列表及上架时间见 [模型上下架与更新](../../raw/model-user-guide/release-notes/newly-released-models.md)。 -更早的上架记录（2026-04 至 2026-05）覆盖 DeepSeek-V4 系列、Qwen3.6 系列、万相 2.7 图像/视频系列、爱诗 C1/V6 系列、智谱 GLM-5/5.1、小米 MiMo-V2.5-Pro、阶跃 Step 3.7 Flash 等，详见原文表格。 +## 视频与图像生成模型 -> **注意**：部分模型存在多个快照版本（如 qwen3.7-max 有 2026-05-17、2026-05-20、2026-06-08 三个快照），调用时请确认所用快照日期，避免因版本切换导致行为变化。 +多媒体生成是百炼近期重点扩展方向，主要模型家族包括： -## 平台功能动态 +- **万相 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 万面。 -按月份组织的关键功能更新（摘自 [模型平台功能更新](../../raw/model-user-guide/release-notes/model-release-notes.md)），按模块归类： +## 语音、OCR 与其他模态 -### [模型调优](../concepts/fine-tuning.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 支持中英文歌曲生成。 -- **强化学习训练（邀约制）**：2026-05-31 上线，基于奖励信号优化模型策略。 -- **图像生成[模型调优](../concepts/fine-tuning.md)**：2026-05-28 支持 Wan/Wanx 系列定制训练。 -- **视觉理解[模型调优](../concepts/fine-tuning.md)**：2026-01-22 新增 VL 模型 SFT 支持。 -- **视频生成模型调优**：2026-01-21 新增万相系列视频模型定制训练。 -- **0 代码安全合规强化**：2026-05-04 上线文本生成模型安全合规训练流程。 -- **模型压缩**：2026-05-25 上线，量化全精度微调模型为低精度版本以降低部署成本。 +## 平台功能更新 -### 模型部署与 API +### 模型调优与部署 -- **API 部署预置模型**：2026-01-23 新增 qwen-flash/qwen-plus 等预置模型部署，并支持按模型单元（MU）时长计费。 -- **模型单元部署**：2025-10-24 上线按时间计费方式，可灵活调整性能、固定成本可预测。 -- **按调用量计费部署**：2024-12-27 支持 qwen2.5-7B/14B/32B/72B 与 qwen2-7B 调优后模型。 -- **文本生成 API 入口聚合**：2026-05-15 新增 OpenAI Responses 与 Anthropic Messages 接口分类。 -- **Responses API 异步调用**：2026-06-01 上线，通过 `background=true` 提交长耗时任务并轮询结果。 -- **异步任务事件回调**：2026-04-23 支持事件总线 EventBridge HTTP 回调与 RocketMQ 主动推送，无需轮询。 +- **调优能力扩展** — 先后新增视觉理解（VL）、视频生成、图像生成模型类型支持，并增加 DPO 偏好训练和强化学习训练（邀约制）。0 代码安全合规强化功能可直接提升模型安全能力。 +- **模型部署** — 支持按模型单元（MU）时长计费和按调用量计费两种模式，可部署预置模型（qwen-flash/qwen-plus 等）及调优后模型。 +- **模型导入** — 支持从 OSS 导入 LoRA 微调模型，已在国际站上线，并开放完整 API。 +- **模型压缩** — 使用量化算法将全精度模型转为低精度版本，降低部署成本。 -### 应用与 SDK +### 模型观测与评测 -- **新版智能体应用 DashScope API**：2026-05-11 首发，支持单轮/多轮、流式、文件问答、视觉理解。 -- **多模态交互开发套件**：陆续上线服务端 Java SDK（4-28）、移动端 Android SDK（4-14）、Linux C++ SDK（2-28）、Android/iOS Lite SDK（2-06）、RTOS C SDK License 模式（4-09）。 -- **通义听悟 Agent**：2026-06-01 新增特惠 ASR 资源包；2026-05-21 工业生产指令转写 WebSocket 协议上线。 -- **通义多模态翻译**：2026-05-26 API 目录上线，覆盖文本/图片/文档/网页翻译；2026-02-06 网页翻译 JSSDK 上线。 -- **Spring AI Alibaba**：2026-06-01 调用百炼智能体、[工作流](../concepts/workflow.md)应用文档上线。 +- **模型观测** — 支持推理日志查看、分钟级高级监控模式、告警与通知、用量统计看板。 +- **模型评测** — 新增排行榜（Leaderboard）和综合评测功能，覆盖 BLEU、ROUGE 等多种评估器。 -### 平台能力 +### API 与开发工具 -- **API Key 加密存储**：2026-06-29 升级业务空间专属推理 API 域名。 -- **临时 API Key**：2026-06-03 新增生成临时 API Key 文档，避免不可信环境下永久 Key 泄露。 -- **模型导入 API**：2026-06-03 上线，涵盖导入任务与自定义模型对象接口；2026-06-05 国际站支持从 OSS 导入 LoRA 微调模型。 -- **模型评测**：2026-06-09 新增排行榜（Leaderboard）与综合评测，支持 BLEU_4 等评分方法。 -- **知识库 RAG**：2026-04-24 检索调用全量投递至 SLS 日志服务；2026-02-05 Retrieve 接口新增排序模型与指令干预模式。 -- **记忆库 Memory 2.0**：2026-03-20 上线，自动提取记忆片段与用户画像，支持多应用共享。 -- **UI 设计器**：2026-04-01 上线，集成魔笔低代码能力，可视化拖放构建网页 UI 应用。 -- **MCP 服务**：2026-02-06 上线官方 MCP 服务，支持平台内集成与外部第三方接入。 -- **Token Plan 团队版**：2026-05-08 新增团队管理，支持 SSO/钉钉登录、席位分配、Credits 用量监控。 +- **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/按量计费三种方式接入。 -## 模型观测与监控 +### 应用与组件 -- **推理日志**：2025-11-06 支持查看用户与模型历史对话内容，用于提示词优化与故障排查。 -- **告警与通知**：2025-06-05 上线，监控指标异常时通知运维团队。 -- **高级监控模式**：2025-04-18 支持分钟级低延时数据刷新，记录 4xx/5xx 详细失败信息。 -- **模型观测能力**：2025-01-21 上线，监测模型使用情况与性能变化。 -- **免费额度与用量看板**：2025-12-22 集中展示各模型免费额度（已用/剩余）及调用量统计。 +- **记忆库 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 协议。 -## 计费调整 +## 计费变动要点 -- **qwen-turbo 资源包退市**：2026-06-28 启动退市通知。 -- **[上下文缓存](../concepts/prompt-caching.md)降价**：见阿里云百炼部分模型[上下文缓存](../concepts/prompt-caching.md)降价通知。 -- **deepseek-v4-pro 缓存计费**：2026-04-29 起 `cached_token` 单价调整为 1 元/百万 token，标准 `input_token` 单价不变。 -- **qwen-max 降价**：2025-02-07 输入价格降低 88%，输出价格降低 84%。 -- **千问系列降价**：2025-01-22 qwen2.5-14b/7b-instruct 降价 50%；qwen2.5-3b-instruct、qwen-vl-72b-instruct 由免费体验转为计费。 -- **千问 VL 模型降价**：2024-12-31 降幅最高 85%。 -- **免费额度用完即停**：2025-07-29 上线，新人免费额度耗尽返回 `AllocationQuota.FreeTierOnly` 错误，避免额外费用。 -- **DeepSeek 系列计费调整**：2025-02-08 部分模型由免费体验转为计费。 +百炼持续推进模型降价，主要变动包括： -> **注意**：原文提及“千问系列模型降价通知”与“通义千问VL系列模型降价通知”两条公告，分别对应不同模型族，使用时请按模型族核对最新价格，不要混淆。 +- 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 +- 新增推理资源包优惠活动与上下文缓存降价 -## 限制与注意事项 +> **注意**：模型价格随时间调整，上述价格仅反映公告时点。最新计费以百炼控制台模型广场页面为准。 -- **模型单元部署**：核心优势为可灵活调整性能、高服务稳定性、可预测的固定成本，但需按模型单元（MU）时长计费。 -- **qwen3.6-max-preview**：仅支持纯文本输入，不支持图像与视频输入；支持思考模式（默认开启）、显式缓存与 Function Calling。 -- **qwen3.7-max 早期快照**（2026-05-17/05-20）：仅支持纯文本输入，仅/默认支持思考模式。 -- **kimi/kimi-k2.7-code**：仅支持思考模式。 -- **Context Cache**：当前支持 qwen-plus 模型（2024-12-24 上线），通过减少重复运算量降低成本。 -- **模型下线机制**：模型下线遵循统一规则，清单见[模型下线机制说明](https://help.aliyun.com/zh/model-studio/model-depreciation)，使用前请确认模型是否处于退市流程。 -- **Batch 任务**：执行时间可能较长，可通过查询接口获取状态；2024-12-20 起支持任务通知。 +## 模型下线机制 + +模型下线遵循统一的退市流程，详见 [模型平台功能更新](../../raw/model-user-guide/release-notes/model-release-notes.md) 中引用的模型下线机制说明。下线前会提前公告通知，建议开发者关注公告并及时迁移到推荐替代模型。 ## 来源文档 @@ -104,7 +92,3 @@ - [模型上下架与更新](../../raw/model-user-guide/release-notes/newly-released-models.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 33e6f70..1ae3135 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 @@ -24,9 +24,9 @@ | 限制模型训练 | 是否可调优（控制台 & API）及调优后部署 | 模型列表 → 模型授权 → 模型训练列 | | 限制[模型部署](../concepts/model-deployment.md) | 是否可直接部署 | 模型列表 → 模型授权 → [模型部署](../concepts/model-deployment.md)列 | -单个 [API Key](../concepts/api-key.md) 只能归属一个地域内的一个[业务空间](../concepts/workspace.md)和一个用户，且不能转移。[API Key](../concepts/api-key.md) 的可调用功能与模型限流与**归属业务空间**的权限保持一致，不受用户控制台权限影响，也无需为不同模型（文生文、文生图、语音合成）创建不同 [API Key](../concepts/api-key.md)。自 2026 年 3 月 25 日起，华北2（北京）地域所有新创建的 [API Key](../concepts/api-key.md) 均归属主账号，并支持设置 IP 访问白名单。 +单个 [API Key](../concepts/api-key.md) 只能归属一个地域内的一个[业务空间](../concepts/workspace.md)和一个用户，且不能转移。[API Key](../concepts/api-key.md) 的可调用功能与模型限流与**归属[业务空间](../concepts/workspace.md)**的权限保持一致，不受用户控制台权限影响，也无需为不同模型（文生文、文生图、语音合成）创建不同 [API Key](../concepts/api-key.md)。自 2026 年 3 月 25 日起，华北2（北京）地域所有新创建的 [API Key](../concepts/api-key.md) 均归属主账号，并支持设置 IP 访问白名单。 -> **注意**：[API Key](../concepts/api-key.md) 的有效性受账号操作影响——将 RAM 账号移出业务空间会使其 [API Key](../concepts/api-key.md) 失效（重新加入后恢复），而在 RAM 控制台删除账号/角色则会使 [API Key](../concepts/api-key.md) 永久失效、不可恢复。 +> **注意**：[API Key](../concepts/api-key.md) 的有效性受账号操作影响——将 RAM 账号移出[业务空间](../concepts/workspace.md)会使其 [API Key](../concepts/api-key.md) 失效（重新加入后恢复），而在 RAM 控制台删除账号/角色则会使 [API Key](../concepts/api-key.md) 永久失效、不可恢复。 ### OpenAPI 接口权限 @@ -37,7 +37,7 @@ RAM 用户默认无权调用百炼应用的数据、[知识库](../concepts/know ### 生产环境实践 -- **空间规划**：推荐按环境（dev/test/prod）划分业务空间实现隔离，或按业务线划分便于权限与成本管理。 +- **空间规划**：推荐按环境（dev/test/prod）划分[业务空间](../concepts/workspace.md)实现隔离，或按业务线划分便于权限与成本管理。 - **限流策略**：将主账号总配额按比例分配给各业务空间并预留缓冲。例如总配额 1000 QPM，可分配 prod 600 / test 200 / dev 100，预留 100。 ## 内容安全：AI 安全护栏 @@ -203,3 +203,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 915b851..5a56e8f 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/skill.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/skill.md @@ -123,3 +123,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 3dd2f08..0b096c6 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/start-using.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/start-using.md @@ -69,3 +69,4 @@ + diff --git a/skills/bailian-docs-llm-wiki/wiki/guides/support.md b/skills/bailian-docs-llm-wiki/wiki/guides/support.md index 73036b5..942fe54 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/support.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/support.md @@ -94,3 +94,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 e4c3f05..565e4c4 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/test-1.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/test-1.md @@ -1,185 +1,122 @@ # test 1 -阿里云百炼平台的计费体系围绕「按量付费」为核心，叠加免费额度、节省计划、资源包等多种优惠方案，覆盖模型调用、模型训练、模型部署等场景。本主题汇总了百炼平台计费、账单与成本管理的全链路要点，帮助您理解计费规则、查询与分摊费用、并选择最优的成本优化方案。 +阿里云百炼平台的计费体系涵盖模型推理调用、模型训练、模型部署三大场景，同时提供免费额度、节省计划、资源包等多种成本优化手段。本文从计费规则、费用查询、成本优化三个维度，帮助开发者快速理解百炼平台的费用结构并做出合理选择。 -## 计费体系总览 +## 计费模式概览 -百炼的计费按**商品名称**维度划分，主要包括： +百炼平台的计费按使用场景分为三类： -- **大模型推理**：模型实时调用（输入/输出 Token）按量计费，分钟级出账（通常 2~10 分钟）。 -- **批量推理（Batch）**：按小时级出账，单价为实时推理的 50%。 -- **模型训练**：按训练 Token 计费，小时级出账。 -- **模型部署**：按使用时长或模型单元计费，支持预付费与后付费。 -- **附加功能**：如联网搜索（`enable_search`）按调用次数单独计费，与推理费用分开出账。 +- **模型推理（调用）**：默认按量付费，按输入/输出 Token 数计费。部分模型支持阶梯计费，单价取决于单次请求的输入 Token 总量。详见[模型调用价格](../../raw/model-user-guide/test-1/model-pricing.md)。 +- **模型训练**：按训练 Token 计费，费用 = 训练数据 Token 总数 x 循环次数 x 训练单价。支持文本生成（千问）、图像生成（万相）、视频生成（万相）等模型的微调训练。 +- **模型部署**：支持按使用时长计费（预置吞吐）和按模型单元计费两种方式，可选后付费或预付费（按天/包月）。 -按量付费采用"预占 + 月结"模式：系统先冻结部分额度，月账期结束后（次月初）生成最终账单并实际扣款。 +> **注意**：免费额度仅抵扣模型实时推理费用，不支持抵扣 Batch 调用、模型调优、模型部署及自定义模型的费用。 -## 免费额度（新人专属） +## 免费额度 -首次开通阿里云百炼时，平台自动发放各模型的免费额度。 +首次开通百炼时，平台自动发放新人免费额度，有效期 30~90 天（2025年9月8日后开通的用户为 90 天）。免费额度仅适用于华北2（北京）地域且服务部署范围为中国内地的模型。主账号与 RAM 子账号共享额度。 -- **适用范围**：仅华北2（北京）地域且服务部署范围为**中国内地**的模型享有免费额度；仅抵扣模型**实时推理**费用，不支持抵扣 Batch 调用、[模型调优](../concepts/fine-tuning.md)、模型部署、自定义模型。 -- **有效期**：30~90 天，自开通或模型申请通过之日起计算。自 **2025 年 9 月 8 日 11 点**起，首次开通的用户获赠额度有效期统一调整为 90 天。 -- **共享规则**：阿里云主账号与其 RAM 子账号共享免费额度。 -- **查看方式**：控制台「模型用量 > 免费额度」页签，或在「模型广场」模型详情页的「免费额度」区域查看（分钟级更新，需手动刷新）。 +关键操作： -### 免费额度用完即停 +- **查看余量**：在控制台[免费额度](https://bailian.console.aliyun.com/?tab=costing-balance#/costing-balance/free-quota)页面查看，或在模型广场详情页的"免费额度"区域查看（分钟级更新，需手动刷新）。 +- **用完即停**：已认证用户免费额度耗尽后会自动扣费。可开启"免费额度用完即停"功能，额度耗尽时返回 `AllocationQuota.FreeTierOnly` 错误码，避免意外扣费。全新未认证用户则默认额度耗尽后停止服务。 -为防止意外扣费，可开启「免费额度用完即停」功能。开启后额度耗尽时停止响应并返回错误码 `AllocationQuota.FreeTierOnly`，不再继续扣费。 +详细规则参见[新人免费额度](../../raw/model-user-guide/test-1/new-free-quota.md)。 -- **开启入口**：「模型用量 > 免费额度」页签（支持单个或批量开启，可一键开启所有模型），或模型广场模型详情页的开关。 -- **关闭时机**：需等到控制台显示「免费额度用完」后才可关闭。 -- **耗尽影响**：全新未认证用户耗尽后无法继续调用，需完成认证并充值；已认证用户若未开启此功能，超出额度将自动按量扣费，可能导致欠费。账户欠费时，即使其他模型仍有免费额度也无法调用。 +## 模型调用价格 -## 模型调用价格（按量计费） +模型推理按量计费，不同模型系列和地域的单价不同。以千问 Max 系列为例（华北2-北京，中国内地部署）： -模型调用默认按量计费，单价取决于**模型版本、服务部署范围（地域）、模式（思考/非思考）、单次请求输入 Token 总量**等因素。部分模型实行**阶梯计费**：单价由单次请求的输入 Token 总量决定，该请求的所有 Token 均按对应阶梯单价结算（区间中 K=1,000，M=1,000,000）。 +| 模型 | 输入单价（每百万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元 | - | -### 计费维度 +千问 Plus 系列（华北2-北京）： -- **文本生成（千问系列）**：分为 Max、Plus、Flash、Turbo、Long、QwQ 等档位，价格递减。例如华北2（北京）中国内地范围下，qwen3.7-max 输入 12 元/百万 Token、输出 36 元/百万 Token；qwen-turbo 输入 0.3 元、输出 0.6 元。 -- **多模态模型**：千问 VL、千问 Omni、千问 OCR、QVQ 等按各自模态的 Token 计费，Omni 系列区分文本/图片/视频、音频等不同输入类型。 -- **图像/视频生成（万相）**：按生成张数或视频时长计费。 -- **语音模型**：CosyVoice、Qwen-TTS、Paraformer 等，TTS 按字符、ASR 按秒计费。 -- **第三方模型**：DeepSeek、GLM、Kimi、MiniMax 等独立计费。 +| 模型 | 输入单价（每百万Token） | 非思考输出 | 思考输出 | 免费额度 | +|------|----------------------|-----------|---------|---------| +| qwen3.7-plus（≤256K） | 2元 | 8元 | 8元 | 100万Token | +| qwen-plus（≤128K） | 0.8元 | 2元 | 8元 | 100万Token | -### 影响价格的因素 +部分模型支持 Batch 调用（输入输出均半价）和上下文缓存（输入 Token 享折扣），两者不能同时生效。海外地域（美国、新加坡、德国、日本）的单价通常高于北京地域。 -- **Batch 调用**：输入和输出 Token 单价均按实时推理价格的 **50%** 计费。 -- **[上下文缓存](../concepts/prompt-caching.md)**：仅输入 Token 享有折扣，与 Batch 折扣不能同时生效。 -- **思考模式**：部分模型（如 qwen-plus）区分非思考与思考模式，思考模式输出单价更高（思维链 + 回答）。 -- **地域差异**：同一模型在华北2（北京）原价最低，海外地域（新加坡、弗吉尼亚、法兰克福、东京）按汇率上浮。 +## 模型训练与部署计费 -> 本文仅展示原价，限时优惠等活动信息请前往百炼控制台模型广场查看。 +### 训练计费 -## 模型训练计费 +训练费用因模型类型而异，详见[模型训练与部署计费](../../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 总数) × 循环次数 × 训练单价`（最小计费单位 1 Token） -- **万相图像生成**：`训练费用 = 训练 Token 总量 × 训练单价`，其中 `训练 Token 总量 ≈ max_steps × Lstep`，Lstep 由 generation_type（t2i/i2i）与 max_token_length（1k/2k）共同决定。 -- **万相视频生成**：`训练 Token 总量 = Σ(视频计费时长) × (max_pixels/1024) × n_epochs`，单条视频计费时长上限因模型而异（wan2.5 最多 10 秒，wan2.2 最多 5 秒）。 +### 部署计费 -主动取消训练会按已消耗 Token 收费；其他原因导致的中断不收费。训练完成的新模型须先完成部署才能评测和调用。 +部署支持两种计费模式： -## 模型部署计费 +1. **预置吞吐（按 TPM）**：费用 = 时长 x (输入 TPM 单价 x 输入 TPM + 输出 TPM 单价 x 输出 TPM)。超出购买的 TPM 量时自动切换为按量付费（返回 Header 包含 `x-dashscope-ptu-overflow:true`）。 +2. **模型单元**：费用 = 时长(小时) x 单元数量 x 单元单价。支持后付费（按小时）和预付费（包月）。部分模型支持 PD 分离模式以降低首 Token 延迟。 -模型部署提供三种计费方式： +## 成本优化方案 -### 1. 按使用时长计费（预置吞吐） - -`费用 = 使用时长 × (输入 TPM 单价 × 输入 TPM + 输出 TPM 单价 × 输出 TPM)` - -- 后付费按小时计算，预付费按天计算。 -- 当输入超过最长输入 Token 或超出购买的 TPM 量时，相关调用自动切换为按量付费模式（响应 Header 含 `x-dashscope-ptu-overflow:true`）。 -- 后付费欠费时资源继续保留并计费 24 小时，超 24 小时停止计费、底层资源被删除，补足欠费后重新分配资源。 - -### 2. 按使用时长计费（模型单元） - -`费用 = 使用时长（小时）× 模型单元数量 × 模型单元单价` - -预付费按月计费时改为 `包月数 × 模型单元数量 × 月单价`。首月提前退订，日单价按 1.2 倍计费。支持 PD 分离模式（降低首 Token 延迟、提高吞吐）。 - -### 3. 按模型 Token 使用量 - -仅当对基础模型完成 SFT 高效训练并得到自定义模型后支持：`费用 = 输入 Token 数 × 输入单价 + 输出 Token 数 × 输出单价`。 - -### 部署计费起点 - -模型状态为**运行中**时开始计费；**部署中**、**欠费**、**部署失败**状态不计费。包月预付费自运行中状态开始消耗包月时间。 - -## 节省计划与资源包 - -为优化成本，百炼提供多种优惠方案。**抵扣顺序统一为：免费额度 > 资源包 > 其他模型节省计划 > AI 通用型节省计划 > 按量付费**。 +百炼提供三种成本优化方案，抵扣优先级为：**免费额度 > 资源包 > 其他模型节省计划 > AI 通用型节省计划 > 按量付费**。 ### AI 通用型节省计划（推荐） -通过承诺每月消费金额换取阶梯式折扣，最高 5.3 折。 +通过承诺每月消费金额换取阶梯折扣，最高 5.3 折。覆盖阿里直供全部模型，灵活性最高。 -- **核心优势**：覆盖阿里直供的全部模型，一次购买跨模型使用；承诺金额越高、周期越长折扣越大；自动抵扣，支持自动续费。 -- **承诺周期**：3 个月、6 个月、12 个月、24 个月。以月为单位，当月未用完部分自动清零，不可累积。 -- **抵扣范围**：支持模型调用（输入/输出 Token）、模型原生工具调用（Function Call、网页抓取）、[上下文缓存](../concepts/prompt-caching.md)、批量推理；**不支持**[模型调优](../concepts/fine-tuning.md)、模型部署。 -- **付款方式**：全预付（一次支付全部承诺金额，折扣最大）或零预付（按月支付，需联系商务经理开通）。 -- **模型分档**：A 类（千问文本/向量/排序/行业模型/工具调用）、B 类（图像/语音/视频）、C 类（qwen3.6-max-preview、DeepSeek、Kimi、GLM、MiniMax、HappyHorse）。三方直供模型不支持抵扣。 -- **金额范围**：1,000 元起，以 10 元为单位调整，不设上限。 +- **承诺周期**：3/6/12/24 个月，月承诺额度 1000 元起（10 元为单位递增） +- **付费方式**：全预付（最大折扣）或零预付（需商务开通） +- **抵扣范围**：模型调用（输入输出 Token）、工具调用（Function Call 等）、上下文缓存、批量推理。不支持抵扣训练和部署费用 +- **折扣示例**：12个月全预付、月承诺 10,000 元，A 类模型（千问文本）享 8 折 + +> **注意**：C 类模型（DeepSeek、Kimi、GLM、MiniMax 等第三方模型）当前不享受节省计划折扣。每月未用完的额度自动清零，不可累积。 ### 其他模型节省计划 -适合用量较小或集中于特定模型的场景，购买后立即生效，超出有效期剩余金额作废、不支持退款。 +针对特定模型系列的一次性购买方案，适合用量集中于单一模型的场景： -- **大语言模型节省计划**：11 档（20 元~500,000 元），均无折扣，有效期 1 个月~1 年。适用于文本生成与多模态模型，**不支持**向量与排序模型。 -- **千问语音模型节省计划**：5 档（20~5,000 元），折扣 9.8~8 折，适用于 CosyVoice、Qwen-TTS、Paraformer、Fun-ASR 等。 -- **向量及排序模型节省计划**：5 档（100~10,000 元），折扣 9~7 折，适用于 text-embedding、gte-rerank 等。 -- **万相模型节省计划**：5 档（20~30,000 元），折扣 9.8~9 折，适用于图像/视频生成模型。 +- **大语言模型推理**：20元~500,000元多档，无折扣，按原价扣费 +- **千问语音模型**：20元~5,000元五档，最高 8 折 +- **向量及排序模型**：100元~10,000元五档，最高 7 折 +- **万相模型**：20元~30,000元五档，最高 9 折 ### 资源包 -预先购买具体 Token 数量或图片张数，用于抵扣特定模型**超出免费额度后**的实时推理用量。 - -- **生效与有效期**：购买后立即生效，无需手动激活；有效期随套餐而定，到期后余量作废。 -- **退订**：未发生使用的部分可申请退款，已使用部分无法退款。 -- **大语言模型推理资源包**：qwen-plus、qwen-max、qwen-turbo 三种，仅抵扣非思考模式实时推理，不支持 Batch、[上下文缓存](../concepts/prompt-caching.md)、调优、部署。qwen-plus 资源包对单次输入超过 128K Token 的部分无法抵扣。 -- **图像生成模型资源包**：qwen-image（文生图消耗 1 张额度，图片编辑消耗 1.2 张）、qwen-image-plus（生成/编辑均消耗 1 张），容量耗尽后自动转按量付费。 - -### 常见抵扣失败原因 +预购具体 Token 数量，抵扣特定模型超出免费额度后的实时推理用量。购买后立即生效，到期未用完自动作废。详见[节省计划与资源包](../../raw/model-user-guide/test-1/savings-plan-and-resource-package.md)。 -- **模型不匹配**：如购买大语言模型节省计划却调用万相或向量模型。 -- **使用了不支持的功能**：调优、部署费用所有节省计划均不抵扣；[上下文缓存](../concepts/prompt-caching.md)、批量推理、工具调用仅 AI 通用型节省计划抵扣。 -- **免费额度未用完**：节省计划/资源包仅抵扣免费额度用尽后的账单。 -- **Token 长度超限**：qwen-plus 资源包对超过 128K 的部分不抵扣。 +## 账单查询与费用管理 -## 账单查询与成本管理 +### 查询账单 -### 出账时机 - -仅在实际调用**结束**后生成账单：大模型推理分钟级出账（2~10 分钟）；批量推理、模型训练、知识库等小时级出账；业务高峰期可能进一步延迟。公测、邀测模型不产生账单记录。 - -### 费用概览 - -百炼控制台「模型 > 用量 & 费用 > 费用概览」展示当月总消费，拆分为**订阅购买费用**（Token Plan、预置吞吐、模型单元、节省计划等）与**账单费用**（按量产生的调用与训练）。支持按模型或 API Key 筛选、对比支出趋势、设置月度费用告警。该页面仅展示大模型推理费用，训练与知识库费用需查账单详情。 - -### 账单详情与字段解读 - -在「费用与成本 > 账单详情」页面，产品名称选择「大模型服务平台百炼」可下载明细。**实例 ID（出账粒度）**字段以英文分号 `;` 分隔，格式为： - -- 标准调用：`ApiKeyID;业务空间ID;模型名称;输入/输出类型;调用渠道;免费额度用完即停标识` -- 控制台调用：`;业务空间ID;模型名称;输入/输出类型;调用渠道;免费额度用完即停标识`（不含 ApiKeyID） - -调用渠道说明：`app`（应用程序调用）、`bmp`（控制台模型体验）、`assistant-api`（Assistant API）。账单的"计费项"统一显示为"大模型文本消耗量"，需通过实例 ID 字段区分具体模型。同一模型按计费类型（输入/输出/缓存命中）和调用渠道分别出账，会产生多行记录。 +- **费用概览**：在控制台"用量 & 费用 > 费用概览"查看当月总消费（订阅购买 + 按量账单），支持按模型或 API Key 筛选 +- **账单详情**：在[账单详情](https://usercenter2.aliyun.com/finance/expense-report/expense-detail)页面，产品名称选"大模型服务平台百炼"。实例 ID 格式为 `ApiKeyID;业务空间ID;模型名称;输入输出类型;调用渠道;免费额度用完即停标识` +- **出账延迟**：推理账单通常 2~10 分钟出账，训练/批量推理/知识库按小时出账 ### 分账管理 -给**业务空间**绑定**标签**可按部门或项目归集费用：在「业务空间管理」获取 Workspace ID，在「标签管理」页面对「大模型服务平台百炼:业务空间」资源绑定标签，再在「费用标签」页面启用该标签。配置完成后分账账单 T+1 天生效，可在账单详情的「实例标签」列验证。 +给[业务空间](../concepts/workspace.md)绑定标签，可按部门或项目归集费用。在标签管理页面为"大模型服务平台百炼:[业务空间](../concepts/workspace.md)"资源绑定标签键值，启用后 T+1 天生效。 -### 模型调用统计 +### 欠费与停止计费 -控制台「模型 > 用量 & 费用 > 模型用量」查看调用次数与统计；「模型监控」页面（北京/新加坡/弗吉尼亚）支持按时间范围、推理类型筛选，展示总调用次数、失败次数、平均调用时长、平均首包时长等指标，数据按小时更新。模型调用完约一小时后可查看监控统计。 +- **欠费判定**：账户可用额度 < 0 时欠费，即使有免费额度也可能无法调用（视具体商品而定） +- **停止计费**：停止 API 调用并删除 API-Key 即可停止推理费用；部署资源需手动下线；Token Plan/Coding Plan 需关闭自动续费或退订 -## 欠费处理与停止计费 +详细操作步骤参见[账单查询与成本管理](../../raw/model-user-guide/test-1/bill-query-and-cost-management.md)。 -### 欠费判定与影响 +## 常见问题 -账户可用额度 < 0 视为欠费（`可用额度 = (现金余额 + 信控额度) - (当月未结清 + 历史未结清)`）。按账单**商品名称**维度判定影响： +**为什么产生了意外费用？** +常见原因包括：免费额度已耗尽但未开启用完即停、控制台额度显示未及时刷新（分钟级更新需手动刷新）、代码中开启了联网搜索（`enable_search`）等附加功能产生单独计费。 -- 仍有免费额度、节省计划或资源包额度：可继续使用。 -- 已购 Coding Plan 或 Token Plan：套餐额度独立于账户余额，欠费期间可继续使用，但自动续费失败，到期后无法续用。 -- 以上额度均无：该商品下服务暂停，需结清欠费后恢复。 +**按量付费是实时扣款吗？** +不是。阿里云采用"预占+月结"模式，先冻结部分额度，次月初生成最终账单并实际扣款。 -### 预防与停止 - -- **预防欠费**：在「高额消费预警」页面设置消费阈值；在费用概览页设置月度限额告警；删除不再使用的 API Key 防止意外调用；检查应用代码中是否开启了 `enable_search` 等按次计费参数。 -- **停止模型推理**：停止代码调用、关闭控制台模型体验，或删除 API Key。 -- **停止模型训练**：无正在进行的训练任务即不产生费用。 -- **取消订阅**：Coding Plan 到期自动停止（不支持中途退订）；Token Plan 团队版按席位退订；模型部署按计费方式分别下线或退订实例。 - -## 成本优化建议 - -1. **优先用尽免费额度**：抵扣顺序最高，开通百炼后自动生效。 -2. **常规场景首选 AI 通用型节省计划**：覆盖广、折扣大、灵活性高，承诺周期越长折扣越大。RAG 等同时涉及文本与向量/排序模型的场景，可选 AI 通用型或额外购买向量及排序模型节省计划。 -3. **特定模型高用量**：可叠加资源包（抵扣优先级高于节省计划）。 -4. **避免不支持功能的扣费**：Batch、[上下文缓存](../concepts/prompt-caching.md)等仅 AI 通用型节省计划抵扣；调优、部署费用所有优惠方案均不抵扣。 -5. **关注出账延迟**：免费额度与控制台余量为分钟级更新且需手动刷新，操作前以最新显示为准，避免"看似有额度实际已耗尽"导致意外扣费。 -6. **海外地域注意汇率上浮**：同一模型在新加坡、弗吉尼亚、法兰克福、东京等地域单价高于华北2（北京）。 +**如何选择节省计划？** +大多数场景优先选择 AI 通用型节省计划（覆盖面广、折扣力度大）。仅当用量高度集中于语音、向量排序或万相模型时，考虑对应的专项节省计划。资源包适合小额试用或精确预算控制的场景。 ## 来源文档 @@ -190,7 +127,3 @@ - [模型调用价格](../../raw/model-user-guide/test-1/model-pricing.md) - - - - 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 5ddd3ca..9988a6c 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,6 +1,6 @@ # token plan guide -阿里云百炼提供两类面向 AI 编程与智能体场景的订阅型套餐——**Token Plan 团队版**与 **Coding Plan**。两者均以专属 API Key + 专属 Base URL 的方式接入主流 AI 编程工具（Claude Code、Qwen Code、OpenClaw、OpenCode、Cursor、Codex、Cline、Kilo CLI 等），通过预付费订阅锁定预算、避免按量计费欠费风险。本主题汇总两款套餐的产品定位、订阅流程、接入方式、团队与用量管理、工具扩展（联网搜索 / 多模态生成 / 视觉理解）以及高频报错排查。 +阿里云百炼提供两类面向 AI 编程与智能体场景的订阅型套餐——**Token Plan 团队版**与 **Coding Plan**。两者均以专属 API Key + 专属 Base URL 的方式接入主流 AI 编程工具（Claude Code、Qwen Code、OpenClaw、OpenCode、Cursor、Codex、Cline、Kilo CLI 等），通过预付费订阅锁定预算、避免按量计费欠费风险。本主题汇总两款套餐的产品定位、订阅流程、接入方式、团队与用量管理、工具扩展（联网搜索 / [多模态](../concepts/multimodal.md)生成 / 视觉理解）以及高频报错排查。 ## 套餐总览与对比 @@ -171,7 +171,7 @@ Token Plan 团队版提供两种工具接入方式： > 提问时建议明确提及 `websearch MCP` 以避免与其他工具混淆。旧版 SSE 协议（`/sse` 结尾）需取消开通后重新开通以升级到 Streamable HTTP。 -### 接入多模态生成模型（图像生成） +### 接入[多模态](../concepts/multimodal.md)生成模型（图像生成） Token Plan 团队版支持 `qwen-image-2.0`、`qwen-image-2.0-pro`、`wan2.7-image`、`wan2.7-image-pro` 等图像生成模型，但需通过工具的扩展机制（Skill / Slash Command / Agent）接入，无法通过文本模型 Base URL 直接调用。 @@ -281,3 +281,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 2f1baa6..79306bb 100644 --- a/skills/bailian-docs-llm-wiki/wiki/guides/use-cases.md +++ b/skills/bailian-docs-llm-wiki/wiki/guides/use-cases.md @@ -1,128 +1,126 @@ # use cases -本页汇总阿里云百炼平台上常见使用场景的开发实践，覆盖 Prompt 设计、多模态生成（文生图/文生视频）、RAG 应用构建、自定义[模型调优](../concepts/fine-tuning.md)、第三方模型调用、限流应对与显式缓存等。所有场景均通过 OpenAI 兼容接口或 DashScope SDK 调用，统一使用 `DASHSCOPE_API_KEY` 鉴权。 +阿里云百炼平台提供了丰富的使用场景支持，涵盖 Prompt 工程、[多模态](../concepts/multimodal.md)内容生成、RAG 应用构建、自定义模型训练、第三方模型集成以及 API 调用优化等方面。本文汇总了平台的主要使用场景，帮助开发者快速找到适合自身业务需求的实践方案。 -## 调用入口与鉴权 +## Prompt 工程 -百炼提供两套等价接口： +### 文生文 Prompt 优化 -- **OpenAI 兼容**：`base_url` 为 `https://dashscope.aliyuncs.com/compatible-mode/v1`，路径 `/chat/completions`，可直接复用 OpenAI SDK。 -- **DashScope 原生**：`https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation`。 +设计高质量 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)。 -华北2（北京）推出业务空间专属域名 `https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com`，推理性能与稳定性更优，建议从默认域名迁移。海外地域（弗吉尼亚、新加坡、法兰克福、东京）需使用对应地域的端点，部分端点要求把 `{WorkspaceId}` 替换为真实业务空间 ID。详见 [DeepSeek-阿里云](../../raw/model-user-guide/use-cases/third-party-model-integration-tutorial/deepseek-api.md)。 +### 文生图 Prompt 技巧 -调用前需[获取 API Key](https://help.aliyun.com/zh/model-studio/get-api-key) 并配置到环境变量 `DASHSCOPE_API_KEY`。 +文生图模型通过 `prompt`（正向提示词）和 `negative_prompt`（反向提示词）两个参数控制图像生成。百炼提供两种提示词公式： -## Prompt 设计 +- **基础公式**：`主体 + 场景 + 风格`，适合初次尝试的用户 +- **进阶公式**：`主体描述 + 场景描述 + 定义风格 + 镜头语言 + 氛围词 + 细节修饰`，适合有经验的用户 -### 文生文 +文生图 V2 还支持 `prompt_extend` 参数开启大模型智能改写，默认开启。提示词词典覆盖景别、视角、镜头拍摄类型、风格和光线五大维度，详见 [文生图Prompt指南](../../raw/model-user-guide/use-cases/text-to-image-prompt.md)。 -Prompt 越清晰、具体、无歧义，模型表现越符合预期。可使用「背景-目的-风格-语气-受众-输出」六要素框架系统化构建 Prompt；百炼控制台 Prompt 页面提供「自动优化」工具，对输入进行自动扩写和细节添加（消耗 Token，按推理费用计费）。详见 [文生文Prompt指南](../../raw/model-user-guide/use-cases/prompt-engineering-guide.md)。 +### 视频生成 Prompt 技巧 -### 文生图 +万相系列模型支持文生视频和图生视频，提示词公式为 `主体 + 场景 + 运动`。进阶公式在此基础上增加美学控制和风格化描述。wan2.7/wan2.6 模型还支持多镜头连贯叙事、参考生视频、以及原生音频能力（人声/音效/背景音乐描述）。图生视频场景中，由于图像已确定主体和风格，提示词主要描述运动和运镜。 -适用万相-文生图 V1/V2。关键参数： +此外，Vidu 视频生成模型提供了独立的提示词体系，支持通过特定关键词触发动态控制、运镜控制、视频风格和特效等能力，详见 [Vidu视频生成Prompt指南](../../raw/model-user-guide/use-cases/third-party-model-integration-tutorial/vidu-video-generation-prompt-guide.md)。 -- `prompt`：正向提示词，中英文描述目标图像。 -- `negative_prompt`：反向提示词，描述不希望出现的内容。 -- `prompt_extend`（仅 V2）：是否开启大模型智能改写，默认 `true`。 +## 应用构建 -提示词公式： +### 基于 LlamaIndex 构建 RAG 应用 -- 基础公式：`主体 + 场景 + 风格` -- 进阶公式：`主体（主体描述）+ 场景（场景描述）+ 风格（定义风格）+ 镜头语言 + 氛围词 + 细节修饰` +百炼提供了与 LlamaIndex 的集成方案，通过 `DashScopeCloudIndex` 和 `DashScopeCloudRetriever` 组件，开发者可以在 LlamaIndex 框架中直接使用百炼的知识库检索增强服务。完整流程包括： -提示词词典覆盖景别（特写/近景/中景/远景）、视角（平视/俯视/仰视）、镜头拍摄类型、风格与光线五大维度。详见 [文生图Prompt指南](../../raw/model-user-guide/use-cases/text-to-image-prompt.md)。 +1. 使用 `DashScopeParse` 解析文档（支持 .doc/.docx/.pdf，单文件 100M、1000 页以内） +2. 通过 `DashScopeCloudIndex.from_documents()` 创建知识库 +3. 获取 retriever 或 query engine 进行检索和问答 -### 文生视频 / 图生视频 +前提条件为获取 API Key 并安装 `llama-index-indices-managed-dashscope` 等依赖包。详见 [基于LlamaIndex构建RAG应用](../../raw/model-user-guide/use-cases/build-rag-applications-based-on-llamaindex.md)。 -万相视频生成支持文生视频、图生视频（首帧、首尾帧）、参考生视频。提示词公式按场景区分： +### 借助大模型将文档转换为视频 -- 文生视频基础：`主体 + 场景 + 运动` -- 文生视频进阶：`主体描述 + 场景描述 + 运动描述 + 美学控制 + 风格化` -- 图生视频：`运动 + 运镜`（图像已确定主体/场景/风格） -- 声音公式（wan2.5+）：在主体/场景/运动之外追加 `声音描述`，分为人声（角色内容+情绪+语调+语速+音色+口音）、音效（音源材质+行为+环境音）、背景音乐（配乐+风格）。 -- 多镜头公式（wan2.6/2.7）：`总体描述 + 镜头序号 + 时间戳 + 分镜内容`。 -- 参考生视频（wan2.7）：`参考指代（图n/视频n）+ 动作 + 场景 + 台词（可选）+ 背景音乐（可选）`；wan2.6 改用 `character1/character2` 引用主角，最多 3 个。 +百炼支持利用大语言模型和[多模态](../concepts/multimodal.md)技术将文档自动转换为包含图文、语音、字幕的视频。方案流程为：文档切片（LLM 总结标题和段落）、生成演示文稿（Marp）、生成讲解语音与字幕（[多模态](../concepts/multimodal.md)模型）、合成视频（FFmpeg）。该方案依赖 FFmpeg 和 Marp 工具，提供了完整的 Python 代码包。 -wan2.7 不再支持 `shot_type` 指定单/多镜头，改由提示词控制；要强制单镜头，中文写「生成单镜头」，英文写「Generate single shot.」。详见 [文生视频/图生视频Prompt指南](../../raw/model-user-guide/use-cases/text-to-video-prompt.md)。 +## 自定义模型调优 -Vidu 视频生成提示词公式为「主体/场景 + 场景描述 + 环境描述 + 艺术风格/媒介」，并通过关键词词典控制动态幅度（大/中/小动态）、运镜（move left/right/up/down、zoom in/out、固定镜头）、特殊拍摄（延时、微距、FPV、航拍）、景别、视角、构图、画面风格、特效与氛围。首次提示词效果不佳时，可通过调整主体与背景的比例关系、追加镜头控制等手段调优。 +百炼支持基于通用大语言模型创建自定义模型，流程包含三个主要步骤和三个辅助步骤： -## RAG 应用 +| 步骤 | 说明 | +|------|------| +| 训练数据准备 | 收集业务数据，编排为 Prompt-Completion 格式，建议至少 500 条 | +| 模型调优 | 配置超参数（学习率、迭代次数等），平台自动训练 | +| 模型部署 | 部署到独占实例，完成部署后方可调用和评测 | +| 模型评测 | 选择评测方式、数据和维度，平台自动完成评测 | -基于 LlamaIndex 接入百炼检索增强服务： +如果评测结果不满意，可调整训练策略（更换基础模型、扩充数据、调整超参数）后重复流程。详见 [自定义模型调优、部署与评测](../../raw/model-user-guide/use-cases/model-training-best-practices.md)。 -1. 安装 `llama-index-core`、`llama-index-llms-dashscope`、`llama-index-indices-managed-dashscope`（Python 3.8–3.12）。 -2. 用 `DashScopeParse` 解析 .doc/.docx/.pdf（单文件 ≤100M、页数 ≤1000），通过 `DASHSCOPE_WORKSPACE_ID` 指定业务空间。 -3. `DashScopeCloudIndex.from_documents` 创建知识库，`DashScopeCloudRetriever` 或 `index.as_retriever()` 检索，`index.as_query_engine(llm=...)` 问答。 -4. `index._insert(documents)` 增文档，`index.delete_ref_doc([doc_id])` 删文档。 +## 第三方模型集成 -详见 [基于LlamaIndex构建RAG应用](../../raw/model-user-guide/use-cases/build-rag-applications-based-on-llamaindex.md)。 +百炼平台聚合了多家第三方模型供应商的推理服务，统一通过 [OpenAI 兼容接口](../concepts/openai-compatible-interface.md)或 [DashScope SDK](../concepts/dashscope-sdk.md) 调用，开发者只需使用百炼 API Key 即可访问。 -## 自定义[模型调优](../concepts/fine-tuning.md) +### 可用模型 -流程为「[模型调优](../concepts/fine-tuning.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 | 仅北京 | -- **数据**：编排成 `Prompt-Completion` 格式，建议 ≥500 条；注意来源多样化、质量控制和分布平衡，并做脱敏。 -- **数据集**：在数据管理页面创建训练集（Prompt+Completion）与评测集（仅 Prompt），支持版本管理与发布。 -- **部署**：将自定义模型部署到独占实例，部署后即可在代码或评测中调用。 -- **计费**：调优、部署、评测分别计费。 +> **注意**：部分模型即将下架。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。 -评测结果不满意可更换基础模型、扩充数据、调整超参数后重训，直至满足预期。详见 [自定义模型调优、部署与评测](../../raw/model-user-guide/use-cases/model-training-best-practices.md)。 +### 调用方式 -## 第三方模型调用 +所有第三方模型均支持 [OpenAI 兼容接口](../concepts/openai-compatible-interface.md)调用，大部分也支持 [DashScope SDK](../concepts/dashscope-sdk.md)。以 OpenAI Python SDK 为例： -百炼聚合了多家供应商的第三方模型，统一通过 OpenAI 兼容接口或 DashScope SDK 调用，模型名以 `供应商/模型` 形式标识。多数模型支持 `enable_thinking` 切换思考/非思考模式（OpenAI Python SDK 走 `extra_body`，Node.js SDK 走顶层参数），思考过程通过 `reasoning_content` 字段返回；部分模型还支持 `reasoning_effort`（low/medium/high/max）控制推理深度。 +```python +from openai import OpenAI +import os -| 供应商 | 模型名示例 | 默认思考 | 备注 | -| --- | --- | --- | --- | -| 阿里云（DeepSeek） | `deepseek-v4-pro` | 可切换 | 多地域；旧版 v3/r1 系列将于 2026-07-09 下架 | -| 硅基流动（DeepSeek） | `siliconflow/deepseek-v3.2` | 可切换 | 仅华北2；上下文更长；不支持联网/缓存 | -| 快手万擎（DeepSeek） | `vanchin/deepseek-v4-pro` | 可切换 | 仅华北2 | -| 月之暗面（Kimi） | `kimi/kimi-k2.6` 等 | 可切换 | 仅华北2；多模态模型走 `multimodal-generation` | -| 阿里云（Kimi） | `kimi-k2-thinking` 等 | 因模型而异 | 多地域；旧版 K2 将于 2026-07-09 下架 | -| 智谱（GLM） | `ZHIPU/GLM-5.2` | 可切换 | 仅华北2；1M 上下文 | -| 阿里云（GLM） | `glm-5.2` 等 | 可切换 | 多地域；旧版 4.6/4.7 将于 2026-07-09 下架 | -| 稀宇（MiniMax 直供） | `MiniMax/MiniMax-M2.7` | 默认思考 | 仅华北2 | -| 阿里云（MiniMax） | `MiniMax-M2.5` | 默认思考 | 仅中国内地；旧版 M2.1 将于 2026-07-09 下架 | -| 小米（MiMo） | `xiaomi/mimo-v2.5-pro` | 默认开启 | 仅华北2；混合推理 | -| 阶跃星辰（Step） | `stepfun/step-3.7-flash` | 默认关闭 | 仅华北2；多模态推理 | +client = OpenAI( + api_key=os.getenv("DASHSCOPE_API_KEY"), + base_url="https://dashscope.aliyuncs.com/compatible-mode/v1", +) -> **注意**：多家供应商的旧版模型（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`。新接入建议直接选择推荐模型或各系列的最新版本。 +completion = client.chat.completions.create( + model="deepseek-v4-pro", # 替换为目标模型名称 + messages=[{"role": "user", "content": "你好"}], +) +``` -> **注意**：阿里云百炼与硅基流动都提供 DeepSeek 服务，硅基流动支持更[长上下文](../concepts/long-context.md)，但阿里云供应商限流更宽松且支持联网搜索与[上下文缓存](../concepts/prompt-caching.md)。DeepSeek 直供（月之暗面/快手万擎/智谱/小米/阶跃等）仅华北2（北京）可用，需用华北2 的 API Key。 +多数模型支持通过 `enable_thinking` 参数开启思考模式，开启后模型会输出 `reasoning_content` 字段展示推理过程。该参数为非标准参数，Python SDK 通过 `extra_body` 传入，Node.js SDK 作为顶层参数传入。 -## 限流应对 +> **注意**：同一模型在不同供应商间存在差异。例如硅基流动供应商的 DeepSeek 支持更长上下文，而阿里云百炼供应商的限流条件更宽松且支持联网搜索和上下文缓存。部分直供模型（如月之暗面 Kimi、智谱 GLM、小米 MiMo 等）需先在百炼控制台搜索并开通服务后方可调用。 -百炼按**主账号**维度、**模型**独立限流，触发后通常 1 分钟内恢复。三类规则：分钟级配额（RPM/TPM）、瞬时频率（RPS/TPS）、增速限制（Traffic Burst）。 +## API 调用优化 -按改动成本从低到高的应对方案： +### 限流应对 -1. **平台配置** - - 服务端排队等待（首选，针对增速限流）：请求头 `X-DashScope-Wait-Timeout: 30`（建议 3–120 秒），服务端排队而非直接 429；需相应调大客户端超时（非流式 = 基础超时 + Wait-Timeout）。 - - 提升限流额度：控制台临时提升，立即生效（华北2/新加坡）。 - - PTU 预置吞吐单元：专享算力，避免公共池竞争；未满负荷也持续计费。 - - Batch API：异步批处理，不受在线限流约束。 -2. **客户端流控**：令牌桶、并发信号量、双重令牌桶（同时限 RPM/TPM）、平滑限速器、自适应拥塞控制。 -3. **架构兜底**：模型降级（Fallback）、基于消息队列削峰填谷。 +百炼 API 按主账号和模型维度独立限流，包括分钟级配额（RPM/TPM）、瞬时频率（RPS/TPS）和增速限制（Traffic Burst）三种规则。应对方案按改动成本从低到高分为三类： -错误码定位：`Throttling.RateQuota`/`limit_requests` 对应请求频率超限；`Throttling.AllocationQuota`/`insufficient_quota` 对应 Token 用量超限；`Throttling.BurstRate`/`limit_burst_rate` 对应流量增速超限。详见 [限流应对最佳实践](../../raw/model-user-guide/use-cases/rate-limiting-best-practices.md)。 +1. **平台配置方案**：服务端排队等待（推荐首选，仅需添加 `X-DashScope-Wait-Timeout` 请求头）、提升限流额度、PTU 预置吞吐单元、Batch API 异步批处理 +2. **客户端流控策略**：从基础重试到令牌桶、平滑限速器、自适应拥塞控制，按工程复杂度递进 +3. **架构兜底方案**：模型降级（Fallback）、基于消息队列的削峰填谷 -## 显式缓存 +遇到 `429` 错误时，可根据错误码和触发维度特征快速定位原因并选择策略。详见 [限流应对最佳实践](../../raw/model-user-guide/use-cases/rate-limiting-best-practices.md)。 -显式缓存通过在请求中添加缓存标记，确保相同输入**确定性命中**缓存（不受后端调度影响），首次写入产生标准价格 25% 的额外开销，后续命中节省 90% 成本，发生一次命中即整体便宜于不使用缓存。适用场景：需要稳定命中、高频复用相同 Prompt、工业级 Agent [长上下文](../concepts/long-context.md)管理。 +### 显式缓存 -百炼 Anthropic 兼容端点原生支持显式缓存，常见 Coding 工具接入后自动启用： +显式缓存通过在请求中添加 `cache_control` 标记，确保相同输入内容确定性命中缓存，首次写入仅产生标准价格 25% 的额外开销，后续命中可节省 90% 成本。适用于高频复用相同 Prompt、工业级 Agent 长上下文管理等场景。 -- **Claude Code**：v2.x 起默认对 system、env、最近 user message 携带 `cache_control`，无需额外配置。端点：按量计费 `https://dashscope.aliyuncs.com/apps/anthropic`，Coding Plan `https://coding.dashscope.aliyuncs.com/apps/anthropic`，Token Plan 团队版 `https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic`。可用 `--exclude-dynamic-system-prompt-sections` 把动态信息移到 user message 以提升跨会话命中率；`DISABLE_PROMPT_CACHING=1` 关闭。 -- **OpenCode**：通过 `@ai-sdk/anthropic` 接入，默认对 system 与最近非 system 消息注入 `cache_control`，`baseURL` 末尾需带 `/v1`。 -- **OpenClaw**：provider base URL 指向 `/apps/anthropic` 即自动启用；可在 system [prompt](prompt.md) 中插入 `` 标记分隔稳定前缀与动态后缀。 -- **Hermes**：通过 `hermes config set` 配置 base URL。 +多种主流 Agent 和 Coding 工具已原生支持显式缓存： -## 文档转视频 +- **Claude Code**：v2.x 起默认携带 `cache_control` 标记，接入百炼 Anthropic 兼容端点后自动生效 +- **Open Code**：通过 `@ai-sdk/anthropic` 接入时默认注入缓存标记 +- **OpenClaw**：走 Anthropic 兼容端点时默认启用 +- **Hermes**：通过配置接入参数即可使用 -借助大模型把文档自动转为含图文、语音、字幕的视频，方案分四步：文档切片（大模型总结标题分段）→ 生成演示文稿图片（整合标题/正文/图片）→ 生成讲解语音与字幕（多模态 TTS + 按音频时长生成字幕）→ 生成视频（图片剪辑 + 音频/字幕嵌入）。依赖 FFmpeg、Marp（演示文稿）和浏览器引擎渲染，提供完整代码包。详见 [借助大模型将文档转换为视频](../../raw/model-user-guide/use-cases/use-llm-to-convert-document-to-video.md)。 +详见 [显式缓存最佳实践](../../raw/model-user-guide/use-cases/explicit-cache-guide.md)。 ## 来源文档 @@ -148,7 +146,3 @@ Vidu 视频生成提示词公式为「主体/场景 + 场景描述 + 环境描 - [显式缓存最佳实践](../../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 ab9e1ec..82ff857 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 @@ -145,3 +145,4 @@ Cursor、Cline、Qoder 等支持通过对话调用百炼能力：全局安装 `b + diff --git a/skills/bailian-docs-llm-wiki/wiki/index.md b/skills/bailian-docs-llm-wiki/wiki/index.md index 741b081..9b28774 100644 --- a/skills/bailian-docs-llm-wiki/wiki/index.md +++ b/skills/bailian-docs-llm-wiki/wiki/index.md @@ -48,7 +48,7 @@ - [knowledge](api/knowledge.md) — 1 篇源文档 - [long term memory new](api/long-term-memory-new.md) — 1 篇源文档 - [managed agents api](api/managed-agents-api.md) — 7 篇源文档 -- [model production](api/model-production.md) — 3 篇源文档 +- [model production](api/model-production.md) — 2 篇源文档 - [more](api/more.md) — 3 篇源文档 - [more about models](api/more-about-models.md) — 6 篇源文档 - [more models](api/more-models.md) — 6 篇源文档 @@ -61,22 +61,22 @@ ## 横切概念 -- [上下文窗口](concepts/context-window.md) — 关联 4 个主题 -- [函数调用](concepts/function-calling.md) — 关联 6 个主题 -- [向量嵌入](concepts/embedding.md) — 关联 5 个主题 -- [工作流](concepts/workflow.md) — 关联 5 个主题 -- [提示词工程](concepts/prompt-engineering.md) — 关联 5 个主题 -- [模型调优](concepts/fine-tuning.md) — 关联 5 个主题 -- [流式输出](concepts/streaming-output.md) — 关联 5 个主题 -- [重排序](concepts/rerank.md) — 关联 3 个主题 -- [限流与配额](concepts/rate-limiting.md) — 关联 5 个主题 +- [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 个主题 +- [流式输出](concepts/streaming.md) — 关联 5 个主题 ## 对比分析 -- [应用评测与应用监控对比](comparisons/application-evaluation-vs-monitoring.md) — 对比 2 个主题 -- [应用调用方式对比](comparisons/application-call-vs-bailian-calling.md) — 对比 2 个主题 -- [微调与模型压缩对比](comparisons/fine-tuning-vs-compression.md) — 对比 2 个主题 -- [模型评测与模型监控对比](comparisons/model-evaluation-vs-monitoring.md) — 对比 2 个主题 -- [模型部署与高速推理对比](comparisons/model-deployment-vs-inference.md) — 对比 2 个主题 -- [知识库与记忆库对比](comparisons/knowledge-base-vs-memory-library.md) — 对比 2 个主题 +- [多模态内容生成 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 个主题