<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/">
  <channel>
    <title>TalkingData文档中心</title>
    <link>http://doc.talkingdata.com</link>
    <description></description>
    <language>zh-CN</language>
    <pubdate>Sat, 25 Apr 2026 17:52:26 +0800</pubdate>
    <image>
      <link>http://doc.talkingdata.com</link>
      <url>http://doc.talkingdata.com/resource/img/logo.png</url>
      <title>TalkingData文档中心</title>
    </image>
    <item>
      <title>TD云筑38/Google Veo-3.1</title>
      <link>http://doc.talkingdata.com/posts/1233</link>
      <category>视频生成 API</category>
      <author>liuxinmei</author>
      <description>云筑38 接口说明文档 TD模型编号：T0301004 模型能力简介 云筑38 文生视频：仅通过文本描述（Prompt）即可生成完整视频，适合创意概念快速可视化。 图生视频：基于用户提供的首帧图片和文本提示，生成符合图片内容与描述的动态视频，支持精准控制首帧画面。 鉴权说明  本接口仅支持API Key鉴权，需联系TD运维同学获取长效API Key。
 创建 AIGC 生视频任务接口地址 请求方法： POST 接口URL：https://modelpool-api.talkingdata.com/model/orgin/job 请求头（Request Headers）： 头部字段 值 是否必需 说明 Authorization Bearer &lt;your_api_key&gt; 是 API 鉴权凭证</description>
      <content:encoded><![CDATA[<h4 id="%3Cstrong%3E%E4%BA%91%E7%AD%9138%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3%3C%2Fstrong%3E" name="%3Cstrong%3E%E4%BA%91%E7%AD%9138%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3%3C%2Fstrong%3E"><strong>云筑38 接口说明文档</strong></h4>
<p><strong>TD模型编号：T0301004</strong></p>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%A8%A1%E5%9E%8B%E8%83%BD%E5%8A%9B%E7%AE%80%E4%BB%8B" name="%E6%A8%A1%E5%9E%8B%E8%83%BD%E5%8A%9B%E7%AE%80%E4%BB%8B">模型能力简介</h2>
<p><span id="Hrya4y9k"></span></p>
<ul>
<li><strong>云筑38</strong><ul>
<li><strong>文生视频</strong>：仅通过文本描述（Prompt）即可生成完整视频，适合创意概念快速可视化。</li>
<li><strong>图生视频</strong>：基于用户提供的首帧图片和文本提示，生成符合图片内容与描述的动态视频，支持精准控制首帧画面。</li>
</ul>
</li>
</ul>
<h5 id="%3Cstrong%3E%E9%89%B4%E6%9D%83%E8%AF%B4%E6%98%8E%3C%2Fstrong%3E%26nbsp%3B" name="%3Cstrong%3E%E9%89%B4%E6%9D%83%E8%AF%B4%E6%98%8E%3C%2Fstrong%3E%26nbsp%3B"><strong>鉴权说明</strong>&nbsp;</h5>
<pre><code>本接口仅支持API Key鉴权，需联系TD运维同学获取长效API Key。
</code></pre><hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E5%88%9B%E5%BB%BA%20AIGC%20%E7%94%9F%E8%A7%86%E9%A2%91%E4%BB%BB%E5%8A%A1%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80" name="%E5%88%9B%E5%BB%BA%20AIGC%20%E7%94%9F%E8%A7%86%E9%A2%91%E4%BB%BB%E5%8A%A1%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80">创建 AIGC 生视频任务接口地址</h2>
<p><span id="Hrya4y9k"></span></p>
<p><strong>请求方法：</strong> POST</p>
<p><strong>接口URL：</strong><code>https://modelpool-api.talkingdata.com/model/orgin/job</code> </p>
<p><strong>请求头（Request Headers）：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">头部字段</th>
<th style="text-align:left">值</th>
<th style="text-align:left">是否必需</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>Authorization</code></td>
<td style="text-align:left"><code>Bearer &lt;your_api_key&gt;</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">API 鉴权凭证，请替换为有效的 API Key</td>
</tr>
<tr>
<td style="text-align:left"><code>X-Timestamp</code></td>
<td style="text-align:left"><code>1700000000</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">Unix 时间戳格式</td>
</tr>
<tr>
<td style="text-align:left"><code>Content-Type</code></td>
<td style="text-align:left"><code>application/json</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">请求体格式必须为 JSON</td>
</tr>
<tr>
<td style="text-align:left"><code>X-TC-Action</code></td>
<td style="text-align:left"><code>T0301004</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">固定值</td>
</tr>
</tbody>
</table>
<p><strong>请求参数（Request  Parameter）：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">字段</th>
<th style="text-align:left">值</th>
<th style="text-align:left">是否必需</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>requestld</code></td>
<td style="text-align:left"><code>550e8400-e29b-41d4-a716-446655440000</code></td>
<td style="text-align:left">否</td>
<td style="text-align:left">请求唯一标识符。使用 UUID 格式字符串，用于跟踪和排查请求相关问题，以便在需要技术排查时，提供此 ID 可快速定位具体请求的完整处理链路和日志信息。</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E5%88%9B%E5%BB%BA%20AIGC%20%E7%94%9F%E8%A7%86%E9%A2%91%E4%BB%BB%E5%8A%A1%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0" name="%E5%88%9B%E5%BB%BA%20AIGC%20%E7%94%9F%E8%A7%86%E9%A2%91%E4%BB%BB%E5%8A%A1%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0">创建 AIGC 生视频任务请求参数</h2>
<p><span id="Hrya4y9k"></span></p>
<h3 id="%E5%88%9B%E5%BB%BA%20AIGC%20%E7%94%9F%E8%A7%86%E9%A2%91%E4%BB%BB%E5%8A%A1%E8%AF%B7%E6%B1%82%E4%BD%93%EF%BC%88requestBody%EF%BC%89" name="%E5%88%9B%E5%BB%BA%20AIGC%20%E7%94%9F%E8%A7%86%E9%A2%91%E4%BB%BB%E5%8A%A1%E8%AF%B7%E6%B1%82%E4%BD%93%EF%BC%88requestBody%EF%BC%89">创建 AIGC 生视频任务请求体（requestBody）</h3>
<p><span id="Hrya4y9k"></span></p>
<table>
<thead>
<tr>
<th style="text-align:left">参数名</th>
<th style="text-align:left">类型</th>
<th style="text-align:left">必填</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><strong>Prompt</strong></td>
<td style="text-align:left">String</td>
<td style="text-align:left">文生视频必填</td>
<td style="text-align:left">生成视频的提示词。图生视频时若未传入参考文件且ExtInfo为空，也为必填</td>
</tr>
<tr>
<td style="text-align:left"><strong>FileInfos.N</strong></td>
<td style="text-align:left">Array</td>
<td style="text-align:left">图生视频必填</td>
<td style="text-align:left">描述生成视频要使用的资源文件，支持首尾帧模式、参考图模式</td>
</tr>
<tr>
<td style="text-align:left">├─ Type</td>
<td style="text-align:left">String</td>
<td style="text-align:left">是</td>
<td style="text-align:left">文件类型：<code>Url</code></td>
</tr>
<tr>
<td style="text-align:left">├─ Url</td>
<td style="text-align:left">String</td>
<td style="text-align:left">是</td>
<td style="text-align:left">文件URL（图片大小不超过10M，格式：jpeg、jpg、png）</td>
</tr>
<tr>
<td style="text-align:left">└─ Usage</td>
<td style="text-align:left">String</td>
<td style="text-align:left">是</td>
<td style="text-align:left"><code>FirstFrame</code>（首帧）、<code>LastFrame</code>（尾帧）、<code>Reference</code>（参考图）之一</td>
</tr>
<tr>
<td style="text-align:left">LastFrameFileId</td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">尾帧媒体文件ID，须同时通过FileInfos指定首帧（图片≤10M，格式jpeg/jpg/png/webp）</td>
</tr>
<tr>
<td style="text-align:left">LastFrameUrl</td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">尾帧媒体文件URL，须同时通过FileInfos指定首帧（图片≤5M，格式jpeg/jpg/png/webp）</td>
</tr>
<tr>
<td style="text-align:left">SubjectInfos.N</td>
<td style="text-align:left">Array</td>
<td style="text-align:left">否</td>
<td style="text-align:left">固定主体输入信息</td>
</tr>
<tr>
<td style="text-align:left">NegativePrompt</td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">阻止模型生成的内容提示词</td>
</tr>
<tr>
<td style="text-align:left"><strong>EnhancePrompt</strong></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">是否自动优化提示词：<code>Enabled</code>、<code>Disabled</code></td>
</tr>
<tr>
<td style="text-align:left">OutputConfig</td>
<td style="text-align:left">Object</td>
<td style="text-align:left">否</td>
<td style="text-align:left">输出媒体文件配置</td>
</tr>
<tr>
<td style="text-align:left">├─ StorageMode</td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">存储模式：<code>Temporary</code>（临时）、<code>Permanent</code>（永久）</td>
</tr>
<tr>
<td style="text-align:left">├─ AspectRatio</td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">视频宽高比：<code>16:9</code>、<code>9:16</code>、<code>1:1</code>等</td>
</tr>
<tr>
<td style="text-align:left">├─ AudioGeneration</td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">音频生成：<code>Enabled</code>、<code>Disabled</code></td>
</tr>
<tr>
<td style="text-align:left">├─ PersonGeneration</td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">人物生成策略：<code>AllowAdult</code>、<code>AllowAll</code></td>
</tr>
<tr>
<td style="text-align:left">├─ InputComplianceCheck</td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">输入合规检测：<code>Enabled</code>、<code>Disabled</code></td>
</tr>
<tr>
<td style="text-align:left">└─ OutputComplianceCheck</td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">输出合规检测：<code>Enabled</code>、<code>Disabled</code></td>
</tr>
<tr>
<td style="text-align:left">InputRegion</td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">输入文件区域：<code>Mainland</code>（默认）、<code>Oversea</code></td>
</tr>
<tr>
<td style="text-align:left">SceneType</td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">场景类型（如：<code>motion_control</code>）</td>
</tr>
<tr>
<td style="text-align:left">Seed</td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">否</td>
<td style="text-align:left">随机种子，用于结果复现</td>
</tr>
<tr>
<td style="text-align:left">SessionId</td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">去重识别码（最长50字符），三天内相同值会返回错误</td>
</tr>
<tr>
<td style="text-align:left">SessionContext</td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">透传用户信息（最长1000字符），回调时返回</td>
</tr>
<tr>
<td style="text-align:left">TasksPriority</td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">否</td>
<td style="text-align:left">任务优先级，范围-10到10，默认0</td>
</tr>
<tr>
<td style="text-align:left">ExtInfo</td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">保留字段，可传入模型特殊参数、分镜prompt等</td>
</tr>
</tbody>
</table>
<h2 id="%E5%88%9B%E5%BB%BA%20AIGC%20%E7%94%9F%E8%A7%86%E9%A2%91%E4%BB%BB%E5%8A%A1%E8%BF%94%E5%9B%9E%E5%8F%82%E6%95%B0" name="%E5%88%9B%E5%BB%BA%20AIGC%20%E7%94%9F%E8%A7%86%E9%A2%91%E4%BB%BB%E5%8A%A1%E8%BF%94%E5%9B%9E%E5%8F%82%E6%95%B0">创建 AIGC 生视频任务返回参数</h2>
<table>
<thead>
<tr>
<th style="text-align:left">参数名</th>
<th style="text-align:left">类型</th>
<th style="text-align:left">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>TaskId</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">异步任务ID，用于后续查询任务状态或结果。</td>
</tr>
<tr>
<td style="text-align:left"><code>RequestId</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">唯一请求ID，由服务端生成，用于定位问题或对接技术支持。</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E5%88%9B%E5%BB%BA%20AIGC%20%E7%94%9F%E8%A7%86%E9%A2%91%E4%BB%BB%E5%8A%A1%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B" name="%E5%88%9B%E5%BB%BA%20AIGC%20%E7%94%9F%E8%A7%86%E9%A2%91%E4%BB%BB%E5%8A%A1%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B">创建 AIGC 生视频任务调用示例</h2>
<p><span id="Hrya4y9k"></span></p>
<p>请求示例：</p>
<pre><code class="lang-Curl">curl -X POST &#39;https://modelpool-api.talkingdata.com/model/orgin/job?requestId=550e8400-e29b-41d4-a716-446655440000&#39; \
  -H &#39;Content-Type: application/json&#39; \
  -H &#39;Authorization: Bearer YOUR_API_KEY&#39; \
  -H &#39;X-Timestamp: 1760000000&#39; \
  -H &#39;X-TC-Action: T0301004&#39; \
  -d &#39;{
        &quot;EnhancePrompt&quot;: &quot;Enabled&quot;,
        &quot;FileInfos&quot;: [
                {
                        &quot;Type&quot;: &quot;Url&quot;,
                        &quot;Url&quot;: &quot;https://td-llm.tos-cn-beijing.volces.com/%2Fexperience%2F20260424%2F1777010408357_bae83c.jpg?X-Tos-Algorithm=TOS4-HMAC-SHA256&amp;X-Tos-Credential=AKLTMjdmOWJhYTdlZDc4NDcxMjkxM2RmODdhMGYxZWYwMzg%2F20260424%2Fcn-beijing%2Ftos%2Frequest&amp;X-Tos-Expires=604800&amp;X-Tos-Date=20260424T060008Z&amp;X-Tos-Signature=83cc0472f1bbb9754ec4b25c436325d206e92abc2f25a67d2c38a5126cfb34a4&amp;X-Tos-SignedHeaders=host&quot;,
                        &quot;Usage&quot;: &quot;FirstFrame&quot;
                }
        ],
        &quot;InputRegion&quot;: &quot;Mainland&quot;,
        &quot;OutputConfig&quot;: {
                &quot;StorageMode&quot;: &quot;Temporary&quot;,
                &quot;AspectRatio&quot;: &quot;16:9&quot;,
                &quot;AudioGeneration&quot;: &quot;Enabled&quot;,
                &quot;PersonGeneration&quot;: &quot;AllowAdult&quot;,
                &quot;InputComplianceCheck&quot;: &quot;Enabled&quot;,
                &quot;OutputComplianceCheck&quot;: &quot;Enabled&quot;
        },
        &quot;Prompt&quot;: &quot;旋转视频&quot;,
        &quot;Seed&quot;: 0,
        &quot;TasksPriority&quot;: 0
}&#39;
</code></pre>
<p>响应示例：</p>
<pre><code>{
    &quot;Response&quot;: {
        &quot;TaskId&quot;: &quot;1395528311-AigcVideoTask-92202210f541073442f58e7f4a857f4bt&quot;,
        &quot;RequestId&quot;: &quot;d239582c-ebe3-42ab-a046-5d89bd7b8021&quot;
    }
}
</code></pre><hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%9F%A5%E8%AF%A2%E4%BB%BB%E5%8A%A1%E8%AF%A6%E6%83%85%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80" name="%E6%9F%A5%E8%AF%A2%E4%BB%BB%E5%8A%A1%E8%AF%A6%E6%83%85%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80">查询任务详情接口地址</h2>
<p><span id="Hrya4y9k"></span></p>
<p>根据提交任务时返回的 <code>TaskId</code>，查询视频生成任务的详细执行状态和结果。</p>
<p><strong>请求方法：</strong> POST</p>
<p><strong>接口URL：</strong><code>https://modelpool-api.talkingdata.com/model/orgin/job</code> </p>
<p><strong>请求头（Request Headers）：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">头部字段</th>
<th style="text-align:left">值</th>
<th style="text-align:left">是否必需</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>Authorization</code></td>
<td style="text-align:left"><code>Bearer &lt;your_api_key&gt;</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">API 鉴权凭证，请替换为有效的 API Key</td>
</tr>
<tr>
<td style="text-align:left"><code>X-Timestamp</code></td>
<td style="text-align:left"><code>1700000000</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">Unix 时间戳格式</td>
</tr>
<tr>
<td style="text-align:left"><code>Content-Type</code></td>
<td style="text-align:left"><code>application/json</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">请求体格式必须为 JSON</td>
</tr>
</tbody>
</table>
<p><strong>请求参数（Request  Parameter）：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">参数名</th>
<th style="text-align:left">类型</th>
<th style="text-align:left">必选</th>
<th style="text-align:left">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>TaskId</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">是</td>
<td style="text-align:left">视频生成任务的任务ID，由创建任务接口返回，用于查询该任务的执行详情和结果。</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%9F%A5%E8%AF%A2%E4%BB%BB%E5%8A%A1%E8%AF%A6%E6%83%85%E6%8E%A5%E5%8F%A3%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0" name="%E6%9F%A5%E8%AF%A2%E4%BB%BB%E5%8A%A1%E8%AF%A6%E6%83%85%E6%8E%A5%E5%8F%A3%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0">查询任务详情接口请求参数</h2>
<p><span id="Hrya4y9k"></span></p>
<table>
<thead>
<tr>
<th style="text-align:left">参数</th>
<th style="text-align:left">类型</th>
<th style="text-align:left">必选</th>
<th style="text-align:left">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>JobId</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">是</td>
<td style="text-align:left">提交文生图任务时返回的异步任务ID</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%9F%A5%E8%AF%A2%E4%BB%BB%E5%8A%A1%E8%AF%A6%E6%83%85%E6%8E%A5%E5%8F%A3%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0" name="%E6%9F%A5%E8%AF%A2%E4%BB%BB%E5%8A%A1%E8%AF%A6%E6%83%85%E6%8E%A5%E5%8F%A3%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0">查询任务详情接口响应参数</h2>
<p><span id="Hrya4y9k"></span></p>
<table>
<thead>
<tr>
<th style="text-align:left">参数名</th>
<th style="text-align:left">类型</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left">TaskType</td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务类型，此处固定为 <code>AigcVideoTask</code></td>
</tr>
<tr>
<td style="text-align:left">Status</td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务状态：<code>PROCESSING</code>（处理中）、<code>FINISH</code>（已完成）</td>
</tr>
<tr>
<td style="text-align:left">CreateTime</td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务创建时间（ISO 日期格式）</td>
</tr>
<tr>
<td style="text-align:left">BeginProcessTime</td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务开始执行时间（ISO 日期格式）</td>
</tr>
<tr>
<td style="text-align:left">FinishTime</td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务完成时间（ISO 日期格式）</td>
</tr>
<tr>
<td style="text-align:left">AigcVideoTask</td>
<td style="text-align:left">Object</td>
<td style="text-align:left">AIGC生视频任务详细信息（任务类型为AigcVideoTask时有值）</td>
</tr>
<tr>
<td style="text-align:left">RequestId</td>
<td style="text-align:left">String</td>
<td style="text-align:left">唯一请求ID</td>
</tr>
</tbody>
</table>
<h3 id="AigcVideoTask%20%E4%BB%BB%E5%8A%A1%E8%AF%A6%E7%BB%86%E4%BF%A1%E6%81%AF" name="AigcVideoTask%20%E4%BB%BB%E5%8A%A1%E8%AF%A6%E7%BB%86%E4%BF%A1%E6%81%AF">AigcVideoTask 任务详细信息</h3>
<table>
<thead>
<tr>
<th style="text-align:left">参数名</th>
<th style="text-align:left">类型</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left">TaskId</td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务ID</td>
</tr>
<tr>
<td style="text-align:left">Status</td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务状态：<code>PROCESSING</code>、<code>FINISH</code></td>
</tr>
<tr>
<td style="text-align:left">ErrCode</td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">错误码，0表示成功</td>
</tr>
<tr>
<td style="text-align:left">ErrCodeExt</td>
<td style="text-align:left">String</td>
<td style="text-align:left">扩展错误码</td>
</tr>
<tr>
<td style="text-align:left">Message</td>
<td style="text-align:left">String</td>
<td style="text-align:left">错误信息</td>
</tr>
<tr>
<td style="text-align:left">Progress</td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">任务进度百分比</td>
</tr>
<tr>
<td style="text-align:left">Input</td>
<td style="text-align:left">Object</td>
<td style="text-align:left">任务输入参数（详见下方）</td>
</tr>
<tr>
<td style="text-align:left">Output</td>
<td style="text-align:left">Object</td>
<td style="text-align:left">任务输出结果（详见下方）</td>
</tr>
<tr>
<td style="text-align:left">SessionContext</td>
<td style="text-align:left">String</td>
<td style="text-align:left">透传的用户上下文信息</td>
</tr>
<tr>
<td style="text-align:left">SessionId</td>
<td style="text-align:left">String</td>
<td style="text-align:left">去重识别码</td>
</tr>
</tbody>
</table>
<h4 id="Input%20%E4%BB%BB%E5%8A%A1%E8%BE%93%E5%85%A5%E5%8F%82%E6%95%B0" name="Input%20%E4%BB%BB%E5%8A%A1%E8%BE%93%E5%85%A5%E5%8F%82%E6%95%B0">Input 任务输入参数</h4>
<table>
<thead>
<tr>
<th style="text-align:left">参数名</th>
<th style="text-align:left">类型</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left">FileInfos</td>
<td style="text-align:left">Array</td>
<td style="text-align:left">输入文件信息（首帧/参考图等）</td>
</tr>
<tr>
<td style="text-align:left">SubjectInfos</td>
<td style="text-align:left">Array</td>
<td style="text-align:left">固定主体输入信息</td>
</tr>
<tr>
<td style="text-align:left">LastFrameFileId</td>
<td style="text-align:left">String</td>
<td style="text-align:left">尾帧媒体文件ID</td>
</tr>
<tr>
<td style="text-align:left">LastFrameUrl</td>
<td style="text-align:left">String</td>
<td style="text-align:left">尾帧媒体文件URL</td>
</tr>
<tr>
<td style="text-align:left">Prompt</td>
<td style="text-align:left">String</td>
<td style="text-align:left">生成视频的提示词</td>
</tr>
<tr>
<td style="text-align:left">NegativePrompt</td>
<td style="text-align:left">String</td>
<td style="text-align:left">负面提示词</td>
</tr>
<tr>
<td style="text-align:left">ModelName</td>
<td style="text-align:left">String</td>
<td style="text-align:left">模型名称：<code>GV</code></td>
</tr>
<tr>
<td style="text-align:left">ModelVersion</td>
<td style="text-align:left">String</td>
<td style="text-align:left">模型版本：<code>3.1</code> 或 <code>3.1-fast</code></td>
</tr>
<tr>
<td style="text-align:left">EnhancePrompt</td>
<td style="text-align:left">String</td>
<td style="text-align:left">是否启用提示词优化：<code>Enabled</code>、<code>Disabled</code></td>
</tr>
<tr>
<td style="text-align:left">GenerationMode</td>
<td style="text-align:left">String</td>
<td style="text-align:left">生成模式</td>
</tr>
<tr>
<td style="text-align:left">OutputConfig</td>
<td style="text-align:left">Object</td>
<td style="text-align:left">输出配置（详见下方）</td>
</tr>
<tr>
<td style="text-align:left">InputRegion</td>
<td style="text-align:left">String</td>
<td style="text-align:left">输入文件区域：<code>Mainland</code>、<code>Oversea</code></td>
</tr>
<tr>
<td style="text-align:left">SceneType</td>
<td style="text-align:left">String</td>
<td style="text-align:left">场景类型</td>
</tr>
<tr>
<td style="text-align:left">Seed</td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">随机种子</td>
</tr>
</tbody>
</table>
<p><strong>OutputConfig 输出配置：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">参数名</th>
<th style="text-align:left">类型</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left">StorageMode</td>
<td style="text-align:left">String</td>
<td style="text-align:left">存储模式：<code>Temporary</code>（临时）、<code>Permanent</code>（永久）</td>
</tr>
<tr>
<td style="text-align:left">MediaName</td>
<td style="text-align:left">String</td>
<td style="text-align:left">媒体文件名称</td>
</tr>
<tr>
<td style="text-align:left">ClassId</td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">分类ID</td>
</tr>
<tr>
<td style="text-align:left">ExpireTime</td>
<td style="text-align:left">String</td>
<td style="text-align:left">过期时间（临时存储模式有效）</td>
</tr>
<tr>
<td style="text-align:left">Duration</td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">视频时长（秒）</td>
</tr>
<tr>
<td style="text-align:left">Resolution</td>
<td style="text-align:left">String</td>
<td style="text-align:left">视频分辨率</td>
</tr>
<tr>
<td style="text-align:left">AspectRatio</td>
<td style="text-align:left">String</td>
<td style="text-align:left">视频宽高比：<code>16:9</code>、<code>9:16</code>、<code>1:1</code>等</td>
</tr>
<tr>
<td style="text-align:left">AudioGeneration</td>
<td style="text-align:left">String</td>
<td style="text-align:left">音频生成：<code>Enabled</code>、<code>Disabled</code></td>
</tr>
<tr>
<td style="text-align:left">EnableBGM</td>
<td style="text-align:left">String</td>
<td style="text-align:left">背景音乐开关</td>
</tr>
<tr>
<td style="text-align:left">PersonGeneration</td>
<td style="text-align:left">String</td>
<td style="text-align:left">人物生成策略：<code>AllowAdult</code>、<code>AllowAll</code></td>
</tr>
<tr>
<td style="text-align:left">InputComplianceCheck</td>
<td style="text-align:left">String</td>
<td style="text-align:left">输入合规检测：<code>Enabled</code>、<code>Disabled</code></td>
</tr>
<tr>
<td style="text-align:left">OutputComplianceCheck</td>
<td style="text-align:left">String</td>
<td style="text-align:left">输出合规检测：<code>Enabled</code>、<code>Disabled</code></td>
</tr>
<tr>
<td style="text-align:left">EnhanceSwitch</td>
<td style="text-align:left">String</td>
<td style="text-align:left">增强开关</td>
</tr>
<tr>
<td style="text-align:left">OffPeak</td>
<td style="text-align:left">String</td>
<td style="text-align:left">闲时处理</td>
</tr>
<tr>
<td style="text-align:left">FrameInterpolate</td>
<td style="text-align:left">String</td>
<td style="text-align:left">帧插值</td>
</tr>
<tr>
<td style="text-align:left">LogoAdd</td>
<td style="text-align:left">String</td>
<td style="text-align:left">是否添加水印</td>
</tr>
</tbody>
</table>
<h4 id="Output%20%E4%BB%BB%E5%8A%A1%E8%BE%93%E5%87%BA%E7%BB%93%E6%9E%9C" name="Output%20%E4%BB%BB%E5%8A%A1%E8%BE%93%E5%87%BA%E7%BB%93%E6%9E%9C">Output 任务输出结果</h4>
<table>
<thead>
<tr>
<th style="text-align:left">参数名</th>
<th style="text-align:left">类型</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left">FileInfos</td>
<td style="text-align:left">Array</td>
<td style="text-align:left">输出文件信息列表</td>
</tr>
</tbody>
</table>
<p><strong>FileInfos 元素结构：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">参数名</th>
<th style="text-align:left">类型</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left">StorageMode</td>
<td style="text-align:left">String</td>
<td style="text-align:left">存储模式</td>
</tr>
<tr>
<td style="text-align:left">MediaName</td>
<td style="text-align:left">String</td>
<td style="text-align:left">媒体文件名称</td>
</tr>
<tr>
<td style="text-align:left">ClassId</td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">分类ID</td>
</tr>
<tr>
<td style="text-align:left">ExpireTime</td>
<td style="text-align:left">String</td>
<td style="text-align:left">过期时间（临时存储模式）</td>
</tr>
<tr>
<td style="text-align:left">FileType</td>
<td style="text-align:left">String</td>
<td style="text-align:left">文件类型</td>
</tr>
<tr>
<td style="text-align:left">FileId</td>
<td style="text-align:left">String</td>
<td style="text-align:left">文件ID</td>
</tr>
<tr>
<td style="text-align:left">FileUrl</td>
<td style="text-align:left">String</td>
<td style="text-align:left">文件播放URL</td>
</tr>
<tr>
<td style="text-align:left">MetaData</td>
<td style="text-align:left">Object</td>
<td style="text-align:left">文件元数据信息</td>
</tr>
</tbody>
</table>
<p><strong>MetaData 结构：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">参数名</th>
<th style="text-align:left">类型</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left">AudioDuration</td>
<td style="text-align:left">Float</td>
<td style="text-align:left">音频时长（秒）</td>
</tr>
<tr>
<td style="text-align:left">AudioStreamSet</td>
<td style="text-align:left">Array</td>
<td style="text-align:left">音频流信息</td>
</tr>
<tr>
<td style="text-align:left">├─ Bitrate</td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">音频码率（bps）</td>
</tr>
<tr>
<td style="text-align:left">├─ Channel</td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">声道数</td>
</tr>
<tr>
<td style="text-align:left">├─ Codec</td>
<td style="text-align:left">String</td>
<td style="text-align:left">音频编码格式</td>
</tr>
<tr>
<td style="text-align:left">├─ Codecs</td>
<td style="text-align:left">String</td>
<td style="text-align:left">编码详细参数</td>
</tr>
<tr>
<td style="text-align:left">├─ Loudness</td>
<td style="text-align:left">Float</td>
<td style="text-align:left">响度</td>
</tr>
<tr>
<td style="text-align:left">└─ SamplingRate</td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">采样率（Hz）</td>
</tr>
<tr>
<td style="text-align:left">Bitrate</td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">总码率（bps）</td>
</tr>
<tr>
<td style="text-align:left">Container</td>
<td style="text-align:left">String</td>
<td style="text-align:left">容器格式</td>
</tr>
<tr>
<td style="text-align:left">Duration</td>
<td style="text-align:left">Float</td>
<td style="text-align:left">总时长（秒）</td>
</tr>
<tr>
<td style="text-align:left">Height</td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">视频高度（像素）</td>
</tr>
<tr>
<td style="text-align:left">Md5</td>
<td style="text-align:left">String</td>
<td style="text-align:left">文件MD5校验值</td>
</tr>
<tr>
<td style="text-align:left">Rotate</td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">视频旋转角度</td>
</tr>
<tr>
<td style="text-align:left">Size</td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">文件大小（字节）</td>
</tr>
<tr>
<td style="text-align:left">VideoDuration</td>
<td style="text-align:left">Float</td>
<td style="text-align:left">视频时长（秒）</td>
</tr>
<tr>
<td style="text-align:left">VideoStreamSet</td>
<td style="text-align:left">Array</td>
<td style="text-align:left">视频流信息</td>
</tr>
<tr>
<td style="text-align:left">├─ Bitrate</td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">视频码率（bps）</td>
</tr>
<tr>
<td style="text-align:left">├─ Codec</td>
<td style="text-align:left">String</td>
<td style="text-align:left">视频编码格式</td>
</tr>
<tr>
<td style="text-align:left">├─ CodecTag</td>
<td style="text-align:left">String</td>
<td style="text-align:left">编码标签</td>
</tr>
<tr>
<td style="text-align:left">├─ Codecs</td>
<td style="text-align:left">String</td>
<td style="text-align:left">编码详细参数</td>
</tr>
<tr>
<td style="text-align:left">├─ DynamicRangeInfo</td>
<td style="text-align:left">Object</td>
<td style="text-align:left">动态范围信息（HDR类型等）</td>
</tr>
<tr>
<td style="text-align:left">├─ Fps</td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">帧率</td>
</tr>
<tr>
<td style="text-align:left">├─ Height</td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">视频高度</td>
</tr>
<tr>
<td style="text-align:left">└─ Width</td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">视频宽度</td>
</tr>
<tr>
<td style="text-align:left">Width</td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">视频宽度（像素）</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%9F%A5%E8%AF%A2%E4%BB%BB%E5%8A%A1%E8%AF%A6%E6%83%85%E6%8E%A5%E5%8F%A3%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B" name="%E6%9F%A5%E8%AF%A2%E4%BB%BB%E5%8A%A1%E8%AF%A6%E6%83%85%E6%8E%A5%E5%8F%A3%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B">查询任务详情接口调用示例</h2>
<p><span id="Hrya4y9k"></span></p>
<p>请求示例：</p>
<pre><code class="lang-Curl">curl -X POST &#39;https://modelpool-api.talkingdata.com/model/orgin/job?requestId=550e8400-e29b-41d4-a716-446655440001&#39; \
  -H &#39;Content-Type: application/json&#39; \
  -H &#39;Authorization: Bearer YOUR_API_KEY&#39; \
  -H &#39;X-Timestamp: 1760000000&#39; \
  -d &#39;{
    &quot;TaskId&quot;: &quot;1395528311-AigcVideoTask-92202210f541073442f58e7f4a857f4bt&quot;
}&#39;
</code></pre>
<p>响应示例：</p>
<pre><code class="lang-Curl">{
    &quot;Response&quot;: {
        &quot;TaskType&quot;: &quot;AigcVideoTask&quot;,
        &quot;Status&quot;: &quot;FINISH&quot;,
        &quot;CreateTime&quot;: &quot;2026-04-24T05:52:01Z&quot;,
        &quot;BeginProcessTime&quot;: &quot;2026-04-24T05:52:01Z&quot;,
        &quot;FinishTime&quot;: &quot;2026-04-24T05:53:33Z&quot;,
        &quot;ProcedureTask&quot;: null,
        &quot;EditMediaTask&quot;: null,
        &quot;SplitMediaTask&quot;: null,
        &quot;ComposeMediaTask&quot;: null,
        &quot;WechatPublishTask&quot;: null,
        &quot;PullUploadTask&quot;: null,
        &quot;WechatMiniProgramPublishTask&quot;: null,
        &quot;DescribeFileAttributesTask&quot;: null,
        &quot;RemoveWatermarkTask&quot;: null,
        &quot;RebuildMediaTask&quot;: null,
        &quot;FastClipMediaTask&quot;: null,
        &quot;ExtractTraceWatermarkTask&quot;: null,
        &quot;ExtractCopyRightWatermarkTask&quot;: null,
        &quot;ExtractBlindWatermarkTask&quot;: null,
        &quot;ReviewAudioVideoTask&quot;: null,
        &quot;QualityInspectTask&quot;: null,
        &quot;QualityEnhanceTask&quot;: null,
        &quot;ComplexAdaptiveDynamicStreamingTask&quot;: null,
        &quot;ProcessMediaByMPSTask&quot;: null,
        &quot;ProcessImageAsyncTask&quot;: null,
        &quot;AigcImageTask&quot;: null,
        &quot;SceneAigcImageTask&quot;: null,
        &quot;AigcVideoTask&quot;: {
            &quot;TaskId&quot;: &quot;1395528311-AigcVideoTask-df86d4503d813fab512b1ae5ed814bf0t&quot;,
            &quot;Status&quot;: &quot;FINISH&quot;,
            &quot;ErrCode&quot;: 0,
            &quot;ErrCodeExt&quot;: &quot;&quot;,
            &quot;Message&quot;: &quot;&quot;,
            &quot;Progress&quot;: 100,
            &quot;Input&quot;: {
                &quot;FileInfos&quot;: [],
                &quot;SubjectInfos&quot;: [],
                &quot;LastFrameFileId&quot;: &quot;&quot;,
                &quot;LastFrameUrl&quot;: &quot;&quot;,
                &quot;Prompt&quot;: &quot;生成小猫跳跃的视频&quot;,
                &quot;NegativePrompt&quot;: &quot;黑色&quot;,
                &quot;ModelName&quot;: &quot;GV&quot;,
                &quot;ModelVersion&quot;: &quot;3.1&quot;,
                &quot;EnhancePrompt&quot;: &quot;Enabled&quot;,
                &quot;GenerationMode&quot;: &quot;&quot;,
                &quot;OutputConfig&quot;: {
                    &quot;StorageMode&quot;: &quot;Temporary&quot;,
                    &quot;MediaName&quot;: &quot;&quot;,
                    &quot;ClassId&quot;: 0,
                    &quot;ExpireTime&quot;: &quot;0000-00-00T00:00:00Z&quot;,
                    &quot;Duration&quot;: 0,
                    &quot;Resolution&quot;: &quot;&quot;,
                    &quot;AspectRatio&quot;: &quot;16:9&quot;,
                    &quot;AudioGeneration&quot;: &quot;Enabled&quot;,
                    &quot;EnableBGM&quot;: &quot;&quot;,
                    &quot;PersonGeneration&quot;: &quot;AllowAdult&quot;,
                    &quot;InputComplianceCheck&quot;: &quot;Enabled&quot;,
                    &quot;OutputComplianceCheck&quot;: &quot;Enabled&quot;,
                    &quot;EnhanceSwitch&quot;: &quot;&quot;,
                    &quot;OffPeak&quot;: &quot;&quot;,
                    &quot;FrameInterpolate&quot;: &quot;&quot;,
                    &quot;LogoAdd&quot;: &quot;&quot;
                },
                &quot;InputRegion&quot;: &quot;Mainland&quot;,
                &quot;SceneType&quot;: &quot;&quot;,
                &quot;Seed&quot;: 0
            },
            &quot;Output&quot;: {
                &quot;FileInfos&quot;: [
                    {
                        &quot;StorageMode&quot;: &quot;Temporary&quot;,
                        &quot;MediaName&quot;: &quot;&quot;,
                        &quot;ClassId&quot;: 0,
                        &quot;ExpireTime&quot;: &quot;2026-05-01T09:12:40Z&quot;,
                        &quot;FileType&quot;: &quot;&quot;,
                        &quot;FileId&quot;: &quot;&quot;,
                        &quot;FileUrl&quot;: &quot;http://251000800.vod2.myqcloud.com/1a168d62vodcq251000800/2135ec885145403724387426477/aigcVideoGenFile.mp4&quot;,
                        &quot;MetaData&quot;: {
                            &quot;AudioDuration&quot;: 8,
                            &quot;AudioStreamSet&quot;: [
                                {
                                    &quot;Bitrate&quot;: 256297,
                                    &quot;Channel&quot;: 0,
                                    &quot;Codec&quot;: &quot;aac&quot;,
                                    &quot;Codecs&quot;: &quot;&quot;,
                                    &quot;Loudness&quot;: 0,
                                    &quot;SamplingRate&quot;: 48000
                                }
                            ],
                            &quot;Bitrate&quot;: 3148161,
                            &quot;Container&quot;: &quot;mov,mp4,m4a,3gp,3g2,mj2&quot;,
                            &quot;Duration&quot;: 8,
                            &quot;Height&quot;: 720,
                            &quot;Md5&quot;: &quot;&quot;,
                            &quot;Rotate&quot;: 0,
                            &quot;Size&quot;: 3148161,
                            &quot;VideoDuration&quot;: 8,
                            &quot;VideoStreamSet&quot;: [
                                {
                                    &quot;Bitrate&quot;: 2874839,
                                    &quot;Codec&quot;: &quot;h264&quot;,
                                    &quot;CodecTag&quot;: &quot;&quot;,
                                    &quot;Codecs&quot;: &quot;&quot;,
                                    &quot;DynamicRangeInfo&quot;: {
                                        &quot;HDRType&quot;: &quot;&quot;,
                                        &quot;Type&quot;: &quot;Unknown&quot;
                                    },
                                    &quot;Fps&quot;: 24,
                                    &quot;Height&quot;: 720,
                                    &quot;Width&quot;: 1280
                                }
                            ],
                            &quot;Width&quot;: 1280
                        }
                    }
                ]
            },
            &quot;SessionContext&quot;: &quot;&quot;,
            &quot;SessionId&quot;: &quot;&quot;
        },
        &quot;SceneAigcVideoTask&quot;: null,
        &quot;ImportMediaKnowledge&quot;: null,
        &quot;CreateAigcAdvancedCustomElementTask&quot;: null,
        &quot;CreateAigcCustomVoiceTask&quot;: null,
        &quot;CreateAigcSubjectTask&quot;: null,
        &quot;AigcVideoRedrawTask&quot;: null,
        &quot;TranscodeTask&quot;: null,
        &quot;SnapshotByTimeOffsetTask&quot;: null,
        &quot;ConcatTask&quot;: null,
        &quot;ClipTask&quot;: null,
        &quot;CreateImageSpriteTask&quot;: null,
        &quot;ReduceMediaBitrateTask&quot;: null,
        &quot;RequestId&quot;: &quot;516629a8-9ea5-4025-b184-2ed456eed88d&quot;
    }
}
</code></pre>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E9%94%99%E8%AF%AF%E7%A0%81" name="%E9%94%99%E8%AF%AF%E7%A0%81">错误码</h2>
<table>
<thead>
<tr>
<th style="text-align:left">错误码</th>
<th style="text-align:left">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left">FailedOperation</td>
<td style="text-align:left">操作失败。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.InvalidVodUser</td>
<td style="text-align:left">没有开通点播业务。</td>
</tr>
<tr>
<td style="text-align:left">InternalError</td>
<td style="text-align:left">内部错误。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameterValue</td>
<td style="text-align:left">参数取值错误。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameterValue.SubAppId</td>
<td style="text-align:left">参数值错误：应用 ID。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameterValue.TaskId</td>
<td style="text-align:left">任务 ID 不存在。</td>
</tr>
<tr>
<td style="text-align:left">ResourceNotFound</td>
<td style="text-align:left">资源不存在。</td>
</tr>
<tr>
<td style="text-align:left">UnauthorizedOperation</td>
<td style="text-align:left">未授权操作。</td>
</tr>
</tbody>
</table>
]]></content:encoded>
      <pubDate>Thu, 23 Apr 2026 18:11:09 +0800</pubDate>
      <guid>http://doc.talkingdata.com/posts/1233</guid>
      <comments>http://doc.talkingdata.com/posts/1233#comments</comments>
    </item>
    <item>
      <title>TD云联9/Doubao-deepseek-v3.2</title>
      <link>http://doc.talkingdata.com/posts/1232</link>
      <category>开源模型 LLM</category>
      <author>liuxinmei</author>
      <description>云联9 接口说明文档 TD模型编号：T0106004 模型能力简介 云联9 发送包含文本、图片、视频等模态的消息列表，模型将生成对话中的下一条消息。 鉴权说明  本接口仅支持API Key鉴权，需联系TD运维同学获取长效API Key。
 对话(Chat) 接口地址 本文介绍对话(Chat) API 请求时的输入输出参数，供您使用接口时查阅字段含义。 请求方法： POST 接口URL：https://modelpool-api.talkingdata.com/model/openai/api/v3/chat/completions 请求头（Request Headers）： 头部字段 值 是否必需 说明 Authorization Bearer &lt;your_api_key&gt; 是 API 鉴权</description>
      <content:encoded><![CDATA[<h4 id="%3Cstrong%3E%E4%BA%91%E8%81%949%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3%3C%2Fstrong%3E" name="%3Cstrong%3E%E4%BA%91%E8%81%949%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3%3C%2Fstrong%3E"><strong>云联9 接口说明文档</strong></h4>
<p><strong>TD模型编号：T0106004</strong></p>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%A8%A1%E5%9E%8B%E8%83%BD%E5%8A%9B%E7%AE%80%E4%BB%8B" name="%E6%A8%A1%E5%9E%8B%E8%83%BD%E5%8A%9B%E7%AE%80%E4%BB%8B">模型能力简介</h2>
<p><span id="Hrya4y9k"></span></p>
<ul>
<li><strong>云联9</strong><ul>
<li>发送包含文本、图片、视频等模态的消息列表，模型将生成对话中的下一条消息。</li>
</ul>
</li>
</ul>
<h5 id="%3Cstrong%3E%E9%89%B4%E6%9D%83%E8%AF%B4%E6%98%8E%3C%2Fstrong%3E%26nbsp%3B" name="%3Cstrong%3E%E9%89%B4%E6%9D%83%E8%AF%B4%E6%98%8E%3C%2Fstrong%3E%26nbsp%3B"><strong>鉴权说明</strong>&nbsp;</h5>
<pre><code>本接口仅支持API Key鉴权，需联系TD运维同学获取长效API Key。
</code></pre><hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E5%AF%B9%E8%AF%9D(Chat)%20%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80" name="%E5%AF%B9%E8%AF%9D(Chat)%20%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80">对话(Chat) 接口地址</h2>
<p><span id="Hrya4y9k"></span>
本文介绍对话(Chat) API 请求时的输入输出参数，供您使用接口时查阅字段含义。</p>
<p><strong>请求方法：</strong> POST </p>
<p><strong>接口URL：</strong><code>https://modelpool-api.talkingdata.com/model/openai/api/v3/chat/completions</code> </p>
<p><strong>请求头（Request Headers）：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">头部字段</th>
<th style="text-align:left">值</th>
<th style="text-align:left">是否必需</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>Authorization</code></td>
<td style="text-align:left"><code>Bearer &lt;your_api_key&gt;</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">API 鉴权凭证，请替换为有效的 API Key</td>
</tr>
<tr>
<td style="text-align:left"><code>X-Timestamp</code></td>
<td style="text-align:left"><code>1700000000</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">Unix 时间戳格式</td>
</tr>
<tr>
<td style="text-align:left"><code>Content-Type</code></td>
<td style="text-align:left"><code>application/json</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">请求体格式必须为 JSON</td>
</tr>
</tbody>
</table>
<p><strong>请求参数（Request  Parameter）：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">字段</th>
<th style="text-align:left">值</th>
<th style="text-align:left">是否必需</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>requestld</code></td>
<td style="text-align:left"><code>550e8400-e29b-41d4-a716-446655440000</code></td>
<td style="text-align:left">否</td>
<td style="text-align:left">请求唯一标识符。使用 UUID 格式字符串，用于跟踪和排查请求相关问题，以便在需要技术排查时，提供此 ID 可快速定位具体请求的完整处理链路和日志信息。</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E5%AF%B9%E8%AF%9D(Chat)%20%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0" name="%E5%AF%B9%E8%AF%9D(Chat)%20%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0">对话(Chat) 请求参数</h2>
<p><span id="Hrya4y9k"></span></p>
<h3 id="%E5%AF%B9%E8%AF%9D(Chat)%20%E8%AF%B7%E6%B1%82%E4%BD%93%EF%BC%88requestBody%EF%BC%89" name="%E5%AF%B9%E8%AF%9D(Chat)%20%E8%AF%B7%E6%B1%82%E4%BD%93%EF%BC%88requestBody%EF%BC%89">对话(Chat) 请求体（requestBody）</h3>
<hr>
<p><strong>model</strong>   <code>string</code>   <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span>   </p>
<p>本次请求使用模型的 Model ID 为 T0106004</p>
<hr>
<p><strong>messages</strong> <code>object[]</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>消息列表，不同模型支持不同类型的消息，如文本、图片、视频等。</p>
<ul>
<li><p><strong>消息类型</strong></p>
<ul>
<li><p><strong>系统消息</strong> <code>object</code>
模型需遵循的指令，包括扮演的角色、背景信息等。</p>
<ul>
<li>messages.<strong>role</strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>发送消息的角色，此处应为<code>system</code>。</li>
<li>messages.<strong>content</strong> <code>string / object[]</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>系统消息的内容。<ul>
<li><strong>纯文本内容</strong> <code>string</code>
纯文本消息内容。</li>
<li><strong>多模态内容</strong> <code>object[]</code>
各模态内容对象，支持文本、图片、视频类型。<ul>
<li><strong>文本部分</strong> <code>object</code><ul>
<li>messages.content.<strong>text</strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>文本模态部分的内容。</li>
<li>messages.content.<strong>type</strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>内容模态，此处应为<code>text</code>。</li>
</ul>
</li>
<li><strong>图片部分</strong> <code>object</code><ul>
<li>messages.content.<strong>image_url</strong> <code>object</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>图片模态的内容。<ul>
<li>messages.content.image_url.<strong>url</strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>支持图片链接或图片的Base64编码。</li>
<li>messages.content.image_url.<strong>detail</strong> <code>string</code>
取值范围：<code>low</code>、<code>high</code>、<code>xhigh</code>。理解图片的精细度。</li>
</ul>
</li>
<li>messages.content.<strong>type</strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>内容模态，此处应为<code>image_url</code>。</li>
</ul>
</li>
<li><strong>视频部分</strong> <code>object</code>
不支持理解视频中的音频内容。<ul>
<li>messages.content.<strong>type</strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>内容模态，此处应为<code>video_url</code>。</li>
<li>messages.content.<strong>video_url</strong> <code>object</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>视频消息的内容部分。<ul>
<li>messages.content.video_url.<strong>url</strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>支持视频链接或视频的Base64编码。</li>
<li>messages.content.video_url.<strong>fps</strong> <code>float/ null</code>  默认值 <code>1</code>
取值范围：<code>[0.2, 5]</code>。抽帧频率。取值越高，对视频中画面变化越敏感；取值越低，对视频中画面变化越迟钝，但 token 花费少，速度更快。</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
<li><p><strong>用户消息</strong> <code>object</code>
用户角色发送的消息，不同模型支持的字段类型不同。</p>
<ul>
<li><p>messages.<strong>role</strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>发送消息的角色，此处应为<code>user</code>。</p>
</li>
<li><p>messages.<strong>content</strong> <code>string / object[]</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>用户信息内容。</p>
<ul>
<li><p><strong>纯文本内容</strong> <code>string</code>
纯文本消息内容。</p>
</li>
<li><p><strong>多模态内容</strong> <code>object[]</code>
支持文本、图片、视频等模态内容，不支持理解视频中的音频内容。</p>
<ul>
<li><p><strong>文本部分</strong> <code>object</code></p>
<ul>
<li>messages.content.<strong>text</strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>文本模态部分的内容。</li>
<li>messages.content.<strong>type</strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>内容模态，此处应为<code>text</code>。</li>
</ul>
</li>
<li><p><strong>图片部分</strong> <code>object</code></p>
<ul>
<li><p>messages.content.<strong>type</strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>消息模态，此处应为<code>image_url</code>。</p>
</li>
<li><p>messages.content.<strong>image_url</strong> <code>object</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>图片模态的内容。</p>
<ul>
<li>messages.content.image_url.<strong>url</strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>支持图片链接或图片的Base64编码。</li>
<li>messages.content.image_url.<strong>detail</strong> <code>string</code>
取值范围：<code>low</code>、<code>high</code>、<code>xhigh</code>。理解图片的精细度、不同模型默认取值及对应的具体像素区间。</li>
<li>messages.content.<strong>image_pixel_limit</strong> <code>object / null</code>  默认值 <code>null</code>
输入给模型的图片的像素范围，如不在此范围，图片会被等比例缩放至该范围。</li>
</ul>
<blockquote>
<p>注意：</p>
<p>图片像素范围需在 [196, 36,000,000]，否则会直接报错。</p>
</blockquote>
<ul>
<li>生效优先级：高于 <code>detail</code> 字段，即同时配置 <code>detail</code> 与 <code>image_pixel_limit</code> 字段时，生效 <code>image_pixel_limit</code> 字段配置。</li>
<li>默认生效规则：若未设置<code>image_pixel_limit</code>，则使用 <code>detail</code> 配置的值对应的 <code>min_pixels</code> / <code>max_pixels</code> 值。</li>
<li>messages.content.image_pixel_limit.<strong>max_pixels</strong> <code>integer</code>
传入图片最大像素限制，大于此像素则等比例缩小至 <code>max_pixels</code> 字段取值以下。若未设置，则取值为 <code>detail</code> 配置的值对应的 <code>max_pixels</code> 值。</li>
<li>messages.content.image_pixel_limit.<strong>min_pixels</strong> <code>integer</code>
传入图片最小像素限制，小于此像素则等比例放大至 <code>min_pixels</code> 字段取值以上。若未设置，则取值为 <code>detail</code> 配置的值对应的 <code>min_pixels</code> 值。</li>
</ul>
</li>
</ul>
</li>
<li><p><strong>视频部分</strong> <code>object</code></p>
</li>
<li><p>messages.content.<strong>type</strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>内容模态，此处应为<code>video_url</code>。</p>
</li>
<li><p>messages.content.<strong>video_url</strong> <code>object</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>视频模态的内容。</p>
<ul>
<li>messages.content.video_url.<strong>url</strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>支持视频链接或视频的Base64编码。</li>
<li>messages.content.video_url.<strong>fps</strong> <code>float</code>
取值范围：<code>[0.2, 5]</code>。抽帧频率，取值越高，对视频中画面变化越敏感；取值越低，对视频中画面变化越迟钝，但 token 花费少，速度更快。</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
<li><p><strong>模型消息</strong> <code>object</code></p>
<p>历史对话中，模型角色返回的消息，用以保持对话一致性，多在多轮对话及续写模式使用。</p>
<blockquote>
<p>说明：messages.content 与 messages.tool_calls 至少填写其一。</p>
</blockquote>
<ul>
<li>messages.<strong>role</strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>发送消息的角色，此处应为<code>assistant</code>。</li>
<li>messages.<strong>content</strong> <code>string / array</code>
模型消息的内容。</li>
<li>messages.<strong>reasoning_content</strong> <code>string</code></li>
</ul>
<p>​       模型消息中的思维连内容。</p>
<ul>
<li><p>messages.<strong>tool_calls</strong> <code>object[]</code>
模型消息中工具调用部分。</p>
<ul>
<li><p>messages.tool_calls.<strong>function</strong> <code>object</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span>    </p>
<p>模型返回的需调用的函数信息。</p>
<ul>
<li>messages.tool_calls<strong>.</strong>function.<strong>name</strong>  <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span>    </li>
</ul>
<p>​       需调用的函数的名称。</p>
<ul>
<li>messages.tool_calls<strong>.</strong>function.<strong>arguments</strong>  <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span>    </li>
</ul>
<p>​       需调用的函数的入参，JSON 格式。</p>
<blockquote>
<p>说明：模型并不总是生成有效的 JSON，可能会虚构出未定义的参数。建议在调用函数前，验证参数是否有效。</p>
</blockquote>
</li>
<li><p>messages.tool_calls.<strong>id</strong><code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span>    </p>
<p>需调用的工具的 ID，由模型生成。</p>
</li>
<li><p>messages.tool_calls.<strong>type</strong><code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span>    </p>
<p>消息类型，当前仅支持 <code>function</code>。</p>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
<ul>
<li><p><strong>工具消息</strong> <code>object</code>
历史对话中，调用工具返回的消息，工具调用场景中使用。</p>
<ul>
<li>messages.<strong>role</strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>发送消息的角色，此处应为<code>tool</code>。</li>
<li>messages.<strong>content</strong> <code>string / array</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>工具返回的消息。</li>
<li>messages.<strong>tool_call_id</strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>模型生成的需调用工具请求时生成的ID。在程序调用工具的返回需要附上同一 ID，来关联工具结构与模型请求，避免多工具调用时混淆信息。</li>
</ul>
</li>
</ul>
<hr>
<p><strong>thinking</strong> <code>object</code>  默认值 <code>{&quot;type&quot;:&quot;enabled&quot;}</code>
控制模型是否开启深度思考模式，不同模型是否支持以及默认取值不同。</p>
<ul>
<li>thinking.<strong>type</strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>取值范围：<code>enabled</code>，<code>disabled</code>，<code>auto</code>。<ul>
<li><code>enabled</code>：开启思考模式，模型强制先思考再回答。</li>
<li><code>disabled</code>：关闭思考模式，模型直接回答问题，不进行思考。</li>
<li><code>auto</code>：自动思考模式，模型根据问题自主判断是否需要思考，简单题目直接回答。</li>
</ul>
</li>
</ul>
<hr>
<p><strong>stream</strong> <code>boolean / null</code>  默认值 <code>false</code>
响应内容是否流式返回：</p>
<ul>
<li><code>false</code>：模型生成完所有内容后一次性返回结果。</li>
<li><code>true</code>：按 SSE 协议逐块返回模型生成内容，并以一条 <code>data: [DONE]</code> 消息结束。当 <code>stream</code> 为 <code>true</code> 时，可设置 <code>stream_options</code> 字段以获取 token 用量统计信息。</li>
</ul>
<hr>
<p><strong>stream_options</strong> <code>object / null</code>  默认值 <code>null</code>
流式响应的选项，当 <code>stream</code> 为 <code>true</code> 时，可设置 <code>stream_options</code> 字段。</p>
<ul>
<li>stream_options.<strong>include_usage</strong> <code>boolean / null</code>  默认值 <code>false</code>
模型流式输出时，是否在输出结束前输出本次请求的 token 用量信息。<ul>
<li><code>true</code>：在 <code>data: [DONE]</code> 消息之前会返回一个额外的 chunk。此 chunk 中，<code>usage</code> 字段中输出整个请求的 token 用量，<code>choices</code> 字段为空数组。</li>
<li><code>false</code>：输出结束前，没有一个 chunk 来返回 token 用量信息。</li>
</ul>
</li>
<li>stream_options.<strong>chunk_include_usage</strong> <code>boolean / null</code>  默认值 <code>false</code>
模型流式输出时，输出的每个 chunk 中是否输出本次请求到此 chunk 输出时刻的累计 token 用量信息。<ul>
<li><code>true</code>：在返回的 <code>usage</code> 字段中，输出本次请求到此 chunk 输出时刻的累计 token 用量。</li>
<li><code>false</code>：不在每个 chunk 都返回 token 用量信息。</li>
</ul>
</li>
</ul>
<hr>
<p><strong>max_tokens</strong> <code>integer / null</code>  默认值 <code>4096</code>
取值范围：各个模型不同，模型回答最大长度（单位 token）。</p>
<p>上下文窗口: 128k；最大输入: 96k；最大回答(默认 4k): 32k；最大思维链: 32k</p>
<blockquote>
<p>说明：模型回答不包含思维链内容，模型回答 = 模型输出 - 模型思维链（如有）。输出 token 的总长度还受模型的上下文长度限制。</p>
</blockquote>
<hr>
<p><strong>max_completion_tokens</strong> <code>integer / null</code></p>
<p>支持该字段的模型及使用说明见文档。取值范围：<code>[0, 65536]</code>。控制模型输出的最大长度（包括模型回答和模型思维链内容长度，单位 token）。配置了该参数后，可以让模型输出超长内容，<code>max_tokens</code> 默认值失效，模型按需输出内容（回答和思维链），直到达到 <code>max_completion_tokens</code> 值。不可与 <code>max_tokens</code> 字段同时设置。</p>
<hr>
<p><strong>service_tier</strong> <code>string / null</code>  默认值 <code>auto</code>
控制是否使用TPM保障包。取值范围：<code>auto</code>、<code>default</code>。</p>
<ul>
<li><code>auto</code>：本次请求优先使用 TPM 保障包额度。有 TPM 保障包额度的推理接入点，本次请求将会优先使用 TPM 保障包额度，获得更高的服务等级（响应速度、可用性）；无 TPM 保障包额度或用超额度的推理接入点，维持默认的服务等级。</li>
<li><code>default</code>：本次请求不使用 TPM 保障包，维持默认的服务等级（即使推理接入点有TPM保障包额度）。</li>
</ul>
<hr>
<p><strong>reasoning_effort</strong> <code>string / null</code>  默认值 <code>medium</code>
支持该字段的模型、与 <code>thinking.type</code> 字段关系见文档。限制思考的工作量，减少思考深度可提升速度，思考花费的 token 更少。
取值范围：<code>minimal</code>，<code>low</code>，<code>medium</code>，<code>high</code>。</p>
<ul>
<li><code>minimal</code>：关闭思考，直接回答。</li>
<li><code>low</code>：轻量思考，侧重快速响应。</li>
<li><code>medium</code>：均衡模式，兼顾速度与深度。</li>
<li><code>high</code>：深度分析，处理复杂问题。</li>
</ul>
<hr>
<p><strong>response_format</strong> <code>object</code>  默认值 <code>{&quot;type&quot;: &quot;text&quot;}</code>  beta阶段
指定模型回答格式。</p>
<ul>
<li><strong>文本格式</strong> <code>object</code>
模型默认回复文本格式内容。<ul>
<li>response_format.<strong>type</strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>此处应为 <code>text</code>。</li>
</ul>
</li>
<li><strong>JSON Object 格式</strong> <code>object</code>
模型回复内容以JSON对象结构来组织。该能力尚在 beta 阶段，请谨慎在生产环境使用。<ul>
<li>response_format.<strong>type</strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>此处应为<code>json_object</code>。</li>
</ul>
</li>
<li><strong>JSON Schema 格式</strong> <code>object</code>
模型回复内容以JSON对象结构来组织，遵循 schema 字段定义的JSON结构。该能力尚在 beta 阶段，请谨慎在生产环境使用。<ul>
<li>response_format.<strong>type</strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>此处应为<code>json_schema</code>。</li>
<li>response_format.<strong>json_schema</strong> <code>object</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>JSON结构体的定义。<ul>
<li>response_format.json_schema.<strong>name</strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>用户自定义的JSON结构的名称。</li>
<li>response_format.json_schema.<strong>description</strong> <code>string / null</code>
回复用途描述，模型将根据此描述决定如何以该格式回复。</li>
<li>response_format.json_schema.<strong>schema</strong> <code>object</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>回复格式的 JSON 格式定义，以 JSON Schema 对象的形式描述。</li>
<li>response_format.json_schema.<strong>strict</strong> <code>boolean / null</code>  默认值 <code>false</code>
是否在生成输出时，启用严格遵循模式。<ul>
<li><code>true</code>：模型将始终严格遵循schema字段中定义的格式。</li>
<li><code>false</code>：模型会尽可能遵循schema字段中定义的结构。</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
<hr>
<p><strong>frequency_penalty</strong> <code>float / null</code>  默认值 <code>0</code></p>
<p>取值范围为 <code>[-2.0, 2.0]</code>。频率惩罚系数。如值为正，根据新 token 在文本中的出现频率对其进行惩罚，从而降低模型逐字重复的可能性。</p>
<hr>
<p><strong>presence_penalty</strong> <code>float / null</code>  默认值 <code>0</code></p>
<p>取值范围为 <code>[-2.0, 2.0]</code>。存在惩罚系数。如果值为正，会根据新 token 到目前为止是否出现在文本中对其进行惩罚，从而增加模型谈论新主题的可能性。</p>
<p><strong>temperature</strong> <code>float / null</code>  默认值 <code>1</code>
取值范围为 <code>[0, 2]</code>。</p>
<blockquote>
<p>采样温度。控制了生成文本时对每个候选词的概率分布进行平滑的程度。当取值为 0 时模型仅考虑对数概率最大的一个 token。较高的值（如 0.8）会使输出更加随机，而较低的值（如 0.2）会使输出更加集中确定。通常建议仅调整 <code>temperature</code> 或 <code>top_p</code> 其中之一，不建议两者都修改。</p>
</blockquote>
<hr>
<p><strong>top_p</strong> <code>float / null</code>  默认值 <code>0.7</code>
取值范围为 <code>[0, 1]</code>。</p>
<blockquote>
<p>核采样概率阈值。模型会考虑概率质量在 <code>top_p</code> 内的 token 结果。当取值为 0 时模型仅考虑对数概率最大的一个 token。0.1 意味着只考虑概率质量最高的前 10% 的 token，取值越大生成的随机性越高，取值越低生成的确定性越高。通常建议仅调整 <code>temperature</code> 或 <code>top_p</code> 其中之一，不建议两者都修改。</p>
</blockquote>
<hr>
<p><strong>tools</strong> <code>object[] / null</code>  默认值 <code>null</code>
待调用工具的列表，模型返回信息中可包含。当您需要让模型返回待调用工具时，需要配置该结构体。</p>
<ul>
<li><p>tools.<strong>type</strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>工具类型，此处应为 <code>function</code>。</p>
</li>
<li><p>tools.<strong>function</strong> <code>object</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>模型返回中可包含待调用的工具。</p>
<ul>
<li><p>tools.function.<strong>name</strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>调用的函数的名称。</p>
</li>
<li><p>tools.function.<strong>description</strong> <code>string</code>
调用的函数的描述，大模型会使用它来判断是否调用这个工具。</p>
</li>
<li><p>tools.function.<strong>parameters</strong> <code>object</code>
函数请求参数，以 JSON Schema 格式描述。具体格式请参考 JSON Schema 文档，格式如下：</p>
<pre><code class="lang-json">{
&quot;type&quot;: &quot;object&quot;,
&quot;properties&quot;: {
&quot;参数名&quot;: {
&quot;type&quot;: &quot;string | number | boolean | object | array&quot;,
&quot;description&quot;: &quot;参数说明&quot;
}
},
&quot;required&quot;: [&quot;必填参数&quot;]
}
</code></pre>
<p>其中，</p>
<ul>
<li>所有字段名大小写敏感。</li>
<li><code>parameters</code> 须是合规的 JSON Schema 对象。</li>
<li>建议用英文字段名，中文置于 <code>description</code> 字段中。</li>
</ul>
</li>
</ul>
</li>
</ul>
<hr>
<p><strong>parallel_tool_calls</strong> <code>boolean</code>  默认值 <code>true</code></p>
<p>本次请求，模型返回是否允许包含多个待调用的工具。</p>
<ul>
<li><code>true</code> ：允许返回多个待调用的工具。</li>
<li><code>false</code> ：允许返回的待调用的工具小于等于1。</li>
</ul>
<hr>
<p><strong>tool_choice</strong> <code>string / object</code>
本次请求，模型返回信息中是否有待调用的工具。当没有指定工具时，<code>none</code> 是默认值。如果存在工具，则 <code>auto</code> 是默认值。</p>
<ul>
<li><strong>选择模式</strong> <code>string</code>
控制模型返回是否包含待调用的工具。<ul>
<li><code>none</code> ：模型返回信息中不可含有待调用的工具。</li>
<li><code>required</code> ：模型返回信息中必须含待调用的工具。选择此项时请确认存在适合的工具，以减少模型产生幻觉的情况。</li>
<li><code>auto</code> ：模型自行判断返回信息是否有待调用的工具。</li>
</ul>
</li>
<li><strong>工具调用</strong> <code>object</code>
指定待调用工具的范围。模型返回信息中，只允许包含以下模型信息。选择此项时请确认该工具适合用户需求，以减少模型产生幻觉的情况。<ul>
<li>tool_choice.<strong>type</strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>调用的类型，此处应为 <code>function</code>。</li>
<li>tool_choice.<strong>function</strong> <code>object</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>调用工具的信息。<ul>
<li>tool_choice.function.<strong>name</strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span><br>待调用工具的名称。</li>
</ul>
</li>
</ul>
</li>
</ul>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E5%AF%B9%E8%AF%9D(Chat)%20%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0" name="%E5%AF%B9%E8%AF%9D(Chat)%20%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0">对话(Chat) 响应参数</h2>
<p><span id="Hrya4y9k"></span></p>
<h3 id="%E5%AF%B9%E8%AF%9D(Chat)%20%E9%9D%9E%E6%B5%81%E5%BC%8F%E8%B0%83%E7%94%A8%E8%BF%94%E5%9B%9E" name="%E5%AF%B9%E8%AF%9D(Chat)%20%E9%9D%9E%E6%B5%81%E5%BC%8F%E8%B0%83%E7%94%A8%E8%BF%94%E5%9B%9E">对话(Chat) 非流式调用返回</h3>
<hr>
<p><strong>id</strong> <code>string</code>
本次请求的唯一标识</p>
<hr>
<p><strong>model</strong> <code>string</code>
本次请求实际使用的模型名称和版本</p>
<hr>
<p><strong>service_tier</strong> <code>string</code>
本次请求是否使用了TPM保障包（<code>scale</code>：使用；<code>default</code>：未使用）</p>
<hr>
<p><strong>created</strong> <code>integer</code>
本次请求创建时间的 Unix 时间戳（秒）</p>
<hr>
<p><strong>object</strong> <code>string</code>
固定为 <code>chat.completion</code></p>
<hr>
<p><strong>choices</strong> <code>object[]</code>
本次请求的模型输出内容</p>
<ul>
<li><p>choices.<strong>index</strong> <code>integer</code>
当前元素在 <code>choices</code> 列表的索引。</p>
</li>
<li><p>choices.<strong>finish_reason</strong> <code>string</code>
模型停止生成 token 的原因。取值范围：</p>
<ul>
<li><code>stop</code>：模型输出自然结束，或因命中请求参数 <code>stop</code> 中指定的字段而被截断。</li>
<li><code>length</code>：模型输出因达到模型输出限制而被截断，有以下原因：<ul>
<li>触发<code>max_tokens</code>限制（回答内容的长度限制）。</li>
<li>触发<code>`max_completion_tokens</code>（思维链内容+回答内容的长度限制）。</li>
<li>触发<code>context_window</code>限制（输入内容+思维链内容+回答内容的长度限制）。</li>
</ul>
</li>
<li><code>content_filter</code>：模型输出被内容审核拦截。</li>
<li><code>tool_calls</code>：模型调用了工具。</li>
</ul>
</li>
<li><p>choices.<strong>message</strong> <code>object</code>
模型输出的内容。</p>
<ul>
<li>choices.message.<strong>role</strong> <code>string</code>
内容输出的角色，此处固定为 <code>assistant</code>。</li>
<li>choices.message.<strong>content</strong> <code>string</code>
模型生成的消息内容。</li>
<li>choices.message.<strong>reasoning_content</strong> <code>string / null</code>
模型处理问题的思维链内容，仅深度推理模型支持返回此字段。</li>
<li>choices.message.<strong>tool_calls</strong> <code>object[] / null</code>
模型生成的工具调用。<ul>
<li>choices.message.tool_calls.<strong>id</strong> <code>string</code>
调用的工具的 ID。</li>
<li>choices.message.tool_calls.<strong>type</strong> <code>string</code>
工具类型，当前仅支持<code>function</code>。</li>
<li>choices.message.tool_calls.<strong>function</strong> <code>object</code>
模型调用的函数。<ul>
<li>choices.message.tool_calls.function.<strong>name</strong> <code>string</code>
模型调用的函数的名称。</li>
<li>choices.message.tool_calls.function.<strong>arguments</strong> <code>string</code>
模型生成的用于调用函数的参数，JSON 格式。模型并不总是生成有效的 JSON，并且可能会虚构出一些您的函数参数规范中未定义的参数。在调用函数之前，请在您的代码中验证这些参数是否有效。</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
<li><p>choices.<strong>logprobs</strong> <code>object / null</code>
当前内容的对数概率信息。</p>
<ul>
<li>choices.logprobs.<strong>content</strong> <code>object[] / null</code>
message列表中每个 content 元素中的 token 对数概率信息。<ul>
<li>choices.logprobs.content.<strong>token</strong> <code>string</code>
当前 token。</li>
<li>choices.logprobs.content.<strong>bytes</strong> <code>integer[] / null</code>
当前 token 的 UTF-8 值，格式为整数列表。当一个字符由多个 token 组成（表情符号或特殊字符等）时可以用于字符的编码和解码。如果 token 没有 UTF-8 值则为空。</li>
<li>choices.logprobs.content.<strong>logprob</strong> <code>float</code>
当前 token 的对数概率。</li>
<li>choices.logprobs.content.<strong>top_logprobs</strong> <code>object[]</code>
在当前 token 位置最有可能的标记及其对数概率的列表。在一些情况下，返回的数量可能比请求参数 <code>top_logprobs</code> 指定的数量要少。<ul>
<li>choices.logprobs.content.top_logprobs.<strong>token</strong> <code>string</code>
当前 token。</li>
<li>choices.logprobs.content.top_logprobs.<strong>bytes</strong> <code>integer[] / null</code>
当前 token 的 UTF-8 值，格式为整数列表。当一个字符由多个 token 组成（表情符号或特殊字符等）时可以用于字符的编码和解码。如果 token 没有 UTF-8 值则为空。</li>
<li>choices.logprobs.content.top_logprobs.<strong>logprob</strong> <code>float</code>
当前 token 的对数概率。</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
<li><p>choices.<strong>moderation_hit_type</strong> <code>string/ null</code>
模型输出文字含有敏感信息时，会返回模型输出文字命中的风险分类标签。返回值及含义：</p>
<ul>
<li><code>severe_violation</code>：模型输出文字涉及严重违规。</li>
<li><code>violence</code>：模型输出文字涉及激进行为。</li>
</ul>
<blockquote>
<p>注意：当前只有视觉理解模型支持返回该字段，且只有在方舟控制台接入点配置页面或者 CreateEndpoint 接口中，将内容护栏方案（ModerationStrategy）设置为基础方案（Basic）时，才会返回风险分类标签。</p>
</blockquote>
</li>
</ul>
<hr>
<p><strong>usage</strong> <code>object</code>
本次请求的 token 用量</p>
<ul>
<li><p>usage.<strong>total_tokens</strong> <code>integer</code>
本次请求消耗的总 token 数量（输入 + 输出）。</p>
</li>
<li><p>usage.<strong>prompt_tokens</strong> <code>integer</code>
输入给模型处理的内容 token 数量。</p>
</li>
<li>usage.<strong>prompt_tokens_details</strong> <code>object</code>
输入给模型处理的内容 token 数量的细节。<ul>
<li>usage.prompt_tokens_details.<strong>cached_tokens</strong> <code>integer</code>
缓存输入内容的 token 用量，此处应为 0。</li>
</ul>
</li>
<li>usage.<strong>completion_tokens</strong> <code>integer</code>
模型输出内容花费的 token。</li>
<li>usage.<strong>completion_tokens_details</strong> <code>object</code>
模型输出内容花费的 token 的细节。<ul>
<li>usage.completion_tokens_details.<strong>reasoning_tokens</strong> <code>integer</code>
输出思维链内容花费的 token 数。</li>
</ul>
</li>
</ul>
<hr>
<h3 id="%E5%AF%B9%E8%AF%9D(Chat)%20%E6%B5%81%E5%BC%8F%E8%B0%83%E7%94%A8%E8%BF%94%E5%9B%9E" name="%E5%AF%B9%E8%AF%9D(Chat)%20%E6%B5%81%E5%BC%8F%E8%B0%83%E7%94%A8%E8%BF%94%E5%9B%9E">对话(Chat) 流式调用返回</h3>
<hr>
<p><strong>id</strong> <code>string</code>
本次请求的唯一标识</p>
<hr>
<p><strong>model</strong> <code>string</code>
本次请求实际使用的模型名称和版本</p>
<hr>
<p><strong>service_tier</strong> <code>string</code>
本次请求是否使用了TPM保障包（<code>scale</code>：使用；<code>default</code>：未使用）</p>
<hr>
<p><strong>created</strong> <code>integer</code>
本次请求创建时间的 Unix 时间戳（秒）</p>
<hr>
<p><strong>object</strong> <code>string</code>
固定为 <code>chat.completion.chunk</code></p>
<hr>
<p><strong>choices</strong> <code>object[]</code>
本次请求的模型输出内容</p>
<ul>
<li><p>choices.<strong>index</strong> <code>integer</code>
当前元素在 <code>choices</code> 列表的索引。</p>
</li>
<li><p>choices.<strong>finish_reason</strong> <code>string</code>
模型停止生成 token 的原因。取值范围：</p>
<ul>
<li><code>stop</code>：模型输出自然结束，或因命中请求参数 <code>stop</code> 中指定的字段而被截断。</li>
<li><code>length</code>：模型输出因达到模型输出限制而被截断，有以下原因：<ul>
<li>触发<code>max_tokens</code>限制（回答内容的长度限制）。</li>
<li>触发<code>`max_completion_tokens</code>（思维链内容+回答内容的长度限制）。</li>
<li>触发<code>context_window</code>限制（输入内容+思维链内容+回答内容的长度限制）。</li>
</ul>
</li>
<li><code>content_filter</code>：模型输出被内容审核拦截。</li>
<li><code>tool_calls</code>：模型调用了工具。</li>
</ul>
</li>
<li><p>choices.<strong>delta</strong> <code>object</code>
模型生成的增量内容。</p>
<ul>
<li>choices.delta.<strong>role</strong> <code>string</code>
内容输出的角色，此处固定为 <code>assistant</code>。</li>
<li>choices.delta.<strong>content</strong> <code>string</code>
模型生成的消息内容（增量返回）。</li>
<li>choices.delta.<strong>reasoning_content</strong> <code>string / null</code>
模型处理问题的思维链内容（增量返回），仅深度推理模型支持返回此字段。</li>
<li>choices.delta.<strong>tool_calls</strong> <code>object[] / null</code>
模型生成的工具调用（增量返回）。<ul>
<li>choices.delta.tool_calls.<strong>id</strong> <code>string</code>
调用的工具的 ID。</li>
<li>choices.delta.tool_calls.<strong>type</strong> <code>string</code>
工具类型，当前仅支持<code>function</code>。</li>
<li>choices.delta.tool_calls.<strong>function</strong> <code>object</code>
模型调用的函数。<ul>
<li>choices.delta.tool_calls.function.<strong>name</strong> <code>string</code>
模型调用的函数的名称。</li>
<li>choices.delta.tool_calls.function.<strong>arguments</strong> <code>string</code>
模型生成的用于调用函数的参数，JSON 格式。模型并不总是生成有效的 JSON，并且可能会虚构出一些您的函数参数规范中未定义的参数。在调用函数之前，请在您的代码中验证这些参数是否有效。</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
<li><p>choices.<strong>logprobs</strong> <code>object / null</code>
当前内容的对数概率信息。</p>
<ul>
<li>choices.logprobs.<strong>content</strong> <code>object[] / null</code>
message列表中每个 content 元素中的 token 对数概率信息。<ul>
<li>choices.logprobs.content.<strong>token</strong> <code>string</code>
当前 token。</li>
<li>choices.logprobs.content.<strong>bytes</strong> <code>integer[] / null</code>
当前 token 的 UTF-8 值，格式为整数列表。当一个字符由多个 token 组成（表情符号或特殊字符等）时可以用于字符的编码和解码。如果 token 没有 UTF-8 值则为空。</li>
<li>choices.logprobs.content.<strong>logprob</strong> <code>float</code>
当前 token 的对数概率。</li>
<li>choices.logprobs.content.<strong>top_logprobs</strong> <code>object[]</code>
在当前 token 位置最有可能的标记及其对数概率的列表。在一些情况下，返回的数量可能比请求参数 <code>top_logprobs</code> 指定的数量要少。<ul>
<li>choices.logprobs.content.top_logprobs.<strong>token</strong> <code>string</code>
当前 token。</li>
<li>choices.logprobs.content.top_logprobs.<strong>bytes</strong> <code>integer[] / null</code>
当前 token 的 UTF-8 值，格式为整数列表。当一个字符由多个 token 组成（表情符号或特殊字符等）时可以用于字符的编码和解码。如果 token 没有 UTF-8 值则为空。</li>
<li>choices.logprobs.content.top_logprobs.<strong>logprob</strong> <code>float</code>
当前 token 的对数概率。</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
<li><p>choices.<strong>moderation_hit_type</strong> <code>string/ null</code>
模型输出文字含有敏感信息时，会返回模型输出文字命中的风险分类标签。返回值及含义：</p>
<ul>
<li><code>severe_violation</code>：模型输出文字涉及严重违规。</li>
<li><code>violence</code>：模型输出文字涉及激进行为。</li>
</ul>
<blockquote>
<p>注意：当前只有视觉理解模型支持返回该字段，且只有在方舟控制台接入点配置页面或者 CreateEndpoint 接口中，将内容护栏方案（ModerationStrategy）设置为基础方案（Basic）时，才会返回风险分类标签。</p>
</blockquote>
</li>
</ul>
<hr>
<p><strong>usage</strong> <code>object</code>
本次请求的 token 用量</p>
<ul>
<li><p>usage.<strong>total_tokens</strong> <code>integer</code>
本次请求消耗的总 token 数量（输入 + 输出）。</p>
</li>
<li><p>usage.<strong>prompt_tokens</strong> <code>integer</code>
输入给模型处理的内容 token 数量。</p>
</li>
<li>usage.<strong>prompt_tokens_details</strong> <code>object</code>
输入给模型处理的内容 token 数量的细节。<ul>
<li>usage.prompt_tokens_details.<strong>cached_tokens</strong> <code>integer</code>
缓存输入内容的 token 用量，此处应为 0。</li>
</ul>
</li>
<li>usage.<strong>completion_tokens</strong> <code>integer</code>
模型输出内容花费的 token。</li>
<li>usage.<strong>completion_tokens_details</strong> <code>object</code>
模型输出内容花费的 token 的细节。<ul>
<li>usage.completion_tokens_details.<strong>reasoning_tokens</strong> <code>integer</code>
输出思维链内容花费的 token 数。</li>
</ul>
</li>
</ul>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E5%AF%B9%E8%AF%9D(Chat)%20%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B" name="%E5%AF%B9%E8%AF%9D(Chat)%20%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B">对话(Chat) 调用示例</h2>
<p><span id="Hrya4y9k"></span></p>
<h3 id="%E4%BA%91%E8%81%949-%E9%BB%98%E8%AE%A4" name="%E4%BA%91%E8%81%949-%E9%BB%98%E8%AE%A4">云联9-默认</h3>
<p>请求示例：</p>
<pre><code class="lang-Curl">curl https://modelpool-api.talkingdata.com/model/openai/api/v3/chat/completions?requestId=550e8400-e29b-41d4-a716-446655440000 \
  -H &quot;Content-Type: application/json&quot; \
  -H &quot;Authorization: Bearer $ARK_API_KEY&quot; \
  -H &quot;X-Timestamp: $TIMESTAMP&quot; \
  -d &#39;{
    &quot;model&quot;: &quot;T0106004&quot;,
    &quot;messages&quot;: [
        {
            &quot;role&quot;: &quot;system&quot;,
            &quot;content&quot;: &quot;You are a helpful assistant.&quot;
        },
        {
            &quot;role&quot;: &quot;user&quot;,
            &quot;content&quot;: &quot;Hello!&quot;
        }
    ]
  }&#39;
</code></pre>
<p>响应示例：</p>
<pre><code class="lang-json">{
  &quot;choices&quot;: [
    {
      &quot;finish_reason&quot;: &quot;stop&quot;,
      &quot;index&quot;: 0,
      &quot;logprobs&quot;: null,
      &quot;message&quot;: {
        &quot;content&quot;: &quot;Hello! How can I help you today?&quot;,
        &quot;role&quot;: &quot;assistant&quot;
      }
    }
  ],
  &quot;created&quot;: 1742631811,
  &quot;id&quot;: &quot;0217426318107460cfa43dc3f3683b1de1c09624ff49085a456ac&quot;,
  &quot;model&quot;: &quot;T0106004&quot;,
  &quot;service_tier&quot;: &quot;default&quot;,
  &quot;object&quot;: &quot;chat.completion&quot;,
  &quot;usage&quot;: {
    &quot;completion_tokens&quot;: 9,
    &quot;prompt_tokens&quot;: 19,
    &quot;total_tokens&quot;: 28,
    &quot;prompt_tokens_details&quot;: {
      &quot;cached_tokens&quot;: 0
    },
    &quot;completion_tokens_details&quot;: {
      &quot;reasoning_tokens&quot;: 0
    }
  }
}
</code></pre>
<h3 id="%E4%BA%91%E8%81%949-%E6%B5%81%E5%BC%8F%E8%BE%93%E5%87%BA" name="%E4%BA%91%E8%81%949-%E6%B5%81%E5%BC%8F%E8%BE%93%E5%87%BA">云联9-流式输出</h3>
<p>请求示例：</p>
<pre><code class="lang-curl">curl https://modelpool-api.talkingdata.com/model/openai/api/v3/chat/completions?requestId=550e8400-e29b-41d4-a716-446655440000 \
  -H &quot;Content-Type: application/json&quot; \
  -H &quot;Authorization: Bearer $ARK_API_KEY&quot; \
  -H &quot;X-Timestamp: $TIMESTAMP&quot; \
  -d $&#39;{
    &quot;messages&quot;: [
        {
            &quot;content&quot;: &quot;You are a helpful assistant.&quot;,
            &quot;role&quot;: &quot;system&quot;
        },
        {
            &quot;content&quot;: &quot;hello&quot;,
            &quot;role&quot;: &quot;user&quot;
        }
    ],
    &quot;model&quot;: &quot;T0106004&quot;,
    &quot;stream&quot;: true
}&#39;
</code></pre>
<p>响应示例：</p>
<pre><code class="lang-json">{&quot;choices&quot;:[{&quot;delta&quot;:{&quot;content&quot;:&quot;Hello&quot;,&quot;role&quot;:&quot;assistant&quot;},&quot;index&quot;:0}],&quot;created&quot;:1742632436,&quot;id&quot;:&quot;021742632435712396f12d018b5d576a7a55349c2eba0815061fc&quot;,&quot;model&quot;:&quot;T0106004&quot;,&quot;service_tier&quot;:&quot;default&quot;,&quot;object&quot;:&quot;chat.completion.chunk&quot;,&quot;usage&quot;:null}

{&quot;choices&quot;:[{&quot;delta&quot;:{&quot;content&quot;:&quot;!&quot;,&quot;role&quot;:&quot;assistant&quot;},&quot;index&quot;:0}],&quot;created&quot;:1742632436,&quot;id&quot;:&quot;021742632435712396f12d018b5d576a7a55349c2eba0815061fc&quot;,&quot;model&quot;:&quot;T0106004&quot;:&quot;default&quot;,&quot;object&quot;:&quot;chat.completion.chunk&quot;,&quot;usage&quot;:null}

{&quot;choices&quot;:[{&quot;delta&quot;:{&quot;content&quot;:&quot; How&quot;,&quot;role&quot;:&quot;assistant&quot;},&quot;index&quot;:0}],&quot;created&quot;:1742632436,&quot;id&quot;:&quot;021742632435712396f12d018b5d576a7a55349c2eba0815061fc&quot;,&quot;model&quot;:&quot;T0106004&quot;,&quot;service_tier&quot;:&quot;default&quot;,&quot;object&quot;:&quot;chat.completion.chunk&quot;,&quot;usage&quot;:null}

{&quot;choices&quot;:[{&quot;delta&quot;:{&quot;content&quot;:&quot; can&quot;,&quot;role&quot;:&quot;assistant&quot;},&quot;index&quot;:0}],&quot;created&quot;:1742632436,&quot;id&quot;:&quot;021742632435712396f12d018b5d576a7a55349c2eba0815061fc&quot;,&quot;model&quot;:&quot;T0106004&quot;,&quot;service_tier&quot;:&quot;default&quot;,&quot;object&quot;:&quot;chat.completion.chunk&quot;,&quot;usage&quot;:null}

{&quot;choices&quot;:[{&quot;delta&quot;:{&quot;content&quot;:&quot; I&quot;,&quot;role&quot;:&quot;assistant&quot;},&quot;index&quot;:0}],&quot;created&quot;:1742632436,&quot;id&quot;:&quot;021742632435712396f12d018b5d576a7a55349c2eba0815061fc&quot;,&quot;model&quot;:&quot;T0106004&quot;,&quot;service_tier&quot;:&quot;default&quot;,&quot;object&quot;:&quot;chat.completion.chunk&quot;,&quot;usage&quot;:null}

{&quot;choices&quot;:[{&quot;delta&quot;:{&quot;content&quot;:&quot; help&quot;,&quot;role&quot;:&quot;assistant&quot;},&quot;index&quot;:0}],&quot;created&quot;:1742632436,&quot;id&quot;:&quot;021742632435712396f12d018b5d576a7a55349c2eba0815061fc&quot;,&quot;model&quot;:&quot;T0106004&quot;,&quot;service_tier&quot;:&quot;default&quot;,&quot;object&quot;:&quot;chat.completion.chunk&quot;,&quot;usage&quot;:null}

{&quot;choices&quot;:[{&quot;delta&quot;:{&quot;content&quot;:&quot; you&quot;,&quot;role&quot;:&quot;assistant&quot;},&quot;index&quot;:0}],&quot;created&quot;:1742632436,&quot;id&quot;:&quot;021742632435712396f12d018b5d576a7a55349c2eba0815061fc&quot;,&quot;model&quot;:&quot;T0106004&quot;,&quot;service_tier&quot;:&quot;default&quot;,&quot;object&quot;:&quot;chat.completion.chunk&quot;,&quot;usage&quot;:null}

{&quot;choices&quot;:[{&quot;delta&quot;:{&quot;content&quot;:&quot; today&quot;,&quot;role&quot;:&quot;assistant&quot;},&quot;index&quot;:0}],&quot;created&quot;:1742632436,&quot;id&quot;:&quot;021742632435712396f12d018b5d576a7a55349c2eba0815061fc&quot;,&quot;model&quot;:&quot;T0106004&quot;,&quot;service_tier&quot;:&quot;default&quot;,&quot;object&quot;:&quot;chat.completion.chunk&quot;,&quot;usage&quot;:null}

{&quot;choices&quot;:[{&quot;delta&quot;:{&quot;content&quot;:&quot;?&quot;,&quot;role&quot;:&quot;assistant&quot;},&quot;index&quot;:0}],&quot;created&quot;:1742632436,&quot;id&quot;:&quot;021742632435712396f12d018b5d576a7a55349c2eba0815061fc&quot;,&quot;model&quot;:&quot;T0106004&quot;,&quot;service_tier&quot;:&quot;default&quot;,&quot;object&quot;:&quot;chat.completion.chunk&quot;,&quot;usage&quot;:null}

{&quot;choices&quot;:[{&quot;delta&quot;:{&quot;content&quot;:&quot;&quot;,&quot;role&quot;:&quot;assistant&quot;},&quot;finish_reason&quot;:&quot;stop&quot;,&quot;index&quot;:0}],&quot;created&quot;:1742632436,&quot;id&quot;:&quot;021742632435712396f12d018b5d576a7a55349c2eba0815061fc&quot;,&quot;model&quot;:&quot;T0106004&quot;,&quot;service_tier&quot;:&quot;default&quot;,&quot;object&quot;:&quot;chat.completion.chunk&quot;,&quot;usage&quot;:null}

[DONE]
</code></pre>
<h3 id="%E4%BA%91%E8%81%949-%E7%BB%AD%E5%86%99%E6%A8%A1%E5%BC%8F" name="%E4%BA%91%E8%81%949-%E7%BB%AD%E5%86%99%E6%A8%A1%E5%BC%8F">云联9-续写模式</h3>
<p>请求示例：</p>
<pre><code class="lang-Curl">curl https://modelpool-api.talkingdata.com/model/openai/api/v3/chat/completions?requestId=550e8400-e29b-41d4-a716-446655440000 \
  -H &quot;Content-Type: application/json&quot; \
  -H &quot;Authorization: Bearer $ARK_API_KEY&quot; \
  -H &quot;X-Timestamp: $TIMESTAMP&quot; \
  -d $&#39;{
    &quot;messages&quot;: [
        {
            &quot;content&quot;: &quot;你是一个计算器，请计算： 1 + 1&quot;,
            &quot;role&quot;: &quot;user&quot;
        },
        {
            &quot;content&quot;: &quot;=&quot;,
            &quot;role&quot;: &quot;assistant&quot;
        }
    ],
    &quot;model&quot;: &quot;T0106004&quot;
}&#39;
</code></pre>
<p>响应示例：</p>
<pre><code class="lang-json">{
  &quot;choices&quot;: [
    {
      &quot;finish_reason&quot;: &quot;stop&quot;,
      &quot;index&quot;: 0,
      &quot;logprobs&quot;: null,
      &quot;message&quot;: {
        &quot;content&quot;: &quot; 2&quot;,
        &quot;role&quot;: &quot;assistant&quot;
      }
    }
  ],
  &quot;created&quot;: 1742634165,
  &quot;id&quot;: &quot;0217426341647344ee2a242cadeb3c7acc981f0bd805884bc65fc&quot;,
  &quot;model&quot;: &quot;T0106004&quot;,
  &quot;service_tier&quot;: &quot;default&quot;,
  &quot;object&quot;: &quot;chat.completion&quot;,
  &quot;usage&quot;: {
    &quot;completion_tokens&quot;: 2,
    &quot;prompt_tokens&quot;: 21,
    &quot;total_tokens&quot;: 23,
    &quot;prompt_tokens_details&quot;: {
      &quot;cached_tokens&quot;: 0
    },
    &quot;completion_tokens_details&quot;: {
      &quot;reasoning_tokens&quot;: 0
    }
  }
}
</code></pre>
<hr>
<h3 id="%E4%BA%91%E8%81%949-%E5%9B%BE%E7%89%87%E7%90%86%E8%A7%A3" name="%E4%BA%91%E8%81%949-%E5%9B%BE%E7%89%87%E7%90%86%E8%A7%A3">云联9-图片理解</h3>
<p>请求示例：</p>
<pre><code class="lang-Curl">curl https://modelpool-api.talkingdata.com/model/openai/api/v3/chat/completions?requestId=550e8400-e29b-41d4-a716-446655440000 \
  -H &quot;Content-Type: application/json&quot; \
  -H &quot;Authorization: Bearer $ARK_API_KEY&quot; \
  -H &quot;X-Timestamp: $TIMESTAMP&quot; \
  -d $&#39;{
    &quot;model&quot;: &quot;T0106004&quot;,
    &quot;messages&quot;: [
        {
            &quot;content&quot;: [
                {
                    &quot;image_url&quot;: {
                        &quot;url&quot;: &quot;https://ark-project.tos-cn-beijing.volces.com/images/view.jpeg&quot;
                    },
                    &quot;type&quot;: &quot;image_url&quot;
                },
                {
                    &quot;text&quot;: &quot;图片主要讲了什么?&quot;,
                    &quot;type&quot;: &quot;text&quot;
                }
            ],
            &quot;role&quot;: &quot;user&quot;
        }
    ]
}&#39;
</code></pre>
<p>响应示例：</p>
<pre><code class="lang-json">{
  &quot;choices&quot;: [
    {
      &quot;finish_reason&quot;: &quot;stop&quot;,
      &quot;index&quot;: 0,
      &quot;logprobs&quot;: null,
      &quot;message&quot;: {
        &quot;content&quot;: &quot;画面中呈现了一幅宁静的户外景象。一个人乘坐在橙黄色的皮划艇上，手持船桨，正在平静的水面划行。水面如镜，倒映着周围景致。远处是茂密的森林，森林后方矗立着巍峨的雪山，山体覆盖着白雪。天空呈浅蓝色，飘浮着一些云朵。整体氛围静谧而美好，展现出自然的纯净与壮阔。 &quot;,
        &quot;role&quot;: &quot;assistant&quot;
      }
    }
  ],
  &quot;created&quot;: 1742636149,
  &quot;id&quot;: &quot;0217426361458116592a076493be583bc5e33f80ac2dcf1efc31b&quot;,
  &quot;model&quot;: &quot;T0106004&quot;,
  &quot;service_tier&quot;: &quot;default&quot;,
  &quot;object&quot;: &quot;chat.completion&quot;,
  &quot;usage&quot;: {
    &quot;completion_tokens&quot;: 85,
    &quot;prompt_tokens&quot;: 521,
    &quot;total_tokens&quot;: 606,
    &quot;prompt_tokens_details&quot;: {
      &quot;cached_tokens&quot;: 0
    },
    &quot;completion_tokens_details&quot;: {
      &quot;reasoning_tokens&quot;: 0
    }
  }
}
</code></pre>
<h3 id="%E4%BA%91%E8%81%949-%E8%A7%86%E9%A2%91%E7%90%86%E8%A7%A3" name="%E4%BA%91%E8%81%949-%E8%A7%86%E9%A2%91%E7%90%86%E8%A7%A3">云联9-视频理解</h3>
<p>请求示例：</p>
<pre><code class="lang-curl">curl https://modelpool-api.talkingdata.com/model/openai/api/v3/chat/completions?requestId=550e8400-e29b-41d4-a716-446655440000 \
   -H &quot;Content-Type: application/json&quot; \
   -H &quot;Authorization: Bearer $ARK_API_KEY&quot; \
   -H &quot;X-Timestamp: $TIMESTAMP&quot; \
   -d &#39;{
    &quot;model&quot;: &quot;T0106004&quot;,
    &quot;messages&quot;: [
        {
            &quot;role&quot;: &quot;user&quot;,
            &quot;content&quot;: [                
                {&quot;type&quot;: &quot;video_url&quot;,&quot;video_url&quot;: {&quot;url&quot;:  &quot;https://ark-project.tos-cn-beijing.volces.com/doc_video/ark_vlm_video_input.mp4&quot;},&quot;fps&quot;: &quot;2&quot;},
                {&quot;type&quot;: &quot;text&quot;, &quot;text&quot;: &quot;What is in the video?&quot;}
            ]
        }
    ],
    &quot;max_tokens&quot;: 300
  }&#39;
</code></pre>
<p>响应示例：</p>
<pre><code class="lang-json">{
    &quot;choices&quot;: [
        {
            &quot;finish_reason&quot;: &quot;stop&quot;,
            &quot;index&quot;: 0,
            &quot;logprobs&quot;: null,
            &quot;message&quot;: {
                &quot;content&quot;: &quot;The video showcases a cityscape featuring a prominent clock tower (resembling Big Ben) on the left side. A bridge spans across the scene, with a steady flow of vehicles—including cars and a red bus—moving along it. The background includes a mix of historic and modern buildings under a cloudy sky with warm, golden-hour lighting. The text \&quot;AI生成\&quot; (AI-generated) is visible in the bottom-right corner throughout the video.&quot;,
                &quot;reasoning_content&quot;: &quot;\nGot it, let&#39;s see. The video shows a city scene with a famous clock tower (Big Ben-like) and a bridge with traffic. The clock is on the left, and there are cars and a red bus moving on the bridge. The sky is cloudy with a sunset or sunrise hue. Also, there are buildings in the background, and the word \&quot;AI生成\&quot; is in the bottom right corner. So I need to describe what&#39;s visible: the clock tower, the bridge with vehicles (including a red bus), the cityscape, the sky, and the AI-generated text.&quot;,
                &quot;role&quot;: &quot;assistant&quot;
            }
        }
    ],
    &quot;created&quot;: 1769687250,
    &quot;id&quot;: &quot;02176968724393181abbd6c16bee1cf75e33ac11302acbd610474&quot;,
    &quot;model&quot;: &quot;T0106004&quot;,
    &quot;service_tier&quot;: &quot;default&quot;,
    &quot;object&quot;: &quot;chat.completion&quot;,
    &quot;usage&quot;: {
        &quot;completion_tokens&quot;: 210,
        &quot;prompt_tokens&quot;: 10391,
        &quot;total_tokens&quot;: 10601,
        &quot;prompt_tokens_details&quot;: {
            &quot;cached_tokens&quot;: 0
        },
        &quot;completion_tokens_details&quot;: {
            &quot;reasoning_tokens&quot;: 121
        }
    }
}
</code></pre>
<h3 id="%E4%BA%91%E8%81%949-%E6%B7%B1%E5%BA%A6%E6%8E%A8%E7%90%86" name="%E4%BA%91%E8%81%949-%E6%B7%B1%E5%BA%A6%E6%8E%A8%E7%90%86">云联9-深度推理</h3>
<p>请求示例：</p>
<pre><code class="lang-Curl">curl https://modelpool-api.talkingdata.com/model/openai/api/v3/chat/completions?requestId=550e8400-e29b-41d4-a716-446655440000 \
  -H &quot;Content-Type: application/json&quot; \
  -H &quot;Authorization: Bearer $ARK_API_KEY&quot; \
  -H &quot;X-Timestamp: $TIMESTAMP&quot; \
  -d $&#39;{
    &quot;messages&quot;: [

        {
            &quot;content&quot;: &quot;我要有研究推理模型与非推理模型区别的课题，怎么体现我的专业性&quot;,
            &quot;role&quot;: &quot;user&quot;
        }
    ],
    &quot;model&quot;: &quot;T0106004&quot;
}&#39;
</code></pre>
<p>响应示例：</p>
<pre><code class="lang-json">{
  &quot;choices&quot;: [
    {
      &quot;finish_reason&quot;: &quot;stop&quot;,
      &quot;index&quot;: 0,
      &quot;logprobs&quot;: null,
      &quot;message&quot;: {
        &quot;content&quot;: &quot;\n\n推理模型与非推理模型的主要区别在于其处理任务的方式、能力侧重点以及应用场景。以下是两者的核心区别分析：\n\n---\n\n### **1. 核心定义**\n- **推理模型**  \n  具备**逻辑推理、因果推断或复杂决策**能力，***  \n\n实际应用中，两类模型常配合使用（如用非推理模型提取特征，再交给推理模型决策），以平衡效率与准确性。&quot;,
        &quot;reasoning_content&quot;: &quot;嗯，用户问的是推理模型和非推理模型有什么区别。我需要先理解这两个术语的具体含义。可能用户对机器学习或深度学习有一定的了解，但需要更清晰的区分。首先，我应该明确这两个概念的定义，然后从不同角度进行比较。\n\n首先，推理模型可能指的是那些需要进行逻辑推理、处理复杂任务的模型，***，而非推理模型侧重于模式识别和直接映射，帮助用户形成清晰的概念框架。\n&quot;,
        &quot;role&quot;: &quot;assistant&quot;
      }
    }
  ],
  &quot;created&quot;: 1742636537,
  &quot;id&quot;: &quot;0217426364949596592a076493be583bc5e33f80ac2dcf1eeaf9b&quot;,
  &quot;model&quot;: &quot;T0106004&quot;,
  &quot;service_tier&quot;: &quot;default&quot;,
  &quot;object&quot;: &quot;chat.completion&quot;,
  &quot;usage&quot;: {
    &quot;completion_tokens&quot;: 1207,
    &quot;prompt_tokens&quot;: 11,
    &quot;total_tokens&quot;: 1218,
    &quot;prompt_tokens_details&quot;: {
      &quot;cached_tokens&quot;: 0
    },
    &quot;completion_tokens_details&quot;: {
      &quot;reasoning_tokens&quot;: 419
    }
  }
}
</code></pre>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E9%94%99%E8%AF%AF%E7%A0%81" name="%E9%94%99%E8%AF%AF%E7%A0%81">错误码</h2>
<p><span id="Hrya4y9k"></span></p>
<table>
<thead>
<tr>
<th>HTTP 状态码</th>
<th>错误类型 Type</th>
<th>错误码 Code</th>
<th>错误信息 Message</th>
<th>含义</th>
</tr>
</thead>
<tbody>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>MissingParameter</td>
<td>The request failed because it is missing one or multiple required parameters. Request ID: {id}</td>
<td>请求缺少必要参数，请查阅 API 文档。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>InvalidParameter</td>
<td>One or more parameters specified in the request are not valid. Request ID: {id}</td>
<td>请求包含非法参数，请查阅 API 文档。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>InputTextRiskDetection</td>
<td>The request could not be processed because the input text includes sensitive content that violates ContentSecurityDetection.ARKRequest ID:{id};CSDRequestId:{RequestId};Label:{Label};SubLabel:{SubLable}</td>
<td>风险识别产品检测到输入文本可能包含敏感信息，请您更换后重试。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>InputImageRiskDetection</td>
<td>The request could not be processed because the input image includes sensitive content that violates ContentSecurityDetection.ARKRequest ID:{id};CSDRequestId:{RequestId};Label:{Label};SubLabel:{SubLable}</td>
<td>风险识别产品检测到输入图片可能包含敏感信息，请您更换后重试。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>InvalidImageURL.EmptyURL</td>
<td>Empty base64 image url</td>
<td>传入的图片 URL 为空。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>InvalidImageURL.InvalidFormat</td>
<td>Invalid base64 image url</td>
<td>无法解析或处理图片，可能是 Base64 格式不正确、图片数据损坏或格式不支持。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>OutofContextError</td>
<td>Total tokens of image and text exceed max message tokens.</td>
<td>当请求中包含图片时，文本和图片编码后的总 token 数超过了模型上下文长度限制。</td>
</tr>
<tr>
<td>401</td>
<td>Unauthorized</td>
<td>AuthenticationError</td>
<td>The API key or AK/SK in the request is missing or invalid. Request ID: {id}</td>
<td>请求携带的 API Key 或 AK/SK 校验未通过，请您重新检查设置的鉴权凭证，或者查看 API 调用文档来排查问题。</td>
</tr>
<tr>
<td>403</td>
<td>Forbidden</td>
<td>OperationDenied.ServiceNotOpen</td>
<td>Operation is denied because the model service is unavailable, please go to the Volcano Ark console activation management page to activate the corresponding model service, or submit a work order to contact us.</td>
<td>模型服务不可用，不支持该操作。</td>
</tr>
<tr>
<td>404</td>
<td>NotFound</td>
<td>InvalidEndpointOrModel.NotFound</td>
<td>The model or endpoint %s does not exist or you do not have access to it.</td>
<td>模型或者推理接入点 %s 不存在或者您无权访问它。</td>
</tr>
<tr>
<td>429</td>
<td>TooManyRequests</td>
<td>RateLimitExceeded.EndpointRPMExceeded</td>
<td>The Requests Per Minute (RPM) limit of the associated endpoint for your account has been exceeded. Request ID: {id}</td>
<td>请求所关联的推理接入点已超过 RPM (Requests Per Minute) 限制，请稍后重试。</td>
</tr>
<tr>
<td>429</td>
<td>TooManyRequests</td>
<td>RateLimitExceeded.EndpointTPMExceeded</td>
<td>The Tokens Per Minute (TPM) limit of the associated endpoint for your account has been exceeded. Request ID: {id}</td>
<td>请求所关联的推理接入点已超过 TPM (Tokens Per Minute) 限制，请稍后重试。</td>
</tr>
<tr>
<td>500</td>
<td>InternalServerError</td>
<td>InternalServiceError</td>
<td>The service encountered an unexpected internal error. Please retry later. Request ID: {id}</td>
<td>内部系统异常，请您稍后重试。</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E5%85%AC%E5%85%B1%E9%94%99%E8%AF%AF%E7%A0%81" name="%E5%85%AC%E5%85%B1%E9%94%99%E8%AF%AF%E7%A0%81">公共错误码</h2>
<p><span id="Hrya4y9k"></span></p>
<table>
<thead>
<tr>
<th>Code</th>
<th>CodeN</th>
<th>Message</th>
<th>错误说明及解决方式</th>
<th>Status</th>
</tr>
</thead>
<tbody>
<tr>
<td>MissingParameter</td>
<td>100002</td>
<td>The request is missing %s parameter.</td>
<td>关键参数缺失，例如Action, Version参数缺失。请参考API文档补充Action或Version参数。</td>
<td>400</td>
</tr>
<tr>
<td>InvalidTimestamp</td>
<td>100006</td>
<td>The Signature of the request is expired.</td>
<td>请求过期或请求的签名时间来自未来。请检查本地时间是否正常，以及是否使用了UTC时间，精确到秒，使用遵循ISO 8601标准的格式：<code>YYYYMMDD&#39;T&#39;HHMMSS&#39;Z&#39;</code>。</td>
<td>400</td>
</tr>
<tr>
<td>ServiceNotFound</td>
<td>100007</td>
<td>This service[%s] not found.</td>
<td>请求的服务不存在。请参考产品的API文档检查Service是否完全填写正确。</td>
<td>404</td>
</tr>
<tr>
<td>InvalidActionOrVersion</td>
<td>100008</td>
<td>Could not find operation %s for version %s.</td>
<td>请求接口不存在。请参考产品的API文档检查Action是否完全填写正确。</td>
<td>404</td>
</tr>
<tr>
<td>InvalidAccessKey</td>
<td>100009</td>
<td>The accesskey [%s] included in the request is invalid.</td>
<td>请求的Access Key不合法。请检查Access key Id和Secret Access Key是否正确，注意不要有多余的空格符号。</td>
<td>401</td>
</tr>
<tr>
<td>SignatureDoesNotMatch</td>
<td>100010</td>
<td>The request signature we calculated does not match the signature you provided. Check your Secret Access Key and signing method. Consult the service documentation for details.</td>
<td>签名结果不正确。检查签名步骤，建议使用SDK，避免自行编码构造签名。</td>
<td>401</td>
</tr>
<tr>
<td>AccessDenied</td>
<td>100013</td>
<td>User is not authorized to perform: %s on resource: %s.</td>
<td>子用户拥有的权限不支持当前操作。</td>
<td>403</td>
</tr>
<tr>
<td>InternalError</td>
<td>100014</td>
<td>Service has some internal Error. Pls Contact With Admin.</td>
<td>内部错误。</td>
<td>500</td>
</tr>
<tr>
<td>FlowLimitExceeded</td>
<td>100018</td>
<td>Request was rejected because the request speed of this openAPI is beyond the current flow control limit.</td>
<td>请求过于频繁，超出了限速。请降低请求QPS。</td>
<td>429</td>
</tr>
</tbody>
</table>
]]></content:encoded>
      <pubDate>Fri, 17 Apr 2026 11:18:12 +0800</pubDate>
      <guid>http://doc.talkingdata.com/posts/1232</guid>
      <comments>http://doc.talkingdata.com/posts/1232#comments</comments>
    </item>
    <item>
      <title>TD云筑42/Doubao-Seedance-2.0-fast</title>
      <link>http://doc.talkingdata.com/posts/1231</link>
      <category>视频生成 API</category>
      <author>liuxinmei</author>
      <description>云筑42 接口说明文档 TD模型编号：T0101007 模型能力简介 云筑42 多模态参考生视频：根据您输入的参考图片（0~9张）+ 参考视频（0~3个）+ 参考音频（0~3个）+ 文本提示词（可选）生成目标视频。注意不可单独输入音频，应至少包含 1 个参考视频或图片。 图生视频-首尾帧：根据您输入的首帧图片 + 尾帧图片 + 文本提示词（可选）+ 参数（可选）生成目标视频。 图生视频-首帧：根据您输入的首帧图片 + 文本提示词（可选）+ 参数（可选）生成目标视频。 文生视频：根据您输入的文本提示词 + 参数（可选）生成目标视频。 注意：本模型不支持直接上传含有真人人脸的参考图/视频。 鉴权说明 本接口仅支持API Key鉴权，需联系TD运营同学获取长效API Key。
 创建视频生成任务接</description>
      <content:encoded><![CDATA[<p><strong>云筑42 接口说明文档</strong></p>
<p><strong>TD模型编号：T0101007</strong></p>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%A8%A1%E5%9E%8B%E8%83%BD%E5%8A%9B%E7%AE%80%E4%BB%8B" name="%E6%A8%A1%E5%9E%8B%E8%83%BD%E5%8A%9B%E7%AE%80%E4%BB%8B">模型能力简介</h2>
<p><span id="Hrya4y9k"></span></p>
<ul>
<li><strong>云筑42 </strong><ul>
<li><strong>多模态参考生视频</strong>：根据您输入的参考图片（0~9张）+ 参考视频（0~3个）+ 参考音频（0~3个）+ 文本提示词（可选）生成目标视频。注意不可单独输入音频，应至少包含 1 个参考视频或图片。</li>
<li><strong>图生视频-首尾帧</strong>：根据您输入的首帧图片 + 尾帧图片 + 文本提示词（可选）+ 参数（可选）生成目标视频。</li>
<li><strong>图生视频-首帧</strong>：根据您输入的首帧图片 + 文本提示词（可选）+ 参数（可选）生成目标视频。</li>
<li><strong>文生视频</strong>：根据您输入的文本提示词 + 参数（可选）生成目标视频。</li>
</ul>
</li>
</ul>
<blockquote>
<p><strong>注意</strong>：本模型<strong>不支持</strong>直接上传含有真人人脸的参考图/视频。</p>
</blockquote>
<h5 id="%3Cstrong%3E%E9%89%B4%E6%9D%83%E8%AF%B4%E6%98%8E%3C%2Fstrong%3E" name="%3Cstrong%3E%E9%89%B4%E6%9D%83%E8%AF%B4%E6%98%8E%3C%2Fstrong%3E"><strong>鉴权说明</strong></h5>
<pre><code>本接口仅支持API Key鉴权，需联系TD运营同学获取长效API Key。
</code></pre><hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E5%88%9B%E5%BB%BA%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90%E4%BB%BB%E5%8A%A1%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80" name="%E5%88%9B%E5%BB%BA%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90%E4%BB%BB%E5%8A%A1%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80">创建视频生成任务接口地址</h2>
<p><span id="Hrya4y9k"></span></p>
<p>介绍创建视频生成任务 API 的输入输出参数，供您使用接口时查阅字段含义。模型会依据传入的图片、视频、音频及文本信息生成视频，待生成完成后，您可以按条件查询任务并获取生成的视频。</p>
<p><strong>请求方法：</strong> POST</p>
<p><strong>接口URL：</strong> <code>https://modelpool-api.talkingdata.com/model/openai/api/v3/contents/generations/tasks</code></p>
<p><strong>请求头（Request Headers）：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">头部字段</th>
<th style="text-align:left">值</th>
<th style="text-align:left">是否必需</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>Authorization</code></td>
<td style="text-align:left"><code>Bearer &lt;your_api_key&gt;</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">API 鉴权凭证，请替换为有效的 API Key</td>
</tr>
<tr>
<td style="text-align:left"><code>X-Timestamp</code></td>
<td style="text-align:left"><code>1700000000</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">Unix 时间戳格式</td>
</tr>
<tr>
<td style="text-align:left"><code>Content-Type</code></td>
<td style="text-align:left"><code>application/json</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">请求体格式必须为 JSON</td>
</tr>
</tbody>
</table>
<p><strong>请求参数（Request Parameter）：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">字段</th>
<th style="text-align:left">值</th>
<th style="text-align:left">是否必需</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>requestId</code></td>
<td style="text-align:left"><code>550e8400-e29b-41d4-a716-446655440000</code></td>
<td style="text-align:left">否</td>
<td style="text-align:left">请求唯一标识符。使用 UUID 格式字符串，用于跟踪和排查请求相关问题。</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E5%88%9B%E5%BB%BA%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90%E4%BB%BB%E5%8A%A1%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0" name="%E5%88%9B%E5%BB%BA%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90%E4%BB%BB%E5%8A%A1%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0">创建视频生成任务请求参数</h2>
<p><span id="Hrya4y9k"></span></p>
<h3 id="%E5%88%9B%E5%BB%BA%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90%E4%BB%BB%E5%8A%A1%E8%AF%B7%E6%B1%82%E4%BD%93%EF%BC%88requestBody%EF%BC%89" name="%E5%88%9B%E5%BB%BA%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90%E4%BB%BB%E5%8A%A1%E8%AF%B7%E6%B1%82%E4%BD%93%EF%BC%88requestBody%EF%BC%89">创建视频生成任务请求体（requestBody）</h3>
<hr>
<p><strong>model</strong> <code>string</code> <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span></p>
<p>本次请求使用模型的 Model ID 为 <strong>T0101007</strong>。</p>
<hr>
<p><strong>content</strong> <code>object[]</code> <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span></p>
<p>输入给模型，生成视频的信息，支持文本、图片、音频、视频。支持以下几种组合：</p>
<ul>
<li>文本</li>
<li>文本（可选）+ 图片</li>
<li>文本（可选）+ 视频</li>
<li>文本（可选）+ 图片 + 音频</li>
<li>文本（可选）+ 图片 + 视频</li>
<li>文本（可选）+ 视频 + 音频</li>
<li>文本（可选）+ 图片 + 视频 + 音频</li>
</ul>
<p><strong>信息类型：</strong></p>
<ul>
<li><p><strong>文本信息</strong> <code>object</code></p>
<p>输入给模型生成视频的内容，文本内容部分。</p>
<ul>
<li>content.<strong>type</strong> <code>string</code> <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span>
输入内容的类型，此处应为 <code>text</code>。</li>
<li>content.<strong>text</strong> <code>string</code> <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span>
输入给模型的文本提示词，描述期望生成的视频。支持中英文。建议中文不超过500字，英文不超过1000词。</li>
</ul>
</li>
<li><p><strong>图片信息</strong> <code>object</code></p>
<p>输入给模型生成视频的内容，图片信息部分。</p>
<ul>
<li><p>content.<strong>type</strong> <code>string</code> <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span>
输入内容的类型，此处应为 <code>image_url</code>。</p>
</li>
<li><p>content.<strong>image_url</strong> <code>object</code> <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span>
输入给模型的图片对象。</p>
<ul>
<li><p>content.image_url.<strong>url</strong> <code>string</code> <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span>
图片信息，可以是图片URL、图片Base64编码或素材ID。</p>
<ul>
<li>图片URL：请确保图片URL可被访问。</li>
<li>Base64编码：请遵循格式 <code>data:image/&lt;图片格式&gt;;base64,&lt;Base64编码&gt;</code>，注意 <code>&lt;图片格式&gt;</code> 需小写。</li>
<li>素材ID：遵循格式 <code>asset://&lt;ASSET_ID&gt;</code>。</li>
</ul>
<blockquote>
<p><strong>传入图片要求</strong></p>
<ul>
<li><strong>格式</strong>：jpeg、png、webp、bmp、tiff、gif</li>
<li><strong>宽高比</strong>：(0.4, 2.5)</li>
<li><strong>宽高长度（px）</strong>：(300, 6000)</li>
<li><strong>大小</strong>：单张图片小于 30 MB，请求体不超过 64 MB</li>
<li><strong>数量</strong>：1~9张</li>
</ul>
</blockquote>
</li>
</ul>
</li>
<li><p>content.<strong>role</strong> <code>string</code> <code>条件必填</code>
图片的位置或用途。</p>
<blockquote>
<p><strong>注意</strong>：图生视频-首帧、图生视频-首尾帧、多模态参考生视频为 3 种互斥的场景，不支持混用。</p>
</blockquote>
<ul>
<li><p><strong>图生视频-首帧</strong>
<code>role</code> 为 <code>first_frame</code> 或不填。</p>
</li>
<li><p><strong>图生视频-首尾帧</strong></p>
<ul>
<li>需要传入2个<code>image_url</code>对象，且<code>role</code>必填。</li>
<li>首帧图片 <code>role</code>：<code>first_frame</code></li>
<li>尾帧图片 <code>role</code>：<code>last_frame</code></li>
</ul>
<blockquote>
<p>首尾帧图片宽高比不一致时，以首帧图片为主，尾帧图片会自动裁剪适配。</p>
</blockquote>
</li>
<li><p><strong>多模态参考生视频（参考图）</strong></p>
<ul>
<li>每张参考图的 <code>role</code> 均为：<code>reference_image</code></li>
</ul>
<blockquote>
<p>提示词中推荐使用“[图1]xxx，[图2]xxx”的方式来指定图片，以获得更好的指令遵循效果。</p>
</blockquote>
</li>
</ul>
</li>
</ul>
</li>
<li><p><strong>视频信息</strong> <code>object</code></p>
<p>输入给模型的视频信息。</p>
<ul>
<li><p>content.<strong>type</strong> <code>string</code> <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span>
输入内容的类型，此处应为 <code>video_url</code>。</p>
</li>
<li><p>content.<strong>video_url</strong> <code>object</code> <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span>
输入给模型的视频对象。</p>
<ul>
<li><p>content.video_url.<strong>url</strong> <code>string</code> <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span>
视频URL或素材ID。</p>
<blockquote>
<p><strong>传入视频要求</strong></p>
<ul>
<li><strong>格式</strong>：mp4、mov</li>
<li><strong>分辨率</strong>：480p、720p</li>
<li><strong>时长</strong>：单个视频 [2, 15] 秒，最多3个，总时长不超过15秒</li>
<li><strong>宽高比</strong>：[0.4, 2.5]</li>
<li><strong>宽高长度（px）</strong>：[300, 6000]</li>
<li><strong>总像素数</strong>：[409600, 927408]</li>
<li><strong>大小</strong>：单个视频不超过 50 MB</li>
<li><strong>帧率 (FPS)</strong>：[24, 60]</li>
</ul>
</blockquote>
</li>
</ul>
</li>
<li><p>content.<strong>role</strong> <code>string</code> <code>条件必填</code>
视频的位置或用途。当前仅支持 <code>reference_video</code>：参考视频。</p>
</li>
</ul>
</li>
<li><p><strong>音频信息</strong> <code>object</code></p>
<p>输入给模型的音频信息。注意不可单独输入音频，应至少包含 1 个参考视频或图片。</p>
<ul>
<li><p>content.<strong>type</strong> <code>string</code> <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span>
输入内容的类型，此处应为 <code>audio_url</code>。</p>
</li>
<li><p>content.<strong>audio_url</strong> <code>object</code> <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span>
输入给模型的音频对象。</p>
<ul>
<li><p>content.audio_url.<strong>url</strong> <code>string</code> <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span>
音频URL、音频Base64编码或素材ID。</p>
<blockquote>
<p><strong>传入音频要求</strong></p>
<ul>
<li><strong>格式</strong>：wav、mp3</li>
<li><strong>时长</strong>：单个音频 [2, 15] 秒，最多3个，总时长不超过15秒</li>
<li><strong>大小</strong>：单个音频不超过 15 MB，请求体不超过 64 MB</li>
</ul>
</blockquote>
</li>
</ul>
</li>
<li><p>content.<strong>role</strong> <code>string</code> <code>条件必填</code>
音频的位置或用途。当前仅支持 <code>reference_audio</code>：参考音频。</p>
</li>
</ul>
</li>
</ul>
<hr>
<p><strong>callback_url</strong> <code>string</code></p>
<p>填写本次生成任务结果的回调通知地址。当视频生成任务有状态变化时，将向此地址推送 POST 请求。回调请求内容结构与查询视频生成任务接口的返回体一致。</p>
<p>回调返回的 status 包括以下状态：</p>
<ul>
<li><code>queued</code>：排队中。</li>
<li><code>running</code>：任务运行中。</li>
<li><code>succeeded</code>：任务成功。（如发送失败，5秒内未收到成功信息，回调三次）</li>
<li><code>failed</code>：任务失败。（如发送失败，5秒内未收到成功信息，回调三次）</li>
<li><code>expired</code>：任务超时。</li>
</ul>
<hr>
<p><strong>return_last_frame</strong> <code>boolean</code> <code>默认值 false</code></p>
<ul>
<li><code>true</code>：返回生成视频的尾帧图像。可通过查询接口获取尾帧图像（png格式，无水印）。可用于生成多个连续视频。</li>
<li><code>false</code>：不返回生成视频的尾帧图像。</li>
</ul>
<hr>
<p><strong>service_tier</strong> <code>string</code> <code>默认值 default</code></p>
<blockquote>
<p>不支持修改已提交任务的服务等级</p>
</blockquote>
<p>指定处理本次请求的服务等级类型，枚举值：</p>
<ul>
<li><code>default</code>：在线推理模式，适合对推理时效性要求较高的场景。</li>
<li><code>flex</code>：离线推理模式（本模型不支持）。</li>
</ul>
<hr>
<p><strong>execution_expires_after</strong> <code>integer</code> <code>默认值 172800</code></p>
<p>任务超时阈值。指定任务提交后的过期时间（单位：秒），从 <strong>created_at</strong> 时间戳开始计算。默认值 172800 秒（48小时）。取值范围：[3600，259200]。</p>
<hr>
<p><strong>generate_audio</strong> <code>boolean</code> <code>默认值 true</code></p>
<p>控制生成的视频是否包含与画面同步的声音。</p>
<ul>
<li><code>true</code>：模型输出的视频包含同步音频。建议将对话部分置于双引号内以优化效果，例如：“你好，世界。”</li>
<li><code>false</code>：模型输出的视频为无声视频。</li>
</ul>
<blockquote>
<p><strong>注意</strong>：生成的有声视频均为单声道。</p>
</blockquote>
<hr>
<p><strong>tools</strong> <code>object[]</code></p>
<p>配置模型要调用的工具。</p>
<ul>
<li>tools.<strong>type</strong> <code>string</code>
指定使用的工具类型。<ul>
<li><code>web_search</code>：联网搜索工具。模型会根据提示词自主判断是否搜索互联网内容以提升视频时效性。</li>
</ul>
</li>
</ul>
<hr>
<p><strong>safety_identifier</strong> <code>string</code></p>
<p>终端用户的唯一标识符，用于协助平台检测违规行为。推荐传入对用户名、用户ID等进行哈希后的字符串，长度不超过64个字符。</p>
<hr>
<p><strong>resolution</strong> <code>string</code> <code>默认值 720p</code></p>
<p>视频分辨率，枚举值：</p>
<ul>
<li><code>480p</code></li>
<li><code>720p</code></li>
</ul>
<hr>
<p><strong>ratio</strong> <code>string</code> <code>默认值 adaptive</code></p>
<p>生成视频的宽高比例。不同宽高比对应的宽高像素值见下方表格。</p>
<ul>
<li><code>16:9</code></li>
<li><code>4:3</code></li>
<li><code>1:1</code></li>
<li><code>3:4</code></li>
<li><code>9:16</code></li>
<li><code>21:9</code></li>
<li><code>adaptive</code>：根据输入自动选择最合适的宽高比。</li>
</ul>
<blockquote>
<p><strong><code>adaptive</code> 适配规则</strong></p>
<ul>
<li><strong>文生视频</strong>：根据提示词智能选择。</li>
<li><strong>首帧/首尾帧生视频</strong>：根据首帧图片比例选择。</li>
<li><strong>多模态参考生视频</strong>：根据提示词意图判断，否则以第一个媒体文件为准（优先级：视频 &gt; 图片）。</li>
</ul>
</blockquote>
<p><strong>不同宽高比对应的宽高像素值</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">分辨率</th>
<th style="text-align:left">宽高比</th>
<th style="text-align:left">宽高像素值</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left">480p</td>
<td style="text-align:left">16:9</td>
<td style="text-align:left">864×496</td>
</tr>
<tr>
<td style="text-align:left"></td>
<td style="text-align:left">4:3</td>
<td style="text-align:left">752×560</td>
</tr>
<tr>
<td style="text-align:left"></td>
<td style="text-align:left">1:1</td>
<td style="text-align:left">640×640</td>
</tr>
<tr>
<td style="text-align:left"></td>
<td style="text-align:left">3:4</td>
<td style="text-align:left">560×752</td>
</tr>
<tr>
<td style="text-align:left"></td>
<td style="text-align:left">9:16</td>
<td style="text-align:left">496×864</td>
</tr>
<tr>
<td style="text-align:left"></td>
<td style="text-align:left">21:9</td>
<td style="text-align:left">992×432</td>
</tr>
<tr>
<td style="text-align:left">720p</td>
<td style="text-align:left">16:9</td>
<td style="text-align:left">1280×720</td>
</tr>
<tr>
<td style="text-align:left"></td>
<td style="text-align:left">4:3</td>
<td style="text-align:left">1112×834</td>
</tr>
<tr>
<td style="text-align:left"></td>
<td style="text-align:left">1:1</td>
<td style="text-align:left">960×960</td>
</tr>
<tr>
<td style="text-align:left"></td>
<td style="text-align:left">3:4</td>
<td style="text-align:left">834×1112</td>
</tr>
<tr>
<td style="text-align:left"></td>
<td style="text-align:left">9:16</td>
<td style="text-align:left">720×1280</td>
</tr>
<tr>
<td style="text-align:left"></td>
<td style="text-align:left">21:9</td>
<td style="text-align:left">1470×630</td>
</tr>
</tbody>
</table>
<hr>
<p><strong>duration</strong> <code>integer</code> <code>默认值 5</code></p>
<p>生成视频时长，单位：秒。支持两种配置方法：</p>
<ul>
<li><strong>指定具体时长</strong>：支持 [4, 15] 范围内的任一整数。</li>
<li><strong>智能指定</strong>：设置为 <code>-1</code>，表示由模型在 [4, 15] 范围内自主选择合适的视频长度。</li>
</ul>
<hr>
<p><strong>seed</strong> <code>integer</code> <code>默认值 -1</code></p>
<p>种子整数，用于控制生成内容的随机性。取值范围：[-1, 2^32-1]。</p>
<blockquote>
<p><strong>注意</strong>：相同请求下，相同<code>seed</code>值会生成类似但不保证完全一致的结果；不同或<code>-1</code>（随机）则结果不同。</p>
</blockquote>
<hr>
<p><strong>watermark</strong> <code>boolean</code> <code>默认值 false</code></p>
<p>生成视频是否包含水印。</p>
<ul>
<li><code>false</code>：不含水印。</li>
<li><code>true</code>：含有水印。</li>
</ul>
<blockquote>
<p><strong>参数传入方式说明</strong>
本模型<strong>仅支持新方式</strong>：在 <code>request body</code> 中直接传入参数（如 <code>&quot;resolution&quot;: &quot;720p&quot;</code>）。此为强校验，参数错误会返回提示。不再支持在文本后追加 <code>--[parameters]</code> 的旧方式。</p>
</blockquote>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E5%88%9B%E5%BB%BA%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90%E4%BB%BB%E5%8A%A1%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0" name="%E5%88%9B%E5%BB%BA%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90%E4%BB%BB%E5%8A%A1%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0">创建视频生成任务响应参数</h2>
<p><span id="Hrya4y9k"></span></p>
<p><strong>id</strong> <code>string</code></p>
<p>视频生成任务 ID。仅保存 7 天（从 <strong>created_at</strong> 时间戳开始计算），超时后将自动清除。创建任务为异步接口，需通过查询接口获取结果。</p>
<hr>
<p><span id="Hrya4y9k"></span></p>
<h2 id="%E5%88%9B%E5%BB%BA%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90%E4%BB%BB%E5%8A%A1%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B" name="%E5%88%9B%E5%BB%BA%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90%E4%BB%BB%E5%8A%A1%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B">创建视频生成任务调用示例</h2>
<p><span id="Hrya4y9k"></span></p>
<h3 id="%E4%BA%91%E7%AD%9142-%E5%A4%9A%E6%A8%A1%E6%80%81%E5%8F%82%E8%80%83%E7%94%9F%E8%A7%86%E9%A2%91%EF%BC%88%E6%9C%89%E5%A3%B0%EF%BC%89" name="%E4%BA%91%E7%AD%9142-%E5%A4%9A%E6%A8%A1%E6%80%81%E5%8F%82%E8%80%83%E7%94%9F%E8%A7%86%E9%A2%91%EF%BC%88%E6%9C%89%E5%A3%B0%EF%BC%89">云筑42-多模态参考生视频（有声）</h3>
<p>请求示例：</p>
<pre><code>curl -X POST https://modelpool-api.talkingdata.com/model/openai/api/v3/contents/generations/tasks?requestId=550e8400-e29b-41d4-a716-446655440000 \
  -H &quot;Content-Type: application/json&quot; \
  -H &quot;Authorization: Bearer $TD_API_KEY&quot; \
  -H &quot;X-Timestamp: $TIMESTAMP&quot; \
  -d &#39;{
    &quot;model&quot;: &quot;T0101007&quot;,
    &quot;content&quot;: [
        {
            &quot;type&quot;: &quot;text&quot;,
            &quot;text&quot;: &quot;第一人称视角果茶宣传广告。首帧为图片1，你的手摘下一颗带晨露的红苹果；2-4秒：将苹果块投入雪克杯，加入冰块与茶底，用力摇晃；4-6秒：成品特写，分层果茶倒入透明杯；6-8秒：手持举杯到镜头前，尾帧定格为图片2。背景音为女生音色。&quot;
        },
        {
            &quot;type&quot;: &quot;image_url&quot;,
            &quot;image_url&quot;: { &quot;url&quot;: &quot;https://example.com/pic1.jpg&quot; },
            &quot;role&quot;: &quot;reference_image&quot;
        },
        {
            &quot;type&quot;: &quot;image_url&quot;,
            &quot;image_url&quot;: { &quot;url&quot;: &quot;https://example.com/pic2.jpg&quot; },
            &quot;role&quot;: &quot;reference_image&quot;
        },
        {
            &quot;type&quot;: &quot;video_url&quot;,
            &quot;video_url&quot;: { &quot;url&quot;: &quot;https://example.com/video1.mp4&quot; },
            &quot;role&quot;: &quot;reference_video&quot;
        },
        {
            &quot;type&quot;: &quot;audio_url&quot;,
            &quot;audio_url&quot;: { &quot;url&quot;: &quot;https://example.com/audio1.mp3&quot; },
            &quot;role&quot;: &quot;reference_audio&quot;
        }
    ],
    &quot;generate_audio&quot;: true,
    &quot;ratio&quot;: &quot;16:9&quot;,
    &quot;duration&quot;: 11,
    &quot;watermark&quot;: false
}&#39;
</code></pre><p>响应示例：</p>
<pre><code>{
  &quot;id&quot;: &quot;cgt-2026******-****&quot;
}
</code></pre><p><span id="Hrya4y9k"></span></p>
<h3 id="%E4%BA%91%E7%AD%9142-%E6%9C%89%E5%A3%B0%E8%A7%86%E9%A2%91-%E9%A6%96%E5%B8%A7" name="%E4%BA%91%E7%AD%9142-%E6%9C%89%E5%A3%B0%E8%A7%86%E9%A2%91-%E9%A6%96%E5%B8%A7">云筑42-有声视频-首帧</h3>
<p>请求示例：</p>
<pre><code>curl -X POST https://modelpool-api.talkingdata.com/model/openai/api/v3/contents/generations/tasks \
  -H &quot;Content-Type: application/json&quot; \
  -H &quot;Authorization: Bearer $TD_API_KEY&quot; \
  -H &quot;X-Timestamp: $TIMESTAMP&quot; \
  -d &#39;{
    &quot;model&quot;: &quot;T0101007&quot;,
    &quot;content&quot;: [
        {
            &quot;type&quot;: &quot;text&quot;,
            &quot;text&quot;: &quot;女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出。&quot;
        },
        {
            &quot;type&quot;: &quot;image_url&quot;,
            &quot;image_url&quot;: { &quot;url&quot;: &quot;https://example.com/first_frame.png&quot; },
            &quot;role&quot;: &quot;first_frame&quot;
        }
    ],
    &quot;generate_audio&quot;: true,
    &quot;ratio&quot;: &quot;adaptive&quot;,
    &quot;duration&quot;: 5,
    &quot;watermark&quot;: false
}&#39;
</code></pre><p>响应示例：</p>
<pre><code>{
  &quot;id&quot;: &quot;cgt-2025******-****&quot;
}
</code></pre><p><span id="Hrya4y9k"></span></p>
<h3 id="%E4%BA%91%E7%AD%9142-%E6%9C%89%E5%A3%B0%E8%A7%86%E9%A2%91-%E9%A6%96%E5%B0%BE%E5%B8%A7" name="%E4%BA%91%E7%AD%9142-%E6%9C%89%E5%A3%B0%E8%A7%86%E9%A2%91-%E9%A6%96%E5%B0%BE%E5%B8%A7">云筑42-有声视频-首尾帧</h3>
<p>请求示例：</p>
<pre><code>curl -X POST https://modelpool-api.talkingdata.com/model/openai/api/v3/contents/generations/tasks \
  -H &quot;Content-Type: application/json&quot; \
  -H &quot;Authorization: Bearer $TD_API_KEY&quot; \
  -H &quot;X-Timestamp: $TIMESTAMP&quot; \
  -d &#39;{
    &quot;model&quot;: &quot;T0101007&quot;,
    &quot;content&quot;: [
        {
            &quot;type&quot;: &quot;text&quot;,
            &quot;text&quot;: &quot;花朵从盛开到凋零的过程，延时摄影风格。&quot;
        },
        {
            &quot;type&quot;: &quot;image_url&quot;,
            &quot;image_url&quot;: { &quot;url&quot;: &quot;https://example.com/bloom.jpg&quot; },
            &quot;role&quot;: &quot;first_frame&quot;
        },
        {
            &quot;type&quot;: &quot;image_url&quot;,
            &quot;image_url&quot;: { &quot;url&quot;: &quot;https://example.com/withered.jpg&quot; },
            &quot;role&quot;: &quot;last_frame&quot;
        }
    ],
    &quot;generate_audio&quot;: false,
    &quot;ratio&quot;: &quot;16:9&quot;,
    &quot;duration&quot;: 6,
    &quot;watermark&quot;: true
}&#39;
</code></pre><p>响应示例：</p>
<pre><code>{
  &quot;id&quot;: &quot;cgt-2025******-****&quot;
}
</code></pre><p><span id="Hrya4y9k"></span></p>
<h3 id="%E4%BA%91%E7%AD%9142-%E6%96%87%E7%94%9F%E8%A7%86%E9%A2%91%EF%BC%88%E5%BC%80%E5%90%AF%E8%81%94%E7%BD%91%E6%90%9C%E7%B4%A2%EF%BC%89" name="%E4%BA%91%E7%AD%9142-%E6%96%87%E7%94%9F%E8%A7%86%E9%A2%91%EF%BC%88%E5%BC%80%E5%90%AF%E8%81%94%E7%BD%91%E6%90%9C%E7%B4%A2%EF%BC%89">云筑42-文生视频（开启联网搜索）</h3>
<p>请求示例：</p>
<pre><code>curl -X POST https://modelpool-api.talkingdata.com/model/openai/api/v3/contents/generations/tasks \
  -H &quot;Content-Type: application/json&quot; \
  -H &quot;Authorization: Bearer $TD_API_KEY&quot; \
  -H &quot;X-Timestamp: $TIMESTAMP&quot; \
  -d &#39;{
    &quot;model&quot;: &quot;T0101007&quot;,
    &quot;content&quot;: [
        {
            &quot;type&quot;: &quot;text&quot;,
            &quot;text&quot;: &quot;根据今天的实时天气，生成一个穿着与季节相符的女孩在街头漫步的视频。&quot;
        }
    ],
    &quot;tools&quot;: [{&quot;type&quot;: &quot;web_search&quot;}],
    &quot;ratio&quot;: &quot;9:16&quot;,
    &quot;duration&quot;: 5,
    &quot;watermark&quot;: false
}&#39;
</code></pre><p>响应示例：</p>
<pre><code>{
  &quot;id&quot;: &quot;cgt-2025******-****&quot;
}
</code></pre><hr>
<p><span id="Hrya4y9k"></span></p>
<h2 id="%E6%9F%A5%E8%AF%A2%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90%E4%BB%BB%E5%8A%A1%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80" name="%E6%9F%A5%E8%AF%A2%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90%E4%BB%BB%E5%8A%A1%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80">查询视频生成任务接口地址</h2>
<p><span id="Hrya4y9k"></span></p>
<p>查询视频生成任务的状态。</p>
<blockquote>
<p><strong>说明</strong>
仅支持查询最近 7 天的历史数据。</p>
</blockquote>
<p><strong>请求方法：</strong> GET</p>
<p><strong>接口URL：</strong> <code>https://modelpool-api.talkingdata.com/model/openai/api/v3/contents/generations/tasks/{id}</code></p>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%9F%A5%E8%AF%A2%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90%E4%BB%BB%E5%8A%A1%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0" name="%E6%9F%A5%E8%AF%A2%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90%E4%BB%BB%E5%8A%A1%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0">查询视频生成任务请求参数</h2>
<p><span id="Hrya4y9k"></span></p>
<p><strong>id</strong> <code>string</code> <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span></p>
<p>您需要查询的视频生成任务的 ID。</p>
<blockquote>
<p>上面参数为Query String Parameters，在URL String中传入。</p>
</blockquote>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%9F%A5%E8%AF%A2%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90%E4%BB%BB%E5%8A%A1%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0" name="%E6%9F%A5%E8%AF%A2%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90%E4%BB%BB%E5%8A%A1%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0">查询视频生成任务响应参数</h2>
<p><span id="Hrya4y9k"></span></p>
<p><strong>id</strong> <code>string</code></p>
<p>视频生成任务 ID。</p>
<hr>
<p><strong>model</strong> <code>string</code></p>
<p>本次请求使用的模型 ID，此处为 <code>T0101007</code>。</p>
<hr>
<p><strong>status</strong> <code>string</code></p>
<p>任务状态：</p>
<ul>
<li><code>queued</code>：排队中。</li>
<li><code>running</code>：任务运行中。</li>
<li><code>cancelled</code>：取消任务（仅支持排队中状态）。</li>
<li><code>succeeded</code>：任务成功。</li>
<li><code>failed</code>：任务失败。</li>
<li><code>expired</code>：任务超时。</li>
</ul>
<hr>
<p><strong>error</strong> <code>object / null</code></p>
<p>错误提示信息，任务成功返回 <code>null</code>，失败时返回错误数据。</p>
<ul>
<li>error.<strong>code</strong> <code>string</code> 错误码。</li>
<li>error.<strong>message</strong> <code>string</code> 错误提示信息。</li>
</ul>
<hr>
<p><strong>created_at</strong> <code>integer</code></p>
<p>任务创建时间的 Unix 时间戳（秒）。</p>
<hr>
<p><strong>updated_at</strong> <code>integer</code></p>
<p>任务状态更新时间的 Unix 时间戳（秒）。</p>
<hr>
<p><strong>content</strong> <code>object</code></p>
<p>视频生成任务的输出内容。</p>
<ul>
<li>content.<strong>video_url</strong> <code>string</code> 生成视频的URL（mp4格式），24小时后清理。</li>
<li>content.<strong>last_frame_url</strong> <code>string</code> 视频尾帧图像URL（png格式），24小时后清理。仅在创建时设置 <code>&quot;return_last_frame&quot;: true</code> 时返回。</li>
</ul>
<hr>
<p><strong>seed</strong> <code>integer</code></p>
<p>本次请求使用的种子整数值。</p>
<hr>
<p><strong>resolution</strong> <code>string</code></p>
<p>生成视频的分辨率。</p>
<hr>
<p><strong>ratio</strong> <code>string</code></p>
<p>生成视频的宽高比。</p>
<hr>
<p><strong>duration</strong> <code>integer</code></p>
<p>生成视频的时长，单位：秒。</p>
<hr>
<p><strong>framespersecond</strong> <code>integer</code></p>
<p>生成视频的帧率。</p>
<hr>
<p><strong>generate_audio</strong> <code>boolean</code></p>
<p>生成的视频是否包含声音。</p>
<ul>
<li><code>true</code>：包含同步音频。</li>
<li><code>false</code>：无声视频。</li>
</ul>
<hr>
<p><strong>tools</strong> <code>object[]</code></p>
<p>本次请求实际使用的工具。</p>
<ul>
<li>tools.<strong>type</strong> <code>string</code> 实际使用的工具类型，如 <code>web_search</code>。</li>
</ul>
<hr>
<p><strong>safety_identifier</strong> <code>string</code></p>
<p>创建任务时传入的用户标识符，会原样返回。</p>
<hr>
<p><strong>service_tier</strong> <code>string</code></p>
<p>实际处理任务使用的服务等级。</p>
<hr>
<p><strong>execution_expires_after</strong> <code>integer</code></p>
<p>任务超时阈值，单位：秒。</p>
<hr>
<p><strong>usage</strong> <code>object</code></p>
<p>本次请求的 token 用量。</p>
<ul>
<li>usage.<strong>completion_tokens</strong> <code>integer</code> 模型输出视频花费的 token 数量。</li>
<li>usage.<strong>total_tokens</strong> <code>integer</code> 总 token 数量（= completion_tokens）。</li>
<li>usage.<strong>tool_usage</strong> <code>object</code> 工具用量信息。<ul>
<li>usage.tool_usage.<strong>web_search</strong> <code>integer</code> 实际调用联网搜索工具的次数。</li>
</ul>
</li>
</ul>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%9F%A5%E8%AF%A2%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90%E4%BB%BB%E5%8A%A1%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B" name="%E6%9F%A5%E8%AF%A2%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90%E4%BB%BB%E5%8A%A1%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B">查询视频生成任务调用示例</h2>
<p><span id="Hrya4y9k"></span></p>
<p>请求示例：</p>
<pre><code>curl -X GET https://modelpool-api.talkingdata.com/model/openai/api/v3/contents/generations/tasks/cgt-2025**** \
  -H &quot;Content-Type: application/json&quot; \
  -H &quot;Authorization: Bearer $TD_API_KEY&quot;
</code></pre><p>响应示例：</p>
<pre><code>{
  &quot;id&quot;: &quot;cgt-2025******-****&quot;,
  &quot;model&quot;: &quot;T0101007&quot;,
  &quot;status&quot;: &quot;succeeded&quot;,
  &quot;content&quot;: {
    &quot;video_url&quot;: &quot;https://ark-content-generation-cn-beijing.tos-cn-beijing.volces.com/xxx&quot;
  },
  &quot;usage&quot;: {
    &quot;completion_tokens&quot;: 108900,
    &quot;total_tokens&quot;: 108900,
    &quot;tool_usage&quot;: {
      &quot;web_search&quot;: 1
    }
  },
  &quot;created_at&quot;: 1743414619,
  &quot;updated_at&quot;: 1743414673,
  &quot;seed&quot;: 10,
  &quot;resolution&quot;: &quot;720p&quot;,
  &quot;ratio&quot;: &quot;16:9&quot;,
  &quot;duration&quot;: 5,
  &quot;framespersecond&quot;: 24,
  &quot;service_tier&quot;: &quot;default&quot;,
  &quot;execution_expires_after&quot;: 172800,
  &quot;generate_audio&quot;: true
}
</code></pre><hr>
<p><span id="Hrya4y9k"></span></p>
<h2 id="%E5%8F%96%E6%B6%88%E6%88%96%E5%88%A0%E9%99%A4%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90%E4%BB%BB%E5%8A%A1%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80" name="%E5%8F%96%E6%B6%88%E6%88%96%E5%88%A0%E9%99%A4%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90%E4%BB%BB%E5%8A%A1%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80">取消或删除视频生成任务接口地址</h2>
<p><span id="Hrya4y9k"></span></p>
<p>取消排队中的视频生成任务，或者删除视频生成任务记录。</p>
<p><strong>请求方法：</strong> DELETE</p>
<p><strong>接口URL：</strong> <code>https://modelpool-api.talkingdata.com/model/openai/api/v3/contents/generations/tasks/{id}</code></p>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E5%8F%96%E6%B6%88%E6%88%96%E5%88%A0%E9%99%A4%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90%E4%BB%BB%E5%8A%A1%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0" name="%E5%8F%96%E6%B6%88%E6%88%96%E5%88%A0%E9%99%A4%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90%E4%BB%BB%E5%8A%A1%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0">取消或删除视频生成任务请求参数</h2>
<p><span id="Hrya4y9k"></span></p>
<p><strong>id</strong> <code>string</code> <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span></p>
<p>需要取消或者删除的视频生成任务。</p>
<p>任务状态不同，调用DELETE接口，执行的操作有所不同，具体说明如下：</p>
<table>
<thead>
<tr>
<th>当前任务状态</th>
<th>是否支持DELETE操作</th>
<th>操作含义</th>
<th>DELETE操作后任务状态</th>
</tr>
</thead>
<tbody>
<tr>
<td>queued</td>
<td>是</td>
<td>任务取消排队，任务状态被变更为cancelled。</td>
<td>cancelled</td>
</tr>
<tr>
<td>running</td>
<td>否</td>
<td>-</td>
<td>-</td>
</tr>
<tr>
<td>succeeded</td>
<td>否</td>
<td>-</td>
<td>-</td>
</tr>
<tr>
<td>failed</td>
<td>否</td>
<td>-</td>
<td>-</td>
</tr>
<tr>
<td>cancelled</td>
<td>否</td>
<td>-</td>
<td>-</td>
</tr>
<tr>
<td>expired</td>
<td>否</td>
<td>-</td>
<td>-</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E5%8F%96%E6%B6%88%E6%88%96%E5%88%A0%E9%99%A4%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90%E4%BB%BB%E5%8A%A1%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0" name="%E5%8F%96%E6%B6%88%E6%88%96%E5%88%A0%E9%99%A4%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90%E4%BB%BB%E5%8A%A1%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0">取消或删除视频生成任务响应参数</h2>
<p><span id="Hrya4y9k"></span></p>
<p><strong>message</strong> <code>string</code> </p>
<p>请求处理结果的描述信息。</p>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E5%8F%96%E6%B6%88%E6%88%96%E5%88%A0%E9%99%A4%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90%E4%BB%BB%E5%8A%A1%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B" name="%E5%8F%96%E6%B6%88%E6%88%96%E5%88%A0%E9%99%A4%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90%E4%BB%BB%E5%8A%A1%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B">取消或删除视频生成任务调用示例</h2>
<p><span id="Hrya4y9k"></span></p>
<p>请求示例：</p>
<pre><code>curl -X DELETE https://modelpool-api.talkingdata.com/model/openai/api/v3/contents/generations/tasks/$ID \
  -H &quot;Content-Type: application/json&quot; \
  -H &quot;Authorization: Bearer $ARK_API_KEY&quot;
</code></pre><p>响应示例：</p>
<pre><code>{
    &quot;message&quot; : &quot;取消成功&quot;
}
</code></pre><hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E9%94%99%E8%AF%AF%E7%A0%81" name="%E9%94%99%E8%AF%AF%E7%A0%81">错误码</h2>
<table>
<thead>
<tr>
<th>HTTP 状态码</th>
<th>错误类型 Type</th>
<th>错误码 Code</th>
<th>错误信息 Message</th>
<th>含义</th>
</tr>
</thead>
<tbody>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>MissingParameter</td>
<td>The request failed because it is missing one or multiple required parameters. Request ID: {id}</td>
<td>请求缺少必要参数，请查阅 API 文档。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>InvalidParameter</td>
<td>One or more parameters specified in the request are not valid. Request ID: {id}</td>
<td>请求包含非法参数，请查阅 API 文档。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>InvalidParameter</td>
<td>The parameter instructions specified in the request are not valid: caching is not supported for instructions. Request id: {id}</td>
<td>Responses API 中，当配置过 instructions 字段信息，后续轮次无法配置 Caching 字段。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>InputTextRiskDetection</td>
<td>The request could not be processed because the input text includes sensitive content that violates ContentSecurityDetection.ARKRequest ID:{id};CSDRequestId:{RequestId};Label:{Label};SubLabel:{SubLable}</td>
<td>风险识别产品检测到输入文本可能包含敏感信息，请您更换后重试。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>InputImageRiskDetection</td>
<td>The request could not be processed because the input image includes sensitive content that violates ContentSecurityDetection.ARKRequest ID:{id};CSDRequestId:{RequestId};Label:{Label};SubLabel:{SubLable}</td>
<td>风险识别产品检测到输入图片可能包含敏感信息，请您更换后重试。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>OutputTextRiskDetection</td>
<td>The request could not be processed because the output text includes sensitive content that violates ContentSecurityDetection.ARKRequest ID:{id};CSDRequestId:{RequestId};Label:{Label};SubLabel:{SubLable}</td>
<td>风险识别产品检测到输出文本可能包含敏感信息，请您更换后重试。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>OutputImageRiskDetection</td>
<td>The request could not be processed because the output image includes sensitive content that violates ContentSecurityDetection.ARKRequest ID:{id};CSDRequestId:{RequestId};Label:{Label};SubLabel:{SubLable}</td>
<td>风险识别产品检测到输出图片可能包含敏感信息，请您更换后重试。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>ContentSecurityDetectionError</td>
<td>Internal error.ARKRequest ID:{id};CSDRequestId:{RequestId};CSDcode:{};CSDmessage:{}</td>
<td>风险识别产品请求失败。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>SensitiveContentDetected</td>
<td>The request failed because the input text may contain sensitive information.</td>
<td>输入文本可能包含敏感信息，请您使用其他 prompt。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>SensitiveContentDetected.SevereViolation</td>
<td>The request failed because the input text may contain severe violation information.</td>
<td>输入文本可能包含严重违规相关信息，请您使用其他 prompt。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>SensitiveContentDetected.Violence</td>
<td>The request failed because the input text may contain violence information.</td>
<td>输入文本可能包含激进行为相关信息，请您使用其他 prompt。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>InputTextSensitiveContentDetected</td>
<td>The request failed because the input text may contain sensitive information.Request ID: {id}</td>
<td>输入文本可能包含敏感信息，请您更换后重试。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>InputImageSensitiveContentDetected</td>
<td>The request failed because the input image may contain sensitive information.Request ID: {id}</td>
<td>输入图像可能包含敏感信息，请您更换后重试。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>InputVideoSensitiveContentDetected</td>
<td>The request failed because the input video may contain sensitive information.</td>
<td>输入视频可能包含敏感信息，请您更换后重试。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>OutputTextSensitiveContentDetected</td>
<td>The request failed because the output may contain sensitive information.</td>
<td>生成的文字可能包含敏感信息，请您更换输入内容后重试。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>OutputImageSensitiveContentDetected</td>
<td>The request failed because the output image may contain sensitive information.</td>
<td>生成的图像可能包含敏感信息，请您更换输入内容后重试。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>OutputVideoSensitiveContentDetected</td>
<td>The request failed because the output video may contain sensitive information.Request ID: {id}</td>
<td>生成的视频可能包含敏感信息，请您更换输入内容后重试。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>InvalidParameter.{{Parameter}}</td>
<td>The specified parameter {{Parameter}} is invalid.</td>
<td>请求参数值不合法。请检查参数值的正确性后重试。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>MissingParameter.{{Parameter}}</td>
<td>The required parameter {{Parameter}} is missing.</td>
<td>缺少必要的请求参数。请确认请求参数后重试。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>Duplicate.Tags.Key</td>
<td>The specified object of tags contains duplicate keys.</td>
<td>对象的标签存在重复Key。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>InvalidArgumentError</td>
<td>MissingRole：Invalid message: {{Message}}</td>
<td>请求中的 messages 列表里，有消息体缺少 role 字段。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>InvalidArgumentError.UnknownRole</td>
<td>Unknow the role of message: {{Role}}</td>
<td>消息体中的 role 值不被支持，如user_。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>InvalidArgumentError.UnknownRole</td>
<td>The Inference role not found: {{Role}}</td>
<td>指定的 inference_role 未在配置中定义。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>InvalidArgumentError.InvalidImageDetail</td>
<td>Invalid image detail: {{Parameter}}</td>
<td>image_url 中的 detail 参数值无效，只接受 &quot;auto&quot;, &quot;high&quot;, &quot;low&quot;。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>InvalidArgumentError.InvalidPixelLimit</td>
<td>Customized min_pixels 100 is greater than max_pixels 50</td>
<td>用户自定义的图片像素限制（min_pixels, max_pixels）无效（例如 min_pixels &gt; max_pixels，或超出了服务配置的范围）。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>InvalidImageURL.EmptyURL</td>
<td>Empty base64 image url</td>
<td>传入的图片 URL 为空。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>InvalidImageURL.InvalidFormat</td>
<td>Invalid base64 image url</td>
<td>无法解析或处理图片，可能是 Base64 格式不正确、图片数据损坏或格式不支持。</td>
</tr>
<tr>
<td>400</td>
<td>BadRequest</td>
<td>OutofContextError</td>
<td>Total tokens of image and text exceed max message tokens.</td>
<td>当请求中包含图片时，文本和图片编码后的总 token 数超过了模型上下文长度限制。</td>
</tr>
<tr>
<td>403</td>
<td>Forbidden</td>
<td>InvalidSubscription</td>
<td>Your account ({{account_identifier}}) does not have a valid coding plan subscription, or your subscription has expired. Please visit {{subscription_check_url}} to review your subscription status or complete the subscription or renewal process.</td>
<td>Coding Plan 套餐未订阅或已过期。</td>
</tr>
<tr>
<td>401</td>
<td>Unauthorized</td>
<td>AuthenticationError</td>
<td>The API key or AK/SK in the request is missing or invalid. Request ID: {id}</td>
<td>请求携带的 API Key 或 AK/SK 校验未通过，请您重新检查设置的鉴权凭证，或者查看 API 调用文档来排查问题。</td>
</tr>
<tr>
<td>401</td>
<td>Unauthorized</td>
<td>AuthenticationError</td>
<td>Unauthorized</td>
<td>请求中使用的 API Key 无效，或指定的 Model ID 不正确或不可访问。</td>
</tr>
<tr>
<td>401</td>
<td>Forbidden</td>
<td>InvalidAccountStatus</td>
<td>There is an issue with your account status. If you need assistance, please contact the platform administrators.</td>
<td>当前使用的账号异常。</td>
</tr>
<tr>
<td>403</td>
<td>Forbidden</td>
<td>OperationDenied.InvalidState</td>
<td>The specified context is in invalid state: InProgress.Request ID: {id}</td>
<td>请求所关联的Context ID处于非空闲状态，不可调用。</td>
</tr>
<tr>
<td>403</td>
<td>Forbidden</td>
<td>OperationDenied.ConflictedValidationSet</td>
<td>Operation is denied because it is not supported to configure ValidationSet and ValidationPercentage at the same time.</td>
<td>无法同时上传验证集和设置训练集取样为验证集百分比，不支持该操作。</td>
</tr>
<tr>
<td>403</td>
<td>Forbidden</td>
<td>OperationDenied.PermissionDenied</td>
<td>Operation is denied because you are not permitted to access the specified configuration of the FoundationModel.</td>
<td>您没有权限访问基础模型的配置，不支持该操作。</td>
</tr>
<tr>
<td>403</td>
<td>Forbidden</td>
<td>OperationDenied.UnsupportedCustomizationType</td>
<td>Operation is denied because the specified CustomizationType is not supported by the CustomModel.</td>
<td>模型不支持该训练方法，不支持该操作。</td>
</tr>
<tr>
<td>403</td>
<td>Forbidden</td>
<td>OperationDenied.CustomizationNotSupported</td>
<td>Operation is denied because the specified version of the FoundationModel is not configured for the specified type of customization.</td>
<td>基础模型的版本不支持该训练方法，不支持该操作。</td>
</tr>
<tr>
<td>403</td>
<td>Forbidden</td>
<td>OperationDenied.ServiceNotOpen</td>
<td>Operation is denied because the model service is unavailable, please go to the Volcano Ark console activation management page to activate the corresponding model service, or submit a work order to contact us.</td>
<td>模型服务不可用，不支持该操作。</td>
</tr>
<tr>
<td>403</td>
<td>Forbidden</td>
<td>AccessDenied</td>
<td>The request failed because you do not have access to the requested resource. Request ID: {id}</td>
<td>没有访问该资源的权限，请检查权限设置。</td>
</tr>
<tr>
<td>403</td>
<td>Forbidden</td>
<td>OperationDenied.InvalidState</td>
<td>Operation is denied because the specified context is in invalid state: InProgress. Request id: {id}</td>
<td>请求的缓存信息状态是不可用状态。请查看缓存信息是否正在被更新中。</td>
</tr>
<tr>
<td>403</td>
<td>Forbidden</td>
<td>OperationDenied.UnsupportedPhase</td>
<td>Operation is denied because operation is not supported while the target is in its current phase.</td>
<td>操作失败，操作目标在特殊状态，请检查目标是否存在或者被锁定等特殊状态中。</td>
</tr>
<tr>
<td>403</td>
<td>Forbidden</td>
<td>OperationDenied.FileQuotaExceeded</td>
<td>Your account %s has exhausted its file storage quota. To continue using the service, please delete historical files.</td>
<td>当前账号 %s 已耗尽文件存储额度，如需继续使用，请删除历史文件。</td>
</tr>
<tr>
<td>403</td>
<td>Forbidden</td>
<td>OperationDenied.InvalidState</td>
<td>The specified file is in invalid state: InProgress.Request ID: {id}</td>
<td>请求所关联的File ID处于非可用状态，不可调用。</td>
</tr>
<tr>
<td>404</td>
<td>NotFound</td>
<td>InvalidEndpointOrModel.NotFound</td>
<td>The model or endpoint %s does not exist or you do not have access to it.</td>
<td>模型或者推理接入点 %s 不存在或者您无权访问它。</td>
</tr>
<tr>
<td>404</td>
<td>NotFound</td>
<td>ModelNotOpen</td>
<td>Your account %s has not activated the model %s. Please activate the model service in the Ark Console.</td>
<td>当前账号 %s 暂未开通 %s 模型服务。</td>
</tr>
<tr>
<td>404</td>
<td>NotFound</td>
<td>NotFound.{{Parameter}}</td>
<td>The specified {{ResourceType}} {{ResourceContent}} is not found.</td>
<td>指定资源找不到。请确认参数后重试。</td>
</tr>
<tr>
<td>404</td>
<td>NotFound</td>
<td>InvalidEndpointOrModel.ModelIDAccessDisabled</td>
<td>Accessing the model via Model ID is not allowed for your account. Please use a custom endpoint ID instead. Request id:{id}</td>
<td>未能找到指定的模型ID。你的账号不允许使用模型ID来调用模型，请确认你账号权限或者使用有权限的推理接入点 ID 来调用模型服务。</td>
</tr>
<tr>
<td>404</td>
<td>NotFound</td>
<td>UnsupportedModel</td>
<td>The {{model_name}} model does not support the coding plan feature. Please refer to the documentation at {{doc_url}} to select a compatible model.</td>
<td>当前模型不支持 Coding Plan。</td>
</tr>
<tr>
<td>429</td>
<td>TooManyRequests</td>
<td>RateLimitExceeded.EndpointRPMExceeded</td>
<td>The Requests Per Minute (RPM) limit of the associated endpoint for your account has been exceeded. Request ID: {id}</td>
<td>请求所关联的推理接入点已超过 RPM (Requests Per Minute) 限制，请稍后重试。</td>
</tr>
<tr>
<td>429</td>
<td>TooManyRequests</td>
<td>RateLimitExceeded.EndpointTPMExceeded</td>
<td>The Tokens Per Minute (TPM) limit of the associated endpoint for your account has been exceeded. Request ID: {id}</td>
<td>请求所关联的推理接入点已超过 TPM (Tokens Per Minute) 限制，请稍后重试。</td>
</tr>
<tr>
<td>429</td>
<td>TooManyRequests</td>
<td>ModelAccountRpmRateLimitExceeded</td>
<td>RPM (Requests Per Minute) limit of the model is exceeded. Request ID: {id}</td>
<td>请求已超过帐户模型 RPM (Requests Per Minute) 限制：请您稍后重试，或者联系平台技术同学进行解决。</td>
</tr>
<tr>
<td>429</td>
<td>TooManyRequests</td>
<td>ModelAccountTpmRateLimitExceeded</td>
<td>TPM (Tokens Per Minute) limit of the model is exceeded. Request ID: {id}</td>
<td>请求已超过帐户模型 TPM (Tokens Per Minute) 限制：请您稍后重试，或者联系平台技术同学进行解决。</td>
</tr>
<tr>
<td>429</td>
<td>TooManyRequests</td>
<td>APIAccountRpmRateLimitExceeded</td>
<td>The RPM (Requests Per Minute) limit for the API on your account has been exceeded. Request ID: {id}</td>
<td>当前账号该接口的RPM (Requests Per Minute)限制已超出，请稍后重试。</td>
</tr>
<tr>
<td>429</td>
<td>TooManyRequests</td>
<td>ModelAccountIpmRateLimitExceeded</td>
<td>IPM (Images Per Minute) limit of the model is exceeded.</td>
<td>请求已超过账户模型 IPM (Images Per Minute) 限制：请您稍后重试，或者联系平台技术同学进行解决。</td>
</tr>
<tr>
<td>429</td>
<td>TooManyRequests</td>
<td>QuotaExceeded</td>
<td>Your account [%s] has exhausted its free trial quota for the [%s] model. Request ID: {id}</td>
<td>当前账号 %s 对 %s 模型的免费试用额度已消耗完毕。</td>
</tr>
<tr>
<td>429</td>
<td>TooManyRequests</td>
<td>QuotaExceeded</td>
<td>The request has exceeded the quota. Request ID: {id}</td>
<td>当前账号处于排队中状态的任务数已超过限制，请稍后重试。</td>
</tr>
<tr>
<td>429</td>
<td>TooManyRequests</td>
<td>ServerOverloaded</td>
<td>The service is currently unable to handle additional requests due to server overload. Please retry later. Request ID: {id}</td>
<td>服务资源紧张，请您稍后重试。常出现在调用流量突增或刚开始调用长时间未使用的推理接入点。</td>
</tr>
<tr>
<td>429</td>
<td>TooManyRequests</td>
<td>SetLimitExceeded</td>
<td>Your account [%s] has reached the set inference limit for the [%s] model, and the model service has been paused. To continue using this model, please visit the Model Activation page to adjust or close the &quot;Safe Experience Mode&quot;. Request ID: {id}</td>
<td>当前账号 %s 对 %s 模型已达到设置的推理限额值。</td>
</tr>
<tr>
<td>429</td>
<td>TooManyRequests</td>
<td>InflightBatchsizeExceeded</td>
<td>The Inflight Batchsize limit has been exceeded.Request ID: {id}</td>
<td>您已经达到当前充值金额下的最大并发数限制，您可以充值解锁更大并发额度或降低并发数。</td>
</tr>
<tr>
<td>429</td>
<td>TooManyRequests</td>
<td>AccountRateLimitExceeded</td>
<td>Requests are too frequent. Please reduce your request frequency, wait a short moment, and retry your request.</td>
<td>请求超出RPM / TPM限制。</td>
</tr>
<tr>
<td>429</td>
<td>TooManyRequests</td>
<td>QuotaExceeded</td>
<td>You have exceeded the 5-hour/weekly/monthly usage quota. It will reset at {{reset_time}}.</td>
<td>使用的额度超出5小时/周/月限额。</td>
</tr>
<tr>
<td>500</td>
<td>InternalServerError</td>
<td>InternalServiceError</td>
<td>The service encountered an unexpected internal error. Please retry later. Request ID: {id}</td>
<td>内部系统异常，请您稍后重试。</td>
</tr>
</tbody>
</table>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E5%85%AC%E5%85%B1%E9%94%99%E8%AF%AF%E7%A0%81" name="%E5%85%AC%E5%85%B1%E9%94%99%E8%AF%AF%E7%A0%81">公共错误码</h2>
<table>
<thead>
<tr>
<th>Code</th>
<th>CodeN</th>
<th>Message</th>
<th>错误说明及解决方式</th>
<th>Status</th>
</tr>
</thead>
<tbody>
<tr>
<td>MissingParameter</td>
<td>100002</td>
<td>The request is missing %s parameter.</td>
<td>关键参数缺失，例如Action, Version参数缺失。请参考API文档补充Action或Version参数。</td>
<td>400</td>
</tr>
<tr>
<td>MissingRequestInfo</td>
<td>100004</td>
<td>The request is missing %s information.</td>
<td>缺少请求必要信息，例如：X-Date</td>
<td>400</td>
</tr>
<tr>
<td>InvalidTimestamp</td>
<td>100006</td>
<td>The Signature of the request is expired.</td>
<td>请求过期或请求的签名时间来自未来。请检查本地时间是否正常，以及是否使用了UTC时间，精确到秒，使用遵循ISO 8601标准的格式：<code>YYYYMMDD&#39;T&#39;HHMMSS&#39;Z&#39;</code>。</td>
<td>400</td>
</tr>
<tr>
<td>ServiceNotFound</td>
<td>100007</td>
<td>This service[%s] not found.</td>
<td>请求的服务不存在。请参考产品的API文档检+查Service是否完全填写正确。</td>
<td>404</td>
</tr>
<tr>
<td>InvalidActionOrVersion</td>
<td>100008</td>
<td>Could not find operation %s for version %s.</td>
<td>请求接口不存在。请参考产品的API文档检查Action是否完全填写正确。</td>
<td>404</td>
</tr>
<tr>
<td>InvalidAccessKey</td>
<td>100009</td>
<td>The accesskey [%s] included in the request is invalid.</td>
<td>请求的Access Key不合法。请检查Access key Id和Secret Access Key是否正确，注意不要有多余的空格符号。</td>
<td>401</td>
</tr>
<tr>
<td>SignatureDoesNotMatch</td>
<td>100010</td>
<td>The request signature we calculated does not match the signature you provided. Check your Secret Access Key and signing method. Consult the service documentation for details.</td>
<td>签名结果不正确。检查签名步骤，建议使用SDK，避免自行编码构造签名。</td>
<td>401</td>
</tr>
<tr>
<td>AccessDenied</td>
<td>100013</td>
<td>User is not authorized to perform: %s on resource: %s.</td>
<td>子用户拥有的权限不支持当前操作。</td>
<td>403</td>
</tr>
<tr>
<td>InternalError</td>
<td>100014</td>
<td>Service has some internal Error. Pls Contact With Admin.</td>
<td>内部错误。</td>
<td>500</td>
</tr>
<tr>
<td>InternalServiceTimeout</td>
<td>100016</td>
<td>Internal Service is timeout. Pls Contact With Admin.</td>
<td>服务执行超时。</td>
<td>504</td>
</tr>
<tr>
<td>FlowLimitExceeded</td>
<td>100018</td>
<td>Request was rejected because the request speed of this openAPI is beyond the current flow control limit.</td>
<td>请求过于频繁，超出了限速。请降低请求QPS，</td>
<td>429</td>
</tr>
<tr>
<td>ServiceUnavailableTemp</td>
<td>100019</td>
<td>Service is busy, please try again later.</td>
<td>处于熔断状态的服务暂时不可访问，稍后重试。</td>
<td>503</td>
</tr>
<tr>
<td>InternalServiceError</td>
<td>100023</td>
<td>Service has some internal Error. Pls Contact With Admin.</td>
<td>服务存在故障。</td>
<td>502</td>
</tr>
<tr>
<td>InvalidAuthorization</td>
<td>100024</td>
<td>Invalid &#39;Authorization&#39; header, Pls check authorization header.</td>
<td>Authorization头格式错误，构造的 Authorization Header 不正确，比如没有填 Region 字段、字符不在合法字符集中，请检查Authorization。建议使用SDK，避免自行编码构造签名。</td>
<td>400</td>
</tr>
<tr>
<td>InvalidCredential</td>
<td>100025</td>
<td>Invalid credential in &#39;Authorization&#39;, Pls check credential in authorization header.</td>
<td>Authorization头中的Credential格式错误，比如 AK 不在合法字符集中检查Credential。建议使用SDK，避免自行编码构造签名。</td>
<td>400</td>
</tr>
<tr>
<td>InvalidSecretToken</td>
<td>100026</td>
<td>Invalid secret token, msg: %s.</td>
<td>错误的STS（临时安全凭证），可能是多种错误，例如签名错误、过期等。请检查AssumeRole产生的临时凭证是否过期，以及签名是正确，建议使用SDK，避免自行编码构造签名。</td>
<td>401</td>
</tr>
</tbody>
</table>
<hr>
<h1 id="%3Cstrong%3E%E4%BA%91%E7%AD%9142_%E7%A7%81%E5%9F%9F%E8%99%9A%E6%8B%9F%E4%BA%BA%E5%83%8F%E7%B4%A0%E6%9D%90%E8%B5%84%E4%BA%A7%E5%BA%93%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3%3C%2Fstrong%3E" name="%3Cstrong%3E%E4%BA%91%E7%AD%9142_%E7%A7%81%E5%9F%9F%E8%99%9A%E6%8B%9F%E4%BA%BA%E5%83%8F%E7%B4%A0%E6%9D%90%E8%B5%84%E4%BA%A7%E5%BA%93%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3%3C%2Fstrong%3E"><strong>云筑42_私域虚拟人像素材资产库 接口说明文档</strong></h1>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%8E%A5%E5%8F%A3%E7%AE%80%E4%BB%8B" name="%E6%8E%A5%E5%8F%A3%E7%AE%80%E4%BB%8B">接口简介</h2>
<p><span id="Hrya4y9k"></span></p>
<ul>
<li><p><strong>云筑42_私域虚拟人像素材资产库</strong></p>
<ul>
<li><p>云筑42 模型具有完备的防范 Deepfake 和侵犯版权风险能力。在生成视频时，会对有风险的参考素材输入进行拦截，最大限度保证生成视频合规和安全性。</p>
</li>
<li><p>为确保创作者能充分利用云筑42 模型强大的视频生成能力高效生成视频内容，同时规避 AI 生成内容的潜在风险，推出了私域可信素材库。完成入库的可信素材将进入您的私域素材库，在视频生成中使用。</p>
</li>
</ul>
</li>
<li><h5 id="%E7%B4%A0%E6%9D%90%E8%B5%84%E4%BA%A7%E5%BA%93%E7%BB%93%E6%9E%84%E8%AF%B4%E6%98%8E" name="%E7%B4%A0%E6%9D%90%E8%B5%84%E4%BA%A7%E5%BA%93%E7%BB%93%E6%9E%84%E8%AF%B4%E6%98%8E">素材资产库结构说明</h5>
<ul>
<li><p><strong>Asset Group（素材资产组合）</strong>：单个素材文件为一个 Asset，每个 Asset 属于一个 Asset Group。</p>
</li>
<li><p><strong>Asset（素材资产）</strong>：一个素材文件（当前支持上传图像、视频、音频），是云筑42 模型可直接用于推理的可信资产。</p>
<blockquote>
<p>注意</p>
<ul>
<li>仅需入库推理需使用的素材资产，不需使用的素材资产请勿入库。</li>
<li>仅可使用已入库素材资产的 Id (Asset ID) 进行视频生成，同一形象未入库素材无法使用。</li>
<li>每个上传的素材资产需经过预处理，可轮询调用 <strong>GetAsset</strong> 接口查询素材状态（对应参数为 <strong>Status）</strong>，仅当状态变为 <code>Active</code> 后，该素材资产方可用于后续推理使用；若状态为 <code>Failed</code> 则表示处理失败，无法用于后续推理使用。</li>
</ul>
</blockquote>
</li>
</ul>
</li>
</ul>
<h5 id="%3Cstrong%3E%E9%89%B4%E6%9D%83%E8%AF%B4%E6%98%8E%3C%2Fstrong%3E%26nbsp%3B" name="%3Cstrong%3E%E9%89%B4%E6%9D%83%E8%AF%B4%E6%98%8E%3C%2Fstrong%3E%26nbsp%3B"><strong>鉴权说明</strong>&nbsp;</h5>
<pre><code>本接口仅支持API Key鉴权，需联系TD运营同学获取长效API Key。
</code></pre><hr>
<p><span id="7P96iLnc"></span></p>
<h1 id="CreateAsset%20%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80" name="CreateAsset%20%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80">CreateAsset 接口地址</h1>
<p><span id="Hrya4y9k"></span></p>
<p>向指定的Asset Group（素材资产组合）内创建Asset（素材资产）。</p>
<p><strong>请求方法：</strong> POST</p>
<p><strong>接口URL：</strong><code>https://modelpool-api.talkingdata.com/model/origin/assets/create</code> </p>
<p><strong>请求头（Request Headers）：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">头部字段</th>
<th style="text-align:left">值</th>
<th style="text-align:left">是否必需</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>Authorization</code></td>
<td style="text-align:left"><code>Bearer &lt;your_api_key&gt;</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">API 鉴权凭证，请替换为有效的 API Key</td>
</tr>
<tr>
<td style="text-align:left"><code>X-Timestamp</code></td>
<td style="text-align:left"><code>1700000000</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">Unix 时间戳格式</td>
</tr>
<tr>
<td style="text-align:left"><code>Content-Type</code></td>
<td style="text-align:left"><code>application/json</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">请求体格式必须为 JSON</td>
</tr>
</tbody>
</table>
<p><strong>请求参数（Request  Parameter）：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">字段</th>
<th style="text-align:left">值</th>
<th style="text-align:left">是否必需</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>requestld</code></td>
<td style="text-align:left"><code>550e8400-e29b-41d4-a716-446655440000</code></td>
<td style="text-align:left">否</td>
<td style="text-align:left">请求唯一标识符。使用 UUID 格式字符串，用于跟踪和排查请求相关问题，以便在需要技术排查时，提供此 ID 可快速定位具体请求的完整处理链路和日志信息。</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="CreateAsset%20%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0" name="CreateAsset%20%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0">CreateAsset 请求参数</h2>
<p><span id="Hrya4y9k"></span></p>
<h3 id="CreateAsset%20%E8%AF%B7%E6%B1%82%E4%BD%93%EF%BC%88requestBody%EF%BC%89" name="CreateAsset%20%E8%AF%B7%E6%B1%82%E4%BD%93%EF%BC%88requestBody%EF%BC%89">CreateAsset 请求体（requestBody）</h3>
<hr>
<p><strong>GroupId</strong>   <code>string</code>   <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span>   </p>
<p>Asset（素材资产）所属的 Asset Group（素材资产组合）的 Id。</p>
<hr>
<p><strong>URL </strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span>   </p>
<p>传入的Asset（素材资产）的公共可访问地址。</p>
<hr>
<p><strong>Name</strong> <code>string</code> </p>
<p>Asset（素材资产）的名称，上限为64个字符。</p>
<hr>
<p><strong>AssetType</strong>  <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span>   </p>
<p>Asset（素材资产）的类型，支持传入图像、音频、视频。可选值：</p>
<ul>
<li>Image：Asset（素材资产）的类型为图像。</li>
<li>Video：Asset（素材资产）的类型为视频。</li>
<li>Audio：Asset（素材资产）的类型为音频。</li>
</ul>
<blockquote>
<p><strong>说明：</strong></p>
<p><strong>传入图像、音频、视频素材时，仅支持上传 URL ，不支持 base64。</strong></p>
<p><strong>传入单个图像要求</strong></p>
<ul>
<li>格式：jpeg、png、webp、bmp、tiff、gif、heic/heif</li>
<li>宽高比（宽/高）： (0.4, 2.5) </li>
<li>宽高长度（px）：(300, 6000)</li>
<li>大小：单张图片小于 30 MB</li>
</ul>
<p><strong>传入单个视频要求</strong></p>
<ul>
<li>格式：mp4、mov</li>
<li>分辨率：480p、720p</li>
<li>时长：单个视频时长 [2, 15] s</li>
<li>尺寸：<ul>
<li>宽高比（宽/高）：[0.4, 2.5]</li>
<li>宽高长度（px）：[300, 6000]</li>
<li>总像素数：[640×640=409600, 834×1112=927408]，即宽和高的乘积符合 [409600, 927408] 的区间要求。</li>
</ul>
</li>
<li>大小：单个视频不超过 50 MB</li>
<li>帧率 (FPS)：[24, 60] </li>
</ul>
<p><strong>传入单个音频要求</strong></p>
<ul>
<li>格式：wav、mp3</li>
<li>时长：单个音频时长 [2, 15] s</li>
<li>大小：单个音频不超过 15 MB</li>
</ul>
</blockquote>
<hr>
<p><strong>ProjectName</strong>  <code>string</code> </p>
<p>资源所属的项目名称，默认值为<code>default</code>。</p>
<blockquote>
<p>说明：</p>
<p>需要和待传入的 Asset Group（素材资产组合）的 <strong>ProjectName</strong> 保持一致。</p>
</blockquote>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="CreateAsset%20%E8%BF%94%E5%9B%9E%E5%8F%82%E6%95%B0" name="CreateAsset%20%E8%BF%94%E5%9B%9E%E5%8F%82%E6%95%B0">CreateAsset 返回参数</h2>
<p><span id="Hrya4y9k"></span></p>
<p><strong>Id</strong>  <code>string</code> </p>
<p>Asset（素材资产）的 Id。</p>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="CreateAsset%20%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B" name="CreateAsset%20%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B">CreateAsset 调用示例</h2>
<p><span id="Hrya4y9k"></span></p>
<p>请求示例：</p>
<pre><code class="lang-Curl">curl https://modelpool-api.talkingdata.com/model/origin/assets/create?requestId=550e8400-e29b-41d4-a716-446655440000 \
  -H &quot;Content-Type: application/json&quot; \
  -H &quot;Authorization: Bearer $ARK_API_KEY&quot; \
  -H &quot;X-Timestamp: $TIMESTAMP&quot; \
  -d &#39;{
    &quot;GroupId&quot;: &quot;group-20260330162801-vmpfz&quot;,
    &quot;URL&quot;: &quot;https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png&quot;,
    &quot;AssetType&quot;: &quot;Image&quot;,
    &quot;ProjectName&quot;: &quot;default&quot;
  }&#39;
</code></pre>
<p>响应示例：</p>
<pre><code class="lang-Curl">{
  &quot;ResponseMetadata&quot;: {
    &quot;RequestId&quot;: &quot;20260330170834015124677667C190E71A&quot;,
    &quot;Action&quot;: &quot;CreateAsset&quot;,
    &quot;Version&quot;: &quot;2024-01-01&quot;,
    &quot;Service&quot;: &quot;ark&quot;,
    &quot;Region&quot;: &quot;cn-beijing&quot;
  },
  &quot;Result&quot;: {
    &quot;Id&quot;: &quot;asset-20260330170834-sztnw&quot;
  }
}
</code></pre>
<hr>
<p><span id="Hrya4y9k"></span></p>
<h1 id="GetAsset%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80" name="GetAsset%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80">GetAsset接口地址</h1>
<p><span id="Hrya4y9k"></span></p>
<p>获取单个Asset（素材资产）信息。</p>
<p><strong>请求方法：</strong> POST</p>
<p><strong>接口URL：</strong><code>https://modelpool-api.talkingdata.com/model/origin/assets/get?id={id}</code> </p>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="GetAsset%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0" name="GetAsset%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0">GetAsset请求参数</h2>
<p><span id="Hrya4y9k"></span></p>
<p><strong>id</strong> <code>string</code>  <span style="background-color: #ff6b6b; color: white; padding: 2px 6px; border-radius: 4px; font-family: monospace; font-weight: bold;">必选</span>   </p>
<p>Asset（素材资产）的 Id。</p>
<hr>
<p><strong>ProjectName</strong>  <code>string</code> </p>
<p>需要查询的 Asset（素材资产）所属的项目名称，默认值为<code>default</code>。</p>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="GetAsset%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0" name="GetAsset%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0">GetAsset响应参数</h2>
<p><span id="Hrya4y9k"></span></p>
<p><strong>id</strong>  <code>string</code>  </p>
<p>Asset（素材资产）的 Id。</p>
<hr>
<p><strong>Name</strong> <code>string</code>  </p>
<p>Asset（素材资产）的名称，上限为64个字符。</p>
<hr>
<p><strong>URL</strong>  <code>string</code>   </p>
<p>Asset（素材资产）的访问地址。有效期为12小时，请及时保存。</p>
<hr>
<p><strong>AssetType </strong> <code>string</code>   </p>
<p>Asset（素材资产）的类型，支持传入图像、音频、视频。支持类型：</p>
<ul>
<li>Image：Asset（素材资产）的类型为图像。</li>
<li>Video：Asset（素材资产）的类型为视频。</li>
<li>Audio：Asset（素材资产）的类型为音频。</li>
</ul>
<hr>
<p><strong>GroupId</strong> <code>string</code>   </p>
<p>Asset（素材资产）所属的 Asset Group（素材资产组合）的 Id。</p>
<hr>
<p><strong>Status</strong> <code>string</code>   </p>
<p>任务状态。</p>
<ul>
<li>Active：素材资产（Asset）已处理完毕，可以使用。</li>
<li>Processing：素材资产（Asset）正在预处理，无法使用。</li>
<li>Failed：素材资产（Asset）处理失败。</li>
</ul>
<hr>
<p><strong>Error</strong> <code>object</code>   </p>
<p>错误信息。</p>
<ul>
<li><p>Error.<strong>Code</strong> <code>string</code></p>
<p>错误码。</p>
</li>
<li><p>Error.<strong>Message</strong> <code>string</code></p>
<p>错误信息。</p>
</li>
</ul>
<hr>
<p><strong>CreateTime</strong>  <code>string</code>   </p>
<p>创建时间。</p>
<hr>
<p><strong>UpdateTime</strong>  <code>string</code>   </p>
<p>更新时间。</p>
<hr>
<p><strong>ProjectName</strong> <code>string</code>   </p>
<p>资源所属的项目名称。</p>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="GetAsset%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B" name="GetAsset%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B">GetAsset调用示例</h2>
<p><span id="Hrya4y9k"></span></p>
<p>请求示例：</p>
<pre><code class="lang-Curl">curl -X POST https://modelpool-api.talkingdata.com/model/origin/assets/get?id=asset-20260330170834-sztnw \
  -H &quot;Content-Type: application/json&quot; \
  -H &quot;Authorization: Bearer $ARK_API_KEY&quot;
</code></pre>
<p>响应示例：</p>
<pre><code>{
  &quot;ResponseMetadata&quot;: {
    &quot;RequestId&quot;: &quot;202603301710021FCA38407BEA3C9D496E&quot;,
    &quot;Action&quot;: &quot;GetAsset&quot;,
    &quot;Version&quot;: &quot;2024-01-01&quot;,
    &quot;Service&quot;: &quot;ark&quot;,
    &quot;Region&quot;: &quot;cn-beijing&quot;
  },
  &quot;Result&quot;: {
    &quot;Id&quot;: &quot;asset-20260330164126-dwr9q&quot;,
    &quot;Name&quot;: &quot;&quot;,
    &quot;URL&quot;: &quot;https://ark-media-asset.tos-cn-beijing.volces.com/2119573523/033016412675941755.png?X-Tos-Algorithm=TOS4-HMAC-SHA256&amp;X-Tos-Credential=AKTP0VyX37NH37peqQWqz0vNleVpZvM58z6cQT15hBwUrn%2F20260330%2Fcn-beijing%2Ftos%2Frequest&amp;X-Tos-Date=20260330T091002Z&amp;X-Tos-Expires=43200&amp;X-Tos-Security-Token=nChAzV1A5WUxXVDhQYU9QUTV2.CiQKEE1YckFYRHRqNlZDNU1XaW4SEAM4B3QKG0TOlZFEx2fbnL8Q9vanzgYYwseqzgYg-v3I6QcoBDCs7-stOh9Sb2xlRm9yQXJrQXNzZXQvUm9sZUZvckFya0Fzc2V0QgNhcmtSD1JvbGVGb3JBcmtBc3NldFgDegNhcms.BLNLgOJuUH1tMZrpnkgzWyMjFHK9P30fbYXV9z6879SwC5Opb9TSN_VqeramP6PFZ7NoBT6G9J3cvsmj8EDO-w&amp;X-Tos-Signature=55ee9760b494dd653ae197313262e279fa2ae0bc5b1108605cc97af707d94af7&amp;X-Tos-SignedHeaders=host&quot;,
    &quot;AssetType&quot;: &quot;Image&quot;,
    &quot;GroupId&quot;: &quot;group-20260330162801-vmpfz&quot;,
    &quot;Status&quot;: &quot;Active&quot;,
    &quot;CreateTime&quot;: &quot;2026-03-30T08:41:26Z&quot;,
    &quot;UpdateTime&quot;: &quot;2026-03-30T08:41:33Z&quot;,
    &quot;ProjectName&quot;: &quot;default&quot;
  }
}
</code></pre>]]></content:encoded>
      <pubDate>Thu, 09 Apr 2026 14:56:23 +0800</pubDate>
      <guid>http://doc.talkingdata.com/posts/1231</guid>
      <comments>http://doc.talkingdata.com/posts/1231#comments</comments>
    </item>
    <item>
      <title>TD云音1/MiniMax-speech-2.8-hd</title>
      <link>http://doc.talkingdata.com/posts/1230</link>
      <category>语音生成API</category>
      <author>liuxinmei</author>
      <description>云音1 接口说明文档 TD模型编号：T0311001 模型能力简介 云音1 同步配音：根据您输入的合成文本（Text） + 音色ID（可选） + 克隆音频（可选） + 参数（可选） 同步生成语音合成音频或克隆音色。支持多种语言、音频采样率调节、音调调节、音频时长控制等功能。文本长度不超过2000字符。接口同步返回音频Base64编码或URL（有效期24小时）。 鉴权说明  本接口仅支持API Key鉴权，需联系TD运维同学获取长效API Key。
 同步配音接口地址 请求方法： POST 接口URL：https://modelpool-api.talkingdata.com/model/orgin/job 请求头（Request Headers）： 头部字段 值 是否必需 说明 Author</description>
      <content:encoded><![CDATA[<h4 id="%3Cstrong%3E%E4%BA%91%E9%9F%B31%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3%3C%2Fstrong%3E" name="%3Cstrong%3E%E4%BA%91%E9%9F%B31%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3%3C%2Fstrong%3E"><strong>云音1 接口说明文档</strong></h4>
<p><strong>TD模型编号：T0311001</strong></p>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%A8%A1%E5%9E%8B%E8%83%BD%E5%8A%9B%E7%AE%80%E4%BB%8B" name="%E6%A8%A1%E5%9E%8B%E8%83%BD%E5%8A%9B%E7%AE%80%E4%BB%8B">模型能力简介</h2>
<p><span id="Hrya4y9k"></span></p>
<ul>
<li><strong>云音1</strong><ul>
<li><strong>同步配音</strong>：根据您输入的<strong>合成文本（Text）</strong> + <strong>音色ID（可选）</strong> + <strong>克隆音频（可选）</strong> + <strong>参数（可选）</strong> 同步生成语音合成音频或克隆音色。支持多种语言、音频采样率调节、音调调节、音频时长控制等功能。文本长度不超过2000字符。接口同步返回音频Base64编码或URL（有效期24小时）。</li>
</ul>
</li>
</ul>
<h5 id="%3Cstrong%3E%E9%89%B4%E6%9D%83%E8%AF%B4%E6%98%8E%3C%2Fstrong%3E%26nbsp%3B" name="%3Cstrong%3E%E9%89%B4%E6%9D%83%E8%AF%B4%E6%98%8E%3C%2Fstrong%3E%26nbsp%3B"><strong>鉴权说明</strong>&nbsp;</h5>
<pre><code>本接口仅支持API Key鉴权，需联系TD运维同学获取长效API Key。
</code></pre><hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E5%90%8C%E6%AD%A5%E9%85%8D%E9%9F%B3%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80" name="%E5%90%8C%E6%AD%A5%E9%85%8D%E9%9F%B3%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80">同步配音接口地址</h2>
<p><span id="Hrya4y9k"></span></p>
<p><strong>请求方法：</strong> POST</p>
<p><strong>接口URL：</strong><code>https://modelpool-api.talkingdata.com/model/orgin/job</code> </p>
<p><strong>请求头（Request Headers）：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">头部字段</th>
<th style="text-align:left">值</th>
<th style="text-align:left">是否必需</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>Authorization</code></td>
<td style="text-align:left"><code>Bearer &lt;your_api_key&gt;</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">API 鉴权凭证，请替换为有效的 API Key</td>
</tr>
<tr>
<td style="text-align:left"><code>X-Timestamp</code></td>
<td style="text-align:left"><code>1700000000</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">Unix 时间戳格式</td>
</tr>
<tr>
<td style="text-align:left"><code>Content-Type</code></td>
<td style="text-align:left"><code>application/json</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">请求体格式必须为 JSON</td>
</tr>
<tr>
<td style="text-align:left"><code>X-TC-Action</code></td>
<td style="text-align:left"><code>T0311001</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">固定值</td>
</tr>
</tbody>
</table>
<p><strong>请求参数（Request  Parameter）：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">字段</th>
<th style="text-align:left">值</th>
<th style="text-align:left">是否必需</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>requestld</code></td>
<td style="text-align:left"><code>550e8400-e29b-41d4-a716-446655440000</code></td>
<td style="text-align:left">否</td>
<td style="text-align:left">请求唯一标识符。使用 UUID 格式字符串，用于跟踪和排查请求相关问题，以便在需要技术排查时，提供此 ID 可快速定位具体请求的完整处理链路和日志信息。</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E5%90%8C%E6%AD%A5%E9%85%8D%E9%9F%B3%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0" name="%E5%90%8C%E6%AD%A5%E9%85%8D%E9%9F%B3%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0">同步配音请求参数</h2>
<p><span id="Hrya4y9k"></span></p>
<h3 id="%E5%90%8C%E6%AD%A5%E9%85%8D%E9%9F%B3%E8%AF%B7%E6%B1%82%E4%BD%93%EF%BC%88requestBody%EF%BC%89" name="%E5%90%8C%E6%AD%A5%E9%85%8D%E9%9F%B3%E8%AF%B7%E6%B1%82%E4%BD%93%EF%BC%88requestBody%EF%BC%89">同步配音请求体（requestBody）</h3>
<table>
<thead>
<tr>
<th style="text-align:left">参数</th>
<th style="text-align:left">类型</th>
<th style="text-align:left">必选</th>
<th style="text-align:left">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>Text</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">合成文本，语音合成时必填。文本长度不超过2000字符</td>
</tr>
<tr>
<td style="text-align:left"><code>TextLang</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">文本语言，不填默认中文（<code>zh</code>）。支持多种语言，详见支持的语言列表。</td>
</tr>
<tr>
<td style="text-align:left"><code>VoiceId</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">音色ID，指定音色合成时填写。支持系统音色和克隆音色</td>
</tr>
<tr>
<td style="text-align:left"><code>AudioData</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">克隆音频的Base64编码。<code>AudioData</code> 和 <code>AudioUrl</code> 提供一个即可</td>
</tr>
<tr>
<td style="text-align:left"><code>AudioUrl</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">克隆音频的URL地址。<code>AudioData</code> 和 <code>AudioUrl</code> 提供一个即可</td>
</tr>
<tr>
<td style="text-align:left"><code>AudioLang</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">克隆音频语言，默认中文。支持的语言同 <code>TextLang</code></td>
</tr>
<tr>
<td style="text-align:left"><code>Output</code></td>
<td style="text-align:left">Object</td>
<td style="text-align:left">否</td>
<td style="text-align:left">输出相关参数，可以指定输出形式等</td>
</tr>
<tr>
<td style="text-align:left"><code>ExtParam</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">扩展参数，JSON字符串格式。支持以下子参数： - <code>synExt.duration</code>：合成音频时长（秒） - <code>synExt.sampleRate</code>：合成音频采样率，默认16000，支持8000/16000/22050/32000/44100 - <code>synExt.pitch</code>：音调，默认0（原音色），取值[-12, 12] - <code>cloneExt.timeRanges</code>：指定克隆音频时间范围，默认<code>[[0, 20]]</code></td>
</tr>
</tbody>
</table>
<h2 id="%E5%90%8C%E6%AD%A5%E9%85%8D%E9%9F%B3%E8%BF%94%E5%9B%9E%E5%8F%82%E6%95%B0" name="%E5%90%8C%E6%AD%A5%E9%85%8D%E9%9F%B3%E8%BF%94%E5%9B%9E%E5%8F%82%E6%95%B0">同步配音返回参数</h2>
<table>
<thead>
<tr>
<th style="text-align:left">参数</th>
<th style="text-align:left">类型</th>
<th style="text-align:left">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>ErrorCode</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">错误码，成功时返回 <code>0</code></td>
</tr>
<tr>
<td style="text-align:left"><code>Msg</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">错误信息，成功时返回 <code>&quot;success&quot;</code></td>
</tr>
<tr>
<td style="text-align:left"><code>AudioData</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">合成音频的Base64编码，WAV格式。</td>
</tr>
<tr>
<td style="text-align:left"><code>AudioUrl</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">合成音频的URL地址，有效期24小时。</td>
</tr>
<tr>
<td style="text-align:left"><code>VoiceId</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">克隆的音色ID。</td>
</tr>
<tr>
<td style="text-align:left"><code>ExtInfo</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">扩展信息，JSON字符串格式。包含 <code>duration</code>（结果音频时长，单位秒）</td>
</tr>
<tr>
<td style="text-align:left"><code>RequestId</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">唯一请求ID，由服务端生成，用于问题定位</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E5%90%8C%E6%AD%A5%E9%85%8D%E9%9F%B3%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B" name="%E5%90%8C%E6%AD%A5%E9%85%8D%E9%9F%B3%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B">同步配音调用示例</h2>
<p><span id="Hrya4y9k"></span></p>
<p>请求示例：</p>
<pre><code class="lang-Curl">curl -X POST &#39;https://modelpool-api.talkingdata.com/model/orgin/job?requestId=550e8400-e29b-41d4-a716-446655440000&#39; \
  -H &#39;Content-Type: application/json&#39; \
  -H &#39;Authorization: Bearer YOUR_API_KEY&#39; \
  -H &#39;X-Timestamp: 1760000000&#39; \
  -H &#39;X-TC-Action: T0311001&#39; \
  -d &#39;{
    &quot;Text&quot;: &quot;你好&quot;,
    &quot;VoiceId&quot;: &quot;s1_2GSzVAf00hl7+A+LJTNvVI6nFJB0qliIvR8wntPeaniVSstd7Z4E4UL8Hky3azMHVlDSps1zWW4nJ7ll9w==&quot;,
    &quot;ExtParam&quot;: &quot;{\&quot;engine\&quot;: \&quot;\&quot;}&quot;
}&#39;
</code></pre>
<p>响应示例：</p>
<pre><code>{
    &quot;Response&quot;: {
        &quot;AudioData&quot;: &quot;UklGRuxnAABXQVZFZm10IBAAAAABAAEAgD4AAAB9AAACABAAZGF0YchnAABBAEUAQwBFAEgARwBJAEkASQBOAEwASABKAEkASgBJAEgASABMAEoASABIAEgASgBIAEkASQBIAEkASABHAEcASABIAEoASABJAEgARwBKAEoASABFAEkASQBIAEYARwBHAEgARwBIAEYARgBFAEUARABFAEcARQBEAEQARQBEAEQARABEAEUARQBDAEMARQBDAEMAQQBBAEMAQAA/AEAAQAA/AEAAQgA/AEAAQgA/AD8APwA+AD8APQA7AD0APQA9ADoAOgA7ADoAOgA9ADwAOwA6ADkAOQA3ADgAOQA3ADgANwA4ADgANwA2ADcANwA3ADcANwA1ADQANgA1ADQANAA1ADUANQA1ADMAMwAzADUAMgAyADMAMwAzADIAMgAwADEAMQAxADEAMAAvADEALwAyADAALwAxAC8AMQAwAC0ALAAtAC0ALAAtAC8ALAAsAC4ALgAsAC0ALAAqACoAKwAqACoAKwArACoAKgApACkAKQAoACcAKAAoACYAJwAnACcAJgAmACYAJgAmACQAJAAkACMAJAAjACQAJQAlACMAIwAjACMAIwAkACQAIgAhACIAIgAhACEAIgAjACEAIgAiAB8AIQAgACAAIQAhACAAIAAhAB8AIAAgACAAIAAfAB8AIAAgAB0AIAAgAB8AHgAfAB8AHwAfAB4AHgAdABwAHQAdAB0AGwAcABwAGwAcABwAHAAcABwAGwAbABsAHQAdABsAGwAbABwAHgAcABsAHQAcABoAGQAaABwAHAAZABkAGAAaABoAGQAZABgAFwAZABoAGAAXABgAGQAYABkAGQAWABgAGAAYABcAGAAXABkAGgAWABUAGAAaABcAFgAXABUAFwAYABgAGAAWABYAFgAaABkAFwAVABcAFgAWABcAFwAWABYAFgAWABUAEwAVABYAFQAXABcAFwAWABUAFQAVABcAFwAWABgAFQATABUAFQAXABcAFwAWABcAFQAWABYAFQAVABYAFQAVABYAFAAWABUAFQAWABUAFgAXABUAFwAXABcAFgAWABUAFAAUABcAFgATABUAFQATABUAEwARABQAEwATABUAFQAVABQAFgATABEAFAASABQAFAATABIAEQATABUAEwASABMAEAAUABMADwATABMAFAAQABEAEwARABEAEQARABEAEQARABEAEAAPABEAEQARAA8ADwARABAADwAPAA8AEQARAA8ADwAQABEAEQASAA8ADgAPAA8ADwAPAA8ADwAPAA8ADwAQAA8ADQANAA0ADAANAA0ADAAMAAsACwAKAAwADAALAAsADAANAAwADQANAAsACwALAAsACwALAAsACwALAAsACwALAAkACwAKAAcABwAFAAUABQAFAAMAAgAEAAIAAgABAAEAAQABAAEAAgACAAEAAwAAAAEAAAD/////AAD//wAAAAD//wAAAQAAAAAAAAD//wAA//8AAAAA//8AAAAAAAD//wAAAAAAAAEAAQAAAAAA/////wAA//8AAAAAAAD//wAA//////3//f/7//v/+f/5//n/+v/7//j/9//4//b/9//2//X/9f/0//P/8//x//L/9P/z//D/8v/x//L/8v/x//H/8v/x//D/8f/x//D/8f/v//P/8//x//L/8v/x//L/8//z//X/8//x//L/8f/0//T/9P/z//P/9P/z//P/9f/1//X/9P/0//T/8//0//T/8//1//P/9P/z//T/9f/1//X/8//1//X/9f/1//P/9P/1//X/9f/z//X/9f/1//X/9f/2//j/9f/2//b/9v/3//j/+P/3//b/9v/4//j/+P/5//f/+P/5//n/+//4//r/+//7//v/+//7//v//P/7//v/+//8//7//v/+////AAD//wEA//8AAAEAAAABAAEAAwACAAEAAwAEAAYABQAFAAUABgAFAAYABwAGAAYABgAGAAgACAAJAAoACgALAAsADQANAA4ADgANAA8AEAASABIAEgATABIAFAAUABQAFQAWABcAGAAYABcAGgAbABsAGwAdABoAHAAeAB8AIAAgACIAIgAiACIAIwAjACUAJQAmACUAJwAmACcAKAApACkAKAAqACsALAAqACwALQAtAC8AMQAvAC8AMQAxADEAMwAzADQANQA1ADUANAA2ADcANwA3ADcAOQA4ADkAOQA7ADsAPAA9ADsAPQA9AD8APQA+AD8APgA/AEEAQAA/AEEAQQBDAEIARQBEAEQARQBFAEQARABGAEYARgBHAEcASQBJAEoASgBKAEoASgBLAE0ASwBMAEwASgBNAE4ATQBNAE0ATwBPAE4ATQBPAE8ATwBRAFEATwBQAFMAUgBRAFEAUQBSAFIAUwBTAFMAVABUAFUAVABTAFMAVABTAFcAVgBTAFUAVABVAFYAVgBVAFUAVQBVAFUAVQBWAFUAVABTAFYAUwBWAFUAUwBUAFUAVQBVAFUAVgBWAFYAVQBUAFQAVgBVAFUAVABTAFMAVABWAFQAUwBTAFUAUwBUAFUAVABXAFUAVQBUAFMAVABUAFQAUgBTAFMAVABUAFMAUwBRAFEAUwBTAFEAUgBTAFIAUABQAFAATgBOAFAATgBPAE8ATgBPAE0ATQBPAEwATQBOAEwASwBLAE0ASwBJAEoASQBLAEsASQBJAEgASABHAEgASQBHAEkASABIAEYARQBGAEUARQBFAEQARABDAEQAQwBDAEMAQQBCAEIAQwBCAEEAQQBAAD4AQQA/AD8AQAA/AD8AQABAAD4APwA/AD4APQA8AD0AQAA9ADsAOwA6ADoAOQA5ADgAOAA4ADkAOQA5ADcANgA3ADcANwA3ADUANgA2ADUANwA2ADUAMwAyADIAMQAzADEAMQAxADEAMQAxAC8ALwAvAC8AMAAvAC8ALgAvAC8ALwAuAC0ALQAsAC4AKwArACkALAAtACgAKwApACgAKgAoACkAKgApACkAKQAnACcAJgAnACgAJgAnACYAJgAmACYAJQAkACUAJgAmACQAJAAjACIAIwAjACIAJAAjACIAIgAjACIAIQAhACEAIgAiACEAIQAiACIAIAAhACEAIAAeAB8AIQAgAB8AHwAeAB4AHwAeAB8AHwAeAB4AHwAfACAAIQAfAB4AHQAfAB8AHwAdAB0AHgAdAB4AHgAfAB8AHQAeAB8AHgAeAB0AHgAeABwAHQAfAB0AHAAeAB0AHgAeAB0AHAAdABwAHAAdAB0AHQAdAB0AHgAcAB0AHgAfAB4AHwAgAB8AHwAgAB4AIAAfACAAIAAhACIAHgAfAB8AIAAjACIAIAAfACEAIgAhACAAIQAjACIAIgAkACUAJQAkACUAJgAmACQAJQAlACcAJQAmACYAJQAnACcAJwAoACYAJwApACgAKAApACgAKAApACgAKAAqACkAKgArACsALAAsACwAKwAsAC4ALAAsAC4ALwAyAC4ALwAxAC8ALwAxADAAMgAxAC8AMgAzADEAMwAzADMAMwA0ADQAMwA0ADMANgA1ADIANQA2ADUAOAA2ADcAOQA4ADkANQA3ADkAOgA5ADgAOQA7ADwAPAA8ADwAPgA+AD0APgA/AD4AQAA+AD4AQAA/AEEAQQBBAEEAQQBBAEMAQwBCAEQAQwBEAEQAQwBDAEQARQBFAEMARABFAEUARQBGAEUARgBGAEcARwBJAEgASABIAEkASQBJAEkASQBLAEoASgBLAEsASwBLAEwASwBMAEwATwBPAE0ATQBNAFAATwBPAFAATwBOAFAAUQBRAE8AUQBQAFAAUgBQAFEAUABQAFEAUQBRAFEAUQBSAFUAUgBSAFQAVQBVAFMAVgBXAFUAUwBUAFYAVABTAFUAVgBVAFYAVQBXAFcAVwBYAFYAVwBaAFcAVgBYAFgAWABWAFgAVwBXAFgAVwBYAFgAWQBYAFgAVwBYAFcAVwBaAFgAVwBYAFgAWwBZAFgAWQBXAFcAVwBZAFkAWQBaAFkAWgBaAFsAWQBaAFoAWQBZAFgAWABZAFkAWgBaAFkAWwBbAFoAWgBaAFkAWwBZAFkAWQBaAFoAWwBaAFgAWgBZAFgAWQBZAFkAWQBYAFsAWgBYAFgAWQBZAFoAWABXAFgAWABXAFgAWABYAFkAVgBYAFgAVgBYAFkAWABYAFkAWABXAFcAWABXAFkAWABVAFcAVwBXAFYAVgBVAFgAVwBUAFcAVgBXAFYAVQBVAFUAVQBXAFQAVQBUAFQAVQBVAFQAVABTAFQAUgBSAFIAUwBTAFIAUABPAFAATgBSAFAATQBQAE4AUQBQAE8AUQBPAE8AUABQAFAATgBRAE8ATwBQAE4AUQBPAE0ATgBNAEwATQBNAE4ATgBMAEsASwBMAEsASwBMAEsASwBMAEwASwBKAEgASgBLAEkASgBJAEYARwBIAEYASABIAEcARwBHAEcARgBGAEcARQBFAEQARABHAEcARQBEAEUARQBEAEUARABDAEQAQwBDAEQAQgBCAEMAQwBAAEEAQABAAEIAQQBBAEAAQABAAD8AQAA/AD8AQABBAD8APgA+AD0APgA9AD0APQA+AD4AOgA+ADsAOwA7ADoAOwA7ADgAOgA6ADcAOQA4ADgAOAA4ADYANwA2ADcANwA2ADcANgA0ADYANQA1ADQANAA1ADUANQA1ADYANQA0ADQANAA0ADQAMwAzADMAMQAyADAAMQAxADEALwAwADAALQAxADAALwAvAC4ALwAtAC0ALQAsACwALAAsACwALAArACkAKQApACoALAApACgAJwApACcAJgAqACcAKQAnACcAJwAlACYAJQAlACcAJQAmACUAIwAjACUAJQAkACUAJQAkACUAIwAkACQAIQAiACIAIgAhACAAIAAfACEAHgAgACEAIQAgACEAHgAfAB8AHQAcAB0AHQAfABwAGwAcABwAGwAcABwAGwAbABsAGgAbABwAHQAaABcAGAAaABoAGQAXABgAGQAZABkAFgAXABcAFgAUABYAFgAUABQAFQAXABQAEwATABMAFAARABEAEQARABEAEQARABAAEAAQAA8ADwAQAA8ADgAPAA4ADgAOAA8ADgAOAA8ADgANAA4ADQALAAsADAALAAwADAAMAAsACwAJAAcADQAKAAkABwAHAAcABwAKAAkABwAHAAYABgAHAAUABwAGAAUABQAFAAYABwADAAQABgAFAAIAAgAEAAQABQACAAIAAwACAAEAAQABAAEAAgACAAIA//8CAAIAAAAAAAAAAAAAAAEAAAAAAAAAAAD/////AAAAAP////8AAP7//f///////v/9//7//v/9/////v/9//7//P/7//v/+//8//v/+//6//n/+v/6//v/+//7//v/+f/5//n/+f/5//n/+f/5//n/+f/5//n/+f/5//n/+f/5//f/9//5//j/+P/3//j/+P/5//f/9f/4//j/9v/2//f/9//2//b/9//3//j/+P/4//f/+P/3//b/+f/3//b/9//3//n/9//2//f/9//3//b/9P/2//X/9v/0//T/9f/1//X/9f/1//b/9//1//X/9v/3//X/9f/1//f/9//3//f/9v/1//j/+f/3//f/9//3//f/9//3//f/9f/1//f/9//1//X/9f/2//f/9//1//X/9v/2//f/9//2//b/+f/3//f/9//3//j/9//3//f/+P/5//f//P/7//n/+f/6//r/+f/5//j/+v/6//z/+f/3//j/+P/5//n/+v/3//f/+f/5//n/+P/5//j/+//7//r/+f/5//n/+//8//n/+f/8//3//P/6//j/+//9//3//f/9//3//f///////v/9/////f/+//7///////3//f/8//z//v/+//7////+/wAAAQD/////AAD//wAA//8AAAAAAAAAAP////8AAAAAAAAAAAAAAAD///////8AAAAAAAD//wAAAAAAAAEAAAAAAAAAAQABAAEAAQAAAAEAAAACAAMAAAAAAAEAAwACAAEAAQAAAAEAAgABAAEAAQABAAIAAQABAAEABAADAAQAAgABAAMAAwABAAEAAgABAAMAAwACAAIABAAEAAQAAwACAAMABAAEAAYAAwAFAAYABQAGAAMABQAEAAUABQAFAAQABQAGAAUABAAFAAMABQAEAAUABQAEAAUAAQAHAAYABQAFAAQABwAHAAYABwAHAAUABwAJAAYABQAIAAgABgAEAAcABwAGAAgACAAGAAUABgAGAAcABgAFAAcABQAIAAgABwAIAAgABQAHAAgACAAJAAkACQAGAAYACAAKAAkABwAIAAkABwAIAAgABwAIAAkACAAHAAcABwAIAAYACAAHAAcACQAJAAgACAAKAAkABwAHAAgABwAIAAcABwAJAAoACAAJAAkABwAHAAcACAAHAAgACQAHAAcABwAJAAkACQAHAAgACAAIAAYABgAHAAcACQAHAAgACgAIAAcACQAIAAgACAAJAAcABwAIAAcABwAHAAkACQAHAAcACQAJAAcACgALAAoACQAJAAkACQAJAAoACQAKAAoACQAJAAoACgAKAAoACgAIAAYABgAIAAgACQAJAAkACQAKAAgACAAJAAkACQAJAAkACQAJAAkACAALAAgACAALAAoACQAKAAwACwAIAAoACwAKAAoACgAJAAkACgAKAAsACQAKAAkACQAJAAoACQAKAAoACQAJAAoACQAIAAoACQAKAAkACQAJAAkABwAIAAkACgAJAAoACQAJAAkACQAJAAoACQAHAAsACgAKAAoACAAKAAkACgALAAsACwAKAAwADQANAAsADAALAAsADAALAAsADAALAAwACwALAAwADAAMAAsACwAKAAwACgAMAAsACQANAA4ADQAOAA0ADgAOAA0ACwAMAAwADQANAAsADQANAAwADgAMAAwADQANAA4ADQALAA0ADgALAAwADQANAAwADQANAA4ADQALAA0ADQAPAA8ADQAOABAADwAOAA4ADwAPABAAEAAQAA8ADwATABIAEQAQAA8AEQAQABAAEwAQAA8ADwAPABEAEQASABMAEQASABIAEgAUABMAEQATABQAEwATABMAEgASABMAFAAVABMAEwATABMAEwAUABIAEQAUABIAEAAPABEAFAAQABEAFQATABMAEwASABMAEQATABQAFAAUABIAFwAWABMAFQAWABUAFAAXABYAFgAWABcAFwAWABcAFgAXABYAGAAWABcAFgAWABgAFQAXABgAFgAVABgAGQAZABkAGAAYABgAGgAZABYAGAAZABoAGAAXABcAGAAZABgAFwAYABwAGAAZABgAFwAaABsAGQAaABcAGgAcABoAGgAaABsAGgAcABwAGwAZABwAHQAdABwAHwAfAB8AHQAdAB0AHQAfAB8AHQAcAB0AHQAdAB0AHwAeACAAIQAdAB4AIAAfAB0AHgAfAB4AHgAdAB4AHgAeAB0AHwAdAB0AHgAcABwAHQAdAB0AHgAfAB8AHQAfACAAHwAdAB0AIAAeAB0AHgAfAB8AHwAdAB0AHwAgACAAIQAhAB8AIAAgACEAIQAfAB8AIQAhACAAIQAhACIAIgAeACAAHwAgACIAIAAhACEAIQAhACIAIgAhACEAIgAiACEAIAAeACAAIAAiACIAIAAhACEAIAAgAB8AHQAeACAAIQAgAB8AHwAeAB4AHQAeAB8AHgAdAB4AHQAeACEAHgAdABwAHQAeAB0AHQAdAB8AHQAdABsAHAAdABsAHAAdABwAHAAaABwAGgAaABsAGgAdABoAGgAcABwAGgAaABkAGgAaABkAGwAbABoAGQAZABoAGwAbABkAGgAYABgAGgAXABYAGQAXABkAGQAZABgAFwAXABcAFwAWABYAFgATABcAFgAVABcAFQAVABQAFAAWABQAEgATABIAEgATABMAFAATABMAEgAQABIAEQAPABEAEAAPABEADwAPAA8ADwAPABEADwAPAA4ADwAOAAwADwAOAA8ADAAMAA0ACwAMAAsACwAJAAsACwAIAAgACQALAAgACgAJAAgACgAHAAgACAAJAAgACgAIAAkACQAIAAoACQAHAAYABQAFAAYABgAFAAMAAwAFAAcABQAEAAMABQAEAAMAAwADAAMABAADAAMAAgADAAIAAgABAAAAAQAAAAAAAQABAAEAAAAAAAAAAAD/////AAAAAAEAAAD//wAA/v/8//7///8AAP///f/9//v/+//+/////P/+//3//P////r/+//9//3//v/6//r/+//8//z//P/7//v/+//7//n/+f/7//v/+f/5//n/9//3//n/+P/4//n/9//3//f/+f/4//n/+P/3//j/+P/2//f/9v/2//b/9//2//b/9//3//b/+P/2//b/9//2//b/9v/1//f/9v/3//b/9//1//b/9f/2//b/9f/1//b/9v/1//f/9//3//n/9//2//f/9v/2//T/9f/0//T/9v/1//b/9//3//b/9//1//X/9P/1//f/9v/0//b/9//2//f/9P/1//f/9//3//b/9v/4//j/9v/2//f/9//4//b/+f/4//f/+P/3//f/+P/3//f/9//4//j/9f/4//j/+P/5//n/+//6//n/+//7//r/+v/7//v/+//6//v/+f/8//v/+v/6//z//v/8//z//P/7//3//v/+//3//v////7//v/+//3//v/8//3////9/////v/9///////+/////v/+////////////AAAAAAAA/////////////wAAAAAAAAEAAQABAAEAAgACAAIAAgADAAEAAQACAAMAAwABAAIAAwACAAIAAQADAAMABAAFAAUABQAEAAUABgAFAAMABAAFAAMABgAGAAUABgAFAAYABwAGAAYACwAJAAgACAAGAAcACQAJAAcACgAJAAoACwAJAAkACQAJAAkACQAJAAoACwAJAAoACgAKAAkACQAJAAkACQAJAAoACwAJAAoACgALAAsACwAJAAcACQAKAAsADAAMAAwADQAMAAwADQANAAwADQAMAAwACwALAA8ADgAPAA4ADQANAA0ADQANAA8ADgAPAA0ACwAMAA0ADQANAAwADQAMAA4ADwANAA0ADAANAA8ADQANAAsADAAPAA8ADQAOAA4ADwANAA4AEAAOAA0ADQAMAA0ADQAOAA8ADgANAA0ADwAPAA8ADwANAA0ADQAMAAwADAANAAsACwAMAAwADAALAAwADQAMAA0ACwAKAAsACwAJAAkACQALAAsACwALAAsACwALAAsACQAKAAsACgAJAAkACQAKAAsACwAJAAkACQALAAsACQALAAkACwALAAwACQAJAAkACwALAAsACQAHAAkACQAJAAkACAAHAAcABgAGAAcABwAHAAgACAAHAAkACQAHAAUABAAFAAcABAADAAUABAAEAAUABQAFAAUABgAFAAMAAwAFAAYABAAEAAQABQAFAAUABgAFAAUABwAFAAgABgAGAAcABgAIAAYAAwAGAAYABQAEAAMABAADAAMABAAEAAMAAwAFAAMAAwACAAMAAQAAAAEAAAABAAEAAQABAAEAAQABAAAAAQAAAP//AQAAAAAAAAAAAAAA/////wAAAAAAAAAAAAABAAAAAwACAAEAAwADAAEAAQACAAAA///8//7///////////8AAP////8BAAAA//8AAAAAAgACAP//AQAAAP//AAD///7//v/8//7//v/+//////8AAP7//////wAAAAAAAP///v/+//v//P/8//3//f////3//v////7//////wAA/v/+/////P/9//7//f/+//3/////////AAAAAPz/+//9//3//P/9/////////wAAAQD//////////////f/6//z/+//8//z/+//7//v//P/8//z//f/+//z//f/5//r/+//5//n/+//8//3////9///////9//7//v8AAP3//f/+//r//f/8//j/+v/6//n/+//4//v//P/9/////v8AAP////8AAP7//f/9//3////9//7/AAD////////+//z/+v/7//n/+P/1//f/9//3//j/+f/6//3//P/9//z//f/7//v/+//7//v/+f/9/////v8CAAMAAQD///3/+v/5//f/9f/1//r/+v/+/wAAAAADAAIAAgD///v/+P/2//b/9//3//j/+/8AAAEAAgADAAAAAAD+//r/9v/2//X/9f/6//z/AAABAAQABgAGAAMAAgD+//r/9//2//X/8//1//j/+P/8//v//f8AAAAAAAAAAP//AAD9//3//f/9//3/+v/+//r/+//4//v/+f/4//r//P/7//3/AAACAAIABAAFAAMAAQD9//v/9f/z//L/7//u/+//8//3//b/9v/8/wAAAAACAP///f/5//f/8v/y//L/8v/5//v//v8AAAEAAwAAAP7////6//r/+v/3//j/+P///wEABgAGAAQAAwABAAAA9f/0//H/8v/1//T/+f/9/wMABQAGAAEA///+//z/9P/0/+//8P/1//n//f/+/wAABQAAAAEA/v/6//n/9P/w//D/8v/2//j//P8AAAAABgAEAAQAAQD///r/+//3//b/9//2/wAA/f8BAP//BAD/////+f/6//n/8f/5//n/AQD8/wMAAQAEAAIAAgACAPv//P/2//j/8P/1//P/9v/6//v//P/4//7/+f/6//r/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EgAmAD8ATABIAEYAOAAaAAcA9v/4/+v/8f8DAAcAGwAqADUANwAxADIAIQAVABEACAAHAAcAGQAYACkAJQANAAcA4//N/6H/lf+Q/33/if+i/7n/xf/e//T/6f/P/9T/vv+e/57/o/+u/6//3v8DAP3/GQAeAAwA6//Z/+r/0P/Y/wwAGwA5AFAAdQB1AGgAeABgAEUALgAfABUABQAQABQAHgAtACsAMAAqABwACgDz/+z/3//j//b///8QABkAHgAQAAQA+P/c/9P/yv/M/9X/5f/8/wYAEgAPAAoAAgDs/+3/5P/d/+D/7P/2//T//f8FAP7/7//v/+z/4f/c/+b/7v/p//r/AwAIAAsAEQAWAAcAAQAAAAEA/P8BAA0AFQAgACMAMgAvAB8AHAAQAP3/9P/x//f/+f8HAB4ALQA4ADsANQAmABYABgD0/+v/5//l/+3/9f/5//z/AAD+//T/6f/g/9P/yv/U/9v/2P/l//P/8//2//r/+v/t/+z/9//t//L/+v8DAAEACgAZAA0ACwARAAwAAAD//wEA/P/7/wsAEAATACEAIgAdABsAGwASAA0AEgAOAAwAEQAWAA4AFAAXAA0ACAADAAAA8f/r/+//4//h/+j/7//3/wAABgAKAAMAAAD2/+f/4f/b/9v/3v/k//H/+f/+////AAD///3//f8BAAAAAgAJAAUACQAMAA4ADQAFAAcAAQD5//n/8//s/+n/5v/i/93/4f/l/+L/5v/u//H/8P/x//n/9//6/wAAAQAHABAAEgASABgAGQAZABkAFwAaABkAGwAeABoAGQAVABEADAAKAAYAAAABAP//+v/3//P/9f/z//D/9f/1//P/9f/8////AAD/////+//3/////v/8/wAAAQAGAAUABwAJAAQAAQAAAP/////+//r/9f/t/+f/4P/b/9//5P/o//D/+P/9////AAAAAPv/+//8//z///8CAAUACAANABAADgANABAAEAAQAA4ADQAPABEAGAAVABQAFgAOAAgAAgD///f/8//z/+//7v/w//H/8P/v//H/7f/p/+n/6P/m/+f/6v/t//D/8f/y//X/9v/2//X/9P/z//X/9f/2//X/+f///wEAAQADAAYABwAHAAkACQAGAAcABwAIAAkACQAIAAYABQABAAAA///9//v/+v/9//3//v8AAAEAAAD//wAA/v/9//3//f8AAAAAAgADAAIABAACAAMAAwABAAAA///8//n/9P/z//L/7v/u/+7/6v/r/+r/5f/k/+L/3v/b/93/3//h/+X/6v/u//P/9//6//3//v/+////AAAAAAMABAAEAAYABwAIAAoADwAQAA4ADwAPAA4ADAAMAAkACQAIAAgABgACAAMAAwADAAEAAAABAAEAAQABAAEAAAAAAP3//f/7//j/9v/1//T/8//x/+7/7P/o/+b/4//i/+H/4v/g/97/3//g/+H/4v/j/+T/5//p/+v/7v/y//T/+f/7//3/AQABAAUABgAIAAsACwAOABIAEwAWABUAEwARABEAEQAMAAwACgAIAAYAAwABAP///v/+//v/9//2//L/7//x/+7/7f/s/+z/6//r/+3/7f/t/+7/6//r/+r/6f/q/+f/5//p/+v/6P/p/+b/5f/l/+T/5f/l/+X/5//q/+v/7v/x//L/9//6//v//f/+/wEAAwAFAAkADAAOAA8AEQATABMAEwATABQAEQATAA8ADQAMAAkABQAAAP//+//7//n/9f/y//D/7f/t/+v/6P/o/+f/5f/k/+X/5f/m/+f/6f/o/+f/6//t/+3/7//x//H/8//z//P/8v/y//P/9f/z//L/9P/2//X/+P/4//n/+v/7//3//v8AAAAAAwAEAAYABQAHAAkACQAJAAsACwALAA0ADAANAAsACQAJAAgABQAEAAIAAAD//////f/5//n/+P/2//X/9v/0//T/9v/3//b/9P/0//X/8//0//P/8//z//L/8f/w//H/8//y//H/8//x//P/8f/0//T/8//1//P/9f/3//f/9//7//3///8AAAMABQAHAAkADQAPAA4AEQASABQAFAAVABcAFQAZABgAFwAXABUAFQATABMAEQAOAAwACQAGAAQAAgABAAEA//////z/+v/5//f/9//2//b/9v/1//X/8//z//L/8v/0//P/8//0//T/9f/1//T/9//3//X/9//4//j/+//8//3///8AAAEABAAGAAcACQALAA0ADwAPABEAFAAVABcAGQAbAB0AHQAdAB4AHwAdABsAGwAaABcAFwATABIAEQAOAAwACAAFAAQAAgD///7/+//3//f/9P/1//T/8v/w//H/8f/x//L/8f/v//D/8P/y//H/8//1//T/9v/6//n/+v/+////AQADAAMABgAIAAkACwAOAA4AEgATABEAFgAWABgAGAAaABoAGgAZABsAGgAXABkAFwAXABcAFQAUABEADwAMAAsACAAHAAQAAgABAAAA/v/6//n/+P/2//X/8v/x//H/8f/y//L/8P/u/+//7//v//L/8P/y//X/9f/2//j/+f/9////AAAAAAIAAwAEAAgACgALAA0ADQAPABEAEAAQABIAEgARABMAEQASABQAEgARABIAEQAQAA0ACwALAAsACgAIAAcABQAFAAQAAQABAP/////+//z//f/5//n/+f/4//b/9P/0//L/8//z//H/8//x//L/8v/y//P/8//1//X/9v/3//j/+//7//7//////wEAAQADAAcABwAHAAkACwAMAA0ADQANAA0ADQAMAAsADAAMAAsACwAKAAgACwAHAAYABAACAAQAAQAAAAAAAAAAAP7/+//7//v/+v/4//f/9//3//f/9v/2//T/9P/z//T/8v/x//L/8f/y//L/8f/x/+//8v/z//L/8//0//b/9v/3//f/+P/5//n/+v/7//v//f/+////AAAAAP//AQADAAIAAQABAAIABAADAAAAAQABAAEAAAABAP/////////////8//v/+v/5//r/+f/5//n/+P/1//X/9f/2//T/8//z//H/8//v//D/8v/v//H/7v/t/+//7//t/+3/7v/u/+//7v/v/+7/7//v//D/8P/x//T/9P/1//T/9v/3//j/9//5//v/+//6//v/+//7//v//v/+//7//f////////8AAP7///8AAP3/AAAAAP///v/8//////////7/+//7//z/+//7//n/+f/4//T/9f/z//L/9f/0//H/8v/y//D/8P/v/+//7v/t/+7/7f/t/+3/7v/w/+7/7f/v/+//7//w//D/9P/z//P/9f/1//f/+f/6//z/+//5//z//f///wAA//8AAAAAAAACAAIAAgACAAIAAwAFAAMABAADAAQABQABAAQAAQABAAEAAAD////////////////+//3//P/9//v/+//9//v/+//7//z//f/7//z//P/7//7//f/9//3//f///wAA//8AAAEAAAABAAEAAQACAAIAAAADAAQABAAFAAUABwAHAAgACQAIAAgACgAKAAwADAAIAAwACwAKAAsACgAKAAsACgAJAAkACgAJAAkACwALAAoACAAHAAgACAAJAAcABwAGAAYABgAFAAUABgAGAAYABwAFAAUABgAHAAYABgAHAAcABwAIAAkABwAJAAkACgANAAsACwAMAAwACwAMAA0ADgANAA4AEQAPABAAEQARABAAEAARABEAEQASABIAEQATABUAEwATABIAEgAQABMAEgARABIAEwARABMAEgARABEAEAAQAA8ADwAQAA8ADgAPABAAEQAQABEAEAAQABEAEgARABIAEwARABEAEQASABIAEQARAA8AEAARABEAEQAPAA8AEQAPAA8ADgAPAA8ADwAPAA8ADgAPAA8ADwAPAA0ADQAOABEADwAPABEADwASABEADwAPABAAEgATABQAFAASABQAEwAUABAAEQAUABMAFAARABIAEgATABMAEQARABEAEQARAA4ADgAPAA8AEAAQAA8ADwAOAA4ADQAOAA0ADAAKAAsACgAJAAkACAAIAAgACAAJAAcABwAGAAcABgADAAUABQADAAQABAADAAMAAgAFAAMAAwADAAMABAAEAAUABgAGAAQABgAEAAYABgAEAAYABwAHAAcABgAFAAYABQAIAAUABQADAAMABwAFAAUABQAEAAUABQAFAAQAAgAAAAEAAAAAAAEAAAD//////f/9//3//f/7//v/+v/4//f/+P/4//f/+P/3//b/9//1//X/9f/2//b/9f/2//b/9v/2//f/9//0//b/9f/2//f/9f/3//f/9//3//f/9f/1//X/9f/1//b/9v/1//T/8//1//X/8//y//L/8f/y//H/8f/x/+3/7v/v/+3/7//u/+7/7P/s/+r/6v/n/+j/6P/n/+f/5//l/+X/4//j/+H/4f/i/+D/4P/g/9//4P/f/9//3v/g/9//3v/e/97/3f/g/97/3v/f/97/4f/h/+H/4v/j/+P/4//j/+P/5P/k/+T/5f/k/+P/5P/l/+P/4v/j/+P/4f/g/+D/4f/i/+H/4v/j/9//3v/f/9//3f/c/9v/3P/c/9v/2f/Y/9n/2f/Y/9X/1f/V/9L/1P/S/9H/0f/R/9H/0f/P/87/0P/N/8//zv/N/8z/zf/O/9D/0P/Q/9L/0f/S/9P/0v/R/9L/0//T/9T/1P/S/9T/1P/U/9b/1//T/9T/1f/Y/9f/1//Y/9j/2P/W/9f/1v/W/9f/1f/W/9b/1//X/9b/1//X/9b/1f/X/9f/2P/Y/9f/1//W/9X/1//X/9X/1f/V/9T/1f/U/9X/1P/X/9n/1//Z/9n/2//a/9n/2v/a/93/3f/d/93/3f/d/93/3//e/+D/4v/g/9//4P/f/9//4v/h/+H/4v/i/+P/5P/j/+T/5v/m/+b/5//l/+b/5v/o/+f/5v/p/+r/6f/q/+v/6//r/+v/7f/t/+3/7f/v//H/8f/v//D/8//z//X/9P/0//f/9//3//n/+f/7//z//v/+//7//v/+/wAA/////wEAAQABAAMAAgABAAIAAgACAAUABQADAAQABwAHAAUACAAHAAgACAAGAAkACAAJAAsACwALAAsADAAOAA4ADgARABAAEAASABIAFQATABUAFgAVABcAGAAZABoAGwAbABwAHwAfACAAIAAiACMAIwAjACIAIwAlACUAJQAmACcAKAApACkAKwAqACoAKwAtADAAMQAxADEALwAyADMAMwA1ADYANAAyADUANAA0ADYANwA2ADYANgA1ADcAOQA5ADgANwA6ADsAOgA8AD0APgA+AD4APwBAAEAAQQA/AEEAQQA/AEEARABCAEEAQgBCAEIAQgBDAEMAQwBDAEIARABFAEMARABEAEQARQBEAEQARQBFAEYARQBGAEYASABIAEgARwBHAEgASABJAEYARgBIAEgASABHAEgASQBHAEYARwBFAEMARwBGAEUARgBFAEcARgBGAEQARABGAEYARABEAEcARgBFAEYARgBGAEUARABFAEUARABGAEYARwBFAEYARABDAEYAQwBFAEUAQwBDAEQAQwBDAEIAQwBAAEEAQQBAAEAAQQBAAD8AQwBAAD8APAA9AD8APQA9ADwAOwA8AD0APQA+ADsAPAA6ADoAOgA4ADkAOAA4ADoAOgA4ADgANwA4ADYANQA1ADUANQA1ADUANAAzADMAMwA2ADEAMQAyADAAMwAyADEALwAvADEAMAAwAC0ALQAuAC0ALQArAC4ALAArACwALAAsACsALAApACoAKgApACcAJwAnACcAJgAnACgAJQAlACUAJQAlACQAJAAjACMAJAAkACMAIQAjACMAIwAhACEAIAAfACAAHwAfABwAHAAeABsAGwAbABkAGgAZABoAGQAZABgAGAAYABcAFgAYABcAFQAUABQAFAAVABQAFAASABIAEwASABMAEQARABIAEQASABEAEAAPAA4ADgANAA0ADAAMAA4ADAAMAA4ACwALAAsADAAKAAoACwAKAAgABwAIAAYABwAHAAcABgAHAAcABgAGAAUABQAFAAUABQAEAAUABQAEAAUABAADAAQAAgACAAMAAgABAAIAAwACAAIAAgACAAIAAQAAAAAAAQAAAP///////wAA//8AAAAA/v///wAA/////wAA/v///wAA/f////7//v////7//v/+//7//v/9//v//f/9/////v/8//3//v/9/////v/9/////f/+//7//v/9//3//P/8//3//v/9//7////+//7///8AAP3//f8AAP7//v///wAAAAD//wAAAAD//////v8AAP//AAAAAAEAAAAAAAEAAAABAAAAAQABAAAAAQACAAAAAQAAAAEAAQAAAAEAAQABAAEAAQABAAQAAgADAAIAAwACAAEAAQABAAMAAgABAAEAAgADAAQABQADAAIABAAEAAUABQAFAAUABgAFAAQABgAHAAcABQAFAAcABwAJAAgABgAHAAoACAAIAAgABwAJAAcABwAJAAsACQAKAAkACQALAAkACwALAAsACgAJAAkACAAKAAsACwANAAwADQAMAAsADAAMAA0ADQANAA0ADAAOAAwADgAQAA8AEAAQABEAEAARABAADwAPABEAEAAPAA4AEQARABEAEgAUABQAFAATABUAFQAVABcAFAAUABQAFAAUABMAEwATABMAEwASABIAEgATABMAFAAUABUAFAATABUAEwARABIAEgARABMAEwAUABMAEwATABIAFAAUABMAEgASABEAEQASABIAEgASABIAEQARABEAEQATABMAEwARABIAEwARABAAEQARABEAEQAQABAADwAQABEAEQATABEAEQASAA0ADgATAA8ADQAPAA4ADAALAAwADgAOAA0ADQAPABAADgANAA4ADAAKAAwACwAJAA8ADgAMAA4ACwAMAA0ACwAMAAsACgALAAoACQAIAAUABQAEAAUABQAFAAUAAgACAAUABwAEAAEAAwAHAAgACgAJAAkABwAFAAgABwAGAAYAAwACAAIAAAD9//z/+//+/wAA/f/7//j/+v/6//v/+//9//v//f/9//v/+//5//r//v///////v/8//v/+P/8//n/+//7//j/9v/7//T/8//v/+7/8v/z//f/8f/y//T/8f/u//X/8f/u//T/9//0//L/9f/y/+//7//w/+7/6v/q/+//7P/h/+n/5//o/+P/5//t/+X/5v/n/+n/7f/o/+3/5f/k/+X/6v/q/+f/6f/m/+T/5v/m/+T/4v/d/+H/5P/e/93/4f/V/9b/4//i/+L/6f/g/+f/5//m/+r/4//f/+n/5f/k/+r/2P/V/9X/2f/X/9b/3//X/9r/2P/X/9b/0//V/9v/4P/o/9//3//b/9j/3f/i/+r/2//g/+D/1//X/9b/3P/Y/9D/2//Q/9X/1P/V/9H/1//V/9X/3v/X/9b/3//S/9//2//e/9v/3P/a/9f/4f/j/+L/2v/k/+X/7f/l/97/4P/e/9j/2P/T/8v/yP/S/8f/yP/O/8b/x//C/9X/2v/V/+n/5f/m/+X/3v/i/9v/4f/w/+v/6v/i/+b/5//f/9z/3//l/+T/2v/f/9z/1//M/9T/2f/T/9r/4f/V/9L/0v/Q/9X/2f/g/+//5//i/+H/7v/q/+f/8v/r/+3/6//o/+b/3v/Q/83/zf/J/9T/zf/e/9j/yP/Q/9P/4f/i/+z/6P/z//n/9//3/+v/8f8AAAQA/f/5/+j/4v/i/+D/5v/j/8j/yv/Q/9T/0P/C/8P/wf/H/9P/4f8=&quot;,
        &quot;ErrorCode&quot;: 0,
        &quot;Msg&quot;: &quot;success&quot;,
        &quot;VoiceId&quot;: &quot;s1_2GSzVAf00hl7+A+LJTNvVI6nFJB0qliIvR8wntPeaniVSstd7Z4E4UL8Hky3azMHVlDSps1zWW4nJ7ll9w==&quot;,
        &quot;RequestId&quot;: &quot;2f8fa58c-91e8-4564-8b42-490ececda193&quot;
    }
}
</code></pre><hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%94%AF%E6%8C%81%E7%9A%84%E8%AF%AD%E8%A8%80%E5%88%97%E8%A1%A8" name="%E6%94%AF%E6%8C%81%E7%9A%84%E8%AF%AD%E8%A8%80%E5%88%97%E8%A1%A8">支持的语言列表</h2>
<table>
<thead>
<tr>
<th style="text-align:left">语言代码</th>
<th style="text-align:left">语言名称</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>zh</code></td>
<td style="text-align:left">中文</td>
</tr>
<tr>
<td style="text-align:left"><code>en</code></td>
<td style="text-align:left">英语</td>
</tr>
<tr>
<td style="text-align:left"><code>ja</code></td>
<td style="text-align:left">日语</td>
</tr>
<tr>
<td style="text-align:left"><code>de</code></td>
<td style="text-align:left">德语</td>
</tr>
<tr>
<td style="text-align:left"><code>fr</code></td>
<td style="text-align:left">法语</td>
</tr>
<tr>
<td style="text-align:left"><code>ko</code></td>
<td style="text-align:left">韩语</td>
</tr>
<tr>
<td style="text-align:left"><code>ru</code></td>
<td style="text-align:left">俄语</td>
</tr>
<tr>
<td style="text-align:left"><code>uk</code></td>
<td style="text-align:left">乌克兰语</td>
</tr>
<tr>
<td style="text-align:left"><code>pt</code></td>
<td style="text-align:left">葡萄牙语</td>
</tr>
<tr>
<td style="text-align:left"><code>it</code></td>
<td style="text-align:left">意大利语</td>
</tr>
<tr>
<td style="text-align:left"><code>es</code></td>
<td style="text-align:left">西班牙语</td>
</tr>
<tr>
<td style="text-align:left"><code>id</code></td>
<td style="text-align:left">印度尼西亚语</td>
</tr>
<tr>
<td style="text-align:left"><code>nl</code></td>
<td style="text-align:left">荷兰语</td>
</tr>
<tr>
<td style="text-align:left"><code>tr</code></td>
<td style="text-align:left">土耳其语</td>
</tr>
<tr>
<td style="text-align:left"><code>fil</code></td>
<td style="text-align:left">菲律宾语</td>
</tr>
<tr>
<td style="text-align:left"><code>ms</code></td>
<td style="text-align:left">马来语</td>
</tr>
<tr>
<td style="text-align:left"><code>el</code></td>
<td style="text-align:left">希腊语</td>
</tr>
<tr>
<td style="text-align:left"><code>fi</code></td>
<td style="text-align:left">芬兰语</td>
</tr>
<tr>
<td style="text-align:left"><code>hr</code></td>
<td style="text-align:left">克罗地亚语</td>
</tr>
<tr>
<td style="text-align:left"><code>sk</code></td>
<td style="text-align:left">斯洛伐克语</td>
</tr>
<tr>
<td style="text-align:left"><code>pl</code></td>
<td style="text-align:left">波兰语</td>
</tr>
<tr>
<td style="text-align:left"><code>sv</code></td>
<td style="text-align:left">瑞典语</td>
</tr>
<tr>
<td style="text-align:left"><code>hi</code></td>
<td style="text-align:left">印地语</td>
</tr>
<tr>
<td style="text-align:left"><code>bg</code></td>
<td style="text-align:left">保加利亚语</td>
</tr>
<tr>
<td style="text-align:left"><code>ro</code></td>
<td style="text-align:left">罗马尼亚语</td>
</tr>
<tr>
<td style="text-align:left"><code>ar</code></td>
<td style="text-align:left">阿拉伯语</td>
</tr>
<tr>
<td style="text-align:left"><code>cs</code></td>
<td style="text-align:left">捷克语</td>
</tr>
<tr>
<td style="text-align:left"><code>da</code></td>
<td style="text-align:left">丹麦语</td>
</tr>
<tr>
<td style="text-align:left"><code>ta</code></td>
<td style="text-align:left">泰米尔语</td>
</tr>
<tr>
<td style="text-align:left"><code>hun</code></td>
<td style="text-align:left">匈牙利语</td>
</tr>
<tr>
<td style="text-align:left"><code>vi</code></td>
<td style="text-align:left">越南语</td>
</tr>
<tr>
<td style="text-align:left"><code>no</code></td>
<td style="text-align:left">挪威语</td>
</tr>
<tr>
<td style="text-align:left"><code>yue</code></td>
<td style="text-align:left">粤语</td>
</tr>
<tr>
<td style="text-align:left"><code>th</code></td>
<td style="text-align:left">泰语</td>
</tr>
<tr>
<td style="text-align:left"><code>he</code></td>
<td style="text-align:left">希伯来语</td>
</tr>
<tr>
<td style="text-align:left"><code>ca</code></td>
<td style="text-align:left">加泰罗尼亚语</td>
</tr>
<tr>
<td style="text-align:left"><code>nn</code></td>
<td style="text-align:left">尼诺斯克语</td>
</tr>
<tr>
<td style="text-align:left"><code>af</code></td>
<td style="text-align:left">阿非利卡语</td>
</tr>
<tr>
<td style="text-align:left"><code>fa</code></td>
<td style="text-align:left">波斯语</td>
</tr>
<tr>
<td style="text-align:left"><code>sl</code></td>
<td style="text-align:left">斯洛文尼亚语</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E9%94%99%E8%AF%AF%E7%A0%81" name="%E9%94%99%E8%AF%AF%E7%A0%81">错误码</h2>
<table>
<thead>
<tr>
<th style="text-align:left">错误码</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left">ActionOffline</td>
<td style="text-align:left">接口已下线。</td>
</tr>
<tr>
<td style="text-align:left">AuthFailure.InvalidSecretId</td>
<td style="text-align:left">密钥非法。</td>
</tr>
<tr>
<td style="text-align:left">AuthFailure.SecretIdNotFound</td>
<td style="text-align:left">密钥不存在。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation</td>
<td style="text-align:left">操作失败。</td>
</tr>
<tr>
<td style="text-align:left">InternalError</td>
<td style="text-align:left">内部错误。</td>
</tr>
<tr>
<td style="text-align:left">InvalidAction</td>
<td style="text-align:left">接口不存在。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameter</td>
<td style="text-align:left">参数错误（包括参数格式、类型等错误）。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameterValue</td>
<td style="text-align:left">参数取值错误。</td>
</tr>
<tr>
<td style="text-align:left">InvalidRequest</td>
<td style="text-align:left">请求 body 的 multipart 格式错误。</td>
</tr>
<tr>
<td style="text-align:left">IpInBlacklist</td>
<td style="text-align:left">IP 地址在黑名单中。</td>
</tr>
<tr>
<td style="text-align:left">IpNotInWhitelist</td>
<td style="text-align:left">IP 地址不在白名单中。</td>
</tr>
<tr>
<td style="text-align:left">LimitExceeded</td>
<td style="text-align:left">超过配额限制。</td>
</tr>
<tr>
<td style="text-align:left">MissingParameter</td>
<td style="text-align:left">缺少参数。</td>
</tr>
<tr>
<td style="text-align:left">NoSuchProduct</td>
<td style="text-align:left">产品不存在</td>
</tr>
<tr>
<td style="text-align:left">NoSuchVersion</td>
<td style="text-align:left">接口版本不存在。</td>
</tr>
<tr>
<td style="text-align:left">RequestLimitExceeded</td>
<td style="text-align:left">请求的次数超过了频率限制。</td>
</tr>
<tr>
<td style="text-align:left">RequestLimitExceeded.GlobalRegionUinLimitExceeded</td>
<td style="text-align:left">主账号超过频率限制。</td>
</tr>
<tr>
<td style="text-align:left">RequestLimitExceeded.IPLimitExceeded</td>
<td style="text-align:left">IP 限频。</td>
</tr>
<tr>
<td style="text-align:left">RequestLimitExceeded.UinLimitExceeded</td>
<td style="text-align:left">主账号限频。</td>
</tr>
<tr>
<td style="text-align:left">RequestSizeLimitExceeded</td>
<td style="text-align:left">请求包超过限制大小。</td>
</tr>
<tr>
<td style="text-align:left">ResourceInUse</td>
<td style="text-align:left">资源被占用。</td>
</tr>
<tr>
<td style="text-align:left">ResourceInsufficient</td>
<td style="text-align:left">资源不足。</td>
</tr>
<tr>
<td style="text-align:left">ResourceNotFound</td>
<td style="text-align:left">资源不存在。</td>
</tr>
<tr>
<td style="text-align:left">ResourceUnavailable</td>
<td style="text-align:left">资源不可用。</td>
</tr>
<tr>
<td style="text-align:left">ResponseSizeLimitExceeded</td>
<td style="text-align:left">返回包超过限制大小。</td>
</tr>
<tr>
<td style="text-align:left">ServiceUnavailable</td>
<td style="text-align:left">当前服务暂时不可用。</td>
</tr>
<tr>
<td style="text-align:left">UnauthorizedOperation</td>
<td style="text-align:left">未授权操作。</td>
</tr>
<tr>
<td style="text-align:left">UnknownParameter</td>
<td style="text-align:left">未知参数错误，用户多传未定义的参数会导致错误。</td>
</tr>
<tr>
<td style="text-align:left">UnsupportedOperation</td>
<td style="text-align:left">操作不支持。</td>
</tr>
<tr>
<td style="text-align:left">UnsupportedProtocol</td>
<td style="text-align:left">http(s) 请求协议错误，只支持 GET 和 POST 请求。</td>
</tr>
<tr>
<td style="text-align:left">UnsupportedRegion</td>
<td style="text-align:left">接口不支持所传地域。</td>
</tr>
</tbody>
</table>
]]></content:encoded>
      <pubDate>Wed, 08 Apr 2026 15:17:40 +0800</pubDate>
      <guid>http://doc.talkingdata.com/posts/1230</guid>
      <comments>http://doc.talkingdata.com/posts/1230#comments</comments>
    </item>
    <item>
      <title>TD云绘10/Tencent-商品背景生成</title>
      <link>http://doc.talkingdata.com/posts/1229</link>
      <category>图片生成 API</category>
      <author>liuxinmei</author>
      <description>云绘10 接口说明文档 TD模型编号：T0302005 模型能力简介 云绘10 商品背景生成：根据您输入的商品原图（ProductUrl） + 背景描述（Prompt） + 参数（可选） 将商品图中的原背景替换为自定义的新背景并保留商品主体形象，实现商品背景的自由生成与更换。 鉴权说明  本接口仅支持API Key鉴权，需联系TD运维同学获取长效API Key。
 商品背景生成接口地址 请求方法： POST 接口URL：https://modelpool-api.talkingdata.com/model/orgin/job 请求头（Request Headers）： 头部字段 值 是否必需 说明 Authorization Bearer &lt;your_api_key&gt; 是 API 鉴权凭证，</description>
      <content:encoded><![CDATA[<h4 id="%3Cstrong%3E%E4%BA%91%E7%BB%9810%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3%3C%2Fstrong%3E" name="%3Cstrong%3E%E4%BA%91%E7%BB%9810%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3%3C%2Fstrong%3E"><strong>云绘10 接口说明文档</strong></h4>
<p><strong>TD模型编号：T0302005</strong></p>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%A8%A1%E5%9E%8B%E8%83%BD%E5%8A%9B%E7%AE%80%E4%BB%8B" name="%E6%A8%A1%E5%9E%8B%E8%83%BD%E5%8A%9B%E7%AE%80%E4%BB%8B">模型能力简介</h2>
<p><span id="Hrya4y9k"></span></p>
<ul>
<li><strong>云绘10</strong><ul>
<li><strong>商品背景生成</strong>：根据您输入的<strong>商品原图（ProductUrl）</strong> + <strong>背景描述（Prompt）</strong> + <strong>参数（可选）</strong> 将商品图中的原背景替换为自定义的新背景并保留商品主体形象，实现商品背景的自由生成与更换。</li>
</ul>
</li>
</ul>
<h5 id="%3Cstrong%3E%E9%89%B4%E6%9D%83%E8%AF%B4%E6%98%8E%3C%2Fstrong%3E%26nbsp%3B" name="%3Cstrong%3E%E9%89%B4%E6%9D%83%E8%AF%B4%E6%98%8E%3C%2Fstrong%3E%26nbsp%3B"><strong>鉴权说明</strong>&nbsp;</h5>
<pre><code>本接口仅支持API Key鉴权，需联系TD运维同学获取长效API Key。
</code></pre><hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E5%95%86%E5%93%81%E8%83%8C%E6%99%AF%E7%94%9F%E6%88%90%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80" name="%E5%95%86%E5%93%81%E8%83%8C%E6%99%AF%E7%94%9F%E6%88%90%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80">商品背景生成接口地址</h2>
<p><span id="Hrya4y9k"></span></p>
<p><strong>请求方法：</strong> POST</p>
<p><strong>接口URL：</strong><code>https://modelpool-api.talkingdata.com/model/orgin/job</code> </p>
<p><strong>请求头（Request Headers）：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">头部字段</th>
<th style="text-align:left">值</th>
<th style="text-align:left">是否必需</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>Authorization</code></td>
<td style="text-align:left"><code>Bearer &lt;your_api_key&gt;</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">API 鉴权凭证，请替换为有效的 API Key</td>
</tr>
<tr>
<td style="text-align:left"><code>X-Timestamp</code></td>
<td style="text-align:left"><code>1700000000</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">Unix 时间戳格式</td>
</tr>
<tr>
<td style="text-align:left"><code>Content-Type</code></td>
<td style="text-align:left"><code>application/json</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">请求体格式必须为 JSON</td>
</tr>
<tr>
<td style="text-align:left"><code>X-TC-Action</code></td>
<td style="text-align:left"><code>T0302005</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">固定值</td>
</tr>
</tbody>
</table>
<p><strong>请求参数（Request  Parameter）：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">字段</th>
<th style="text-align:left">值</th>
<th style="text-align:left">是否必需</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>requestld</code></td>
<td style="text-align:left"><code>550e8400-e29b-41d4-a716-446655440000</code></td>
<td style="text-align:left">否</td>
<td style="text-align:left">请求唯一标识符。使用 UUID 格式字符串，用于跟踪和排查请求相关问题，以便在需要技术排查时，提供此 ID 可快速定位具体请求的完整处理链路和日志信息。</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E5%95%86%E5%93%81%E8%83%8C%E6%99%AF%E7%94%9F%E6%88%90%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0" name="%E5%95%86%E5%93%81%E8%83%8C%E6%99%AF%E7%94%9F%E6%88%90%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0">商品背景生成请求参数</h2>
<p><span id="Hrya4y9k"></span></p>
<h3 id="%E5%95%86%E5%93%81%E8%83%8C%E6%99%AF%E7%94%9F%E6%88%90%E8%AF%B7%E6%B1%82%E4%BD%93%EF%BC%88requestBody%EF%BC%89" name="%E5%95%86%E5%93%81%E8%83%8C%E6%99%AF%E7%94%9F%E6%88%90%E8%AF%B7%E6%B1%82%E4%BD%93%EF%BC%88requestBody%EF%BC%89">商品背景生成请求体（requestBody）</h3>
<table>
<thead>
<tr>
<th style="text-align:left">参数</th>
<th style="text-align:left">类型</th>
<th style="text-align:left">必选</th>
<th style="text-align:left">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>ProductUrl</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">是</td>
<td style="text-align:left">商品原图URL。图片限制：单边分辨率＜4000，长宽比在2:5 ~ 5:2之间，Base64后＜6MB，格式支持 jpg/jpeg/png/bmp/tiff/webp。</td>
</tr>
<tr>
<td style="text-align:left"><code>Prompt</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">是</td>
<td style="text-align:left">对新背景的文本描述，最多256个UTF-8字符，支持中英文。如果 <code>Prompt = &quot;BackgroundTemplate&quot;</code>，表示启用背景模板，需在 <code>BackgroundTemplate</code> 参数中指定模板名称。</td>
</tr>
<tr>
<td style="text-align:left"><code>NegativePrompt</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">反向提示词，最多256个UTF-8字符，支持中英文。</td>
</tr>
<tr>
<td style="text-align:left"><code>Product</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">商品图中的商品主体名称，最多50个UTF-8字符，支持中英文。建议说明商品主体，否则影响生成效果。</td>
</tr>
<tr>
<td style="text-align:left"><code>BackgroundTemplate</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">背景模板名称。仅当 <code>Prompt = &quot;BackgroundTemplate&quot;</code> 时生效。传入“背景名称”字段中的值。</td>
</tr>
<tr>
<td style="text-align:left"><code>MaskUrl</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">商品Mask图URL，要求背景透明，保留商品主体。如果不传，将自动使用内置的商品分割算法得到Mask。Mask图必须和商品原图分辨率一致，Base64后＜6MB，格式仅支持png。</td>
</tr>
<tr>
<td style="text-align:left"><code>Resolution</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">替换背景后生成的商品图分辨率。支持单边分辨率＞500且＜4000、长宽比在2:5 ~ 5:2之间，不传默认生成<code>1280:1280</code>。建议比例为1:1、9:16、16:9，效果更佳。</td>
</tr>
<tr>
<td style="text-align:left"><code>LogoAdd</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">否</td>
<td style="text-align:left">是否添加水印标识。<code>1</code>：添加（默认）；<code>0</code>：不添加。建议添加以提示AI生成。</td>
</tr>
<tr>
<td style="text-align:left"><code>LogoParam</code></td>
<td style="text-align:left">Object</td>
<td style="text-align:left">否</td>
<td style="text-align:left">自定义标识内容。默认在右下角添加“图片由 AI 生成”字样，可替换为其他标识图片。</td>
</tr>
<tr>
<td style="text-align:left"><code>RspImgType</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">返回图像方式，<code>base64</code>或<code>url</code>，二选一，默认为<code>base64</code>。url有效期为1小时。生成图分辨率较大时建议选择url。</td>
</tr>
</tbody>
</table>
<h2 id="%E5%95%86%E5%93%81%E8%83%8C%E6%99%AF%E7%94%9F%E6%88%90%E8%BF%94%E5%9B%9E%E5%8F%82%E6%95%B0" name="%E5%95%86%E5%93%81%E8%83%8C%E6%99%AF%E7%94%9F%E6%88%90%E8%BF%94%E5%9B%9E%E5%8F%82%E6%95%B0">商品背景生成返回参数</h2>
<table>
<thead>
<tr>
<th style="text-align:left">参数</th>
<th style="text-align:left">类型</th>
<th style="text-align:left">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>ResultImage</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">生成的头像图像。根据入参 <code>RspImgType</code> 返回不同内容：若传入 <code>base64</code>（或不传，默认），返回生成图的Base64编码；若传入 <code>url</code>，返回生成图的URL（有效期1小时）。</td>
</tr>
<tr>
<td style="text-align:left"><code>RequestId</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">唯一请求ID，由服务端生成，用于问题定位。</td>
</tr>
<tr>
<td style="text-align:left"><code>MaskImage</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">如果 <code>MaskUrl</code> 未传，则返回使用内置商品分割算法得到的Mask结果（背景透明、保留商品主体的图片）。仅在未传入 <code>MaskUrl</code> 时返回此字段。</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E5%95%86%E5%93%81%E8%83%8C%E6%99%AF%E7%94%9F%E6%88%90%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B" name="%E5%95%86%E5%93%81%E8%83%8C%E6%99%AF%E7%94%9F%E6%88%90%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B">商品背景生成调用示例</h2>
<p><span id="Hrya4y9k"></span></p>
<p>请求示例：</p>
<pre><code class="lang-Curl">curl -X POST &#39;https://modelpool-api.talkingdata.com/model/orgin/job?requestId=550e8400-e29b-41d4-a716-446655440000&#39; \
  -H &#39;Content-Type: application/json&#39; \
  -H &#39;Authorization: Bearer YOUR_API_KEY&#39; \
  -H &#39;X-Timestamp: 1760000000&#39; \
  -H &#39;X-TC-Action: T0302005&#39; \
  -d &#39;{
    &quot;ProductUrl&quot;: &quot;https://td-llm.tos-cn-beijing.volces.com/public/123.png&quot;,
    &quot;Prompt&quot;: &quot;BackgroundTemplate&quot;,
    &quot;BackgroundTemplate&quot;: &quot;彩虹渐变&quot;,
    &quot;RspImgType&quot;: &quot;url&quot;
}&#39;
</code></pre>
<p>响应示例：</p>
<pre><code>{
    &quot;Response&quot;: {
        &quot;ResultImage&quot;: &quot;https://aiart-1258344699.cos.ap-guangzhou.myqcloud.com/replacebg/2adda514-6743-4447-a06c-1c090ed1a89c-1395528311.jpg?q-sign-algorithm=sha1&amp;q-ak=AKIDpRovliU1IJ5ctufBSVIq8AwTlnZ5MN8d&amp;q-sign-time=1774945282%3B1774948882&amp;q-key-time=1774945282%3B1774948882&amp;q-header-list=host&amp;q-url-param-list=&amp;q-signature=1c74155eea35e8cc63e6dd070271421656a8b1be&quot;,
        &quot;MaskImage&quot;: &quot;https://aiart-1258344699.cos.ap-guangzhou.myqcloud.com/replacebg/2adda514-6743-4447-a06c-1c090ed1a89c-1395528311-mask.png?q-sign-algorithm=sha1&amp;q-ak=AKIDpRovliU1IJ5ctufBSVIq8AwTlnZ5MN8d&amp;q-sign-time=1774945282%3B1774948882&amp;q-key-time=1774945282%3B1774948882&amp;q-header-list=host&amp;q-url-param-list=&amp;q-signature=4d5476961e3e251aec69bad6b7bd8c58bba1c5e4&quot;,
        &quot;RequestId&quot;: &quot;2adda514-6743-4447-a06c-1c090ed1a89c&quot;
    }
}
</code></pre><hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E9%94%99%E8%AF%AF%E7%A0%81" name="%E9%94%99%E8%AF%AF%E7%A0%81">错误码</h2>
<table>
<thead>
<tr>
<th style="text-align:left">错误码</th>
<th style="text-align:left">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left">AuthFailure.UnauthorizedOperation</td>
<td style="text-align:left">无权执行该操作。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.GenerateImageFailed</td>
<td style="text-align:left">生成图片审核不通过，请重试。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.ImageDecodeFailed</td>
<td style="text-align:left">图片解码失败。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.ImageDownloadError</td>
<td style="text-align:left">图片下载错误。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.ImageResolutionExceed</td>
<td style="text-align:left">图片分辨率过大，超过2000*2000。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.ImageSizeExceed</td>
<td style="text-align:left">base64编码后的图片数据大小不超过10M。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.InnerError</td>
<td style="text-align:left">服务内部错误，请稍后重试。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.RequestEntityTooLarge</td>
<td style="text-align:left">整个请求体太大（通常主要是图片）。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.RequestTimeout</td>
<td style="text-align:left">后端服务超时。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.ServerError</td>
<td style="text-align:left">服务内部错误。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.Unknown</td>
<td style="text-align:left">未知错误。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameter.InvalidParameter</td>
<td style="text-align:left">参数不合法。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameterValue.ImageEmpty</td>
<td style="text-align:left">图片为空。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameterValue.ParameterValueError</td>
<td style="text-align:left">参数字段或者值有误</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameterValue.StyleConflict</td>
<td style="text-align:left">1xx和其他风格不可混合使用。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameterValue.TextLengthExceed</td>
<td style="text-align:left">输入文本过长，请更换短一点的文本后重试。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameterValue.UrlIllegal</td>
<td style="text-align:left">URL格式不合法。</td>
</tr>
<tr>
<td style="text-align:left">OperationDenied.ImageIllegalDetected</td>
<td style="text-align:left">图片包含违法违规信息，审核不通过。</td>
</tr>
<tr>
<td style="text-align:left">OperationDenied.TextIllegalDetected</td>
<td style="text-align:left">文本包含违法违规信息，审核不通过。</td>
</tr>
<tr>
<td style="text-align:left">RequestLimitExceeded</td>
<td style="text-align:left">请求的次数超过了频率限制。</td>
</tr>
<tr>
<td style="text-align:left">RequestLimitExceeded.JobNumExceed</td>
<td style="text-align:left">同时处理的任务数过多，请稍后重试。</td>
</tr>
<tr>
<td style="text-align:left">ResourcesSoldOut.ChargeStatusException</td>
<td style="text-align:left">计费状态异常。</td>
</tr>
</tbody>
</table>
]]></content:encoded>
      <pubDate>Wed, 08 Apr 2026 14:15:57 +0800</pubDate>
      <guid>http://doc.talkingdata.com/posts/1229</guid>
      <comments>http://doc.talkingdata.com/posts/1229#comments</comments>
    </item>
    <item>
      <title>TD云绘9/Tencent-百变头像</title>
      <link>http://doc.talkingdata.com/posts/1228</link>
      <category>图片生成 API</category>
      <author>liuxinmei</author>
      <description>云绘9 接口说明文档 TD模型编号：T0302004 模型能力简介 云绘9 百变头像：根据您输入的人像照片（URL或Base64）+ 参数（可选） 生成风格百变的头像。支持人像模式和萌宠贴纸模式（宠物模式无需选择风格），支持输入图片质量检测开关、水印标识开关、返回格式选择（Base64或URL）等功能。建议避免上传无人、多人、人像过小的图片。 鉴权说明  本接口仅支持API Key鉴权，需联系TD运维同学获取长效API Key。
 百变头像接口地址 请求方法： POST 接口URL：https://modelpool-api.talkingdata.com/model/orgin/job 请求头（Request Headers）： 头部字段 值 是否必需 说明 Authorization B</description>
      <content:encoded><![CDATA[<h4 id="%3Cstrong%3E%E4%BA%91%E7%BB%989%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3%3C%2Fstrong%3E" name="%3Cstrong%3E%E4%BA%91%E7%BB%989%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3%3C%2Fstrong%3E"><strong>云绘9 接口说明文档</strong></h4>
<p><strong>TD模型编号：T0302004</strong></p>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%A8%A1%E5%9E%8B%E8%83%BD%E5%8A%9B%E7%AE%80%E4%BB%8B" name="%E6%A8%A1%E5%9E%8B%E8%83%BD%E5%8A%9B%E7%AE%80%E4%BB%8B">模型能力简介</h2>
<p><span id="Hrya4y9k"></span></p>
<ul>
<li><strong>云绘9</strong><ul>
<li><strong>百变头像</strong>：根据您输入的<strong>人像照片（URL或Base64）</strong>+ <strong>参数（可选）</strong> 生成风格百变的头像。支持人像模式和萌宠贴纸模式（宠物模式无需选择风格），支持输入图片质量检测开关、水印标识开关、返回格式选择（Base64或URL）等功能。建议避免上传无人、多人、人像过小的图片。</li>
</ul>
</li>
</ul>
<h5 id="%3Cstrong%3E%E9%89%B4%E6%9D%83%E8%AF%B4%E6%98%8E%3C%2Fstrong%3E%26nbsp%3B" name="%3Cstrong%3E%E9%89%B4%E6%9D%83%E8%AF%B4%E6%98%8E%3C%2Fstrong%3E%26nbsp%3B"><strong>鉴权说明</strong>&nbsp;</h5>
<pre><code>本接口仅支持API Key鉴权，需联系TD运维同学获取长效API Key。
</code></pre><hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E7%99%BE%E5%8F%98%E5%A4%B4%E5%83%8F%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80" name="%E7%99%BE%E5%8F%98%E5%A4%B4%E5%83%8F%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80">百变头像接口地址</h2>
<p><span id="Hrya4y9k"></span></p>
<p><strong>请求方法：</strong> POST</p>
<p><strong>接口URL：</strong><code>https://modelpool-api.talkingdata.com/model/orgin/job</code> </p>
<p><strong>请求头（Request Headers）：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">头部字段</th>
<th style="text-align:left">值</th>
<th style="text-align:left">是否必需</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>Authorization</code></td>
<td style="text-align:left"><code>Bearer &lt;your_api_key&gt;</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">API 鉴权凭证，请替换为有效的 API Key</td>
</tr>
<tr>
<td style="text-align:left"><code>X-Timestamp</code></td>
<td style="text-align:left"><code>1700000000</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">Unix 时间戳格式</td>
</tr>
<tr>
<td style="text-align:left"><code>Content-Type</code></td>
<td style="text-align:left"><code>application/json</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">请求体格式必须为 JSON</td>
</tr>
<tr>
<td style="text-align:left"><code>X-TC-Action</code></td>
<td style="text-align:left"><code>T0302004</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">固定值</td>
</tr>
</tbody>
</table>
<p><strong>请求参数（Request  Parameter）：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">字段</th>
<th style="text-align:left">值</th>
<th style="text-align:left">是否必需</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>requestld</code></td>
<td style="text-align:left"><code>550e8400-e29b-41d4-a716-446655440000</code></td>
<td style="text-align:left">否</td>
<td style="text-align:left">请求唯一标识符。使用 UUID 格式字符串，用于跟踪和排查请求相关问题，以便在需要技术排查时，提供此 ID 可快速定位具体请求的完整处理链路和日志信息。</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E7%99%BE%E5%8F%98%E5%A4%B4%E5%83%8F%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0" name="%E7%99%BE%E5%8F%98%E5%A4%B4%E5%83%8F%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0">百变头像请求参数</h2>
<p><span id="Hrya4y9k"></span></p>
<h3 id="%E7%99%BE%E5%8F%98%E5%A4%B4%E5%83%8F%E8%AF%B7%E6%B1%82%E4%BD%93%EF%BC%88requestBody%EF%BC%89" name="%E7%99%BE%E5%8F%98%E5%A4%B4%E5%83%8F%E8%AF%B7%E6%B1%82%E4%BD%93%EF%BC%88requestBody%EF%BC%89">百变头像请求体（requestBody）</h3>
<table>
<thead>
<tr>
<th style="text-align:left">参数</th>
<th style="text-align:left">类型</th>
<th style="text-align:left">必选</th>
<th style="text-align:left">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>InputImage</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">输入图的Base64编码数据。<code>InputImage</code> 和 <code>InputUrl</code> 必须提供一个，如果都提供以 <code>InputUrl</code> 为准。图片限制：单边分辨率＜5000，Base64后＜6MB，格式支持 jpg/jpeg/png/bmp/tiff/webp。</td>
</tr>
<tr>
<td style="text-align:left"><code>InputUrl</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">输入图的URL地址。<code>InputImage</code> 和 <code>InputUrl</code> 必须提供一个，如果都提供以 <code>InputUrl</code> 为准。图片限制同上。</td>
</tr>
<tr>
<td style="text-align:left"><code>Type</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">图像类型，默认为 <code>human</code>（人像头像）。可选值：<code>human</code>（人像头像，仅支持人像图片）、<code>pet</code>（萌宠贴纸，仅支持动物图片）。</td>
</tr>
<tr>
<td style="text-align:left"><code>Style</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">头像风格，仅在人像模式（<code>Type=&quot;human&quot;</code>）下生效。请在百变头像风格列表中选择期望的风格编号，不传默认使用 <code>flower</code> 风格。萌宠贴纸模式下该参数不生效。</td>
</tr>
<tr>
<td style="text-align:left"><code>Filter</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">否</td>
<td style="text-align:left">输入人像图的质量检测开关，仅在人像模式下生效。<code>1</code>：开启（默认）；<code>0</code>：关闭。建议开启以提升生成效果。开启后会增强质量要求（单边分辨率＜500、人脸占比小、多人、无脸等将被拦截）。</td>
</tr>
<tr>
<td style="text-align:left"><code>LogoAdd</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">否</td>
<td style="text-align:left">是否添加水印标识。<code>1</code>：添加（默认）；<code>0</code>：不添加。建议添加以提示AI生成。</td>
</tr>
<tr>
<td style="text-align:left"><code>LogoParam</code></td>
<td style="text-align:left">Object</td>
<td style="text-align:left">否</td>
<td style="text-align:left">自定义标识内容。默认在右下角添加“图片由 AI 生成”字样，可替换为其他标识图片。</td>
</tr>
<tr>
<td style="text-align:left"><code>RspImgType</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">返回图像方式，<code>base64</code>或<code>url</code>，二选一，默认为<code>base64</code>。url有效期为1小时。<strong>注意</strong>：您的真实调用未传该参数，默认返回Base64编码。</td>
</tr>
</tbody>
</table>
<h2 id="%E7%99%BE%E5%8F%98%E5%A4%B4%E5%83%8F%E8%BF%94%E5%9B%9E%E5%8F%82%E6%95%B0" name="%E7%99%BE%E5%8F%98%E5%A4%B4%E5%83%8F%E8%BF%94%E5%9B%9E%E5%8F%82%E6%95%B0">百变头像返回参数</h2>
<table>
<thead>
<tr>
<th style="text-align:left">参数</th>
<th style="text-align:left">类型</th>
<th style="text-align:left">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>ResultImage</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">生成的头像图像。根据入参 <code>RspImgType</code> 返回不同内容：若传入 <code>base64</code>（或不传，默认），返回生成图的Base64编码；若传入 <code>url</code>，返回生成图的URL（有效期1小时）。</td>
</tr>
<tr>
<td style="text-align:left"><code>RequestId</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">唯一请求ID，由服务端生成，用于问题定位。</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E7%99%BE%E5%8F%98%E5%A4%B4%E5%83%8F%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B" name="%E7%99%BE%E5%8F%98%E5%A4%B4%E5%83%8F%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B">百变头像调用示例</h2>
<p><span id="Hrya4y9k"></span></p>
<p>请求示例：</p>
<pre><code class="lang-Curl">curl -X POST &#39;https://modelpool-api.talkingdata.com/model/orgin/job?requestId=550e8400-e29b-41d4-a716-446655440000&#39; \
  -H &#39;Content-Type: application/json&#39; \
  -H &#39;Authorization: Bearer YOUR_API_KEY&#39; \
  -H &#39;X-Timestamp: 1760000000&#39; \
  -H &#39;X-TC-Action: T0302004&#39; \
  -d &#39;{
    &quot;InputUrl&quot;: &quot;https://td-llm.tos-cn-beijing.volces.com/public/1774320434562_2b131e.png&quot;
}&#39;
</code></pre>
<p>响应示例：</p>
<pre><code>{
    &quot;Response&quot;: {
        &quot;ResultImage&quot;: &quot;iVBORw0KGgoAAAANSUhEUgAABAAAAAQACAIAAADwf7zUAAAHQWVY&quot;,
        &quot;RequestId&quot;: &quot;2c08b36c-b183-44a4-a9fc-5b2e9082896a&quot;
    }
}
</code></pre><hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E9%94%99%E8%AF%AF%E7%A0%81" name="%E9%94%99%E8%AF%AF%E7%A0%81">错误码</h2>
<table>
<thead>
<tr>
<th style="text-align:left">错误码</th>
<th style="text-align:left">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left">AuthFailure.UnauthorizedOperation</td>
<td style="text-align:left">无权执行该操作。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.GenerateImageFailed</td>
<td style="text-align:left">生成图片审核不通过，请重试。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.ImageDecodeFailed</td>
<td style="text-align:left">图片解码失败。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.ImageDownloadError</td>
<td style="text-align:left">图片下载错误。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.ImageResolutionExceed</td>
<td style="text-align:left">图片分辨率过大，超过2000*2000。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.ImageSizeExceed</td>
<td style="text-align:left">base64编码后的图片数据大小不超过10M。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.InnerError</td>
<td style="text-align:left">服务内部错误，请稍后重试。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.RequestEntityTooLarge</td>
<td style="text-align:left">整个请求体太大（通常主要是图片）。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.RequestTimeout</td>
<td style="text-align:left">后端服务超时。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.ServerError</td>
<td style="text-align:left">服务内部错误。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.Unknown</td>
<td style="text-align:left">未知错误。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameter.InvalidParameter</td>
<td style="text-align:left">参数不合法。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameterValue.ImageEmpty</td>
<td style="text-align:left">图片为空。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameterValue.ParameterValueError</td>
<td style="text-align:left">参数字段或者值有误</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameterValue.StyleConflict</td>
<td style="text-align:left">1xx和其他风格不可混合使用。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameterValue.TextLengthExceed</td>
<td style="text-align:left">输入文本过长，请更换短一点的文本后重试。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameterValue.UrlIllegal</td>
<td style="text-align:left">URL格式不合法。</td>
</tr>
<tr>
<td style="text-align:left">OperationDenied.ImageIllegalDetected</td>
<td style="text-align:left">图片包含违法违规信息，审核不通过。</td>
</tr>
<tr>
<td style="text-align:left">OperationDenied.TextIllegalDetected</td>
<td style="text-align:left">文本包含违法违规信息，审核不通过。</td>
</tr>
<tr>
<td style="text-align:left">RequestLimitExceeded</td>
<td style="text-align:left">请求的次数超过了频率限制。</td>
</tr>
<tr>
<td style="text-align:left">RequestLimitExceeded.JobNumExceed</td>
<td style="text-align:left">同时处理的任务数过多，请稍后重试。</td>
</tr>
<tr>
<td style="text-align:left">ResourcesSoldOut.ChargeStatusException</td>
<td style="text-align:left">计费状态异常。</td>
</tr>
</tbody>
</table>
]]></content:encoded>
      <pubDate>Wed, 08 Apr 2026 14:04:35 +0800</pubDate>
      <guid>http://doc.talkingdata.com/posts/1228</guid>
      <comments>http://doc.talkingdata.com/posts/1228#comments</comments>
    </item>
    <item>
      <title>TD云绘8/Tencent-图像风格化（图生图）</title>
      <link>http://doc.talkingdata.com/posts/1227</link>
      <category>图片生成 API</category>
      <author>liuxinmei</author>
      <description>云绘8 接口说明文档 TD模型编号：T0302003 模型能力简介 云绘8 图像风格化（图生图）：根据您输入的图片（URL或Base64） + 文本描述（Prompt，可选） + 参数（可选） 生成风格转化后的目标图像。支持风格选择、画质增强、面部细节修复、生成自由度调节等功能。建议避免输入人像过小、姿势复杂、人数较多的图片。 鉴权说明  本接口仅支持API Key鉴权，需联系TD运维同学获取长效API Key。
 图像风格化（图生图）接口地址 请求方法： POST 接口URL：https://modelpool-api.talkingdata.com/model/orgin/job 请求头（Request Headers）： 头部字段 值 是否必需 说明 Authorization Bea</description>
      <content:encoded><![CDATA[<h4 id="%3Cstrong%3E%E4%BA%91%E7%BB%988%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3%3C%2Fstrong%3E" name="%3Cstrong%3E%E4%BA%91%E7%BB%988%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3%3C%2Fstrong%3E"><strong>云绘8 接口说明文档</strong></h4>
<p><strong>TD模型编号：T0302003</strong></p>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%A8%A1%E5%9E%8B%E8%83%BD%E5%8A%9B%E7%AE%80%E4%BB%8B" name="%E6%A8%A1%E5%9E%8B%E8%83%BD%E5%8A%9B%E7%AE%80%E4%BB%8B">模型能力简介</h2>
<p><span id="Hrya4y9k"></span></p>
<ul>
<li><strong>云绘8</strong><ul>
<li><strong>图像风格化（图生图）</strong>：根据您输入的<strong>图片（URL或Base64）</strong> + <strong>文本描述（Prompt，可选）</strong> + <strong>参数（可选）</strong> 生成风格转化后的目标图像。支持风格选择、画质增强、面部细节修复、生成自由度调节等功能。建议避免输入人像过小、姿势复杂、人数较多的图片。</li>
</ul>
</li>
</ul>
<h5 id="%3Cstrong%3E%E9%89%B4%E6%9D%83%E8%AF%B4%E6%98%8E%3C%2Fstrong%3E%26nbsp%3B" name="%3Cstrong%3E%E9%89%B4%E6%9D%83%E8%AF%B4%E6%98%8E%3C%2Fstrong%3E%26nbsp%3B"><strong>鉴权说明</strong>&nbsp;</h5>
<pre><code>本接口仅支持API Key鉴权，需联系TD运维同学获取长效API Key。
</code></pre><hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E5%9B%BE%E5%83%8F%E9%A3%8E%E6%A0%BC%E5%8C%96%EF%BC%88%E5%9B%BE%E7%94%9F%E5%9B%BE%EF%BC%89%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80" name="%E5%9B%BE%E5%83%8F%E9%A3%8E%E6%A0%BC%E5%8C%96%EF%BC%88%E5%9B%BE%E7%94%9F%E5%9B%BE%EF%BC%89%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80">图像风格化（图生图）接口地址</h2>
<p><span id="Hrya4y9k"></span></p>
<p><strong>请求方法：</strong> POST</p>
<p><strong>接口URL：</strong><code>https://modelpool-api.talkingdata.com/model/orgin/job</code> </p>
<p><strong>请求头（Request Headers）：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">头部字段</th>
<th style="text-align:left">值</th>
<th style="text-align:left">是否必需</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>Authorization</code></td>
<td style="text-align:left"><code>Bearer &lt;your_api_key&gt;</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">API 鉴权凭证，请替换为有效的 API Key</td>
</tr>
<tr>
<td style="text-align:left"><code>X-Timestamp</code></td>
<td style="text-align:left"><code>1700000000</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">Unix 时间戳格式</td>
</tr>
<tr>
<td style="text-align:left"><code>Content-Type</code></td>
<td style="text-align:left"><code>application/json</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">请求体格式必须为 JSON</td>
</tr>
<tr>
<td style="text-align:left"><code>X-TC-Action</code></td>
<td style="text-align:left"><code>T0302003</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">固定值</td>
</tr>
</tbody>
</table>
<p><strong>请求参数（Request  Parameter）：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">字段</th>
<th style="text-align:left">值</th>
<th style="text-align:left">是否必需</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>requestld</code></td>
<td style="text-align:left"><code>550e8400-e29b-41d4-a716-446655440000</code></td>
<td style="text-align:left">否</td>
<td style="text-align:left">请求唯一标识符。使用 UUID 格式字符串，用于跟踪和排查请求相关问题，以便在需要技术排查时，提供此 ID 可快速定位具体请求的完整处理链路和日志信息。</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E5%9B%BE%E5%83%8F%E9%A3%8E%E6%A0%BC%E5%8C%96%EF%BC%88%E5%9B%BE%E7%94%9F%E5%9B%BE%EF%BC%89%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0" name="%E5%9B%BE%E5%83%8F%E9%A3%8E%E6%A0%BC%E5%8C%96%EF%BC%88%E5%9B%BE%E7%94%9F%E5%9B%BE%EF%BC%89%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0">图像风格化（图生图）请求参数</h2>
<p><span id="Hrya4y9k"></span></p>
<h3 id="%E5%9B%BE%E5%83%8F%E9%A3%8E%E6%A0%BC%E5%8C%96%EF%BC%88%E5%9B%BE%E7%94%9F%E5%9B%BE%EF%BC%89%E8%AF%B7%E6%B1%82%E4%BD%93%EF%BC%88requestBody%EF%BC%89" name="%E5%9B%BE%E5%83%8F%E9%A3%8E%E6%A0%BC%E5%8C%96%EF%BC%88%E5%9B%BE%E7%94%9F%E5%9B%BE%EF%BC%89%E8%AF%B7%E6%B1%82%E4%BD%93%EF%BC%88requestBody%EF%BC%89">图像风格化（图生图）请求体（requestBody）</h3>
<table>
<thead>
<tr>
<th style="text-align:left">参数</th>
<th style="text-align:left">类型</th>
<th style="text-align:left">必选</th>
<th style="text-align:left">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>InputImage</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">输入图的Base64编码数据。<code>InputImage</code> 和 <code>InputUrl</code> 必须提供一个，如果都提供以 <code>InputUrl</code> 为准。图片限制：单边分辨率50~5000，Base64后＜8MB，格式支持 jpg/jpeg/png/bmp/tiff/webp。</td>
</tr>
<tr>
<td style="text-align:left"><code>InputUrl</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">输入图的URL地址。<code>InputImage</code> 和 <code>InputUrl</code> 必须提供一个，如果都提供以 <code>InputUrl</code> 为准。图片限制同上。</td>
</tr>
<tr>
<td style="text-align:left"><code>Prompt</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">文本描述，用于在输入图基础上引导生成图效果。推荐使用中文，最多256个UTF-8字符。</td>
</tr>
<tr>
<td style="text-align:left"><code>NegativePrompt</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">反向文本描述，减少生成结果中出现描述内容。推荐使用中文，最多256个UTF-8字符。</td>
</tr>
<tr>
<td style="text-align:left"><code>Styles.N</code></td>
<td style="text-align:left">Array of String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">绘画风格编号。推荐只使用一种风格，不传默认使用<code>201</code>（日系动漫风格）。</td>
</tr>
<tr>
<td style="text-align:left"><code>ResultConfig</code></td>
<td style="text-align:left">Object</td>
<td style="text-align:left">否</td>
<td style="text-align:left">生成图结果的配置，包括输出分辨率。支持：<code>origin</code>（与输入图一致，长边最高2000）、<code>768:768</code>（1:1）、<code>768:1024</code>（3:4）、<code>1024:768</code>（4:3）。不传默认<code>origin</code>。</td>
</tr>
<tr>
<td style="text-align:left"><code>LogoAdd</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">否</td>
<td style="text-align:left">是否添加水印标识。<code>1</code>：添加（默认）；<code>0</code>：不添加。建议添加以提示AI生成。</td>
</tr>
<tr>
<td style="text-align:left"><code>LogoParam</code></td>
<td style="text-align:left">Object</td>
<td style="text-align:left">否</td>
<td style="text-align:left">自定义标识内容。默认在右下角添加“图片由 AI 生成”字样，可替换为其他标识图片。</td>
</tr>
<tr>
<td style="text-align:left"><code>Strength</code></td>
<td style="text-align:left">Float</td>
<td style="text-align:left">否</td>
<td style="text-align:left">生成自由度。取值范围(0, 1]，值越小生成图和原图越接近。推荐范围0.6~0.8。不传使用模型默认值。</td>
</tr>
<tr>
<td style="text-align:left"><code>RspImgType</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">返回图像方式，<code>base64</code>或<code>url</code>，二选一，默认为<code>base64</code>。url有效期为1小时。<strong>注意</strong>：您的真实调用未传该参数，默认返回Base64编码。</td>
</tr>
<tr>
<td style="text-align:left"><code>EnhanceImage</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">否</td>
<td style="text-align:left">画质增强开关。<code>1</code>：开启；<code>0</code>：关闭（默认）。开启后增强画质清晰度，耗时增加。</td>
</tr>
<tr>
<td style="text-align:left"><code>RestoreFace</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">否</td>
<td style="text-align:left">细节优化的面部数量上限，支持0~6，默认为0。若大于0，将以此上限对面积较小的面部进行细节修复，耗时增加。</td>
</tr>
</tbody>
</table>
<h2 id="%E5%9B%BE%E5%83%8F%E9%A3%8E%E6%A0%BC%E5%8C%96%EF%BC%88%E5%9B%BE%E7%94%9F%E5%9B%BE%EF%BC%89%E8%BF%94%E5%9B%9E%E5%8F%82%E6%95%B0" name="%E5%9B%BE%E5%83%8F%E9%A3%8E%E6%A0%BC%E5%8C%96%EF%BC%88%E5%9B%BE%E7%94%9F%E5%9B%BE%EF%BC%89%E8%BF%94%E5%9B%9E%E5%8F%82%E6%95%B0">图像风格化（图生图）返回参数</h2>
<table>
<thead>
<tr>
<th style="text-align:left">参数</th>
<th style="text-align:left">类型</th>
<th style="text-align:left">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>ResultImage</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">生成的图像。根据入参 <code>RspImgType</code> 返回不同内容：若传入 <code>base64</code>（或不传，默认），返回生成图的Base64编码；若传入 <code>url</code>，返回生成图的URL（有效期1小时）。</td>
</tr>
<tr>
<td style="text-align:left"><code>RequestId</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">唯一请求ID，由服务端生成，用于问题定位。</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E5%9B%BE%E5%83%8F%E9%A3%8E%E6%A0%BC%E5%8C%96%EF%BC%88%E5%9B%BE%E7%94%9F%E5%9B%BE%EF%BC%89%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B" name="%E5%9B%BE%E5%83%8F%E9%A3%8E%E6%A0%BC%E5%8C%96%EF%BC%88%E5%9B%BE%E7%94%9F%E5%9B%BE%EF%BC%89%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B">图像风格化（图生图）调用示例</h2>
<p><span id="Hrya4y9k"></span></p>
<p>请求示例：</p>
<pre><code class="lang-Curl">curl -X POST &#39;https://modelpool-api.talkingdata.com/model/orgin/job?requestId=550e8400-e29b-41d4-a716-446655440000&#39; \
  -H &#39;Content-Type: application/json&#39; \
  -H &#39;Authorization: Bearer YOUR_API_KEY&#39; \
  -H &#39;X-Timestamp: 1760000000&#39; \
  -H &#39;X-TC-Action: T0302003&#39; \
  -d &#39;{
    &quot;InputUrl&quot;: &quot;https://td-llm.tos-cn-beijing.volces.com/public/1774320434562_2b131e.png&quot;,
    &quot;Prompt&quot;: &quot;清新自然&quot;,
    &quot;Styles&quot;: [
        &quot;201&quot;
    ],
    &quot;ResultConfig&quot;: {
        &quot;Resolution&quot;: &quot;768:768&quot;
    }
}&#39;
</code></pre>
<p>响应示例：</p>
<pre><code>{
    &quot;Response&quot;: {
        &quot;ResultImage&quot;: &quot;iVBORw0KGgoAAAANSUhEUgAAB9AAAAfQCAIAAAAVWlMuAA&quot;,
        &quot;RequestId&quot;: &quot;34a6f4b8-67dd-4186-a3ca-853aae01f5f6&quot;
    }
}
</code></pre><hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E9%94%99%E8%AF%AF%E7%A0%81" name="%E9%94%99%E8%AF%AF%E7%A0%81">错误码</h2>
<table>
<thead>
<tr>
<th style="text-align:left">错误码</th>
<th style="text-align:left">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left">AuthFailure.UnauthorizedOperation</td>
<td style="text-align:left">无权执行该操作。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.GenerateImageFailed</td>
<td style="text-align:left">生成图片审核不通过，请重试。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.ImageDecodeFailed</td>
<td style="text-align:left">图片解码失败。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.ImageDownloadError</td>
<td style="text-align:left">图片下载错误。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.ImageResolutionExceed</td>
<td style="text-align:left">图片分辨率过大，超过2000*2000。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.ImageSizeExceed</td>
<td style="text-align:left">base64编码后的图片数据大小不超过10M。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.InnerError</td>
<td style="text-align:left">服务内部错误，请稍后重试。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.RequestEntityTooLarge</td>
<td style="text-align:left">整个请求体太大（通常主要是图片）。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.RequestTimeout</td>
<td style="text-align:left">后端服务超时。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.ServerError</td>
<td style="text-align:left">服务内部错误。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.Unknown</td>
<td style="text-align:left">未知错误。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameter.InvalidParameter</td>
<td style="text-align:left">参数不合法。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameterValue.ImageEmpty</td>
<td style="text-align:left">图片为空。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameterValue.ParameterValueError</td>
<td style="text-align:left">参数字段或者值有误</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameterValue.StyleConflict</td>
<td style="text-align:left">1xx和其他风格不可混合使用。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameterValue.TextLengthExceed</td>
<td style="text-align:left">输入文本过长，请更换短一点的文本后重试。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameterValue.UrlIllegal</td>
<td style="text-align:left">URL格式不合法。</td>
</tr>
<tr>
<td style="text-align:left">OperationDenied.ImageIllegalDetected</td>
<td style="text-align:left">图片包含违法违规信息，审核不通过。</td>
</tr>
<tr>
<td style="text-align:left">OperationDenied.TextIllegalDetected</td>
<td style="text-align:left">文本包含违法违规信息，审核不通过。</td>
</tr>
<tr>
<td style="text-align:left">RequestLimitExceeded</td>
<td style="text-align:left">请求的次数超过了频率限制。</td>
</tr>
<tr>
<td style="text-align:left">RequestLimitExceeded.JobNumExceed</td>
<td style="text-align:left">同时处理的任务数过多，请稍后重试。</td>
</tr>
<tr>
<td style="text-align:left">ResourcesSoldOut.ChargeStatusException</td>
<td style="text-align:left">计费状态异常。</td>
</tr>
</tbody>
</table>
]]></content:encoded>
      <pubDate>Wed, 08 Apr 2026 13:51:04 +0800</pubDate>
      <guid>http://doc.talkingdata.com/posts/1227</guid>
      <comments>http://doc.talkingdata.com/posts/1227#comments</comments>
    </item>
    <item>
      <title>TD云绘7/Tencent-混元生图（极速版）</title>
      <link>http://doc.talkingdata.com/posts/1226</link>
      <category>图片生成 API</category>
      <author>liuxinmei</author>
      <description>云绘7 接口说明文档 TD模型编号：T0302002 模型能力简介 云绘7 文生图（极速版）：根据您输入的文本描述（Prompt） + 反向提示词（NegativePrompt，可选） + 参数（可选） 快速生成目标图像。支持分辨率调节、随机种子控制、水印开关、返回格式选择（Base64或URL）等功能。 鉴权说明  本接口仅支持API Key鉴权，需联系TD运维同学获取长效API Key。
 混元生图（极速版）接口地址 请求方法： POST 接口URL：https://modelpool-api.talkingdata.com/model/orgin/job 请求头（Request Headers）： 头部字段 值 是否必需 说明 Authorization Bearer &lt;your_ap</description>
      <content:encoded><![CDATA[<h4 id="%3Cstrong%3E%E4%BA%91%E7%BB%987%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3%3C%2Fstrong%3E" name="%3Cstrong%3E%E4%BA%91%E7%BB%987%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3%3C%2Fstrong%3E"><strong>云绘7 接口说明文档</strong></h4>
<p><strong>TD模型编号：T0302002</strong></p>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%A8%A1%E5%9E%8B%E8%83%BD%E5%8A%9B%E7%AE%80%E4%BB%8B" name="%E6%A8%A1%E5%9E%8B%E8%83%BD%E5%8A%9B%E7%AE%80%E4%BB%8B">模型能力简介</h2>
<p><span id="Hrya4y9k"></span></p>
<ul>
<li><strong>云绘7</strong><ul>
<li><strong>文生图（极速版）</strong>：根据您输入的<strong>文本描述（Prompt）</strong> + <strong>反向提示词（NegativePrompt，可选）</strong> + <strong>参数（可选）</strong> 快速生成目标图像。支持分辨率调节、随机种子控制、水印开关、返回格式选择（Base64或URL）等功能。</li>
</ul>
</li>
</ul>
<h5 id="%3Cstrong%3E%E9%89%B4%E6%9D%83%E8%AF%B4%E6%98%8E%3C%2Fstrong%3E%26nbsp%3B" name="%3Cstrong%3E%E9%89%B4%E6%9D%83%E8%AF%B4%E6%98%8E%3C%2Fstrong%3E%26nbsp%3B"><strong>鉴权说明</strong>&nbsp;</h5>
<pre><code>本接口仅支持API Key鉴权，需联系TD运维同学获取长效API Key。
</code></pre><hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%88%E6%9E%81%E9%80%9F%E7%89%88%EF%BC%89%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80" name="%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%88%E6%9E%81%E9%80%9F%E7%89%88%EF%BC%89%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80">混元生图（极速版）接口地址</h2>
<p><span id="Hrya4y9k"></span></p>
<p><strong>请求方法：</strong> POST</p>
<p><strong>接口URL：</strong><code>https://modelpool-api.talkingdata.com/model/orgin/job</code> </p>
<p><strong>请求头（Request Headers）：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">头部字段</th>
<th style="text-align:left">值</th>
<th style="text-align:left">是否必需</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>Authorization</code></td>
<td style="text-align:left"><code>Bearer &lt;your_api_key&gt;</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">API 鉴权凭证，请替换为有效的 API Key</td>
</tr>
<tr>
<td style="text-align:left"><code>X-Timestamp</code></td>
<td style="text-align:left"><code>1700000000</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">Unix 时间戳格式</td>
</tr>
<tr>
<td style="text-align:left"><code>Content-Type</code></td>
<td style="text-align:left"><code>application/json</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">请求体格式必须为 JSON</td>
</tr>
<tr>
<td style="text-align:left"><code>X-TC-Action</code></td>
<td style="text-align:left"><code>T0302002</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">固定值</td>
</tr>
</tbody>
</table>
<p><strong>请求参数（Request  Parameter）：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">字段</th>
<th style="text-align:left">值</th>
<th style="text-align:left">是否必需</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>requestld</code></td>
<td style="text-align:left"><code>550e8400-e29b-41d4-a716-446655440000</code></td>
<td style="text-align:left">否</td>
<td style="text-align:left">请求唯一标识符。使用 UUID 格式字符串，用于跟踪和排查请求相关问题，以便在需要技术排查时，提供此 ID 可快速定位具体请求的完整处理链路和日志信息。</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%88%E6%9E%81%E9%80%9F%E7%89%88%EF%BC%89%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0" name="%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%88%E6%9E%81%E9%80%9F%E7%89%88%EF%BC%89%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0">混元生图（极速版）请求参数</h2>
<p><span id="Hrya4y9k"></span></p>
<h3 id="%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%88%E6%9E%81%E9%80%9F%E7%89%88%EF%BC%89%E8%AF%B7%E6%B1%82%E4%BD%93%EF%BC%88requestBody%EF%BC%89" name="%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%88%E6%9E%81%E9%80%9F%E7%89%88%EF%BC%89%E8%AF%B7%E6%B1%82%E4%BD%93%EF%BC%88requestBody%EF%BC%89">混元生图（极速版）请求体（requestBody）</h3>
<table>
<thead>
<tr>
<th style="text-align:left">参数</th>
<th style="text-align:left">类型</th>
<th style="text-align:left">必选</th>
<th style="text-align:left">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>Prompt</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">是</td>
<td style="text-align:left">文本描述。算法根据输入的文本智能生成相关图像。推荐使用中文，最多1024个UTF-8字符。</td>
</tr>
<tr>
<td style="text-align:left"><code>NegativePrompt</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">反向提示词。减少生成结果中出现描述内容。推荐使用中文，最多1024个UTF-8字符。</td>
</tr>
<tr>
<td style="text-align:left"><code>Resolution</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">生成图分辨率，默认<code>&quot;1024:1024&quot;</code>。支持的宽高比例：1:1、3:4、4:3、9:16、16:9。支持的长边分辨率：160、200、225、258、512、520、608、768、1024、1080、1280、1600、1620、1920、2048、2400、2560、2592、3440、3840、4096。</td>
</tr>
<tr>
<td style="text-align:left"><code>Seed</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">否</td>
<td style="text-align:left">随机种子。<code>0</code>或不传：随机种子生成；传正数：固定种子生成。</td>
</tr>
<tr>
<td style="text-align:left"><code>LogoAdd</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">否</td>
<td style="text-align:left">是否添加水印标识。<code>1</code>：添加（默认）；<code>0</code>：不添加。建议添加以提示AI生成。</td>
</tr>
<tr>
<td style="text-align:left"><code>LogoParam</code></td>
<td style="text-align:left">Object</td>
<td style="text-align:left">否</td>
<td style="text-align:left">自定义标识内容。默认在右下角添加“图片由 AI 生成”字样，可替换为其他标识图片。</td>
</tr>
<tr>
<td style="text-align:left"><code>RspImgType</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">返回图像方式，<code>base64</code>或<code>url</code>，二选一，默认为<code>base64</code>。url有效期为1小时。</td>
</tr>
</tbody>
</table>
<h2 id="%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%88%E6%9E%81%E9%80%9F%E7%89%88%EF%BC%89%E8%BF%94%E5%9B%9E%E5%8F%82%E6%95%B0" name="%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%88%E6%9E%81%E9%80%9F%E7%89%88%EF%BC%89%E8%BF%94%E5%9B%9E%E5%8F%82%E6%95%B0">混元生图（极速版）返回参数</h2>
<table>
<thead>
<tr>
<th style="text-align:left">参数</th>
<th style="text-align:left">类型</th>
<th style="text-align:left">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>ResultImage</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">生成的图像。根据入参 <code>RspImgType</code> 返回不同内容：若传入 <code>base64</code>，返回生成图的Base64编码；若传入 <code>url</code>，返回生成图的URL（<strong>有效期1小时</strong>，请及时保存）。</td>
</tr>
<tr>
<td style="text-align:left"><code>Seed</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">实际使用的随机种子。若入参传 <code>0</code> 或不传，返回系统生成的随机种子；若传入正数固定种子，则返回该值。</td>
</tr>
<tr>
<td style="text-align:left"><code>RequestId</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">唯一请求ID，由服务端生成，用于问题定位。</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%88%E6%9E%81%E9%80%9F%E7%89%88%EF%BC%89%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B" name="%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%88%E6%9E%81%E9%80%9F%E7%89%88%EF%BC%89%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B">混元生图（极速版）调用示例</h2>
<p><span id="Hrya4y9k"></span></p>
<p>请求示例：</p>
<pre><code class="lang-Curl">curl -X POST &#39;https://modelpool-api.talkingdata.com/model/orgin/job?requestId=550e8400-e29b-41d4-a716-446655440000&#39; \
  -H &#39;Content-Type: application/json&#39; \
  -H &#39;Authorization: Bearer YOUR_API_KEY&#39; \
  -H &#39;X-Timestamp: 1760000000&#39; \
  -H &#39;X-TC-Action: T0302002&#39; \
  -d &#39;{
    &quot;Prompt&quot;: &quot;雨中竹林小路，水墨风格，高清，细节丰富&quot;,
    &quot;NegativePrompt&quot;: &quot;模糊，低画质，水印，文字&quot;,
    &quot;Resolution&quot;: &quot;1024:1024&quot;,
    &quot;Seed&quot;: 0,
    &quot;LogoAdd&quot;: 0,
    &quot;RspImgType&quot;: &quot;https://td-llm.tos-cn-beijing.volces.com/public/1774320434562_2b131e.png&quot;
}&#39;
</code></pre>
<p>响应示例：</p>
<pre><code>{
    &quot;Response&quot;: {
        &quot;RequestId&quot;: &quot;d5d96b7a-7fe3-4ea2-9dce-504e2c0d63cd&quot;,
        &quot;ResultImage&quot;: &quot;https://xxx.cos.ap-guangzhou.myqcloud.com/xxx.jpg&quot;,
        &quot;Seed&quot;: 2068699513
    }
}
</code></pre><hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E9%94%99%E8%AF%AF%E7%A0%81" name="%E9%94%99%E8%AF%AF%E7%A0%81">错误码</h2>
<table>
<thead>
<tr>
<th style="text-align:left">错误码</th>
<th style="text-align:left">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left">AuthFailure.UnauthorizedOperation</td>
<td style="text-align:left">无权执行该操作。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.ConsoleServerError</td>
<td style="text-align:left">控制台服务异常。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.GenerateImageFailed</td>
<td style="text-align:left">生成图片审核不通过，请重试。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.ImageDecodeFailed</td>
<td style="text-align:left">图片解码失败。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.ImageDownloadError</td>
<td style="text-align:left">图片下载错误。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.InnerError</td>
<td style="text-align:left">服务内部错误，请稍后重试。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.ModerationFailed</td>
<td style="text-align:left">审核失败</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.RequestEntityTooLarge</td>
<td style="text-align:left">整个请求体太大（通常主要是图片）。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.RequestTimeout</td>
<td style="text-align:left">后端服务超时。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.ServerError</td>
<td style="text-align:left">服务内部错误。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.Unknown</td>
<td style="text-align:left">未知错误。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameter.InvalidParameter</td>
<td style="text-align:left">参数不合法。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameterValue.ImageEmpty</td>
<td style="text-align:left">图片为空。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameterValue.ParameterValueError</td>
<td style="text-align:left">参数字段或者值有误</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameterValue.TextLengthExceed</td>
<td style="text-align:left">输入文本过长，请更换短一点的文本后重试。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameterValue.UrlIllegal</td>
<td style="text-align:left">URL格式不合法。</td>
</tr>
<tr>
<td style="text-align:left">OperationDenied.ImageIllegalDetected</td>
<td style="text-align:left">图片包含违法违规信息，审核不通过。</td>
</tr>
<tr>
<td style="text-align:left">OperationDenied.TextIllegalDetected</td>
<td style="text-align:left">文本包含违法违规信息，审核不通过。</td>
</tr>
<tr>
<td style="text-align:left">RequestLimitExceeded</td>
<td style="text-align:left">请求的次数超过了频率限制。</td>
</tr>
<tr>
<td style="text-align:left">RequestLimitExceeded.JobNumExceed</td>
<td style="text-align:left">同时处理的任务数过多，请稍后重试。</td>
</tr>
<tr>
<td style="text-align:left">ResourcesSoldOut.ChargeStatusException</td>
<td style="text-align:left">计费状态异常。</td>
</tr>
</tbody>
</table>
]]></content:encoded>
      <pubDate>Wed, 08 Apr 2026 11:37:40 +0800</pubDate>
      <guid>http://doc.talkingdata.com/posts/1226</guid>
      <comments>http://doc.talkingdata.com/posts/1226#comments</comments>
    </item>
    <item>
      <title>TD云绘6/Tencent-混元生图3.0</title>
      <link>http://doc.talkingdata.com/posts/1225</link>
      <category>图片生成 API</category>
      <author>liuxinmei</author>
      <description>云绘6 接口说明文档 TD模型编号：T0302001 模型能力简介 云绘6 文生图：根据您输入的文本描述（Prompt） + 参数（可选） 生成目标图像。支持参考图引导、分辨率调节、随机种子控制、水印开关、Prompt改写优化等功能。 鉴权说明  本接口仅支持API Key鉴权，需联系TD运维同学获取长效API Key。
 提交混元生图（3.0）任务接口地址 请求方法： POST 接口URL：https://modelpool-api.talkingdata.com/model/orgin/job 请求头（Request Headers）： 头部字段 值 是否必需 说明 Authorization Bearer &lt;your_api_key&gt; 是 API 鉴权凭证，请替换为有效的 API Ke</description>
      <content:encoded><![CDATA[<h4 id="%3Cstrong%3E%E4%BA%91%E7%BB%986%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3%3C%2Fstrong%3E" name="%3Cstrong%3E%E4%BA%91%E7%BB%986%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3%3C%2Fstrong%3E"><strong>云绘6 接口说明文档</strong></h4>
<p><strong>TD模型编号：T0302001</strong></p>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%A8%A1%E5%9E%8B%E8%83%BD%E5%8A%9B%E7%AE%80%E4%BB%8B" name="%E6%A8%A1%E5%9E%8B%E8%83%BD%E5%8A%9B%E7%AE%80%E4%BB%8B">模型能力简介</h2>
<p><span id="Hrya4y9k"></span></p>
<ul>
<li><strong>云绘6</strong><ul>
<li><strong>文生图</strong>：根据您输入的<strong>文本描述（Prompt）</strong> + <strong>参数（可选）</strong> 生成目标图像。支持参考图引导、分辨率调节、随机种子控制、水印开关、Prompt改写优化等功能。</li>
</ul>
</li>
</ul>
<h5 id="%3Cstrong%3E%E9%89%B4%E6%9D%83%E8%AF%B4%E6%98%8E%3C%2Fstrong%3E%26nbsp%3B" name="%3Cstrong%3E%E9%89%B4%E6%9D%83%E8%AF%B4%E6%98%8E%3C%2Fstrong%3E%26nbsp%3B"><strong>鉴权说明</strong>&nbsp;</h5>
<pre><code>本接口仅支持API Key鉴权，需联系TD运维同学获取长效API Key。
</code></pre><hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%8F%90%E4%BA%A4%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%883.0%EF%BC%89%E4%BB%BB%E5%8A%A1%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80" name="%E6%8F%90%E4%BA%A4%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%883.0%EF%BC%89%E4%BB%BB%E5%8A%A1%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80">提交混元生图（3.0）任务接口地址</h2>
<p><span id="Hrya4y9k"></span></p>
<p><strong>请求方法：</strong> POST</p>
<p><strong>接口URL：</strong><code>https://modelpool-api.talkingdata.com/model/orgin/job</code> </p>
<p><strong>请求头（Request Headers）：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">头部字段</th>
<th style="text-align:left">值</th>
<th style="text-align:left">是否必需</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>Authorization</code></td>
<td style="text-align:left"><code>Bearer &lt;your_api_key&gt;</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">API 鉴权凭证，请替换为有效的 API Key</td>
</tr>
<tr>
<td style="text-align:left"><code>X-Timestamp</code></td>
<td style="text-align:left"><code>1700000000</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">Unix 时间戳格式</td>
</tr>
<tr>
<td style="text-align:left"><code>Content-Type</code></td>
<td style="text-align:left"><code>application/json</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">请求体格式必须为 JSON</td>
</tr>
<tr>
<td style="text-align:left"><code>X-TC-Action</code></td>
<td style="text-align:left"><code>T0302001</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">固定值</td>
</tr>
</tbody>
</table>
<p><strong>请求参数（Request  Parameter）：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">字段</th>
<th style="text-align:left">值</th>
<th style="text-align:left">是否必需</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>requestld</code></td>
<td style="text-align:left"><code>550e8400-e29b-41d4-a716-446655440000</code></td>
<td style="text-align:left">否</td>
<td style="text-align:left">请求唯一标识符。使用 UUID 格式字符串，用于跟踪和排查请求相关问题，以便在需要技术排查时，提供此 ID 可快速定位具体请求的完整处理链路和日志信息。</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%8F%90%E4%BA%A4%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%883.0%EF%BC%89%E4%BB%BB%E5%8A%A1%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0" name="%E6%8F%90%E4%BA%A4%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%883.0%EF%BC%89%E4%BB%BB%E5%8A%A1%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0">提交混元生图（3.0）任务请求参数</h2>
<p><span id="Hrya4y9k"></span></p>
<h3 id="%E6%8F%90%E4%BA%A4%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%883.0%EF%BC%89%E4%BB%BB%E5%8A%A1%E8%AF%B7%E6%B1%82%E4%BD%93%EF%BC%88requestBody%EF%BC%89" name="%E6%8F%90%E4%BA%A4%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%883.0%EF%BC%89%E4%BB%BB%E5%8A%A1%E8%AF%B7%E6%B1%82%E4%BD%93%EF%BC%88requestBody%EF%BC%89">提交混元生图（3.0）任务请求体（requestBody）</h3>
<table>
<thead>
<tr>
<th style="text-align:left">参数</th>
<th style="text-align:left">类型</th>
<th style="text-align:left">必选</th>
<th style="text-align:left">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>Prompt</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">是</td>
<td style="text-align:left">文本描述。算法根据输入的文本智能生成相关图像。推荐使用中文，最多8192个UTF-8字符。</td>
</tr>
<tr>
<td style="text-align:left"><code>Images</code></td>
<td style="text-align:left">Array of String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">参考图，最多3张。支持Base64或URL。单张图片base64后大小＜6M，格式支持jpg/jpeg/png/bmp/tiff/webp。</td>
</tr>
<tr>
<td style="text-align:left"><code>Resolution</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">生成图分辨率，格式为<code>&quot;宽:高&quot;</code>。默认<code>&quot;1024:1024&quot;</code>。宽高范围512~2048像素，宽高乘积≤1024×1024。支持多种预设比例（详见下方尺寸列表）。</td>
</tr>
<tr>
<td style="text-align:left"><code>Seed</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">否</td>
<td style="text-align:left">随机种子。不传则随机生成；传正整数则固定种子（开启改写时固定种子不生效）。</td>
</tr>
<tr>
<td style="text-align:left"><code>LogoAdd</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">否</td>
<td style="text-align:left">是否添加水印标识。<code>1</code>：添加（默认）；<code>0</code>：不添加。建议添加以提示AI生成。</td>
</tr>
<tr>
<td style="text-align:left"><code>LogoParam</code></td>
<td style="text-align:left">Object</td>
<td style="text-align:left">否</td>
<td style="text-align:left">自定义标识内容。默认在右下角添加“图片由 AI 生成”字样，可替换为其他标识图片。</td>
</tr>
<tr>
<td style="text-align:left"><code>Revise</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">否</td>
<td style="text-align:left">是否开启Prompt改写。<code>1</code>：开启（默认，增加约20s耗时）；<code>0</code>：关闭。建议开启以获得更好效果。</td>
</tr>
</tbody>
</table>
<h2 id="%E6%8F%90%E4%BA%A4%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%883.0%EF%BC%89%E4%BB%BB%E5%8A%A1%E8%BF%94%E5%9B%9E%E5%8F%82%E6%95%B0" name="%E6%8F%90%E4%BA%A4%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%883.0%EF%BC%89%E4%BB%BB%E5%8A%A1%E8%BF%94%E5%9B%9E%E5%8F%82%E6%95%B0">提交混元生图（3.0）任务返回参数</h2>
<table>
<thead>
<tr>
<th style="text-align:left">参数名</th>
<th style="text-align:left">类型</th>
<th style="text-align:left">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>JobId</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">异步任务ID，用于后续查询任务状态或结果。</td>
</tr>
<tr>
<td style="text-align:left"><code>RequestId</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">唯一请求ID，由服务端生成，用于定位问题或对接技术支持。</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%8F%90%E4%BA%A4%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%883.0%EF%BC%89%E4%BB%BB%E5%8A%A1%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B" name="%E6%8F%90%E4%BA%A4%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%883.0%EF%BC%89%E4%BB%BB%E5%8A%A1%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B">提交混元生图（3.0）任务调用示例</h2>
<p><span id="Hrya4y9k"></span></p>
<p>请求示例：</p>
<pre><code class="lang-Curl">curl -X POST &#39;https://modelpool-api.talkingdata.com/model/orgin/job?requestId=550e8400-e29b-41d4-a716-446655440000&#39; \
  -H &#39;Content-Type: application/json&#39; \
  -H &#39;Authorization: Bearer YOUR_API_KEY&#39; \
  -H &#39;X-Timestamp: 1760000000&#39; \
  -H &#39;X-TC-Action: T0302001&#39; \
  -d &#39;{
    &quot;Prompt&quot;: &quot;海边日落，唯美治愈，高清细节，电影质感&quot;
}&#39;
</code></pre>
<p>响应示例：</p>
<pre><code>{
    &quot;Response&quot;: {
        &quot;JobId&quot;: &quot;1395528311-1774940679-e2608c2c-2ccf-11f1-b65b-52540018a910-0&quot;,
        &quot;RequestId&quot;: &quot;66bb4939-ef3a-4d29-bad0-79fddbb9cfe6&quot;
    }
}
</code></pre><hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%9F%A5%E8%AF%A2%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%883.0%EF%BC%89%E4%BB%BB%E5%8A%A1%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80" name="%E6%9F%A5%E8%AF%A2%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%883.0%EF%BC%89%E4%BB%BB%E5%8A%A1%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80">查询混元生图（3.0）任务接口地址</h2>
<p><span id="Hrya4y9k"></span></p>
<p>根据提交任务时返回的 <code>JobId</code>，查询文生图任务的执行状态和结果。支持获取任务状态（等待/运行中/成功/失败）、生成图片URL、改写后的Prompt、错误信息等。</p>
<p><strong>请求方法：</strong> POST</p>
<p><strong>接口URL：</strong><code>https://modelpool-api.talkingdata.com/model/orgin/job</code> </p>
<p><strong>请求头（Request Headers）：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">头部字段</th>
<th style="text-align:left">值</th>
<th style="text-align:left">是否必需</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>Authorization</code></td>
<td style="text-align:left"><code>Bearer &lt;your_api_key&gt;</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">API 鉴权凭证，请替换为有效的 API Key</td>
</tr>
<tr>
<td style="text-align:left"><code>X-Timestamp</code></td>
<td style="text-align:left"><code>1700000000</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">Unix 时间戳格式</td>
</tr>
<tr>
<td style="text-align:left"><code>Content-Type</code></td>
<td style="text-align:left"><code>application/json</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">请求体格式必须为 JSON</td>
</tr>
<tr>
<td style="text-align:left"><code>X-TC-Action</code></td>
<td style="text-align:left"><code>QueryTextToImageJob</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">固定值</td>
</tr>
</tbody>
</table>
<p><strong>请求参数（Request  Parameter）：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">字段</th>
<th style="text-align:left">值</th>
<th style="text-align:left">是否必需</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>requestld</code></td>
<td style="text-align:left"><code>550e8400-e29b-41d4-a716-446655440000</code></td>
<td style="text-align:left">否</td>
<td style="text-align:left">请求唯一标识符。使用 UUID 格式字符串，用于跟踪和排查请求相关问题，以便在需要技术排查时，提供此 ID 可快速定位具体请求的完整处理链路和日志信息。</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%9F%A5%E8%AF%A2%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%883.0%EF%BC%89%E4%BB%BB%E5%8A%A1%E6%8E%A5%E5%8F%A3%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0" name="%E6%9F%A5%E8%AF%A2%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%883.0%EF%BC%89%E4%BB%BB%E5%8A%A1%E6%8E%A5%E5%8F%A3%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0">查询混元生图（3.0）任务接口请求参数</h2>
<p><span id="Hrya4y9k"></span></p>
<table>
<thead>
<tr>
<th style="text-align:left">参数</th>
<th style="text-align:left">类型</th>
<th style="text-align:left">必选</th>
<th style="text-align:left">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>JobId</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">是</td>
<td style="text-align:left">提交文生图任务时返回的异步任务ID</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%9F%A5%E8%AF%A2%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%883.0%EF%BC%89%E4%BB%BB%E5%8A%A1%E6%8E%A5%E5%8F%A3%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0" name="%E6%9F%A5%E8%AF%A2%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%883.0%EF%BC%89%E4%BB%BB%E5%8A%A1%E6%8E%A5%E5%8F%A3%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0">查询混元生图（3.0）任务接口响应参数</h2>
<p><span id="Hrya4y9k"></span></p>
<table>
<thead>
<tr>
<th style="text-align:left">参数</th>
<th style="text-align:left">类型</th>
<th style="text-align:left">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>JobStatusCode</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">当前任务状态码：<code>1</code>=等待中，<code>2</code>=运行中，<code>4</code>=处理失败，<code>5</code>=处理完成。示例：<code>&quot;5&quot;</code></td>
</tr>
<tr>
<td style="text-align:left"><code>JobStatusMsg</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">当前任务状态描述：排队中、处理中、处理失败、处理完成。</td>
</tr>
<tr>
<td style="text-align:left"><code>JobErrorCode</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务处理失败时的错误码。成功时为空字符串。</td>
</tr>
<tr>
<td style="text-align:left"><code>JobErrorMsg</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务处理失败时的错误信息。成功时为空字符串。</td>
</tr>
<tr>
<td style="text-align:left"><code>ResultImage</code></td>
<td style="text-align:left">Array of String</td>
<td style="text-align:left">生成图片的URL列表。<strong>有效期1小时</strong>，请及时保存。</td>
</tr>
<tr>
<td style="text-align:left"><code>ResultDetails</code></td>
<td style="text-align:left">Array of String</td>
<td style="text-align:left">结果详情数组，<code>&quot;Success&quot;</code>代表成功。</td>
</tr>
<tr>
<td style="text-align:left"><code>RevisedPrompt</code></td>
<td style="text-align:left">Array of String</td>
<td style="text-align:left">改写后的Prompt。仅在开启Prompt改写（<code>Revise=1</code>）时返回扩写后的文本；若关闭改写，则返回原始输入的Prompt。</td>
</tr>
<tr>
<td style="text-align:left"><code>RequestId</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">唯一请求ID，由服务端生成，用于问题定位。</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%9F%A5%E8%AF%A2%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%883.0%EF%BC%89%E4%BB%BB%E5%8A%A1%E6%8E%A5%E5%8F%A3%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B" name="%E6%9F%A5%E8%AF%A2%E6%B7%B7%E5%85%83%E7%94%9F%E5%9B%BE%EF%BC%883.0%EF%BC%89%E4%BB%BB%E5%8A%A1%E6%8E%A5%E5%8F%A3%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B">查询混元生图（3.0）任务接口调用示例</h2>
<p><span id="Hrya4y9k"></span></p>
<p>请求示例：</p>
<pre><code class="lang-Curl">curl -X POST &#39;https://modelpool-api.talkingdata.com/model/orgin/job?requestId=550e8400-e29b-41d4-a716-446655440001&#39; \
  -H &#39;Content-Type: application/json&#39; \
  -H &#39;Authorization: Bearer YOUR_API_KEY&#39; \
  -H &#39;X-Timestamp: 1760000000&#39; \
  -d &#39;{
    &quot;JobId&quot;: &quot;1395528311-1774940679-e2608c2c-2ccf-11f1-b65b-52540018a910-0&quot;
}&#39;
</code></pre>
<p>响应示例：</p>
<pre><code class="lang-Curl">{
    &quot;Response&quot;: {
        &quot;JobErrorMsg&quot;: &quot;&quot;,
        &quot;ResultImage&quot;: [
            &quot;https://aiart-1258344699.cos.ap-guangzhou.myqcloud.com/text_to_img_pro/1395528311/1395528311-1774940679-e2608c2c-2ccf-11f1-b65b-52540018a910-0/0?q-sign-algorithm=sha1&amp;q-ak=AKIDpRovliU1IJ5ctufBSVIq8AwTlnZ5MN8d&amp;q-sign-time=1774940700%3B1774944300&amp;q-key-time=1774940700%3B1774944300&amp;q-header-list=host&amp;q-url-param-list=&amp;q-signature=8c83f7985eecc6f4967100411d10de72de80ada3&quot;
        ],
        &quot;ResultDetails&quot;: [
            &quot;Success&quot;
        ],
        &quot;RevisedPrompt&quot;: [
            &quot;一幅高清细节的海边日落场景，构图以水平线平稳分割天空与海洋...&quot;
        ],
        &quot;RequestId&quot;: &quot;ffb17dd2-3cd6-4884-ab11-89b03cfd127f&quot;,
        &quot;JobStatusCode&quot;: &quot;5&quot;,
        &quot;JobStatusMsg&quot;: &quot;处理完成&quot;,
        &quot;JobErrorCode&quot;: &quot;&quot;
    }
}
</code></pre>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E9%94%99%E8%AF%AF%E7%A0%81" name="%E9%94%99%E8%AF%AF%E7%A0%81">错误码</h2>
<table>
<thead>
<tr>
<th style="text-align:left">错误码</th>
<th style="text-align:left">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left">FailedOperation.JobNotExist</td>
<td style="text-align:left">任务不存在。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.ServerError</td>
<td style="text-align:left">服务内部错误。</td>
</tr>
<tr>
<td style="text-align:left">OperationDenied.ImageIllegalDetected</td>
<td style="text-align:left">图片包含违法违规信息，审核不通过。</td>
</tr>
</tbody>
</table>
]]></content:encoded>
      <pubDate>Wed, 08 Apr 2026 11:14:17 +0800</pubDate>
      <guid>http://doc.talkingdata.com/posts/1225</guid>
      <comments>http://doc.talkingdata.com/posts/1225#comments</comments>
    </item>
    <item>
      <title>TD云牍7/Tencent-hunyuan-turbos-vision-vide</title>
      <link>http://doc.talkingdata.com/posts/1223</link>
      <category>文本生成 API</category>
      <author>liuxinmei</author>
      <description>云牍7 接口说明文档 TD模型编号：T0303005 模型能力简介 云牍7 具备强大的中文创作能力，复杂语境下的逻辑推理能力，以及可靠的任务执行能力。本接口支持流式或非流式调用，当使用流式调用时为 SSE 协议。 本接口暂不支持返回图片内容。 鉴权说明 本接口仅支持API Key鉴权，需联系TD运维同学获取长效API Key。
 对话接口地址 请求方法： POST 接口URL：'http://modelpool-api.talkingdata.com/model/openai/api/v3/chat/completions' 请求头（Request Headers）： 头部字段 值 是否必需 说明 Authorization Bearer sk-YsnTXnTV7AAWhfcUYVRt1Ab</description>
      <content:encoded><![CDATA[<h4 id="%3Cstrong%3E%E4%BA%91%E7%89%8D7%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3%3C%2Fstrong%3E" name="%3Cstrong%3E%E4%BA%91%E7%89%8D7%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3%3C%2Fstrong%3E"><strong>云牍7 接口说明文档</strong></h4>
<p><strong>TD模型编号：T0303005</strong></p>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E6%A8%A1%E5%9E%8B%E8%83%BD%E5%8A%9B%E7%AE%80%E4%BB%8B" name="%E6%A8%A1%E5%9E%8B%E8%83%BD%E5%8A%9B%E7%AE%80%E4%BB%8B">模型能力简介</h2>
<p><span id="Hrya4y9k"></span></p>
<ul>
<li><p><strong>云牍7</strong></p>
<ul>
<li><p>具备强大的中文创作能力，复杂语境下的逻辑推理能力，以及可靠的任务执行能力。本接口支持流式或非流式调用，当使用流式调用时为 SSE 协议。</p>
</li>
<li><p>本接口暂不支持返回图片内容。</p>
</li>
</ul>
</li>
</ul>
<h5 id="%3Cstrong%3E%E9%89%B4%E6%9D%83%E8%AF%B4%E6%98%8E%3C%2Fstrong%3E" name="%3Cstrong%3E%E9%89%B4%E6%9D%83%E8%AF%B4%E6%98%8E%3C%2Fstrong%3E"><strong>鉴权说明</strong></h5>
<pre><code>本接口仅支持API Key鉴权，需联系TD运维同学获取长效API Key。
</code></pre><hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E5%AF%B9%E8%AF%9D%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80" name="%E5%AF%B9%E8%AF%9D%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80">对话接口地址</h2>
<p><span id="Hrya4y9k"></span></p>
<p><strong>请求方法：</strong> POST</p>
<p><strong>接口URL：</strong><code>&#39;http://modelpool-api.talkingdata.com/model/openai/api/v3/chat/completions&#39;</code> </p>
<p><strong>请求头（Request Headers）：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">头部字段</th>
<th style="text-align:left">值</th>
<th style="text-align:left">是否必需</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>Authorization</code></td>
<td style="text-align:left"><code>Bearer sk-YsnTXnTV7AAWhfcUYVRt1Abxuyl4xBZSe0abmfjjfNg</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">API 鉴权凭证，请替换为有效的 API Key</td>
</tr>
<tr>
<td style="text-align:left"><code>X-Timestamp</code></td>
<td style="text-align:left"><code>1700000000</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">Unix 时间戳格式</td>
</tr>
<tr>
<td style="text-align:left"><code>content-Type</code></td>
<td style="text-align:left"><code>application/json</code></td>
<td style="text-align:left">是</td>
<td style="text-align:left">请求体格式必须为 JSON</td>
</tr>
</tbody>
</table>
<p><strong>请求参数（Request  Parameter）：</strong></p>
<table>
<thead>
<tr>
<th style="text-align:left">字段</th>
<th style="text-align:left">值</th>
<th style="text-align:left">是否必需</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>requestld</code></td>
<td style="text-align:left"><code>550e8400-e29b-41d4-a716-446655440000</code></td>
<td style="text-align:left">否</td>
<td style="text-align:left">请求唯一标识符。使用 UUID 格式字符串，用于跟踪和排查请求相关问题，以便在需要技术排查时，提供此 ID 可快速定位具体请求的完整处理链路和日志信息。</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E5%AF%B9%E8%AF%9D%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0" name="%E5%AF%B9%E8%AF%9D%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0">对话请求参数</h2>
<p><span id="Hrya4y9k"></span></p>
<h3 id="%E5%AF%B9%E8%AF%9D%E8%AF%B7%E6%B1%82%E4%BD%93%EF%BC%88requestBody%EF%BC%89" name="%E5%AF%B9%E8%AF%9D%E8%AF%B7%E6%B1%82%E4%BD%93%EF%BC%88requestBody%EF%BC%89">对话请求体（requestBody）</h3>
<table>
<thead>
<tr>
<th style="text-align:left">参数名称</th>
<th style="text-align:left">必选</th>
<th style="text-align:left">类型</th>
<th style="text-align:left">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left">model</td>
<td style="text-align:left">是</td>
<td style="text-align:left">String</td>
<td style="text-align:left">本次请求使用模型的 Model ID 为 T0303005</td>
</tr>
<tr>
<td style="text-align:left">messages.N</td>
<td style="text-align:left">是</td>
<td style="text-align:left">Array of message</td>
<td style="text-align:left">聊天上下文信息。<br>说明：<br>1. 长度最多为 40，按对话时间从旧到新在数组中排列。<br>2. message.role 可选值：system、user、assistant、 tool（functioncall场景）。<br>其中，system 角色可选，如存在则必须位于列表的最开始。user（tool） 和 assistant 需交替出现（一问一答），以 user 提问开始，user（tool）提问结束，其中tool可以连续出现多次，且 content 不能为空。role 的顺序示例：[system（可选） user assistant user（tool tool ...） assistant user（tool tool ...） ...]。<br>3. messages 中 content 总长度不能超过模型输入长度上限（可参考产品概述文档），超过则会截断最前面的内容，只保留尾部内容。</td>
</tr>
<tr>
<td style="text-align:left">Stream</td>
<td style="text-align:left">否</td>
<td style="text-align:left">Boolean</td>
<td style="text-align:left">流式调用开关。<br>说明：<br>1. 未传值时默认为非流式调用（false）。<br>2. 流式调用时以 SSE 协议增量返回结果（返回值取 Choices[n].Delta 中的值，需要拼接增量数据才能获得完整结果）。<br>3. 非流式调用时：<br>调用方式与普通 HTTP 请求无异。<br>接口响应耗时较长，<strong>如需更低时延建议设置为 true</strong>。<br>只返回一次最终结果（返回值取 Choices[n].message 中的值）。<br><br>注意：<br>通过 SDK 调用时，流式和非流式调用需用<strong>不同的方式</strong>获取返回值，具体参考 SDK 中的注释或示例（在各语言 SDK 代码仓库的 examples/hunyuan/v20230901/ 目录中）。<br>示例值：false</td>
</tr>
<tr>
<td style="text-align:left">StreamModeration</td>
<td style="text-align:left">否</td>
<td style="text-align:left">Boolean</td>
<td style="text-align:left">流式输出审核开关。<br>说明：<br>1. 当使用流式输出（Stream 字段值为 true）时，该字段生效。<br>2. 输出审核有流式和同步两种模式，<strong>流式模式首包响应更快</strong>。未传值时默认为流式模式（true）。<br>3. 如果值为 true，将对输出内容进行分段审核，审核通过的内容流式输出返回。如果出现审核不过，响应中的 FinishReason 值为 sensitive。<br>4. 如果值为 false，则不使用流式输出审核，需要审核完所有输出内容后再返回结果。<br><br>注意：<br>当选择流式输出审核时，可能会出现部分内容已输出，但中间某一段响应中的 FinishReason 值为 sensitive，此时说明安全审核未通过。如果业务场景有实时文字上屏的需求，需要自行撤回已上屏的内容，并建议自定义替换为一条提示语，如 “这个问题我不方便回答，不如我们换个话题试试”，以保障终端体验。<br>示例值：false</td>
</tr>
<tr>
<td style="text-align:left">TopP</td>
<td style="text-align:left">否</td>
<td style="text-align:left">Float</td>
<td style="text-align:left">说明：<br>1. 影响输出文本的多样性。模型已有默认参数，不传值时使用各模型推荐值，不推荐用户修改。<br>2. 取值区间为 [0.0, 1.0]。取值越大，生成文本的多样性越强。</td>
</tr>
<tr>
<td style="text-align:left">Temperature</td>
<td style="text-align:left">否</td>
<td style="text-align:left">Float</td>
<td style="text-align:left">说明：<br>1. 影响模型输出多样性，模型已有默认参数，不传值时使用各模型推荐值，不推荐用户修改。<br>2. 取值区间为 [0.0, 2.0]。较高的数值会使输出更加多样化和不可预测，而较低的数值会使其更加集中和确定。</td>
</tr>
<tr>
<td style="text-align:left">EnableEnhancement</td>
<td style="text-align:left">否</td>
<td style="text-align:left">Boolean</td>
<td style="text-align:left">功能增强（如搜索）开关。<br>说明：<br>1. hunyuan-lite 无功能增强（如搜索）能力，该参数对 hunyuan-lite 版本不生效。<br>2. 未传值时默认关闭开关。<br>3. 关闭时将直接由主模型生成回复内容，可以降低响应时延（对于流式输出时的首字时延尤为明显）。但在少数场景里，回复效果可能会下降。<br>4. 安全审核能力不属于功能增强范围，不受此字段影响。<br>5. 2025-04-20 00:00:00起，由默认开启状态转为默认关闭状态。<br>示例值：true</td>
</tr>
<tr>
<td style="text-align:left">Tools.N</td>
<td style="text-align:left">否</td>
<td style="text-align:left">Array of Tool</td>
<td style="text-align:left">可调用的工具列表，仅对 hunyuan-turbo、hunyuan-functioncall 模型生效。</td>
</tr>
<tr>
<td style="text-align:left">ToolChoice</td>
<td style="text-align:left">否</td>
<td style="text-align:left">String</td>
<td style="text-align:left">工具使用选项，可选值包括 none、auto、custom。说明：1. 仅对 hunyuan-turbo、hunyuan-functioncall 模型生效。2. none：不调用工具；auto：模型自行选择生成回复或调用工具；custom：强制模型调用指定的工具。3. 未设置时，默认值为auto<br>示例值：auto</td>
</tr>
<tr>
<td style="text-align:left">CustomTool</td>
<td style="text-align:left">否</td>
<td style="text-align:left">Tool</td>
<td style="text-align:left">强制模型调用指定的工具，当参数ToolChoice为custom时，此参数为必填</td>
</tr>
<tr>
<td style="text-align:left">SearchInfo</td>
<td style="text-align:left">否</td>
<td style="text-align:left">Boolean</td>
<td style="text-align:left">默认是false，在值为true且命中搜索时，接口会返回SearchInfo<br>示例值：false</td>
</tr>
<tr>
<td style="text-align:left">Citation</td>
<td style="text-align:left">否</td>
<td style="text-align:left">Boolean</td>
<td style="text-align:left">搜索引文角标开关。<br>说明：<br>1. 配合EnableEnhancement和SearchInfo参数使用。打开后，回答中命中搜索的结果会在片段后增加角标标志，对应SearchInfo列表中的链接。<br>2. false：开关关闭，true：开关打开。<br>3. 未传值时默认开关关闭（false）。<br>示例值：false</td>
</tr>
<tr>
<td style="text-align:left">EnableSpeedSearch</td>
<td style="text-align:left">否</td>
<td style="text-align:left">Boolean</td>
<td style="text-align:left">是否开启极速版搜索，默认false，不开启；在开启且命中搜索时，会启用极速版搜索，流式输出首字返回更快。<br>示例值：false</td>
</tr>
<tr>
<td style="text-align:left">EnableMultimedia</td>
<td style="text-align:left">否</td>
<td style="text-align:left">Boolean</td>
<td style="text-align:left">多媒体开关。<br>详细介绍请阅读多媒体介绍中的说明。<br>说明：<br>1. 该参数目前仅对白名单内用户生效，如您想体验该功能请联系我们。<br>2. 该参数仅在功能增强（如搜索）开关开启（EnableEnhancement=true）并且极速版搜索开关关闭（EnableSpeedSearch=false）时生效。<br>3. hunyuan-lite 无多媒体能力，该参数对 hunyuan-lite 版本不生效。<br>4. 未传值时默认关闭。<br>5. 开启并搜索到对应的多媒体信息时，会输出对应的多媒体地址，可以定制个性化的图文消息。<br>示例值：false</td>
</tr>
<tr>
<td style="text-align:left">EnableDeepSearch</td>
<td style="text-align:left">否</td>
<td style="text-align:left">Boolean</td>
<td style="text-align:left">是否开启深度研究该问题，默认是false，在值为true且命中深度研究该问题时，会返回深度研究该问题信息。<br>示例值：false</td>
</tr>
<tr>
<td style="text-align:left">Seed</td>
<td style="text-align:left">否</td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">说明： 1. 确保模型的输出是可复现的。 2. 取值区间为非0正整数，最大值10000。 3. 非必要不建议使用，不合理的取值会影响效果。<br>示例值：1</td>
</tr>
<tr>
<td style="text-align:left">ForceSearchEnhancement</td>
<td style="text-align:left">否</td>
<td style="text-align:left">Boolean</td>
<td style="text-align:left">强制搜索增强开关。<br>说明：<br>1. 未传值时默认关闭。<br>2. 开启后，将强制走AI搜索，当AI搜索结果为空时，由大模型回复兜底话术。<br>示例值：false</td>
</tr>
<tr>
<td style="text-align:left">Stop.N</td>
<td style="text-align:left">否</td>
<td style="text-align:left">Array of String</td>
<td style="text-align:left">自定义结束生成字符串<br><br>调用 OpenAI 的接口时，如果您指定了 stop 参数, 模型会停止在匹配到 stop 的内容之前。<br>在调用混元接口时，会停止在匹配到 stop 的内容之后。<br><br>说明：<br>未来我们可能会修改此行为以便和 OpenAI 保持一致。<br>但是目前有使用该参数的情况下，开发者需要注意该参数是否会对应用造成影响，以及未来该行为调整时带来的影响。</td>
</tr>
<tr>
<td style="text-align:left">EnableRecommendedQuestions</td>
<td style="text-align:left">否</td>
<td style="text-align:left">Boolean</td>
<td style="text-align:left">推荐问答开关。<br>说明：<br>1. 未传值时默认关闭。<br>2. 开启后，在返回值的最后一个包中会增加 RecommendedQuestions 字段表示推荐问答， 最多返回3条。<br>示例值：false</td>
</tr>
<tr>
<td style="text-align:left">EnableDeepRead</td>
<td style="text-align:left">否</td>
<td style="text-align:left">Boolean</td>
<td style="text-align:left">是否开启深度阅读，默认是false，在值为true时，会返回深度阅读的结果信息。说明:1.深度阅读需要开启插件增强,即设置EnableEnhancement为true,当设置EnableDeepRead为true时EnableEnhancement默认为true；2.目前暂时只支持单文档单轮的深度阅读；3.深度阅读功能的文件上传可以使用FilesUploads接口，具体参数详见FilesUploads接口文档<br>示例值：false</td>
</tr>
<tr>
<td style="text-align:left">WebSearchOptions</td>
<td style="text-align:left">否</td>
<td style="text-align:left">WebSearchOptions</td>
<td style="text-align:left">知识注入相关的参数信息</td>
</tr>
<tr>
<td style="text-align:left">TopicChoice</td>
<td style="text-align:left">否</td>
<td style="text-align:left">String</td>
<td style="text-align:left">用户传入Topic<br>示例值：闲聊</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="output_params"></span></p>
<h2 id="%E5%AF%B9%E8%AF%9D%E6%8E%A5%E5%8F%A3%E8%BF%94%E5%9B%9E%E5%8F%82%E6%95%B0" name="%E5%AF%B9%E8%AF%9D%E6%8E%A5%E5%8F%A3%E8%BF%94%E5%9B%9E%E5%8F%82%E6%95%B0">对话接口返回参数</h2>
<table>
<thead>
<tr>
<th style="text-align:left">参数名称</th>
<th style="text-align:left">类型</th>
<th style="text-align:left">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left">created</td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">Unix 时间戳，单位为秒。<br>示例值：1705634032</td>
</tr>
<tr>
<td style="text-align:left">usage</td>
<td style="text-align:left">Usage</td>
<td style="text-align:left">Token 统计信息。<br>按照总 Token 数量计费。</td>
</tr>
<tr>
<td style="text-align:left">note</td>
<td style="text-align:left">String</td>
<td style="text-align:left">免责声明。<br>示例值：以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记</td>
</tr>
<tr>
<td style="text-align:left">id</td>
<td style="text-align:left">String</td>
<td style="text-align:left">本次请求的 RequestId。<br>示例值：9c772634-8824-43e8-bc24-8bc4c19b9151</td>
</tr>
<tr>
<td style="text-align:left">choices</td>
<td style="text-align:left">Array of Choice</td>
<td style="text-align:left">回复内容。</td>
</tr>
<tr>
<td style="text-align:left">ErrorMsg</td>
<td style="text-align:left">ErrorMsg</td>
<td style="text-align:left">错误信息。<br>如果流式返回中服务处理异常，返回该错误信息。<br>注意：此字段可能返回 null，表示取不到有效值。</td>
</tr>
<tr>
<td style="text-align:left">SearchInfo</td>
<td style="text-align:left">SearchInfo</td>
<td style="text-align:left">搜索结果信息</td>
</tr>
<tr>
<td style="text-align:left">Replaces</td>
<td style="text-align:left">Array of Replace</td>
<td style="text-align:left">多媒体信息。<br>说明：<br>1. 可以用多媒体信息替换回复内容里的占位符，得到完整的消息。<br>2. 可能会出现回复内容里存在占位符，但是因为审核等原因没有返回多媒体信息。</td>
</tr>
<tr>
<td style="text-align:left">RecommendedQuestions</td>
<td style="text-align:left">Array of String</td>
<td style="text-align:left">推荐问答。<br>示例值：[&quot;string&quot;]</td>
</tr>
<tr>
<td style="text-align:left">Processes</td>
<td style="text-align:left">Processes</td>
<td style="text-align:left">AI搜索返回状态</td>
</tr>
<tr>
<td style="text-align:left">RequestId</td>
<td style="text-align:left">String</td>
<td style="text-align:left">唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。本接口为流式响应接口，当请求成功时，RequestId 会被放在 HTTP 响应的 Header &quot;X-TC-RequestId&quot; 中。</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="%E5%AF%B9%E8%AF%9D%E6%8E%A5%E5%8F%A3%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B" name="%E5%AF%B9%E8%AF%9D%E6%8E%A5%E5%8F%A3%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B">对话接口调用示例</h2>
<p><span id="Hrya4y9k"></span></p>
<h3 id="%E4%BA%91%E7%89%8D7-system%20prompt" name="%E4%BA%91%E7%89%8D7-system%20prompt">云牍7-system prompt</h3>
<p>请求示例：</p>
<pre><code>curl --location &#39;http://modelpool-api.talkingdata.com/model/openai/api/v3/chat/completions&#39; \
--header &#39;Authorization: Bearer sk-YsnTXnTV7AAWhfcUYVRt1Abxuyl4xBZSe0abmfjjfNg&#39; \
--header &#39;Content-Type: application/json&#39; \
--header &quot;X-Timestamp: $TIMESTAMP&quot; \
--data &#39;{
    &quot;TopP&quot;: 1,
    &quot;Temperature&quot;: 1,
    &quot;model&quot;: &quot;T0303005&quot;,
    &quot;Stream&quot;: true,
    &quot;messages&quot;: [
        {
            &quot;role&quot;: &quot;system&quot;,
            &quot;content&quot;: &quot;将英文单词转换为包括中文翻译、英文释义和一个例句的完整解释。请检查所有信息是否准确，并在回答时保持简洁，不需要任何其他反馈。&quot;
        },
        {
            &quot;role&quot;: &quot;user&quot;,
            &quot;content&quot;: &quot;nice&quot;
        }
    ]
}&#39;
</code></pre><p>响应示例：</p>
<pre><code>HTTP/1.1 200 OK
Cache-Control: no-cache
Connection: keep-alive
Content-Type: text/event-stream
Date: Tue, 21 Nov 2023 06:56:00 GMT
Transfer-Encoding: chunked
X-TC-RequestId: 61a8459b-27c8-4868-af8f-f374db0245f8

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;很好&quot;}}],&quot;Created&quot;:1705634813,&quot;Id&quot;:&quot;681ef57e-9f1e-4faa-a2d3-07b655a1fa1f&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:36,&quot;CompletionTokens&quot;:1,&quot;TotalTokens&quot;:37}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;：&quot;}}],&quot;Created&quot;:1705634813,&quot;Id&quot;:&quot;681ef57e-9f1e-4faa-a2d3-07b655a1fa1f&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:36,&quot;CompletionTokens&quot;:2,&quot;TotalTokens&quot;:38}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;nice&quot;}}],&quot;Created&quot;:1705634813,&quot;Id&quot;:&quot;681ef57e-9f1e-4faa-a2d3-07b655a1fa1f&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:36,&quot;CompletionTokens&quot;:3,&quot;TotalTokens&quot;:39}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;\n&quot;}}],&quot;Created&quot;:1705634813,&quot;Id&quot;:&quot;681ef57e-9f1e-4faa-a2d3-07b655a1fa1f&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:36,&quot;CompletionTokens&quot;:4,&quot;TotalTokens&quot;:40}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;英文&quot;}}],&quot;Created&quot;:1705634814,&quot;Id&quot;:&quot;681ef57e-9f1e-4faa-a2d3-07b655a1fa1f&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:36,&quot;CompletionTokens&quot;:5,&quot;TotalTokens&quot;:41}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;释义&quot;}}],&quot;Created&quot;:1705634814,&quot;Id&quot;:&quot;681ef57e-9f1e-4faa-a2d3-07b655a1fa1f&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:36,&quot;CompletionTokens&quot;:6,&quot;TotalTokens&quot;:42}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;：&quot;}}],&quot;Created&quot;:1705634814,&quot;Id&quot;:&quot;681ef57e-9f1e-4faa-a2d3-07b655a1fa1f&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:36,&quot;CompletionTokens&quot;:7,&quot;TotalTokens&quot;:43}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;ple&quot;}}],&quot;Created&quot;:1705634814,&quot;Id&quot;:&quot;681ef57e-9f1e-4faa-a2d3-07b655a1fa1f&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:36,&quot;CompletionTokens&quot;:8,&quot;TotalTokens&quot;:44}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;asing&quot;}}],&quot;Created&quot;:1705634814,&quot;Id&quot;:&quot;681ef57e-9f1e-4faa-a2d3-07b655a1fa1f&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:36,&quot;CompletionTokens&quot;:9,&quot;TotalTokens&quot;:45}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot; or&quot;}}],&quot;Created&quot;:1705634814,&quot;Id&quot;:&quot;681ef57e-9f1e-4faa-a2d3-07b655a1fa1f&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:36,&quot;CompletionTokens&quot;:10,&quot;TotalTokens&quot;:46}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot; acceptable&quot;}}],&quot;Created&quot;:1705634814,&quot;Id&quot;:&quot;681ef57e-9f1e-4faa-a2d3-07b655a1fa1f&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:36,&quot;CompletionTokens&quot;:11,&quot;TotalTokens&quot;:47}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;\n&quot;}}],&quot;Created&quot;:1705634814,&quot;Id&quot;:&quot;681ef57e-9f1e-4faa-a2d3-07b655a1fa1f&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:36,&quot;CompletionTokens&quot;:12,&quot;TotalTokens&quot;:48}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;例&quot;}}],&quot;Created&quot;:1705634814,&quot;Id&quot;:&quot;681ef57e-9f1e-4faa-a2d3-07b655a1fa1f&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:36,&quot;CompletionTokens&quot;:13,&quot;TotalTokens&quot;:49}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;句&quot;}}],&quot;Created&quot;:1705634814,&quot;Id&quot;:&quot;681ef57e-9f1e-4faa-a2d3-07b655a1fa1f&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:36,&quot;CompletionTokens&quot;:14,&quot;TotalTokens&quot;:50}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;：&quot;}}],&quot;Created&quot;:1705634814,&quot;Id&quot;:&quot;681ef57e-9f1e-4faa-a2d3-07b655a1fa1f&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:36,&quot;CompletionTokens&quot;:15,&quot;TotalTokens&quot;:51}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;She&quot;}}],&quot;Created&quot;:1705634814,&quot;Id&quot;:&quot;681ef57e-9f1e-4faa-a2d3-07b655a1fa1f&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:36,&quot;CompletionTokens&quot;:16,&quot;TotalTokens&quot;:52}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot; had&quot;}}],&quot;Created&quot;:1705634814,&quot;Id&quot;:&quot;681ef57e-9f1e-4faa-a2d3-07b655a1fa1f&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:36,&quot;CompletionTokens&quot;:17,&quot;TotalTokens&quot;:53}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot; a&quot;}}],&quot;Created&quot;:1705634814,&quot;Id&quot;:&quot;681ef57e-9f1e-4faa-a2d3-07b655a1fa1f&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:36,&quot;CompletionTokens&quot;:18,&quot;TotalTokens&quot;:54}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot; nice&quot;}}],&quot;Created&quot;:1705634814,&quot;Id&quot;:&quot;681ef57e-9f1e-4faa-a2d3-07b655a1fa1f&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:36,&quot;CompletionTokens&quot;:19,&quot;TotalTokens&quot;:55}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot; smile&quot;}}],&quot;Created&quot;:1705634814,&quot;Id&quot;:&quot;681ef57e-9f1e-4faa-a2d3-07b655a1fa1f&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:36,&quot;CompletionTokens&quot;:20,&quot;TotalTokens&quot;:56}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;.&quot;}}],&quot;Created&quot;:1705634814,&quot;Id&quot;:&quot;681ef57e-9f1e-4faa-a2d3-07b655a1fa1f&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:36,&quot;CompletionTokens&quot;:21,&quot;TotalTokens&quot;:57}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;stop&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;&quot;}}],&quot;Created&quot;:1705634814,&quot;Id&quot;:&quot;681ef57e-9f1e-4faa-a2d3-07b655a1fa1f&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:36,&quot;CompletionTokens&quot;:21,&quot;TotalTokens&quot;:57}}
</code></pre><h3 id="%E4%BA%91%E7%89%8D7-%E5%A4%9A%E8%BD%AE%E5%AF%B9%E8%AF%9D" name="%E4%BA%91%E7%89%8D7-%E5%A4%9A%E8%BD%AE%E5%AF%B9%E8%AF%9D">云牍7-多轮对话</h3>
<p>请求示例：</p>
<pre><code>curl --location &#39;http://modelpool-api.talkingdata.com/model/openai/api/v3/chat/completions&#39; \
--header &#39;Authorization: Bearer sk-YsnTXnTV7AAWhfcUYVRt1Abxuyl4xBZSe0abmfjjfNg&#39; \
--header &#39;Content-Type: application/json&#39; \
--header &quot;X-Timestamp: $TIMESTAMP&quot; \
--data &#39;{
    &quot;TopP&quot;: 1,
    &quot;Temperature&quot;: 1,
    &quot;model&quot;: &quot;T0303005&quot;,
    &quot;Stream&quot;: true,
    &quot;messages&quot;: [
        {
            &quot;role&quot;: &quot;user&quot;,
            &quot;content&quot;: &quot;请介绍下自己&quot;
        },
        {
            &quot;role&quot;: &quot;assistant&quot;,
            &quot;content&quot;: &quot;我的名字是腾讯混元大模型，是腾讯开发的一款大型语言模型。我能够理解人类语言，擅长提供问答服务、常识推理、文本创作、数学计算和互动问答等服务。如果您需要帮助或有任何问题，请随时向我提问。&quot;
        },
        {
            &quot;role&quot;: &quot;user&quot;,
            &quot;content&quot;: &quot;请给我讲个字数小于10个字的搞笑笑话&quot;
        },
        {
            &quot;role&quot;: &quot;assistant&quot;,
            &quot;content&quot;: &quot;猫头鹰遇见眯眯眼，看得眼睛都眯成线。&quot;
        },
        {
            &quot;role&quot;: &quot;user&quot;,
            &quot;content&quot;: &quot;不好笑，换一个吧&quot;
        }
    ]
}&#39;
</code></pre><p>响应示例：</p>
<pre><code>HTTP/1.1 200 OK
Cache-Control: no-cache
Connection: keep-alive
Content-Type: text/event-stream
Date: Tue, 21 Nov 2023 06:56:00 GMT
Transfer-Encoding: chunked
X-TC-RequestId: 61a8459b-27c8-4868-af8f-f374db0245f8

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;青蛙&quot;}}],&quot;Created&quot;:1705634032,&quot;Id&quot;:&quot;9c772634-8824-43e8-bc24-8bc4c19b9151&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:85,&quot;CompletionTokens&quot;:1,&quot;TotalTokens&quot;:86}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;跳&quot;}}],&quot;Created&quot;:1705634032,&quot;Id&quot;:&quot;9c772634-8824-43e8-bc24-8bc4c19b9151&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:85,&quot;CompletionTokens&quot;:2,&quot;TotalTokens&quot;:87}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;高&quot;}}],&quot;Created&quot;:1705634032,&quot;Id&quot;:&quot;9c772634-8824-43e8-bc24-8bc4c19b9151&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:85,&quot;CompletionTokens&quot;:3,&quot;TotalTokens&quot;:88}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;，&quot;}}],&quot;Created&quot;:1705634032,&quot;Id&quot;:&quot;9c772634-8824-43e8-bc24-8bc4c19b9151&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:85,&quot;CompletionTokens&quot;:4,&quot;TotalTokens&quot;:89}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;比&quot;}}],&quot;Created&quot;:1705634032,&quot;Id&quot;:&quot;9c772634-8824-43e8-bc24-8bc4c19b9151&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:85,&quot;CompletionTokens&quot;:5,&quot;TotalTokens&quot;:90}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;下马&quot;}}],&quot;Created&quot;:1705634032,&quot;Id&quot;:&quot;9c772634-8824-43e8-bc24-8bc4c19b9151&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:85,&quot;CompletionTokens&quot;:6,&quot;TotalTokens&quot;:91}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;。&quot;}}],&quot;Created&quot;:1705634032,&quot;Id&quot;:&quot;9c772634-8824-43e8-bc24-8bc4c19b9151&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:85,&quot;CompletionTokens&quot;:7,&quot;TotalTokens&quot;:92}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;stop&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;&quot;}}],&quot;Created&quot;:1705634032,&quot;Id&quot;:&quot;9c772634-8824-43e8-bc24-8bc4c19b9151&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:85,&quot;CompletionTokens&quot;:7,&quot;TotalTokens&quot;:92}}
</code></pre><h3 id="%E4%BA%91%E7%89%8D7-%E8%AF%B7%E6%B1%82%E5%A4%B1%E8%B4%A5" name="%E4%BA%91%E7%89%8D7-%E8%AF%B7%E6%B1%82%E5%A4%B1%E8%B4%A5">云牍7-请求失败</h3>
<p>请求示例：</p>
<pre><code>curl --location &#39;http://modelpool-api.talkingdata.com/model/openai/api/v3/chat/completions&#39; \
--header &#39;Authorization: Bearer sk-YsnTXnTV7AAWhfcUYVRt1Abxuyl4xBZSe0abmfjjfNg&#39; \
--header &#39;Content-Type: application/json&#39; \
--header &quot;X-Timestamp: $TIMESTAMP&quot; \
--data &#39;{
    &quot;TopP&quot;: 0,
    &quot;Temperature&quot;: 4.8,
    &quot;model&quot;: &quot;T0303005&quot;,
    &quot;messages&quot;: [
        {
            &quot;role&quot;: &quot;user&quot;,
            &quot;content&quot;: &quot;介绍下自己&quot;
        }
    ]
}&#39;
</code></pre><p>响应示例：</p>
<pre><code>{
    &quot;Response&quot;: {
        &quot;RequestId&quot;: &quot;188cc996-ab09-49a7-aa9f-1df88f11c6b4&quot;,
        &quot;Error&quot;: {
            &quot;Code&quot;: &quot;InvalidParameter&quot;,
            &quot;Message&quot;: &quot;Temperature must be 2 or less&quot;
        }
    }
}
</code></pre><h3 id="%E4%BA%91%E7%89%8D7-%E6%B5%81%E5%BC%8F%E8%AF%B7%E6%B1%82%E6%88%90%E5%8A%9F" name="%E4%BA%91%E7%89%8D7-%E6%B5%81%E5%BC%8F%E8%AF%B7%E6%B1%82%E6%88%90%E5%8A%9F">云牍7-流式请求成功</h3>
<p>请求示例：</p>
<pre><code>curl --location &#39;http://modelpool-api.talkingdata.com/model/openai/api/v3/chat/completions&#39; \
--header &#39;Authorization: Bearer sk-YsnTXnTV7AAWhfcUYVRt1Abxuyl4xBZSe0abmfjjfNg&#39; \
--header &#39;Content-Type: application/json&#39; \
--header &quot;X-Timestamp: $TIMESTAMP&quot; \
--data &#39;{
    &quot;TopP&quot;: 1,
    &quot;Temperature&quot;: 1,
    &quot;model&quot;: &quot;T0303005&quot;,
    &quot;Stream&quot;: true,
    &quot;messages&quot;: [
        {
            &quot;role&quot;: &quot;user&quot;,
            &quot;content&quot;: &quot;计算1+1&quot;
        }
    ]
}&#39;
</code></pre><p>响应示例：</p>
<pre><code>HTTP/1.1 200 OK
Cache-Control: no-cache
Connection: keep-alive
Content-Type: text/event-stream
Date: Tue, 21 Nov 2023 06:56:00 GMT
Transfer-Encoding: chunked
X-TC-RequestId: 61a8459b-27c8-4868-af8f-f374db0245f8

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;1&quot;}}],&quot;Created&quot;:1700549760,&quot;Id&quot;:&quot;148b89ef-14e1-489f-8e70-b767e5b27d56&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:4,&quot;CompletionTokens&quot;:2,&quot;TotalTokens&quot;:6}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;+&quot;}}],&quot;Created&quot;:1700549760,&quot;Id&quot;:&quot;148b89ef-14e1-489f-8e70-b767e5b27d56&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:4,&quot;CompletionTokens&quot;:3,&quot;TotalTokens&quot;:7}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;1&quot;}}],&quot;Created&quot;:1700549760,&quot;Id&quot;:&quot;148b89ef-14e1-489f-8e70-b767e5b27d56&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:4,&quot;CompletionTokens&quot;:4,&quot;TotalTokens&quot;:8}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;=&quot;}}],&quot;Created&quot;:1700549760,&quot;Id&quot;:&quot;148b89ef-14e1-489f-8e70-b767e5b27d56&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:4,&quot;CompletionTokens&quot;:5,&quot;TotalTokens&quot;:9}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;2&quot;}}],&quot;Created&quot;:1700549760,&quot;Id&quot;:&quot;148b89ef-14e1-489f-8e70-b767e5b27d56&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:4,&quot;CompletionTokens&quot;:5,&quot;TotalTokens&quot;:9}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;FinishReason&quot;:&quot;stop&quot;,&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;&quot;}}],&quot;Created&quot;:1700549760,&quot;Id&quot;:&quot;148b89ef-14e1-489f-8e70-b767e5b27d56&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:4,&quot;CompletionTokens&quot;:5,&quot;TotalTokens&quot;:9}}
</code></pre><h3 id="%E4%BA%91%E7%89%8D7-%E9%9D%9E%E6%B5%81%E5%BC%8F%E8%AF%B7%E6%B1%82%E6%88%90%E5%8A%9F" name="%E4%BA%91%E7%89%8D7-%E9%9D%9E%E6%B5%81%E5%BC%8F%E8%AF%B7%E6%B1%82%E6%88%90%E5%8A%9F">云牍7-非流式请求成功</h3>
<p>请求示例：</p>
<pre><code>curl --location &#39;http://modelpool-api.talkingdata.com/model/openai/api/v3/chat/completions&#39; \
--header &#39;Authorization: Bearer sk-YsnTXnTV7AAWhfcUYVRt1Abxuyl4xBZSe0abmfjjfNg&#39; \
--header &#39;Content-Type: application/json&#39; \
--header &quot;X-Timestamp: $TIMESTAMP&quot; \
--data &#39;{
    &quot;TopP&quot;: 0,
    &quot;Stream&quot;: false,
    &quot;Temperature&quot;: 0,
    &quot;model&quot;: &quot;T0303005&quot;,
    &quot;messages&quot;: [
        {
            &quot;role&quot;: &quot;user&quot;,
            &quot;content&quot;: &quot;你好呀！&quot;
        }
    ]
}&#39;
</code></pre><p>响应示例：</p>
<pre><code>{
  &quot;Note&quot;: &quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,
  &quot;Choices&quot;: [
    {
      &quot;FinishReason&quot;: &quot;stop&quot;,
      &quot;Message&quot;: {
        &quot;Role&quot;: &quot;assistant&quot;,
        &quot;Content&quot;: &quot;你好！很高兴为您提供帮助。请问有什么问题我可以帮助您解决？&quot;
      }
    }
  ],
  &quot;Created&quot;: 1710902312,
  &quot;Id&quot;: &quot;e4657570-94a5-45f1-896c-a00ac3471d51&quot;,
  &quot;Usage&quot;: {
    &quot;PromptTokens&quot;: 3,
    &quot;CompletionTokens&quot;: 14,
    &quot;TotalTokens&quot;: 17
  }
}
</code></pre><h3 id="%E4%BA%91%E7%89%8D7-hunyuan-functioncall%E6%A8%A1%E5%9E%8B%E9%9D%9E%E6%B5%81%E5%BC%8F%E8%AF%B7%E6%B1%82%E6%88%90%E5%8A%9F" name="%E4%BA%91%E7%89%8D7-hunyuan-functioncall%E6%A8%A1%E5%9E%8B%E9%9D%9E%E6%B5%81%E5%BC%8F%E8%AF%B7%E6%B1%82%E6%88%90%E5%8A%9F">云牍7-hunyuan-functioncall模型非流式请求成功</h3>
<p>请求示例：</p>
<pre><code>curl --location &#39;http://modelpool-api.talkingdata.com/model/openai/api/v3/chat/completions&#39; \
--header &#39;Authorization: Bearer sk-YsnTXnTV7AAWhfcUYVRt1Abxuyl4xBZSe0abmfjjfNg&#39; \
--header &#39;Content-Type: application/json&#39; \
--header &quot;X-Timestamp: $TIMESTAMP&quot; \
--data &#39;{
    &quot;TopP&quot;: 0,
    &quot;Stream&quot;: false,
    &quot;Temperature&quot;: 0,
    &quot;model&quot;: &quot;T0303005&quot;,
    &quot;messages&quot;: [
        {
            &quot;role&quot;: &quot;user&quot;,
            &quot;content&quot;: &quot;北京和深圳今天天气如何&quot;
        }
    ],
    &quot;Tools&quot;: [
        {
            &quot;Type&quot;: &quot;function&quot;,
            &quot;Function&quot;: {
                &quot;Name&quot;: &quot;get_current_weather&quot;,
                &quot;Description&quot;: &quot;获取当前地点的天气&quot;,
                &quot;Parameters&quot;: &quot;{\n                    \&quot;type\&quot;: \&quot;object\&quot;,\n                    \&quot;properties\&quot;: {\n                        \&quot;location\&quot;: {\n                            \&quot;type\&quot;: \&quot;string\&quot;,\n                            \&quot;description\&quot;: \&quot;城市名称\&quot;\n                        },\n                        \&quot;unit\&quot;: {\n                            \&quot;type\&quot;: \&quot;string\&quot;,\n                            \&quot;enum\&quot;: [\n                                \&quot;celsius\&quot;,\n                                \&quot;fahrenheit\&quot;\n                            ]\n                        }\n                    },\n                    \&quot;required\&quot;: [\n                        \&quot;location\&quot;\n                    ]\n                }&quot;
            }
        }
    ],
    &quot;ToolChoice&quot;: &quot;auto&quot;
}&#39;
</code></pre><p>响应示例：</p>
<pre><code>{
    &quot;Response&quot;: {
        &quot;RequestId&quot;: &quot;e7f5ce41-87fd-4977-803c-54cded687cd9&quot;,
        &quot;Note&quot;: &quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,
        &quot;Choices&quot;: [
            {
                &quot;Message&quot;: {
                    &quot;Role&quot;: &quot;assistant&quot;,
                    &quot;Content&quot;: &quot;使用get_current_weather工具来获取北京和深圳的当前天气情况。\n\t\n\t用户想要知道北京和深圳今天的天气情况。用户的请求是关于天气的查询，需要使用天气查询工具来获取信息。&quot;,
                    &quot;ToolCalls&quot;: [
                        {
                            &quot;Type&quot;: &quot;function&quot;,
                            &quot;Function&quot;: {
                                &quot;Name&quot;: &quot;get_current_weather&quot;,
                                &quot;Arguments&quot;: &quot;{\&quot;location\&quot;:[\&quot;北京\&quot;,\&quot;深圳\&quot;],\&quot;unit\&quot;:\&quot;celsius\&quot;}&quot;
                            }
                        }
                    ]
                },
                &quot;FinishReason&quot;: &quot;tool_calls&quot;
            }
        ],
        &quot;Created&quot;: 1719638614,
        &quot;Usage&quot;: {
            &quot;PromptTokens&quot;: 6,
            &quot;CompletionTokens&quot;: 46,
            &quot;TotalTokens&quot;: 52
        }
    }
}
</code></pre><h3 id="%E4%BA%91%E7%89%8D7-hunyuan-functioncall%E6%A8%A1%E5%9E%8B%E6%B5%81%E5%BC%8F%E8%AF%B7%E6%B1%82%E6%88%90%E5%8A%9F" name="%E4%BA%91%E7%89%8D7-hunyuan-functioncall%E6%A8%A1%E5%9E%8B%E6%B5%81%E5%BC%8F%E8%AF%B7%E6%B1%82%E6%88%90%E5%8A%9F">云牍7-hunyuan-functioncall模型流式请求成功</h3>
<p>请求示例：</p>
<pre><code>curl --location &#39;http://modelpool-api.talkingdata.com/model/openai/api/v3/chat/completions&#39; \
--header &#39;Authorization: Bearer sk-YsnTXnTV7AAWhfcUYVRt1Abxuyl4xBZSe0abmfjjfNg&#39; \
--header &#39;Content-Type: application/json&#39; \
--header &quot;X-Timestamp: $TIMESTAMP&quot; \
--data &#39;{
    &quot;model&quot;: &quot;T0303005&quot;,
    &quot;Stream&quot;: true,
    &quot;messages&quot;: [
        {
            &quot;role&quot;: &quot;user&quot;,
            &quot;content&quot;: &quot;北京和深圳今天天气如何&quot;
        }
    ],
    &quot;Tools&quot;: [
        {
            &quot;Type&quot;: &quot;function&quot;,
            &quot;Function&quot;: {
                &quot;Name&quot;: &quot;get_current_weather&quot;,
                &quot;Description&quot;: &quot;获取当前地点的天气&quot;,
                &quot;Parameters&quot;: &quot;{\n                    \&quot;type\&quot;: \&quot;object\&quot;,\n                    \&quot;properties\&quot;: {\n                        \&quot;location\&quot;: {\n                            \&quot;type\&quot;: \&quot;string\&quot;,\n                            \&quot;description\&quot;: \&quot;城市名称\&quot;\n                        },\n                        \&quot;unit\&quot;: {\n                            \&quot;type\&quot;: \&quot;string\&quot;,\n                            \&quot;enum\&quot;: [\n                                \&quot;celsius\&quot;,\n                                \&quot;fahrenheit\&quot;\n                            ]\n                        }\n                    },\n                    \&quot;required\&quot;: [\n                        \&quot;location\&quot;\n                    ]\n                }&quot;
            }
        }
    ],
    &quot;ToolChoice&quot;: &quot;auto&quot;
}&#39;
</code></pre><p>响应示例：</p>
<pre><code>说明：  对于Delta.ToolCalls每一次的输出值应该以Id为标识对Type、Name、Arguments字段进行合并，本示例中的ToolCalls 最终值为：[{&quot;Id&quot;: &quot;call_cq177uk2c3m1v7ep35dg&quot;,&quot;Type&quot;: &quot;function&quot;,&quot;Function&quot;: {&quot;Name&quot;: &quot;get_current_weather&quot;, &quot;Arguments&quot;: &quot;{\&quot;location\&quot;:[\&quot;北京\&quot;,\&quot;深圳\&quot;],\&quot;unit\&quot;:\&quot;celsius\&quot;}&quot;}}]

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;&quot;,&quot;ToolCalls&quot;:[{&quot;Id&quot;:&quot;call_cq154vk2c3m1v7ep3530&quot;,&quot;Type&quot;:&quot;function&quot;,&quot;Function&quot;:{&quot;Name&quot;:&quot;get_current_weather&quot;,&quot;Arguments&quot;:&quot;&quot;}}]},&quot;FinishReason&quot;:&quot;&quot;}],&quot;Created&quot;:1719816830,&quot;Id&quot;:&quot;cd37cf66-089f-4ab2-8118-e18baa238462&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:6,&quot;CompletionTokens&quot;:0,&quot;TotalTokens&quot;:6}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;&quot;,&quot;ToolCalls&quot;:[{&quot;Id&quot;:&quot;call_cq154vk2c3m1v7ep3530&quot;,&quot;Type&quot;:&quot;function&quot;,&quot;Function&quot;:{&quot;Name&quot;:&quot;&quot;,&quot;Arguments&quot;:&quot;{\&quot;location\&quot;:\&quot;北京\&quot;}&quot;}}]},&quot;FinishReason&quot;:&quot;&quot;}],&quot;Created&quot;:1719816830,&quot;Id&quot;:&quot;cd37cf66-089f-4ab2-8118-e18baa238462&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:6,&quot;CompletionTokens&quot;:0,&quot;TotalTokens&quot;:6}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;计划使用get_current_weather工具来获取北京和深圳的当前天气。\n\t\n\t用户想要知道北京和深圳今天的天气情况。用户的请求是关于天气的查询，需要使用天气查询工具来获取信息。&quot;},&quot;FinishReason&quot;:&quot;&quot;}],&quot;Created&quot;:1719816830,&quot;Id&quot;:&quot;cd37cf66-089f-4ab2-8118-e18baa238462&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:6,&quot;CompletionTokens&quot;:46,&quot;TotalTokens&quot;:52}}

data: {&quot;Note&quot;:&quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,&quot;Choices&quot;:[{&quot;Delta&quot;:{&quot;Role&quot;:&quot;assistant&quot;,&quot;Content&quot;:&quot;&quot;},&quot;FinishReason&quot;:&quot;tool_calls&quot;}],&quot;Created&quot;:1719816830,&quot;Id&quot;:&quot;cd37cf66-089f-4ab2-8118-e18baa238462&quot;,&quot;Usage&quot;:{&quot;PromptTokens&quot;:6,&quot;CompletionTokens&quot;:46,&quot;TotalTokens&quot;:52}}
</code></pre><h3 id="%E4%BA%91%E7%89%8D7-hunyuan-functioncall%E6%A8%A1%E5%9E%8B%E5%A4%9A%E8%BD%AE%E5%AF%B9%E8%AF%9D" name="%E4%BA%91%E7%89%8D7-hunyuan-functioncall%E6%A8%A1%E5%9E%8B%E5%A4%9A%E8%BD%AE%E5%AF%B9%E8%AF%9D">云牍7-hunyuan-functioncall模型多轮对话</h3>
<p>请求示例：</p>
<pre><code>curl --location &#39;http://modelpool-api.talkingdata.com/model/openai/api/v3/chat/completions&#39; \
--header &#39;Authorization: Bearer sk-YsnTXnTV7AAWhfcUYVRt1Abxuyl4xBZSe0abmfjjfNg&#39; \
--header &#39;Content-Type: application/json&#39; \
--header &quot;X-Timestamp: $TIMESTAMP&quot; \
--data &#39;{
    &quot;model&quot;: &quot;T0303005&quot;,
    &quot;messages&quot;: [
        {
            &quot;role&quot;: &quot;user&quot;,
            &quot;content&quot;: &quot;北京和深圳今天天气如何&quot;
        },
        {
            &quot;role&quot;: &quot;assistant&quot;,
            &quot;content&quot;: &quot;使用get_current_weather工具来获取北京和深圳的当前天气。\n\t\n\t用户想要知道北京和深圳今天的天气情况。用户提供了两个城市名称，但没有指定温度单位，根据常识，默认用户需要的是摄氏度。&quot;,
            &quot;ToolCalls&quot;: [
                {
                    &quot;Id&quot;: &quot;call_cq16e7k2c3m1v7ep35c0&quot;,
                    &quot;Type&quot;: &quot;function&quot;,
                    &quot;Function&quot;: {
                        &quot;Name&quot;: &quot;get_current_weather&quot;,
                        &quot;Arguments&quot;: &quot;{\&quot;location\&quot;:\&quot;北京\&quot;,\&quot;unit\&quot;:\&quot;celsius\&quot;}&quot;
                    }
                }
            ]
        },
        {
            &quot;role&quot;: &quot;tool&quot;,
            &quot;ToolCallId&quot;: &quot;call_cq16e7k2c3m1v7ep35c0&quot;,
            &quot;content&quot;: &quot;{\&quot;temperature\&quot;: 35, \&quot;wind\&quot;: \&quot;南\&quot;, \&quot;condition\&quot;: \&quot;暴雨\&quot;}&quot;
        }
    ],
     &quot;Tools&quot;: [
        {
            &quot;Type&quot;: &quot;function&quot;,
            &quot;Function&quot;: {
                &quot;Name&quot;: &quot;get_current_weather&quot;,
                &quot;Description&quot;: &quot;获取当前地点的天气&quot;,
                &quot;Parameters&quot;: &quot;{\n                    \&quot;type\&quot;: \&quot;object\&quot;,\n                    \&quot;properties\&quot;: {\n                        \&quot;location\&quot;: {\n                            \&quot;type\&quot;: \&quot;string\&quot;,\n                            \&quot;description\&quot;: \&quot;城市名称\&quot;\n                        },\n                        \&quot;unit\&quot;: {\n                            \&quot;type\&quot;: \&quot;string\&quot;,\n                            \&quot;enum\&quot;: [\n                                \&quot;celsius\&quot;,\n                                \&quot;fahrenheit\&quot;\n                            ]\n                        }\n                    },\n                    \&quot;required\&quot;: [\n                        \&quot;location\&quot;\n                    ]\n                }&quot;
            }
        }
    ],
    &quot;ToolChoice&quot;: &quot;auto&quot;
}
</code></pre><pre><code> &quot;Tools&quot;: [
        {
            &quot;Type&quot;: &quot;function&quot;,
            &quot;Function&quot;: {
                &quot;Name&quot;: &quot;get_current_weather&quot;,
                &quot;Description&quot;: &quot;获取当前地点的天气&quot;,
                &quot;Parameters&quot;: &quot;{\n                    \&quot;type\&quot;: \&quot;object\&quot;,\n                    \&quot;properties\&quot;: {\n                        \&quot;location\&quot;: {\n                            \&quot;type\&quot;: \&quot;string\&quot;,\n                            \&quot;description\&quot;: \&quot;城市名称\&quot;\n                        },\n                        \&quot;unit\&quot;: {\n                            \&quot;type\&quot;: \&quot;string\&quot;,\n                            \&quot;enum\&quot;: [\n                                \&quot;celsius\&quot;,\n                                \&quot;fahrenheit\&quot;\n                            ]\n                        }\n                    },\n                    \&quot;required\&quot;: [\n                        \&quot;location\&quot;\n                    ]\n                }&quot;
            }
        }
    ],
    &quot;ToolChoice&quot;: &quot;auto&quot;
}
</code></pre><p>响应示例：</p>
<pre><code>{
    &quot;Response&quot;: {
        &quot;RequestId&quot;: &quot;5a112898-d802-4bca-8ba2-7ce2388b98e8&quot;,
        &quot;Note&quot;: &quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,
        &quot;Choices&quot;: [
            {
                &quot;Message&quot;: {
                    &quot;Role&quot;: &quot;assistant&quot;,
                    &quot;Content&quot;: &quot;北京今天的天气情况是：\n温度：35摄氏度\n风向：南\n天气状况：暴雨\n\n深圳今天的天气情况是：\n温度：35摄氏度\n风向：南\n天气状况：暴雨&quot;
                },
                &quot;FinishReason&quot;: &quot;stop&quot;
            }
        ],
        &quot;Created&quot;: 1719822322,
        &quot;Id&quot;: &quot;5a112898-d802-4bca-8ba2-7ce2388b98e8&quot;,
        &quot;Usage&quot;: {
            &quot;PromptTokens&quot;: 71,
            &quot;CompletionTokens&quot;: 42,
            &quot;TotalTokens&quot;: 113
        }
    }
}         \&quot;required\&quot;: [\n                        \&quot;location\&quot;\n                    ]\n                }&quot;
        }
    }
],
&quot;ToolChoice&quot;: &quot;auto&quot;
</code></pre><h3 id="%E4%BA%91%E7%89%8D7-%E5%9B%BE%E7%89%87%E7%90%86%E8%A7%A3" name="%E4%BA%91%E7%89%8D7-%E5%9B%BE%E7%89%87%E7%90%86%E8%A7%A3">云牍7-图片理解</h3>
<p>ImageUrl.Url 支持图片链接以及图片 base64 两种方式
jpeg 图片转 base64 示例 (其他图片格式注意修改为对应的 MIME 类型, 如 image/png, image/webp, image/bmp 等):</p>
<pre><code>import base64

with open(&quot;1.jpeg&quot;, &#39;rb&#39;) as image_file:
    encoded_image = base64.b64encode(image_file.read())
    print(&quot;data:image/jpeg;base64,&quot;+encoded_image.decode(&#39;utf-8&#39;))
</code></pre><p>请求示例：</p>
<pre><code>curl --location &#39;http://modelpool-api.talkingdata.com/model/openai/api/v3/chat/completions&#39; \
--header &#39;Authorization: Bearer sk-YsnTXnTV7AAWhfcUYVRt1Abxuyl4xBZSe0abmfjjfNg&#39; \
--header &#39;Content-Type: application/json&#39; \
--header &quot;X-Timestamp: $TIMESTAMP&quot; \
--data &#39;{
    &quot;model&quot;: &quot;T0303005&quot;,
    &quot;messages&quot;: [
       {
            &quot;role&quot;: &quot;user&quot;,
            &quot;contents&quot;: [
                {
                    &quot;Type&quot;: &quot;text&quot;,
                    &quot;Text&quot;: &quot;图片上有什么内容？&quot;
                },
                {
                    &quot;Type&quot;: &quot;image_url&quot;,
                    &quot;ImageUrl&quot;: {
                        &quot;Url&quot;: &quot;https://cloudcache.tencent-cloud.com/qcloud/ui/portal-set/build/About/images/bg-product-series_87d.png&quot;
                    }
                },
                {
                    &quot;Type&quot;: &quot;image_url&quot;,
                    &quot;ImageUrl&quot;: {
                        &quot;Url&quot;: &quot;https://qcloudimg.tencent-cloud.cn/raw/42c198dbc0b57ae490e57f89aa01ec23.png&quot;
                    }
                }
            ]
        }
    ],
    &quot;Stream&quot;: false
}
</code></pre><p>响应示例：</p>
<pre><code>{
    &quot;Response&quot;: {
        &quot;RequestId&quot;: &quot;a21f9d7e-c18a-438b-bfb4-7941a2adf8ae&quot;,
        &quot;Note&quot;: &quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,
        &quot;Choices&quot;: [
            {
                &quot;Message&quot;: {
                    &quot;Role&quot;: &quot;assistant&quot;,
                    &quot;Content&quot;: &quot;这张图片中展示的Logo属于腾讯公司。&quot;
                },
                &quot;FinishReason&quot;: &quot;stop&quot;
            }
        ],
        &quot;Created&quot;: 1714290436,
        &quot;Id&quot;: &quot;a21f9d7e-c18a-438b-bfb4-7941a2adf8ae&quot;,
        &quot;Usage&quot;: {
            &quot;PromptTokens&quot;: 7,
            &quot;CompletionTokens&quot;: 10,
            &quot;TotalTokens&quot;: 17
        }
    }
}
</code></pre><h3 id="%E4%BA%91%E7%89%8D7-%E8%A7%86%E9%A2%91%E7%90%86%E8%A7%A3" name="%E4%BA%91%E7%89%8D7-%E8%A7%86%E9%A2%91%E7%90%86%E8%A7%A3">云牍7-视频理解</h3>
<p>请求示例：</p>
<pre><code>curl --location &#39;http://modelpool-api.talkingdata.com/model/openai/api/v3/chat/completions&#39; \
--header &#39;Authorization: Bearer sk-YsnTXnTV7AAWhfcUYVRt1Abxuyl4xBZSe0abmfjjfNg&#39; \
--header &#39;Content-Type: application/json&#39; \
--header &quot;X-Timestamp: $TIMESTAMP&quot; \
--data &#39;{
    &quot;model&quot;: &quot;T0303005&quot;,
    &quot;messages&quot;: [
        {
            &quot;role&quot;: &quot;user&quot;,
            &quot;contents&quot;: [
                {
                    &quot;Type&quot;: &quot;text&quot;,
                    &quot;Text&quot;: &quot;视频上有什么内容？&quot;
                },
                {
                    &quot;Type&quot;: &quot;video_url&quot;,
                    &quot;VideoUrl&quot;: {
                        &quot;Url&quot;: &quot;https://xxxxxxx.mov&quot;,
                        &quot;Fps&quot;: 1
                    }
                }
            ]
        }
    ],
    &quot;Stream&quot;: false
}
</code></pre><p>响应示例：</p>
<pre><code>{
    &quot;Response&quot;: {
        &quot;RequestId&quot;: &quot;3fd3d34f-8008-4240-b221-fec236c8584d&quot;,
        &quot;Note&quot;: &quot;以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记&quot;,
        &quot;Choices&quot;: [
            {
                &quot;Index&quot;: 0,
                &quot;Message&quot;: {
                    &quot;Role&quot;: &quot;assistant&quot;,
                    &quot;Content&quot;: &quot;视频展示了一个动画场景，其中有一个蓝发女孩和两只柴犬，背景是如画的秋季景色。&quot;
                },
                &quot;FinishReason&quot;: &quot;stop&quot;
            }
        ],
        &quot;Created&quot;: 1765807285,
        &quot;Id&quot;: &quot;3fd3d34f-8008-4240-b221-fec236c8584d&quot;,
        &quot;Usage&quot;: {
            &quot;PromptTokens&quot;: 823,
            &quot;CompletionTokens&quot;: 23,
            &quot;TotalTokens&quot;: 846
        }
    }
}
</code></pre><h2 id="%E9%94%99%E8%AF%AF%E7%A0%81" name="%E9%94%99%E8%AF%AF%E7%A0%81">错误码</h2>
<table>
<thead>
<tr>
<th style="text-align:left">错误码</th>
<th style="text-align:left">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left">FailedOperation.EngineRequestTimeout</td>
<td style="text-align:left">引擎层请求超时；请稍后重试。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.EngineServerError</td>
<td style="text-align:left">引擎层内部错误；请稍后重试。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.EngineServerLimitExceeded</td>
<td style="text-align:left">引擎层请求超过限额；请稍后重试。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.FreeResourcePackExhausted</td>
<td style="text-align:left">免费资源包余量已用尽，请购买资源包或开通后付费。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.ResourcePackExhausted</td>
<td style="text-align:left">资源包余量已用尽，请购买资源包或开通后付费。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.ServiceNotActivated</td>
<td style="text-align:left">服务未开通，请前往控制台申请试用。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.ServiceStop</td>
<td style="text-align:left">用户主动停服。</td>
</tr>
<tr>
<td style="text-align:left">FailedOperation.ServiceStopArrears</td>
<td style="text-align:left">欠费停服。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameter.ImageCountLimitExceededError</td>
<td style="text-align:left">图片数量超限错误。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameter.ImageProcessingFailureError</td>
<td style="text-align:left">图片处理失败错误。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameterValue</td>
<td style="text-align:left">参数取值错误。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameterValue.ImageRequestError</td>
<td style="text-align:left">图片请求错误。</td>
</tr>
<tr>
<td style="text-align:left">InvalidParameterValue.Model</td>
<td style="text-align:left">模型不存在。</td>
</tr>
</tbody>
</table>
]]></content:encoded>
      <pubDate>Tue, 07 Apr 2026 17:51:33 +0800</pubDate>
      <guid>http://doc.talkingdata.com/posts/1223</guid>
      <comments>http://doc.talkingdata.com/posts/1223#comments</comments>
    </item>
  </channel>
</rss>