本产品（
AI妙笔/2023-08-01）的OpenAPI采用RPC签名风格，签名细节参见签名机制说明。我们已经为开发者封装了常见编程语言的SDK，开发者可通过下载SDK直接调用本产品OpenAPI而无需关心技术细节。如果现有SDK不能满足使用需求，可通过签名机制进行自签名对接。由于自签名细节非常复杂，需花费 5个工作日左右。因此建议加入我们的服务钉钉群（78410016550），在专家指导下进行签名对接。在使用API前，您需要准备好身份账号及访问密钥（AccessKey），才能有效通过客户端工具（SDK、CLI等）访问API。细节请参见获取AccessKey。
通用接口
| API | 标题 | API概述 |
|---|
| API | 标题 | API概述 |
|---|---|---|
| CreateToken | 获取授权token | 创建在线推理API的临时Token。 |
| ListDialogues | 生成历史列表 | 在线推理场景的历史记录。 |
| ListVersions | 获取版本信息 | 获取用户购买的版本信息。 |
| GetProperties | 获取配置信息 | 获取配置信息。包括不限于智能配置的风格，推理相关元数据配置等。 |
通用接口-文件上传下载
| API | 标题 | API概述 |
|---|
| API | 标题 | API概述 |
|---|---|---|
| GenerateFileUrlByKey | 生成文件URL | 生成临时可访问的公开url。 |
| GenerateUploadConfig | 生成上传配置 | 生成文件上传配置。 |
通用接口-异步任务管理
| API | 标题 | API概述 |
|---|
| API | 标题 | API概述 |
|---|---|---|
| SubmitAsyncTask | 提交异步任务 | 执行系统预定义的异步任务。 |
| CancelAsyncTask | 取消异步任务 | 取消已提交，尚未执行完成的异步任务。 |
| QueryAsyncTask | 查询异步任务明细 | 查询已提交异步任务执行明细。 |
| ListAsyncTasks | 获取异步任务列表 | 获取异步任务列表。 |
妙笔-创作文章
| API | 标题 | API概述 |
|---|
| API | 标题 | API概述 |
|---|---|---|
| RunWriting | 直接写作 | 直接写作。 |
| RunStepByStepWriting | 分步骤写作 | 使用大纲+摘编的分步骤的模式进行写作。 |
| RunTranslateGeneration | 中英翻译 | AI妙笔-创作-中英文翻译。 |
| RunTextPolishing | 润色 | 创作-文本润色。 |
| RunStyleFeatureAnalysis | 内容特点分析 | 内容特点分析。 |
| RunKeywordsExtractionGeneration | 关键词抽取 | AI妙笔-创作-抽取关键词。 |
| RunContinueContent | 内容续写 | 内容续写。 |
| RunWriteToneGeneration | 文风改写 | AI妙笔-创作-文风改写。 |
| RunTitleGeneration | 标题生成 | 妙笔：标题生成。 |
| RunSummaryGenerate | 摘要生成 | 内容摘要生成。 |
| RunExpandContent | 内容扩写 | 内容扩写。 |
| RunAbbreviationContent | 内容缩写 | 内容缩写。 |
| SearchNews | 信息检索 | 根据输入检索新闻，目前仅支持夸克搜索。 |
| ListBuildConfigs | 获取系统自定义预设 | 获取系统自定义预设，用于创作文章 -> 直接生成中的内置选项。例如：写作文体、文章篇幅、输出语言、生成文章篇数等选项。 |
| GenerateImageTask | 生成智能配图任务 | 根据文字异步生成图片。 |
| FetchImageTask | 获取图片任务执行结果 | 获取图片任务执行结果。 |
| FeedbackDialogue | 反馈对话 | 反馈模型生成的内容质量。 |
| ListStyleLearningResult | 获取文体学习分析结果列表 | 获取文体学习分析结果列表。 |
妙笔-创作文章-自定义文本
| API | 标题 | API概述 |
|---|
| API | 标题 | API概述 |
|---|---|---|
| GetCustomText | 获取自定义文本 | 获取自定义文本。 |
| UpdateCustomText | 更新自定义文本 | 更新自定义文本。 |
| ListCustomText | 获取自定义文本列表 | 获取自定义文本列表。 |
| SaveCustomText | 保存自定义文本 | 保存自定义文本。 |
| DeleteCustomText | 删除自定义文本 | 删除自定义文本。 |
| DocumentExtraction | 文档提取 | 从链接中提取文档内容。 |
妙笔-文档管理
| API | 标题 | API概述 |
|---|
| API | 标题 | API概述 |
|---|---|---|
| CreateGeneratedContent | 保存文档 | 保存文档：用来保存妙笔中创作的文章，支持富文本。 |
| DeleteGeneratedContent | 删除文档 | 删除文档：用来删除妙笔中创作的文章。 |
| UpdateGeneratedContent | 更新文档 | 更新文档：用来更新妙笔中创作的文章历史。 |
| GetGeneratedContent | 获取文档 | 获取文档：用来查询妙笔中创作的文章历史。 |
| ListGeneratedContents | 获取文档列表 | 获取文档列表：用来查询妙笔中创作的文章历史列表。 |
| ExportGeneratedContent | 导出文档 | 导出文档：用来导出妙笔中创作的文章历史。 |
妙笔-素材库
| API | 标题 | API概述 |
|---|
| API | 标题 | API概述 |
|---|---|---|
| SaveMaterialDocument | 保存素材 | 保存素材：保存素材库中素材。 |
| DeleteMaterialById | 删除素材 | 删除素材：删除素材库中素材。 |
| UpdateMaterialDocument | 更新素材 | 更新素材：更新素材库中素材。 |
| GetMaterialById | 获取素材 | 获取素材：获取素材库中素材详细信息。 |
| ListMaterialDocuments | 获取素材列表 | 获取素材列表：获取素材库中素材列表。 |
妙笔-一键成片
| API | 标题 | API概述 |
|---|
| API | 标题 | API概述 |
|---|---|---|
| SubmitSmartClipTask | 提交智能一键成片任务 | 提交一键成片剪辑任务。 |
| GetSmartClipTask | 获取智能剪辑任务结果 | 查询一键成片剪辑任务。 |
妙策-选题热点
| API | 标题 | API概述 |
|---|
| API | 标题 | API概述 |
|---|---|---|
| ListHotSources | 获取三方热榜源列表 | 获取所有平台热榜源列表。 |
| ListHotTopics | 获取热点列表 | 获取热点事件列表。 |
| GetTopicById | 获取热点对象 | 根据ID获取热点事件信息。 |
| ListHotViewPoints | 获取热门视角列表 | 热门视角列表。 |
| ListTimedViewAttitude | 获取时效性视角列表 | 时效性视角列表。 |
| ListFreshViewPoints | 获取新颖视角列表 | 新颖视角列表。 |
| ListWebReviewPoints | 获取网友视角列表 | 网友视角列表。 |
| ListPlanningProposal | 获取选题策划列表 | 获取选题策划列表。 |
| ExportHotTopicPlanningProposals | 导出选题策划文档 | 导出选题策划文档，响应为一个可公开访问的URL。一小时后失效。 |
妙策-自定义话题
| API | 标题 | API概述 |
|---|
| API | 标题 | API概述 |
|---|---|---|
| DeleteCustomTopicByTopic | 删除自定义热点事件 | 根据热点名称删除自定义热点事件。 |
| ListTopicViewPointRecommendEventList | 获取热点事件推荐观点列表 | 获取热点事件推荐观点列表。 |
| ListTopicRecommendEventList | 获取热点推荐事件列表 | 获取热点推荐事件。 |
| RunCustomHotTopicAnalysis | 自定义热点话题分析 | 自定义热点话题分析。 |
| RunCustomHotTopicViewPointAnalysis | 自定义选题视角分析 | 自定义选题视角分析。 |
| ListCustomViewPoints | 获取自定义视角列表 | 自定义视角列表。 |
| DeleteCustomTopicViewPointById | 删除自定义选题视角 | 根据自定义选题视角ID删除自定义选题视角。 |
妙策-openapi
| API | 标题 | API概述 |
|---|
| API | 标题 | API概述 |
|---|---|---|
| SubmitDocClusterTask | 提交内容聚合任务 | 提交内容聚合任务。 |
| GetDocClusterTask | 获取内容聚合任务结果 | 获取内容聚合任务结果。 |
| SubmitTopicSelectionPerspectiveAnalysisTask | 提交选题热点分析任务 | 提交选题热点分析任务。 |
| GetTopicSelectionPerspectiveAnalysisTask | 获取选题视角分析任务结果 | 获取选题视角分析任务结果。 |
| SubmitCustomTopicSelectionPerspectiveAnalysisTask | 提交自定义热点选题视角分析任务 | 提交自定义热点选题视角分析任务。 |
| GetCustomTopicSelectionPerspectiveAnalysisTask | 获取自定义选题视角分析任务结果 | 获取自定义选题视角分析任务结果。 |
妙策-新闻播报
| API | 标题 | API概述 |
|---|
| API | 标题 | API概述 |
|---|---|---|
| GetHotTopicBroadcast | 查询完整播报单（热榜） | 查询新闻播报单。 |
| SubmitCustomHotTopicBroadcastJob | 提交自定义播报单任务 | 提交自定义播报单任务。 |
| GetCustomHotTopicBroadcastJob | 获取自定义播报单任务结果 | 获取自定义播报单任务结果。 |
妙策-企业VOC挖掘
| API | 标题 | API概述 |
|---|
| API | 标题 | API概述 |
|---|---|---|
| ExportAnalysisTagDetailByTaskId | 导出标签挖掘结果 | 导出企业VOC分析任务明细列表。 |
| ValidateUploadTemplate | 校验VOC上传模板 | 校验企业VOC上传模板。 |
| SubmitEnterpriseVocAnalysisTask | 提交企业VOC分析任务 | 提交VOC异步任务。 |
| ListAnalysisTagDetailByTaskId | 根据任务ID获取标签分析明细列表 | 分页获取企业VOC分析任务明细列表。 |
| GetEnterpriseVocAnalysisTask | 获取企业VOC挖掘任务结果 | 获取企业VOC分析任务结果。 |
| GetCategoriesByTaskId | 根据任务ID获取分类列表 | 获取某次标签挖掘结果分类。 |
妙搜-数据源
| API | 标题 | API概述 |
|---|
| API | 标题 | API概述 |
|---|---|---|
| CreateDataset | 数据源-创建 | 数据源管理-创建。 |
| GetDataset | 数据源-详情 | 数据源管理-详情。 |
| UpdateDataset | 数据源-修改 | 数据源管理-更新。 |
| ListDatasets | 数据源-列表 | 数据源管理-查询。 |
| DeleteDataset | 数据源-删除 | 数据源管理-删除。 |
| AddDatasetDocument | 数据源-添加文档到数据集 | 添加文档到数据源。 |
| GetDatasetDocument | 数据源-获取文档详情 | 获取数据源文档。 |
| UpdateDatasetDocument | 数据源-修改文档 | 修改数据源文档。 |
| ListDatasetDocuments | 数据源-文档列表 | 查询数据源文档列表。 |
| SearchDatasetDocuments | 数据源-搜索文档 | 搜索数据源文档。 |
| DeleteDatasetDocument | 数据源-删除数据集文档 | 删除数据源文档。 |
妙搜-智能搜索
| API | 标题 | API概述 |
|---|
| API | 标题 | API概述 |
|---|---|---|
| RunSearchGeneration | 智能搜索 | AI妙搜-智能搜索生成。 |
| ListSearchTasks | 查询妙搜搜索生成历史任务列表 | 查询妙搜搜索生成历史任务列表。 |
| ListSearchTaskDialogues | 查询妙搜搜索生成任务详情列表 | 查询妙搜搜索生成任务详情列表。 |
| ListSearchTaskDialogueDatas | 查询搜索生成任务对话详情中数据列表 | 查询搜索生成任务对话详情中数据列表。 |
| RunSearchSimilarArticles | 妙搜-文搜文 | 妙搜-文搜文。 |
系统配置-干预配置
| API | 标题 | API概述 |
|---|
| API | 标题 | API概述 |
|---|---|---|
| ListInterveneCnt | 获得所有干预项的数量 | 获得干预项目数量列表。 |
| ListIntervenes | 列出干预项 | 获得干预项列表。 |
| ImportInterveneFile | 同步导入干预项文件 | 导入干预文件。 |
| InsertInterveneGlobalReply | 插入干预全局回复项 | 设置干预全局回复。 |
| ImportInterveneFileAsync | 异步导入干预项文件 | 异步导入干预文件。 |
| GetInterveneTemplateFileUrl | 获得干预导入模版文件地址 | 获得干预导入模版文件下载地址。 |
| ClearIntervenes | 清除所有干预项 | 清除所有干预内容。 |
| GetInterveneGlobalReply | 获得干预全局回复内容 | 获得干预全局回复。 |
| ListInterveneRules | 列出干预规则 | 获得干预规则列表。 |
| ListInterveneImportTasks | 列出干预项导入任务 | 获得导入任务列表。 |
| InsertInterveneRule | 插入干预规则 | 插入干预规则。 |
| GetInterveneRuleDetail | 获得干预规则的详情 | 获得干预项规则详情。 |
| DeleteInterveneRule | 删除干预规则 | 删除干预规则。 |
| ExportIntervenes | 导出干预项内容 | 导出所有干预内容。 |
| GetInterveneImportTaskInfo | 获得干预项目导入任务信息 | 获得导入任务信息。 |
系统配置-信源管理
| API | 标题 | API概述 |
|---|
| API | 标题 | API概述 |
|---|---|---|
| SaveDataSourceOrderConfig | 保存信源权重配置 | 保存用户写作信源配置，通用搜索信源配置的配置信息。 |
| GetDataSourceOrderConfig | 获取信源配置权重数据 | 获取写作信源，通用搜索信源的配置信息。 |
妙读-文档管理
妙读-文档伴读
| API | 标题 | API概述 |
|---|
| API | 标题 | API概述 |
|---|---|---|
| RunMultiDocIntroduction | 多文档聚合摘要 | 针对多篇文章、视频或者URL，生成总分结构的摘要（几篇文章的综合概述、关键要点）。此外支持生成多语言。 |
| RunDocBrainmap | 全文脑图 | 针对文章或者书，生成三级脑图，且支持生成多语种，支持控制脑图第二级数量，支持控制叶子节点的字数。 |
| RunDocIntroduction | 文档摘要 | 针对一篇文章、视频或者URL，生成总分结构的摘要（全文概述、关键要点）；此外还可带章节速览（即分段、每段的总结、段落摘要）。此外支持生成多语言。 |
| RunDocSummary | 问答内容总结 | 妙读文档总结摘要接口。 |
| RunDocQa | 文档问答（文章问答/多模态文件问答） | 文章问答：针对一个自然语言类的query，在指定的文章范围内给出文字答案（有图则会配图），并显示溯源信息。 多模态文件问答：针对一个自然语言类的query，在指定的多模态文件范围内给出文字答案，并带上相关的图片、视频片段或者文字，并显示溯源信息。 |
| GetDocInfo | 获取文档信息 | 妙读获取文档信息。 |
| RunHotword | 抽取关键词 | 基于指定文章、抽取关键词。关键词主要是指在特定领域或行业中具有代表性和识别度的专业术语或概念，它们能够精准地描述和概括某一行业内的核心内容、重要人物、关键事件或技术名词。 |
| RunDocWashing | 改写 | 把一篇文章改换成指定风格。 |
| RunGenerateQuestions | 猜你想问 | 输入一个query，返回几个相关query。 |
妙读-书籍伴读
| API | 标题 | API概述 |
|---|
| API | 标题 | API概述 |
|---|---|---|
| RunBookSmartCard | 妙读书籍智能卡片 | 书籍智能卡片接口。 |
| UploadBook | 妙读书籍上传 | 妙读上传书籍。 |
| RunBookIntroduction | 书籍导读（抽取书籍卖点/书籍摘要） | 基于一本书，抽取书籍的内容概要，以及结构化的卖点、热词信息。 |
妙读-其他
| API | 标题 | API概述 |
|---|
| API | 标题 | API概述 |
|---|---|---|
| RunDocTranslation | 文档翻译 | 中英文互译接口。 |
| RunDocSmartCard | 文档智能卡片 | 针对划选的文字或指定chat，自动打标并生成一个卡片笔记。 |
| RunCommentGeneration | 客户之声预测 | 针对指定文章，预测用户之声。 |
其他
| API | 标题 | API概述 |
|---|
| API | 标题 | API概述 |
|---|---|---|
| ListHotNewsWithType | 获取选题热点列表 | 获取选题热点列表。 |
| GenerateViewPoint | 生成选题视角 | 生成选题视角。 |