<?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>Fri, 15 May 2026 06:15:19 +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云筑54/ali-happyhorse-1.0-video-edit</title>
      <link>http://doc.talkingdata.com/posts/1239</link>
      <category>视频生成 API</category>
      <author>liuxinmei</author>
      <description>云筑54 接口说明文档 TD模型编号：T0401004 模型能力简介 云筑54 视频编辑：支持输入视频与参考图，结合文本指令完成风格变换、局部替换等编辑任务。适合对已有视频进行精准编辑和内容修改。 鉴权说明  本接口仅支持API Key鉴权，需联系TD运维同学获取长效API Key。
 创建生视频任务接口地址 请求方法： POST 接口URL：https://modelpool-api.talkingdata.com/model/openai/api/v3/video-generation/video-synthesis 请求头（Request Headers）： 头部字段 值 是否必填 说明 Authorization Bearer &lt;your_api_key&gt; 是 API 鉴权凭证，请替</description>
      <content:encoded><![CDATA[<h4 id="%3Cstrong%3E%E4%BA%91%E7%AD%9154%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%9154%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3%3C%2Fstrong%3E"><strong>云筑54 接口说明文档</strong></h4>
<p><strong>TD模型编号：T0401004</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>云筑54</strong><ul>
<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%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%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">创建生视频任务接口地址</h2>
<p><span id="Hrya4y9k"></span></p>
<p><strong>请求方法：</strong> POST</p>
<p><strong>接口URL：</strong><code>https://modelpool-api.talkingdata.com/model/openai/api/v3/video-generation/video-synthesis</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%88%9B%E5%BB%BA%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%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">创建生视频任务请求参数</h2>
<p><span id="Hrya4y9k"></span></p>
<h3 id="%E5%88%9B%E5%BB%BA%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%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">创建生视频任务请求体（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"><strong>model</strong></td>
<td style="text-align:left">String</td>
<td style="text-align:left">是</td>
<td style="text-align:left">本次请求使用的模型编码。此值固定为 <strong><code>T0401004</code></strong>。</td>
</tr>
<tr>
<td style="text-align:left"><strong>input</strong></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">├─ <strong>prompt</strong></td>
<td style="text-align:left">String</td>
<td style="text-align:left">是</td>
<td style="text-align:left">文本提示词，用来描述对视频的编辑意图，如风格转换、局部替换等。支持任何语言输入，长度不超过5000个非中文字符或2500个中文字符，超出部分会自动截断。</td>
</tr>
<tr>
<td style="text-align:left">├─ <strong>media</strong></td>
<td style="text-align:left">Array</td>
<td style="text-align:left">是</td>
<td style="text-align:left">媒体素材列表，用于指定待编辑的视频和参考图像。<strong>必须包含1个 <code>video</code> 类型元素</strong>，可选包含 <strong>0~5个 <code>reference_image</code> 类型元素</strong>。</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>video</code>：必传，待编辑的视频。 • <code>reference_image</code>：可选，参考图像。</td>
</tr>
<tr>
<td style="text-align:left">└─ <code>url</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">是</td>
<td style="text-align:left">媒体素材的URL地址（仅支持公网HTTP/HTTPS）。 <strong>视频限制</strong>（<code>type=video</code>）： • 格式：MP4、MOV（建议H.264编码）。 • 时长：3~60秒。 • 分辨率：长边不超过2160像素，短边不小于320像素。 • 宽高比：1:2.5 至 2.5:1 之间。 • 文件大小：不超过100MB。 • 帧率：大于8fps。 <strong>输出视频时长说明</strong>：当输入视频不超过15秒时，输出视频时长与输入视频保持一致；当输入视频超过15秒时，系统会从头开始自动截取前15秒作为有效片段，因此最长输出为15秒。 <strong>图像限制</strong>（<code>type=reference_image</code>）： • 格式：JPEG、JPG、PNG、WEBP。 • 分辨率：宽高尺寸不小于300像素。 • 宽高比：1:2.5 至 2.5:1 之间。 • 文件大小：不超过20MB。 • 支持公网URL或Base64编码（格式：<code>data:{MIME_type};base64,{base64_data}</code>）。</td>
</tr>
<tr>
<td style="text-align:left"><strong>parameters</strong></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>resolution</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">生成视频的分辨率档位，用于控制视频的清晰度。可选值：<code>720P</code>、<code>1080P</code>。默认值为 <code>1080P</code>。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>watermark</code></td>
<td style="text-align:left">Boolean</td>
<td style="text-align:left">否</td>
<td style="text-align:left">是否在生成的视频右下角添加“Happy Horse”字样的水印。<code>true</code>（默认）添加水印，<code>false</code> 不添加。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>audio_setting</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">声音控制。可选值： • <code>auto</code>：默认值，由模型自行控制。 • <code>origin</code>：保留输入视频的原始声音。</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, 2147483647]</code>。不指定时系统自动生成随机种子。若需提升生成结果的可复现性，建议固定 seed 值。请注意，由于模型生成具有概率性，即使使用相同 seed，也不能保证每次生成结果完全一致。</td>
</tr>
</tbody>
</table>
<p><span id="Hrya4y9k"></span></p>
<h2 id="%E5%88%9B%E5%BB%BA%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%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">创建生视频任务返回参数</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>output</code></td>
<td style="text-align:left">Object</td>
<td style="text-align:left">任务输出信息。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>task_id</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">异步任务ID，用于后续查询任务状态与结果。有效期为24小时。</td>
</tr>
<tr>
<td style="text-align:left">└─ <code>task_status</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务创建后的初始状态，通常为 <code>PENDING</code>（排队中）或 <code>RUNNING</code>（处理中）。</td>
</tr>
<tr>
<td style="text-align:left"><code>request_id</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%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%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">创建生视频任务调用示例</h2>
<p><span id="Hrya4y9k"></span></p>
<p>请求示例：</p>
<pre><code class="lang-Curl">curl -X POST &#39;https://modelpool-api.talkingdata.com/model/openai/api/v3/video-generation/video-synthesis?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; \
  -d &#39;{
    &quot;model&quot;: &quot;T0401004&quot;,
    &quot;input&quot;: {
        &quot;prompt&quot;: &quot;让视频中的马头人身角色穿上图片中的条纹毛衣&quot;,
        &quot;media&quot;: [
            {
                &quot;type&quot;: &quot;video&quot;,
                &quot;url&quot;: &quot;https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260409/dozxak/Wan_Video_Edit_33_1.mp4&quot;
            },
            {
                &quot;type&quot;: &quot;reference_image&quot;,
                &quot;url&quot;: &quot;https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260415/hynnff/wan-video-edit-clothes.webp&quot;
            }
        ]
    },
    &quot;parameters&quot;: {
        &quot;resolution&quot;: &quot;720P&quot;
    }
}&#39;
</code></pre>
<p>响应示例：</p>
<pre><code>{
    &quot;output&quot;: {
        &quot;task_status&quot;: &quot;RUNNING&quot;,
        &quot;task_id&quot;: &quot;c39df2cb-66ac-4068-82d3-1ae6382dc3af&quot;
    },
    &quot;request_id&quot;: &quot;f8c9dc08-b5f2-96b2-9029-58434acf2912&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>task_id</code>，查询视频生成任务的详细执行状态和结果。</p>
<p><strong>请求方法：</strong> GET</p>
<p><strong>接口URL：</strong><code>https://modelpool-api.talkingdata.com/model/openai/api/v3/tasks/{taskId}</code> </p>
<blockquote>
<p>请将URL中的 <code>{taskId}</code> 替换为实际的 <code>task_id</code> 值。</p>
</blockquote>
<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>
<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>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%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"><code>output</code></td>
<td style="text-align:left">Object</td>
<td style="text-align:left">任务执行的详细信息。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>task_id</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务ID，查询有效期24小时。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>task_status</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务状态。可能值：<code>PENDING</code>（排队中）、<code>RUNNING</code>（处理中）、<code>SUCCEEDED</code>（成功）、<code>FAILED</code>（失败）、<code>CANCELED</code>（已取消）、<code>UNKNOWN</code>（不存在或已过期）。轮询过程中的状态流转：PENDING → RUNNING → SUCCEEDED/FAILED。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>submit_time</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务提交时间。格式：<code>YYYY-MM-DD HH:mm:ss.SSS</code>。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>scheduled_time</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务开始执行的时间。格式：<code>YYYY-MM-DD HH:mm:ss.SSS</code>。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>end_time</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务完成时间。格式：<code>YYYY-MM-DD HH:mm:ss.SSS</code>。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>orig_prompt</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">创建任务时输入的原始提示词，对应请求参数中的 <code>prompt</code>。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>video_url</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">视频下载链接。<strong>仅在 <code>task_status</code> 为 <code>SUCCEEDED</code> 时返回</strong>。视频格式为MP4（H.264编码），链接有效期为24小时。建议在获取链接后立即下载并转存至永久存储。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>code</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">错误码。请求失败时返回，成功时不返回。详情请参见错误码部分。</td>
</tr>
<tr>
<td style="text-align:left">└─ <code>message</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">错误详细信息。请求失败时返回，成功时不返回。</td>
</tr>
<tr>
<td style="text-align:left"><code>usage</code></td>
<td style="text-align:left">Object</td>
<td style="text-align:left">输出信息统计，只对成功的结果计数，用于计费参考。仅在任务成功时可能返回。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>duration</code></td>
<td style="text-align:left">Float</td>
<td style="text-align:left">生成视频的总视频时长，用于计费，单位秒。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>input_video_duration</code></td>
<td style="text-align:left">Float</td>
<td style="text-align:left">输入视频的时长，单位秒。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>output_video_duration</code></td>
<td style="text-align:left">Float</td>
<td style="text-align:left">输出视频的时长，单位秒。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>video_count</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">生成视频的数量，固定为 <code>1</code>。</td>
</tr>
<tr>
<td style="text-align:left">└─ <code>SR</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">生成视频的分辨率档位。<code>720</code> 对应720P；<code>1080</code> 对应1080P。</td>
</tr>
<tr>
<td style="text-align:left"><code>request_id</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%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 GET https://modelpool-api.talkingdata.com/model/openai/api/v3/tasks/c39df2cb-66ac-4068-82d3-1ae6382dc3af \
--header &quot;Authorization: Bearer YOUR_API_KEY&quot; \
--header &quot;Content-Type: application/json&quot; \
--header &quot;X-Timestamp: 1760000000&quot;
</code></pre>
<p>响应示例：</p>
<pre><code class="lang-Curl">{
    &quot;output&quot;: {
        &quot;task_status&quot;: &quot;SUCCEEDED&quot;,
        &quot;orig_prompt&quot;: &quot;让视频中的马头人身角色穿上图片中的条纹毛衣&quot;,
        &quot;video_url&quot;: &quot;https://dashscope-a717.oss-accelerate.aliyuncs.com/1d/0c/20260511/007a70ae/49216773-0edUXKVU_5399c2abd171_merged.mp4?Expires=1778570307&amp;OSSAccessKeyId=LTAI5tPxpiCM2hjmWrFXrym1&amp;Signature=DvEWY4SfmthyX9rbgwJI%2BVpH8B4%3D&quot;,
        &quot;submit_time&quot;: &quot;2026-05-11 15:16:55.377&quot;,
        &quot;end_time&quot;: &quot;2026-05-11 15:18:27.714&quot;,
        &quot;task_id&quot;: &quot;c39df2cb-66ac-4068-82d3-1ae6382dc3af&quot;,
        &quot;scheduled_time&quot;: &quot;2026-05-11 15:16:55.417&quot;
    },
    &quot;usage&quot;: {
        &quot;duration&quot;: 12,
        &quot;input_video_duration&quot;: 6,
        &quot;output_video_duration&quot;: 6,
        &quot;video_count&quot;: 1,
        &quot;SR&quot;: 720
    },
    &quot;request_id&quot;: &quot;6786140b-3d5e-9ab6-8b03-a6a2e994d630&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"><code>InvalidApiKey</code></td>
<td style="text-align:left">API Key无效或未提供。</td>
</tr>
<tr>
<td style="text-align:left"><code>InvalidParameter</code></td>
<td style="text-align:left">请求参数不合法。请检查参数值是否符合文档要求。</td>
</tr>
<tr>
<td style="text-align:left"><code>InternalError</code></td>
<td style="text-align:left">服务内部错误。请稍后重试，若问题持续存在请联系技术支持。</td>
</tr>
</tbody>
</table>
]]></content:encoded>
      <pubDate>Wed, 13 May 2026 13:56:32 +0800</pubDate>
      <guid>http://doc.talkingdata.com/posts/1239</guid>
      <comments>http://doc.talkingdata.com/posts/1239#comments</comments>
    </item>
    <item>
      <title>TD云筑53/ali-happyhorse-1.0-r2v</title>
      <link>http://doc.talkingdata.com/posts/1238</link>
      <category>视频生成 API</category>
      <author>liuxinmei</author>
      <description>云筑53 接口说明文档 TD模型编号：T0401003 模型能力简介 云筑53 参考生视频：支持传入多张参考图像，通过文本提示词描述场景，将图像中的主体角色融合，生成一段物理真实、运动流畅的视频。适合需要进行多角色或多元素融合的创意视频生成。 鉴权说明  本接口仅支持API Key鉴权，需联系TD运维同学获取长效API Key。
 创建生视频任务接口地址 请求方法： POST 接口URL：https://modelpool-api.talkingdata.com/model/openai/api/v3/video-generation/video-synthesis 请求头（Request Headers）： 头部字段 值 是否必填 说明 Authorization Bearer &lt;your</description>
      <content:encoded><![CDATA[<h4 id="%3Cstrong%3E%E4%BA%91%E7%AD%9153%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%9153%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3%3C%2Fstrong%3E"><strong>云筑53 接口说明文档</strong></h4>
<p><strong>TD模型编号：T0401003</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>云筑53</strong><ul>
<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%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%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">创建生视频任务接口地址</h2>
<p><span id="Hrya4y9k"></span></p>
<p><strong>请求方法：</strong> POST</p>
<p><strong>接口URL：</strong><code>https://modelpool-api.talkingdata.com/model/openai/api/v3/video-generation/video-synthesis</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%88%9B%E5%BB%BA%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%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">创建生视频任务请求参数</h2>
<p><span id="Hrya4y9k"></span></p>
<h3 id="%E5%88%9B%E5%BB%BA%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%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">创建生视频任务请求体（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"><strong>model</strong></td>
<td style="text-align:left">String</td>
<td style="text-align:left">是</td>
<td style="text-align:left">本次请求使用的模型编码。此值固定为 <strong><code>T0401003</code></strong>。</td>
</tr>
<tr>
<td style="text-align:left"><strong>input</strong></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">├─ <strong>prompt</strong></td>
<td style="text-align:left">String</td>
<td style="text-align:left">是</td>
<td style="text-align:left">文本提示词，用来描述生成视频中期望包含的元素和视觉特点。支持任何语言输入，长度不超过5000个非中文字符或2500个中文字符，超出部分会自动截断。 <strong>参考指代</strong>：在 prompt 中通过 <code>[Image 1]</code>、<code>[Image 2]</code> 等标识指代 <code>media</code> 数组中对应位置的参考图像，顺序与 <code>media</code> 数组顺序一致。使用时需要指明参考图中的具体对象，例如 <code>&quot;[Image 1]中身着红色旗袍的女性&quot;</code>。</td>
</tr>
<tr>
<td style="text-align:left">├─ <strong>media</strong></td>
<td style="text-align:left">Array</td>
<td style="text-align:left">是</td>
<td style="text-align:left">媒体素材列表，用于指定参考图像。数组的每个元素为一个媒体对象，包含 <code>type</code> 和 <code>url</code> 字段。数组中的第1个 <code>reference_image</code> 对应 <code>[Image 1]</code>，第2个对应 <code>[Image 2]</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>reference_image</code>（参考图像）。参考图像数量限制为 <strong>1～9张</strong>。</td>
</tr>
<tr>
<td style="text-align:left">└─ <code>url</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">是</td>
<td style="text-align:left">参考图像的URL（支持公网HTTP/HTTPS）或 Base64 编码数据。 • <strong>公网URL</strong>：支持 HTTP 或 HTTPS 协议。 • <strong>Base64编码</strong>：格式为 <code>data:{MIME_type};base64,{base64_data}</code>，其中 <code>{MIME_type}</code> 需与图像格式对应（如 <code>image/png</code>、<code>image/jpeg</code>），<code>{base64_data}</code> 为 Base64 编码后的字符串。 <strong>图像限制</strong>： • 格式：JPEG、JPG、PNG、WEBP。 • 分辨率：短边不低于400像素，推荐720P以上清晰图。避免传入过小、模糊或压缩过度的图像，以免影响生成效果。 • 文件大小：不超过20MB。</td>
</tr>
<tr>
<td style="text-align:left"><strong>parameters</strong></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>resolution</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">生成视频的分辨率档位，用于控制视频的清晰度。可选值：<code>720P</code>、<code>1080P</code>。默认值为 <code>1080P</code>。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>ratio</code></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>3:4</code>、<code>4:3</code>、<code>4:5</code>、<code>5:4</code>、<code>1:1</code>。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>duration</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">否</td>
<td style="text-align:left">生成视频的时长，单位为秒。取值范围 <code>[3, 15]</code> 之间的整数，默认值为 <code>5</code>。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>watermark</code></td>
<td style="text-align:left">Boolean</td>
<td style="text-align:left">否</td>
<td style="text-align:left">是否在生成的视频右下角添加“Happy Horse”字样的水印。<code>true</code>（默认）添加水印，<code>false</code> 不添加。</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, 2147483647]</code>。不指定时系统自动生成随机种子。若需提升生成结果的可复现性，建议固定 seed 值。请注意，由于模型生成具有概率性，即使使用相同 seed，也不能保证每次生成结果完全一致。</td>
</tr>
</tbody>
</table>
<p><span id="Hrya4y9k"></span></p>
<h2 id="%E5%88%9B%E5%BB%BA%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%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">创建生视频任务返回参数</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>output</code></td>
<td style="text-align:left">Object</td>
<td style="text-align:left">任务输出信息。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>task_id</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">异步任务ID，用于后续查询任务状态与结果。有效期为24小时。</td>
</tr>
<tr>
<td style="text-align:left">└─ <code>task_status</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务创建后的初始状态，通常为 <code>PENDING</code>（排队中）或 <code>RUNNING</code>（处理中）。</td>
</tr>
<tr>
<td style="text-align:left"><code>request_id</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%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%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">创建生视频任务调用示例</h2>
<p><span id="Hrya4y9k"></span></p>
<p>请求示例：</p>
<pre><code class="lang-Curl">curl -X POST &#39;https://modelpool-api.talkingdata.com/model/openai/api/v3/video-generation/video-synthesis?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; \
  -d &#39;{
    &quot;model&quot;: &quot;T0401003&quot;,
    &quot;input&quot;: {
        &quot;prompt&quot;: &quot;[Image 1]中身着红色旗袍的女性，镜头先以侧面中景勾勒旗袍修身剪裁与S型曲线，随即切换至低角度仰拍，捕捉她轻抬玉手展开[Image 2]中的折扇的同时，[Image 3]中的流苏耳坠随头部转动轻盈摆动的细节，最后推近至面部特写，定格在她指尖轻点扇骨、眼波流转间的含蓄风情，多视角全方位展现东方韵味。&quot;,
        &quot;media&quot;: [
            {
                &quot;type&quot;: &quot;reference_image&quot;,
                &quot;url&quot;: &quot;https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/mvzfud/hh-v2v-girl.jpg&quot;
            },
            {
                &quot;type&quot;: &quot;reference_image&quot;,
                &quot;url&quot;: &quot;https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/fvuihk/hh-v2v2-folding-fan.jpg&quot;
            },
            {
                &quot;type&quot;: &quot;reference_image&quot;,
                &quot;url&quot;: &quot;https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/imerii/hh-v2v-earrings.jpg&quot;
            }
        ]
    },
    &quot;parameters&quot;: {
        &quot;resolution&quot;: &quot;720P&quot;,
        &quot;ratio&quot;: &quot;16:9&quot;,
        &quot;duration&quot;: 5
    }
}&#39;
</code></pre>
<p>响应示例：</p>
<pre><code>{
    &quot;output&quot;: {
        &quot;task_status&quot;: &quot;RUNNING&quot;,
        &quot;task_id&quot;: &quot;15e84a48-31d2-4c40-a493-5bc314bd47e2&quot;
    },
    &quot;request_id&quot;: &quot;86c780c0-1e05-9a55-a2d8-54628f0d93f4&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>task_id</code>，查询视频生成任务的详细执行状态和结果。</p>
<p><strong>请求方法：</strong> GET</p>
<p><strong>接口URL：</strong><code>https://modelpool-api.talkingdata.com/model/openai/api/v3/tasks/{taskId}</code> </p>
<blockquote>
<p>请将URL中的 <code>{taskId}</code> 替换为实际的 <code>task_id</code> 值。</p>
</blockquote>
<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>
<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>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%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"><code>output</code></td>
<td style="text-align:left">Object</td>
<td style="text-align:left">任务执行的详细信息。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>task_id</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务ID，查询有效期24小时。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>task_status</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务状态。可能值：<code>PENDING</code>（排队中）、<code>RUNNING</code>（处理中）、<code>SUCCEEDED</code>（成功）、<code>FAILED</code>（失败）、<code>CANCELED</code>（已取消）、<code>UNKNOWN</code>（不存在或已过期）。轮询过程中的状态流转：PENDING → RUNNING → SUCCEEDED/FAILED。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>submit_time</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务提交时间。格式：<code>YYYY-MM-DD HH:mm:ss.SSS</code>。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>scheduled_time</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务开始执行的时间。格式：<code>YYYY-MM-DD HH:mm:ss.SSS</code>。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>end_time</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务完成时间。格式：<code>YYYY-MM-DD HH:mm:ss.SSS</code>。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>orig_prompt</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">创建任务时输入的原始提示词，对应请求参数中的 <code>prompt</code>。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>video_url</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">视频下载链接。<strong>仅在 <code>task_status</code> 为 <code>SUCCEEDED</code> 时返回</strong>。视频格式为MP4（H.264编码），链接有效期为24小时。建议在获取链接后立即下载并转存至永久存储。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>code</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">错误码。请求失败时返回，成功时不返回。详情请参见错误码部分。</td>
</tr>
<tr>
<td style="text-align:left">└─ <code>message</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">错误详细信息。请求失败时返回，成功时不返回。</td>
</tr>
<tr>
<td style="text-align:left"><code>usage</code></td>
<td style="text-align:left">Object</td>
<td style="text-align:left">输出信息统计，只对成功的结果计数，用于计费参考。仅在任务成功时可能返回。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>duration</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">生成视频的总视频时长，用于计费，单位秒。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>input_video_duration</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>output_video_duration</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">输出视频的总时长，单位秒。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>video_count</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">生成视频的数量，固定为 <code>1</code>。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>SR</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">生成视频的分辨率档位。<code>720</code> 对应720P；<code>1080</code> 对应1080P。</td>
</tr>
<tr>
<td style="text-align:left">└─ <code>ratio</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">生成视频的宽高比，如 <code>16:9</code>。</td>
</tr>
<tr>
<td style="text-align:left"><code>request_id</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%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 GET https://modelpool-api.talkingdata.com/model/openai/api/v3/tasks/15e84a48-31d2-4c40-a493-5bc314bd47e2 \
--header &quot;Authorization: Bearer YOUR_API_KEY&quot; \
--header &quot;Content-Type: application/json&quot; \
--header &quot;X-Timestamp: 1760000000&quot;
</code></pre>
<p>响应示例：</p>
<pre><code class="lang-Curl">{
    &quot;output&quot;: {
        &quot;task_status&quot;: &quot;SUCCEEDED&quot;,
        &quot;orig_prompt&quot;: &quot;[Image 1]中身着红色旗袍的女性，镜头先以侧面中景勾勒旗袍修身剪裁与S型曲线，随即切换至低角度仰拍，捕捉她轻抬玉手展开[Image 2]中的折扇的同时，[Image 3]中的流苏耳坠随头部转动轻盈摆动的细节，最后推近至面部特写，定格在她指尖轻点扇骨、眼波流转间的含蓄风情，多视角全方位展现东方韵味。&quot;,
        &quot;video_url&quot;: &quot;https://dashscope-a717.oss-accelerate.aliyuncs.com/1d/55/20260511/041319bf/60152058-metadata_video_720p_15e84a48-31d2-4c40-a493-5bc314bd47e2_refiner_watermark.mp4?Expires=1778570077&amp;OSSAccessKeyId=LTAI5tPxpiCM2hjmWrFXrym1&amp;Signature=lJuwZa%2BRbv7eEnlv8k6MEb5TXdo%3D&quot;,
        &quot;submit_time&quot;: &quot;2026-05-11 15:13:03.929&quot;,
        &quot;end_time&quot;: &quot;2026-05-11 15:14:37.931&quot;,
        &quot;task_id&quot;: &quot;15e84a48-31d2-4c40-a493-5bc314bd47e2&quot;,
        &quot;scheduled_time&quot;: &quot;2026-05-11 15:13:03.962&quot;
    },
    &quot;usage&quot;: {
        &quot;duration&quot;: 5,
        &quot;input_video_duration&quot;: 0,
        &quot;output_video_duration&quot;: 5,
        &quot;video_count&quot;: 1,
        &quot;SR&quot;: 720,
        &quot;ratio&quot;: &quot;16:9&quot;
    },
    &quot;request_id&quot;: &quot;09cfd25f-5a7d-91fd-a379-23d14a416526&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"><code>InvalidApiKey</code></td>
<td style="text-align:left">API Key无效或未提供。</td>
</tr>
<tr>
<td style="text-align:left"><code>InvalidParameter</code></td>
<td style="text-align:left">请求参数不合法。请检查参数值是否符合文档要求。</td>
</tr>
<tr>
<td style="text-align:left"><code>InternalError</code></td>
<td style="text-align:left">服务内部错误。请稍后重试，若问题持续存在请联系技术支持。</td>
</tr>
</tbody>
</table>
]]></content:encoded>
      <pubDate>Wed, 13 May 2026 11:37:20 +0800</pubDate>
      <guid>http://doc.talkingdata.com/posts/1238</guid>
      <comments>http://doc.talkingdata.com/posts/1238#comments</comments>
    </item>
    <item>
      <title>TD云筑52/ali-happyhorse-1.0-i2v</title>
      <link>http://doc.talkingdata.com/posts/1237</link>
      <category>视频生成 API</category>
      <author>liuxinmei</author>
      <description>云筑52 接口说明文档 TD模型编号：T0401002 模型能力简介 云筑52 图生视频（基于首帧）：以首帧图片为基础，结合文本描述进行引导，生成物理真实、运动流畅的视频。适合基于具体图像进行动态化创作。 鉴权说明  本接口仅支持API Key鉴权，需联系TD运维同学获取长效API Key。
 创建生视频任务接口地址 请求方法： POST 接口URL：https://modelpool-api.talkingdata.com/model/openai/api/v3/video-generation/video-synthesis 请求头（Request Headers）： 头部字段 值 是否必填 说明 Authorization Bearer &lt;your_api_key&gt; 是 API 鉴权凭</description>
      <content:encoded><![CDATA[<h4 id="%3Cstrong%3E%E4%BA%91%E7%AD%9152%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%9152%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3%3C%2Fstrong%3E"><strong>云筑52 接口说明文档</strong></h4>
<p><strong>TD模型编号：T0401002</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>云筑52</strong><ul>
<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%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%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">创建生视频任务接口地址</h2>
<p><span id="Hrya4y9k"></span></p>
<p><strong>请求方法：</strong> POST</p>
<p><strong>接口URL：</strong><code>https://modelpool-api.talkingdata.com/model/openai/api/v3/video-generation/video-synthesis</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%88%9B%E5%BB%BA%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%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">创建生视频任务请求参数</h2>
<p><span id="Hrya4y9k"></span></p>
<h3 id="%E5%88%9B%E5%BB%BA%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%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">创建生视频任务请求体（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"><strong>model</strong></td>
<td style="text-align:left">String</td>
<td style="text-align:left">是</td>
<td style="text-align:left">本次请求使用的模型编码。此值固定为 <strong><code>T0401002</code></strong>。</td>
</tr>
<tr>
<td style="text-align:left"><strong>input</strong></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">├─ <strong>prompt</strong></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">文本提示词，用于描述期望生成的视频内容。支持任何语言输入，长度不超过5000个非中文字符或2500个中文字符，超出部分将自动截断。</td>
</tr>
<tr>
<td style="text-align:left">├─ <strong>media</strong></td>
<td style="text-align:left">Array</td>
<td style="text-align:left">是</td>
<td style="text-align:left">输入媒体列表。用于指定视频生成所需的图像。<strong>有且仅有1张首帧图像</strong>。</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>first_frame</code>，表示首帧。</td>
</tr>
<tr>
<td style="text-align:left">└─ <code>url</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">是</td>
<td style="text-align:left">媒体素材URL。传入首帧图像的URL或 Base64 编码数据。 • <strong>公网URL</strong>：支持 HTTP 或 HTTPS 协议。 • <strong>Base64编码</strong>：格式为 <code>data:{MIME_type};base64,{base64_data}</code>，其中 <code>{MIME_type}</code> 需与图像格式对应（如 <code>image/png</code>、<code>image/jpeg</code>），<code>{base64_data}</code> 为 Base64 编码后的字符串。 <strong>图像限制</strong>： • 格式：JPEG、JPG、PNG、WEBP。 • 分辨率：宽和高均不小于300像素。 • 宽高比：1:2.5 至 2.5:1 之间。 • 文件大小：不超过20MB。</td>
</tr>
<tr>
<td style="text-align:left"><strong>parameters</strong></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>resolution</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">指定生成的视频分辨率档位，用于控制视频的清晰度（总像素）。模型根据选择的分辨率档位自动缩放。可选值：<code>720P</code>、<code>1080P</code>。默认值为 <code>1080P</code>。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>duration</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">否</td>
<td style="text-align:left">指定生成视频的时长，单位为秒。取值范围 <code>[3, 15]</code> 之间的整数，默认值为 <code>5</code>。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>watermark</code></td>
<td style="text-align:left">Boolean</td>
<td style="text-align:left">否</td>
<td style="text-align:left">是否在生成的视频右下角添加“Happy Horse”字样的水印。<code>true</code>（默认）添加水印，<code>false</code> 不添加。</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, 2147483647]</code>。不指定时系统自动生成随机种子。若需提升生成结果的可复现性，建议固定 seed 值。请注意，由于模型生成具有概率性，即使使用相同 seed，也不能保证每次生成结果完全一致。</td>
</tr>
</tbody>
</table>
<p><span id="Hrya4y9k"></span></p>
<h2 id="%E5%88%9B%E5%BB%BA%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%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">创建生视频任务返回参数</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>output</code></td>
<td style="text-align:left">Object</td>
<td style="text-align:left">任务输出信息。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>task_id</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">异步任务ID，用于后续查询任务状态与结果。有效期为24小时。</td>
</tr>
<tr>
<td style="text-align:left">└─ <code>task_status</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务创建后的初始状态，通常为 <code>PENDING</code>（排队中）或 <code>RUNNING</code>（处理中）。</td>
</tr>
<tr>
<td style="text-align:left"><code>request_id</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%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%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">创建生视频任务调用示例</h2>
<p><span id="Hrya4y9k"></span></p>
<p>请求示例：</p>
<pre><code class="lang-Curl">curl -X POST &#39;https://modelpool-api.talkingdata.com/model/openai/api/v3/video-generation/video-synthesis?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; \
  -d &#39;{
    &quot;model&quot;: &quot;T0401002&quot;,
    &quot;input&quot;: {
        &quot;prompt&quot;: &quot;一只猫在草地上奔跑&quot;,
        &quot;media&quot;: [
            {
                &quot;type&quot;: &quot;first_frame&quot;,
                &quot;url&quot;: &quot;https://td-llm.tos-cn-beijing.volces.com/public/1774320434562_2b131e.png&quot;
            }
        ]
    },
    &quot;parameters&quot;: {
        &quot;resolution&quot;: &quot;720P&quot;,
        &quot;duration&quot;: 5
    }
}&#39;
</code></pre>
<p>响应示例：</p>
<pre><code>{
    &quot;output&quot;: {
        &quot;task_status&quot;: &quot;RUNNING&quot;,
        &quot;task_id&quot;: &quot;766be4a7-c512-48d6-af4a-b2117c110002&quot;
    },
    &quot;request_id&quot;: &quot;ea7497d7-beb3-92f5-9074-1e1571c45acb&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>task_id</code>，查询视频生成任务的详细执行状态和结果。</p>
<p><strong>请求方法：</strong> GET</p>
<p><strong>接口URL：</strong><code>https://modelpool-api.talkingdata.com/model/openai/api/v3/tasks/{taskId}</code> </p>
<blockquote>
<p>请将URL中的 <code>{taskId}</code> 替换为实际的 <code>task_id</code> 值。</p>
</blockquote>
<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>
<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>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%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"><code>output</code></td>
<td style="text-align:left">Object</td>
<td style="text-align:left">任务执行的详细信息。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>task_id</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务ID，查询有效期24小时。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>task_status</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务状态。可能值：<code>PENDING</code>（排队中）、<code>RUNNING</code>（处理中）、<code>SUCCEEDED</code>（成功）、<code>FAILED</code>（失败）、<code>CANCELED</code>（已取消）、<code>UNKNOWN</code>（不存在或已过期）。轮询过程中的状态流转：PENDING → RUNNING → SUCCEEDED/FAILED。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>submit_time</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务提交时间。格式：<code>YYYY-MM-DD HH:mm:ss.SSS</code>。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>scheduled_time</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务开始执行的时间。格式：<code>YYYY-MM-DD HH:mm:ss.SSS</code>。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>end_time</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务完成时间。格式：<code>YYYY-MM-DD HH:mm:ss.SSS</code>。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>orig_prompt</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">创建任务时输入的原始提示词，对应请求参数中的 <code>prompt</code>。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>video_url</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">视频下载链接。<strong>仅在 <code>task_status</code> 为 <code>SUCCEEDED</code> 时返回</strong>。视频帧率为24fps，格式为MP4（H.264编码），链接有效期为24小时。建议在获取链接后立即下载并转存至永久存储。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>code</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">错误码。请求失败时返回，成功时不返回。详情请参见错误码部分。</td>
</tr>
<tr>
<td style="text-align:left">└─ <code>message</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">错误详细信息。请求失败时返回，成功时不返回。</td>
</tr>
<tr>
<td style="text-align:left"><code>usage</code></td>
<td style="text-align:left">Object</td>
<td style="text-align:left">输出信息统计，只对成功的结果计数，用于计费参考。仅在任务成功时可能返回。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>duration</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">总的视频时长，用于计费，单位秒。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>input_video_duration</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>output_video_duration</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">输出视频的时长，单位秒。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>video_count</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">输出视频的数量，固定为 <code>1</code>。</td>
</tr>
<tr>
<td style="text-align:left">└─ <code>SR</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">输出视频的分辨率档位。<code>720</code> 对应720P；<code>1080</code> 对应1080P。</td>
</tr>
<tr>
<td style="text-align:left"><code>request_id</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%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 GET https://modelpool-api.talkingdata.com/model/openai/api/v3/tasks/766be4a7-c512-48d6-af4a-b2117c110002 \
--header &quot;Authorization: Bearer YOUR_API_KEY&quot; \
--header &quot;Content-Type: application/json&quot; \
--header &quot;X-Timestamp: 1760000000&quot;
</code></pre>
<p>响应示例：</p>
<pre><code class="lang-Curl">{
    &quot;output&quot;: {
        &quot;task_status&quot;: &quot;SUCCEEDED&quot;,
        &quot;orig_prompt&quot;: &quot;一只猫在草地上奔跑&quot;,
        &quot;video_url&quot;: &quot;https://dashscope-a717.oss-accelerate.aliyuncs.com/1d/25/20260511/041319bf/8114223-metadata_video_720p_766be4a7-c512-48d6-af4a-b2117c110002_refiner_watermark.mp4?Expires=1778569552&amp;OSSAccessKeyId=LTAI5tPxpiCM2hjmWrFXrym1&amp;Signature=Lu92f7XFqgII8rg1VcrHJogsTpU%3D&quot;,
        &quot;submit_time&quot;: &quot;2026-05-11 15:04:20.445&quot;,
        &quot;end_time&quot;: &quot;2026-05-11 15:05:52.317&quot;,
        &quot;task_id&quot;: &quot;766be4a7-c512-48d6-af4a-b2117c110002&quot;,
        &quot;scheduled_time&quot;: &quot;2026-05-11 15:04:20.469&quot;
    },
    &quot;usage&quot;: {
        &quot;duration&quot;: 5,
        &quot;input_video_duration&quot;: 0,
        &quot;output_video_duration&quot;: 5,
        &quot;video_count&quot;: 1,
        &quot;SR&quot;: 720
    },
    &quot;request_id&quot;: &quot;35cf541b-b104-958b-92f3-d6176e86aa65&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"><code>InvalidApiKey</code></td>
<td style="text-align:left">API Key无效或未提供。</td>
</tr>
<tr>
<td style="text-align:left"><code>InvalidParameter</code></td>
<td style="text-align:left">请求参数不合法。请检查参数值是否符合文档要求。</td>
</tr>
<tr>
<td style="text-align:left"><code>InternalError</code></td>
<td style="text-align:left">服务内部错误。请稍后重试，若问题持续存在请联系技术支持。</td>
</tr>
</tbody>
</table>
]]></content:encoded>
      <pubDate>Wed, 13 May 2026 11:25:54 +0800</pubDate>
      <guid>http://doc.talkingdata.com/posts/1237</guid>
      <comments>http://doc.talkingdata.com/posts/1237#comments</comments>
    </item>
    <item>
      <title>TD云筑51/ali-happyhorse-1.0-t2v</title>
      <link>http://doc.talkingdata.com/posts/1236</link>
      <category>视频生成 API</category>
      <author>liuxinmei</author>
      <description>云筑51 接口说明文档 TD模型编号：T0401001 模型能力简介 云筑51 文生视频：仅通过文本描述（Prompt）即可生成完整视频，适合创意概念快速可视化。 鉴权说明  本接口仅支持API Key鉴权，需联系TD运维同学获取长效API Key。
 创建生视频任务接口地址 请求方法： POST 接口URL：https://modelpool-api.talkingdata.com/model/openai/api/v3/video-generation/video-synthesis 请求头（Request Headers）： 头部字段 值 是否必填 说明 Authorization Bearer &lt;your_api_key&gt; 是 API 鉴权凭证，请替换为有效的 API Key X-T</description>
      <content:encoded><![CDATA[<h4 id="%3Cstrong%3E%E4%BA%91%E7%AD%9151%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%9151%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3%3C%2Fstrong%3E"><strong>云筑51 接口说明文档</strong></h4>
<p><strong>TD模型编号：T0401001</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>云筑51</strong><ul>
<li><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="%E5%88%9B%E5%BB%BA%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%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">创建生视频任务接口地址</h2>
<p><span id="Hrya4y9k"></span></p>
<p><strong>请求方法：</strong> POST</p>
<p><strong>接口URL：</strong><code>https://modelpool-api.talkingdata.com/model/openai/api/v3/video-generation/video-synthesis</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%88%9B%E5%BB%BA%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%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">创建生视频任务请求参数</h2>
<p><span id="Hrya4y9k"></span></p>
<h3 id="%E5%88%9B%E5%BB%BA%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%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">创建生视频任务请求体（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"><strong>model</strong></td>
<td style="text-align:left">String</td>
<td style="text-align:left">是</td>
<td style="text-align:left">本次请求使用的模型编码。此值固定为 <strong><code>T0401001</code></strong>。</td>
</tr>
<tr>
<td style="text-align:left"><strong>input</strong></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">├─ <strong>prompt</strong></td>
<td style="text-align:left">String</td>
<td style="text-align:left">是</td>
<td style="text-align:left">文本提示词，用于描述期望生成的视频内容。支持中英文输入，长度不超过2500个中文字符或5000个非中文字符，超出部分将自动截断。</td>
</tr>
<tr>
<td style="text-align:left"><strong>parameters</strong></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">├─ resolution</td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">生成视频的分辨率档位。可选值：<code>720P</code>、<code>1080P</code>。默认值为 <code>1080P</code>。</td>
</tr>
<tr>
<td style="text-align:left">├─ ratio</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>、<code>4:3</code>、<code>3:4</code>、<code>4:5</code>、<code>5:4</code>。</td>
</tr>
<tr>
<td style="text-align:left">├─ duration</td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">否</td>
<td style="text-align:left">生成视频的时长，单位为秒。取值范围 <code>[3, 15]</code>，默认值为 <code>5</code>。</td>
</tr>
<tr>
<td style="text-align:left">├─ watermark</td>
<td style="text-align:left">Boolean</td>
<td style="text-align:left">否</td>
<td style="text-align:left">是否在生成的视频右下角添加“Happy Horse”字样的水印。<code>true</code>（默认）添加水印，<code>false</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">随机数种子，用于结果复现。取值范围 <code>[0, 2147483647]</code>。不指定时系统自动生成。</td>
</tr>
</tbody>
</table>
<p><span id="Hrya4y9k"></span></p>
<h2 id="%E5%88%9B%E5%BB%BA%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%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">创建生视频任务返回参数</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>output</code></td>
<td style="text-align:left">Object</td>
<td style="text-align:left">任务输出信息。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>task_id</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">异步任务ID，用于后续查询任务状态与结果。有效期为24小时。</td>
</tr>
<tr>
<td style="text-align:left">└─ <code>task_status</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务创建后的初始状态，通常为 <code>PENDING</code> 或 <code>RUNNING</code>。</td>
</tr>
<tr>
<td style="text-align:left"><code>request_id</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%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%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">创建生视频任务调用示例</h2>
<p><span id="Hrya4y9k"></span></p>
<p>请求示例：</p>
<pre><code class="lang-Curl">curl -X POST &#39;https://modelpool-api.talkingdata.com/model/openai/api/v3/video-generation/video-synthesis?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; \
  -d &#39;{
    &quot;model&quot;: &quot;T0401001&quot;,
    &quot;input&quot;: {
        &quot;prompt&quot;: &quot;一座由硬纸板和瓶盖搭建的微型城市，在夜晚焕发出生机。一列硬纸板火车缓缓驶过，小灯点缀其间，照亮前路。&quot;
    },
    &quot;parameters&quot;: {
        &quot;resolution&quot;: &quot;720P&quot;,
        &quot;ratio&quot;: &quot;16:9&quot;,
        &quot;duration&quot;: 5
    }
}&#39;
</code></pre>
<p>响应示例：</p>
<pre><code>{
    &quot;output&quot;: {
        &quot;task_status&quot;: &quot;RUNNING&quot;,
        &quot;task_id&quot;: &quot;602ac3b0-f096-4822-aa13-ba603b5520d9&quot;
    },
    &quot;request_id&quot;: &quot;c2555b9a-f1db-9bd2-84fe-0c644731905a&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>task_id</code>，查询视频生成任务的详细执行状态和结果。</p>
<p><strong>请求方法：</strong> GET</p>
<p><strong>接口URL：</strong><code>https://modelpool-api.talkingdata.com/model/openai/api/v3/tasks/{taskId}</code> </p>
<blockquote>
<p>请将URL中的 <code>{taskId}</code> 替换为实际的 <code>task_id</code> 值。</p>
</blockquote>
<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>
<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>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%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"><code>output</code></td>
<td style="text-align:left">Object</td>
<td style="text-align:left">任务执行的详细信息。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>task_id</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务ID。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>task_status</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务状态。可能值：<code>PENDING</code>（排队中）、<code>RUNNING</code>（处理中）、<code>SUCCEEDED</code>（成功）、<code>FAILED</code>（失败）、<code>CANCELED</code>（已取消）、<code>UNKNOWN</code>（不存在或已过期）。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>submit_time</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务提交时间。格式：<code>YYYY-MM-DD HH:mm:ss.SSS</code>。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>scheduled_time</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务开始执行的时间。格式：<code>YYYY-MM-DD HH:mm:ss.SSS</code>。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>end_time</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务完成时间。格式：<code>YYYY-MM-DD HH:mm:ss.SSS</code>。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>orig_prompt</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">创建任务时输入的原始提示词。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>video_url</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">视频下载链接。<strong>仅在 <code>task_status</code> 为 <code>SUCCEEDED</code> 时返回</strong>。视频格式为MP4（H.264编码），链接有效期为24小时。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>code</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">错误码。请求失败时返回，成功时不返回。</td>
</tr>
<tr>
<td style="text-align:left">└─ <code>message</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">错误详细信息。请求失败时返回，成功时不返回。</td>
</tr>
<tr>
<td style="text-align:left"><code>usage</code></td>
<td style="text-align:left">Object</td>
<td style="text-align:left">资源用量信息，用于计费参考。仅在任务成功时可能返回。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>duration</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">计费用时长，单位秒。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>output_video_duration</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">输出视频的时长，单位秒。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>SR</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">输出视频的分辨率档位。<code>720</code> 对应720P；<code>1080</code> 对应1080P。</td>
</tr>
<tr>
<td style="text-align:left">├─ <code>ratio</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">输出视频的宽高比，如 <code>16:9</code>。</td>
</tr>
<tr>
<td style="text-align:left">└─ <code>video_count</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">生成的视频数量，固定为 <code>1</code>。</td>
</tr>
<tr>
<td style="text-align:left"><code>request_id</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%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 GET https://modelpool-api.talkingdata.com/model/openai/api/v3/tasks/602ac3b0-f096-4822-aa13-ba603b5520d9 \
--header &quot;Authorization: Bearer YOUR_API_KEY&quot; \
--header &quot;Content-Type: application/json&quot; \
--header &quot;X-Timestamp: 1760000000&quot;
</code></pre>
<p>响应示例：</p>
<pre><code class="lang-Curl">{
    &quot;output&quot;: {
        &quot;task_status&quot;: &quot;SUCCEEDED&quot;,
        &quot;orig_prompt&quot;: &quot;一座由硬纸板和瓶盖搭建的微型城市，在夜晚焕发出生机。一列硬纸板火车缓缓驶过，小灯点缀其间，照亮前路。&quot;,
        &quot;video_url&quot;: &quot;https://dashscope-a717.oss-accelerate.aliyuncs.com/.../video.mp4?Expires=...&amp;Signature=...&quot;,
        &quot;submit_time&quot;: &quot;2026-05-11 14:52:23.185&quot;,
        &quot;end_time&quot;: &quot;2026-05-11 14:53:37.239&quot;,
        &quot;task_id&quot;: &quot;602ac3b0-f096-4822-aa13-ba603b5520d9&quot;,
        &quot;scheduled_time&quot;: &quot;2026-05-11 14:52:23.221&quot;
    },
    &quot;usage&quot;: {
        &quot;duration&quot;: 5,
        &quot;output_video_duration&quot;: 5,
        &quot;video_count&quot;: 1,
        &quot;SR&quot;: 720,
        &quot;ratio&quot;: &quot;16:9&quot;
    },
    &quot;request_id&quot;: &quot;654b74e3-0f47-99e4-a704-3f032d5a46d1&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"><code>InvalidApiKey</code></td>
<td style="text-align:left">API Key无效或未提供。</td>
</tr>
<tr>
<td style="text-align:left"><code>InvalidParameter</code></td>
<td style="text-align:left">请求参数不合法。请检查参数值是否符合文档要求。</td>
</tr>
<tr>
<td style="text-align:left"><code>InternalError</code></td>
<td style="text-align:left">服务内部错误。请稍后重试，若问题持续存在请联系技术支持。</td>
</tr>
</tbody>
</table>
]]></content:encoded>
      <pubDate>Wed, 13 May 2026 11:08:11 +0800</pubDate>
      <guid>http://doc.talkingdata.com/posts/1236</guid>
      <comments>http://doc.talkingdata.com/posts/1236#comments</comments>
    </item>
    <item>
      <title>TD云绘17</title>
      <link>http://doc.talkingdata.com/posts/1235</link>
      <category>图片生成 API</category>
      <author>liuxinmei</author>
      <description>云绘17 接口说明文档 TD模型编号：T0302007 模型能力简介 云绘17 - GPT Image-2 文生图：仅通过文本描述（Prompt）即可生成高质量图片，适用于创意概念可视化。 图生图：基于用户提供的参考图片和文本提示，生成符合图片内容与描述的衍生图片，支持对已有素材进行二次创作。 多版本支持：通过 ModelVersion 参数，可选择不同质量与速度的生成版本。 image2_low：低质量版本，生成速度快，适用于快速预览和草稿。 image2_medium：中等质量版本，平衡速度与效果。 image2_high：高质量版本，生成效果最佳，耗时相对较长。 鉴权说明  本接口仅支持API Key鉴权，需联系TD运维同学获取长效API Key。
 创建 AIGC 生图任务接口地址 </description>
      <content:encoded><![CDATA[<h4 id="%3Cstrong%3E%E4%BA%91%E7%BB%9817%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%9817%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3%3C%2Fstrong%3E"><strong>云绘17 接口说明文档</strong></h4>
<p><strong>TD模型编号：T0302007</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>云绘17 - GPT Image-2</strong><ul>
<li><strong>文生图</strong>：仅通过文本描述（Prompt）即可生成高质量图片，适用于创意概念可视化。</li>
<li><strong>图生图</strong>：基于用户提供的参考图片和文本提示，生成符合图片内容与描述的衍生图片，支持对已有素材进行二次创作。</li>
<li><strong>多版本支持</strong>：通过 <code>ModelVersion</code> 参数，可选择不同质量与速度的生成版本。<ul>
<li><code>image2_low</code>：低质量版本，生成速度快，适用于快速预览和草稿。</li>
<li><code>image2_medium</code>：中等质量版本，平衡速度与效果。</li>
<li><code>image2_high</code>：高质量版本，生成效果最佳，耗时相对较长。</li>
</ul>
</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%E5%9B%BE%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%E5%9B%BE%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>T0302007</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%E5%9B%BE%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%E5%9B%BE%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%E5%9B%BE%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%E5%9B%BE%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">生成图片的提示词。建议使用英文提示词以获得更佳效果。</td>
</tr>
<tr>
<td style="text-align:left"><strong>FileInfos.N</strong></td>
<td style="text-align:left">Array of AigcImageTaskInputFileInfo</td>
<td style="text-align:left">图生图必填</td>
<td style="text-align:left">描述生成图片要使用的参考文件信息，最多支持 3 张参考图。</td>
</tr>
<tr>
<td style="text-align:left"><strong>ModelVersion</strong></td>
<td style="text-align:left">String</td>
<td style="text-align:left">是</td>
<td style="text-align:left">指定模型版本。 <strong>可选值</strong>： - <code>image2_low</code>：低质量版本，速度最快 - <code>image2_medium</code>：中等质量版本（默认） - <code>image2_high</code>：高质量版本，效果最佳</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">是否自动优化提示词。 <strong>可选值</strong>： - <code>Enabled</code>：启用 - <code>Disabled</code>：禁用 <strong>默认值</strong>：<code>Disabled</code></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">OutputConfig</td>
<td style="text-align:left">AigcImageOutputConfig</td>
<td style="text-align:left">否</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">否</td>
<td style="text-align:left">输入文件所在区域。 <strong>可选值</strong>： - <code>Mainland</code>：中国大陆（默认） - <code>Oversea</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">保留字段，可传入模型特殊参数或业务自定义信息。</td>
</tr>
</tbody>
</table>
<p><strong>AigcImageTaskInputFileInfo</strong></p>
<p>描述输入文件信息的对象。图生图时必传，最多支持 3 张参考图。</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">Type</td>
<td style="text-align:left">String</td>
<td style="text-align:left">是</td>
<td style="text-align:left">文件类型。<strong>固定值</strong>：<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>
</tbody>
</table>
<p><strong>AigcImageOutputConfig</strong></p>
<p>描述输出配置的对象。</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">StorageMode</td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">输出文件的存储模式。 <strong>可选值</strong>： - <code>Temporary</code>：临时存储（默认），文件在一段时间后自动失效。 - <code>Permanent</code>：永久存储。</td>
</tr>
<tr>
<td style="text-align:left">Resolution</td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">生成图片的分辨率规格。 <strong>可选值</strong>： - <code>1K</code> - <code>2K</code>（默认） - <code>4K</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">生成图片的宽高比。 <strong>可选值</strong>： - <code>1:1</code>（默认） - <code>3:2</code>、<code>2:3</code> - <code>3:4</code>、<code>4:3</code> - <code>16:9</code>、<code>9:16</code> - <code>21:9</code>、<code>9:21</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">人物生成策略，用于控制生成图片中的人物范围。 <strong>可选值</strong>： - <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">是否对输入内容进行合规检测。 <strong>可选值</strong>： - <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">是否对生成结果进行合规检测。 <strong>可选值</strong>： - <code>Enabled</code>：启用 - <code>Disabled</code>：禁用（默认）</td>
</tr>
</tbody>
</table>
<h2 id="%E5%88%9B%E5%BB%BA%20AIGC%20%E7%94%9F%E5%9B%BE%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%E5%9B%BE%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%E5%9B%BE%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%E5%9B%BE%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: T0302007&#39; \
  -d &#39;{
    &quot;FileInfos&quot;: [
        {
            &quot;Type&quot;: &quot;Url&quot;,
            &quot;Url&quot;: &quot;https://td-llm.tos-cn-beijing.volces.com/public/1774320434562_2b131e.png&quot;,
            &quot;Text&quot;: &quot;参考图：客厅里的橘猫&quot;
        }
    ],
    &quot;Prompt&quot;: &quot;generate a car&quot;,
    &quot;NegativePrompt&quot;: &quot;red&quot;,
    &quot;EnhancePrompt&quot;: &quot;Enabled&quot;,
    &quot;OutputConfig&quot;: {
        &quot;StorageMode&quot;: &quot;Temporary&quot;,
        &quot;AspectRatio&quot;: &quot;16:9&quot;,
        &quot;PersonGeneration&quot;: &quot;AllowAdult&quot;,
        &quot;InputComplianceCheck&quot;: &quot;Enabled&quot;,
        &quot;OutputComplianceCheck&quot;: &quot;Enabled&quot;
    },
    &quot;TasksPriority&quot;: 10,
    &quot;ExtInfo&quot;: &quot;myextinfo&quot;,
    &quot;ModelVersion&quot;: &quot;image2_medium&quot;
}&#39;
</code></pre>
<p>响应示例：</p>
<pre><code>{
    &quot;Response&quot;: {
        &quot;TaskId&quot;: &quot;1395528311-AigcImageTask-fc15ffcabf12aeda727dd756f1ec9732t&quot;,
        &quot;RequestId&quot;: &quot;91c4a0f1-5a99-44f5-88c0-2d033e92d43a&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>AigcImageTask</code>。</td>
</tr>
<tr>
<td style="text-align:left">Status</td>
<td style="text-align:left">String</td>
<td style="text-align:left">任务状态。 <strong>取值</strong>：<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">AigcImageTask</td>
<td style="text-align:left">Object</td>
<td style="text-align:left">AIGC 生图任务详细信息，具体结构见 AigcImageTask。</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>
<p><strong>AigcImageTask（AIGC 生图任务详细信息）</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">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">任务状态。 <strong>取值</strong>：<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">错误码，<code>0</code> 表示成功，非 <code>0</code> 表示失败。</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">任务进度百分比，取值范围 <code>0</code>-<code>100</code>。</td>
</tr>
<tr>
<td style="text-align:left">Input</td>
<td style="text-align:left">Object</td>
<td style="text-align:left">任务输入参数，具体结构见 AigcImageTaskInput。</td>
</tr>
<tr>
<td style="text-align:left">Output</td>
<td style="text-align:left">Object</td>
<td style="text-align:left">任务输出结果，具体结构见 AigcImageTaskOutput。</td>
</tr>
<tr>
<td style="text-align:left">SessionContext</td>
<td style="text-align:left">String</td>
<td style="text-align:left">透传的用户上下文信息，与创建任务时传入的 <code>SessionContext</code> 一致。</td>
</tr>
<tr>
<td style="text-align:left">SessionId</td>
<td style="text-align:left">String</td>
<td style="text-align:left">去重识别码，与创建任务时传入的 <code>SessionId</code> 一致。</td>
</tr>
</tbody>
</table>
<p><strong>AigcImageTaskInput（任务输入参数）</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">ModelName</td>
<td style="text-align:left">String</td>
<td style="text-align:left">模型名称，此处为 <code>OG</code>。</td>
</tr>
<tr>
<td style="text-align:left">ModelVersion</td>
<td style="text-align:left">String</td>
<td style="text-align:left">模型版本。 <strong>取值</strong>：<code>image2_low</code>、<code>image2_medium</code>、<code>image2_high</code></td>
</tr>
<tr>
<td style="text-align:left">FileInfos</td>
<td style="text-align:left">Array</td>
<td style="text-align:left">输入文件信息（参考图），具体元素结构见 InputFileInfo。</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">EnhancePrompt</td>
<td style="text-align:left">String</td>
<td style="text-align:left">是否启用提示词优化。 <strong>取值</strong>：<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">SceneType</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">输出配置，具体结构见 InputOutputConfig。</td>
</tr>
</tbody>
</table>
<p><strong>InputFileInfo（输入文件信息）</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">Type</td>
<td style="text-align:left">String</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">文件的公网可访问 URL。</td>
</tr>
</tbody>
</table>
<p><strong>InputOutputConfig（输入时的输出配置）</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">文件存储模式。 <strong>取值</strong>：<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">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">生成图片宽高比。</td>
</tr>
<tr>
<td style="text-align:left">PersonGeneration</td>
<td style="text-align:left">String</td>
<td style="text-align:left">人物生成策略。 <strong>取值</strong>：<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">输入合规检测开关。 <strong>取值</strong>：<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">输出合规检测开关。 <strong>取值</strong>：<code>Enabled</code>（开启）、<code>Disabled</code>（关闭）</td>
</tr>
</tbody>
</table>
<p><strong>AigcImageTaskOutput（任务输出结果）</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">FileInfos</td>
<td style="text-align:left">Array</td>
<td style="text-align:left">输出文件信息列表，具体元素结构见 OutputFileInfo。</td>
</tr>
</tbody>
</table>
<p><strong>OutputFileInfo（输出文件信息）</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">文件类型，例如 <code>png</code>。</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">图片元数据信息，具体结构见 ImageMetaData。</td>
</tr>
</tbody>
</table>
<p><strong>ImageMetaData（图片元数据信息）</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">Container</td>
<td style="text-align:left">String</td>
<td style="text-align:left">容器格式，例如 <code>png_pipe</code>。</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">Size</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>
</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-AigcImageTask-fc15ffcabf12aeda727dd756f1ec9732t&quot;
}&#39;
</code></pre>
<p>响应示例：</p>
<pre><code class="lang-Curl">{
  &quot;Response&quot;: {
    &quot;TaskType&quot;: &quot;AigcImageTask&quot;,
    &quot;Status&quot;: &quot;FINISH&quot;,
    &quot;CreateTime&quot;: &quot;2026-05-11T03:19:57Z&quot;,
    &quot;BeginProcessTime&quot;: &quot;2026-05-11T03:19:57Z&quot;,
    &quot;FinishTime&quot;: &quot;2026-05-11T03:21:32Z&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;: {
      &quot;TaskId&quot;: &quot;1395528311-AigcImageTask-fc15ffcabf12aeda727dd756f1ec9732t&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;ModelName&quot;: &quot;OG&quot;,
        &quot;ModelVersion&quot;: &quot;image2_medium&quot;,
        &quot;FileInfos&quot;: [
          {
            &quot;Type&quot;: &quot;Url&quot;,
            &quot;FileId&quot;: &quot;&quot;,
            &quot;Url&quot;: &quot;https://td-llm.tos-cn-beijing.volces.com/public/1774320434562_2b131e.png&quot;
          }
        ],
        &quot;Prompt&quot;: &quot;generate a car&quot;,
        &quot;NegativePrompt&quot;: &quot;red&quot;,
        &quot;EnhancePrompt&quot;: &quot;Enabled&quot;,
        &quot;GenerationMode&quot;: &quot;&quot;,
        &quot;SceneType&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;Resolution&quot;: &quot;&quot;,
          &quot;AspectRatio&quot;: &quot;16:9&quot;,
          &quot;PersonGeneration&quot;: &quot;AllowAdult&quot;,
          &quot;InputComplianceCheck&quot;: &quot;Enabled&quot;,
          &quot;OutputComplianceCheck&quot;: &quot;Enabled&quot;
        }
      },
      &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-18T03:21:34Z&quot;,
            &quot;FileType&quot;: &quot;&quot;,
            &quot;FileId&quot;: &quot;&quot;,
            &quot;FileUrl&quot;: &quot;http://251000800.vod2.myqcloud.com/1a168d62vodcq251000800/feb85fb25145403726325113414/aigcImageGenFile.png&quot;,
            &quot;MetaData&quot;: {
              &quot;AudioDuration&quot;: 0,
              &quot;AudioStreamSet&quot;: [],
              &quot;Bitrate&quot;: 0,
              &quot;Container&quot;: &quot;png_pipe&quot;,
              &quot;Duration&quot;: 0,
              &quot;Height&quot;: 1024,
              &quot;Md5&quot;: &quot;&quot;,
              &quot;Rotate&quot;: 0,
              &quot;Size&quot;: 3095806,
              &quot;VideoDuration&quot;: 0,
              &quot;VideoStreamSet&quot;: [
                {
                  &quot;Bitrate&quot;: 0,
                  &quot;Codec&quot;: &quot;png&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;: 25,
                  &quot;Height&quot;: 1024,
                  &quot;Width&quot;: 1808
                }
              ],
              &quot;Width&quot;: 1808
            }
          }
        ]
      },
      &quot;SessionContext&quot;: &quot;&quot;,
      &quot;SessionId&quot;: &quot;&quot;
    },
    &quot;SceneAigcImageTask&quot;: null,
    &quot;AigcVideoTask&quot;: null,
    &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;AigcAudioTask&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;c1b43c63-f68a-48c0-9e0e-6ff358ebe177&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>Tue, 12 May 2026 15:01:03 +0800</pubDate>
      <guid>http://doc.talkingdata.com/posts/1235</guid>
      <comments>http://doc.talkingdata.com/posts/1235#comments</comments>
    </item>
    <item>
      <title>TD云灵11/OpenAI-GPT5.4</title>
      <link>http://doc.talkingdata.com/posts/1234</link>
      <category>多模态生成API</category>
      <author>liuxinmei</author>
      <description>云灵11 接口说明文档 TD模型编号：T0320001 模型能力简介 云灵11 本模型为高性能大语言模型，提供生文能力。您可以根据对话上下文和指令，进行智能文本生成，适用于内容创作、代码生成、逻辑推理、多轮对话等多种场景。 鉴权说明  本接口仅支持API Key鉴权，需联系TD运维同学获取长效API Key。
 AIGC文生文接口地址 请求方法： 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%E7%81%B511%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%81%B511%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3%3C%2Fstrong%3E"><strong>云灵11 接口说明文档</strong></h4>
<p><strong>TD模型编号：T0320001</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>云灵11</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="AIGC%E6%96%87%E7%94%9F%E6%96%87%E6%8E%A5%E5%8F%A3%E5%9C%B0%E5%9D%80" name="AIGC%E6%96%87%E7%94%9F%E6%96%87%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/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="AIGC%E6%96%87%E7%94%9F%E6%96%87%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0" name="AIGC%E6%96%87%E7%94%9F%E6%96%87%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0">AIGC文生文请求参数</h2>
<p><span id="Hrya4y9k"></span></p>
<h3 id="AIGC%E6%96%87%E7%94%9F%E6%96%87%E8%AF%B7%E6%B1%82%E4%BD%93%EF%BC%88requestBody%EF%BC%89" name="AIGC%E6%96%87%E7%94%9F%E6%96%87%E8%AF%B7%E6%B1%82%E4%BD%93%EF%BC%88requestBody%EF%BC%89">AIGC文生文请求体（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>model</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">是</td>
<td style="text-align:left">指定使用的AI模型。<strong>固定为 <code>T0310001</code></strong>。</td>
</tr>
<tr>
<td style="text-align:left"><code>messages</code></td>
<td style="text-align:left">List<Object></td>
<td style="text-align:left">是</td>
<td style="text-align:left">对话消息列表，用于提供上下文和当前问题。详见下表。</td>
</tr>
<tr>
<td style="text-align:left"><code>stream</code></td>
<td style="text-align:left">Boolean</td>
<td style="text-align:left">否</td>
<td style="text-align:left">是否使用流式传输。默认 <code>false</code>。</td>
</tr>
<tr>
<td style="text-align:left"><code>max_tokens</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">否</td>
<td style="text-align:left">限制单次请求生成的最大Token数。需结合模型上下文限制设置，超出会触发截断或报错。</td>
</tr>
<tr>
<td style="text-align:left"><code>temperature</code></td>
<td style="text-align:left">Float</td>
<td style="text-align:left">否</td>
<td style="text-align:left">控制输出的随机性和创造性。取值范围 0~2，默认值通常为 0.7。<br /> • 越接近 0：输出越精准、确定，适合事实性问答。 <br />• 越接近 2：输出越发散、有创意，适合头脑风暴。</td>
</tr>
<tr>
<td style="text-align:left"><code>thinking_enabled</code></td>
<td style="text-align:left">Boolean</td>
<td style="text-align:left">否</td>
<td style="text-align:left">是否开启推理（思考）模式。<br /> • <code>true</code>: 模型在回答前会进行深度链式思考（CoT），适合复杂逻辑分析、数学计算或代码生成。开启后响应延迟增加，且 <code>usage</code> 中会产生 <code>reasoning_tokens</code> 消耗。<br /> • <code>false</code>: 标准对话模式，响应速度更快。</td>
</tr>
<tr>
<td style="text-align:left"><code>reasoning_effort</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">思考等级。在 <code>thinking_enabled</code> 为 <code>true</code> 时生效。取值范围: <code>none</code>/<code>minimal</code>/<code>low</code>/<code>medium</code>/<code>high</code>/<code>xhigh</code>。</td>
</tr>
<tr>
<td style="text-align:left"><code>tools</code></td>
<td style="text-align:left">Array</td>
<td style="text-align:left">否</td>
<td style="text-align:left">可供模型调用的工具列表，详细定义参考OpenAI官方文档。</td>
</tr>
<tr>
<td style="text-align:left"><code>tool_choice</code></td>
<td style="text-align:left">String/Object</td>
<td style="text-align:left">否</td>
<td style="text-align:left">控制模型如何选择工具，如 <code>&quot;auto&quot;</code>, <code>&quot;none&quot;</code>, <code>&quot;required&quot;</code> 或指定具体工具。</td>
</tr>
<tr>
<td style="text-align:left"><code>response_format</code></td>
<td style="text-align:left">Object</td>
<td style="text-align:left">否</td>
<td style="text-align:left">指定输出格式，如 <code>{&quot;type&quot;: &quot;json_object&quot;}</code> 或 <code>{&quot;type&quot;: &quot;json_schema&quot;, ...}</code>。</td>
</tr>
<tr>
<td style="text-align:left"><code>input_compliance_check</code></td>
<td style="text-align:left">Boolean</td>
<td style="text-align:left">否</td>
<td style="text-align:left">是否开启输入文本审核。若审核不通过，接口直接返回400错误。</td>
</tr>
<tr>
<td style="text-align:left"><code>output_compliance_check</code></td>
<td style="text-align:left">Boolean</td>
<td style="text-align:left">否</td>
<td style="text-align:left">是否开启输出文本审核。若审核不通过，非流式请求返回400错误；流式请求中断输出，<code>finish_reason</code> 为 <code>content_filter</code>。</td>
</tr>
</tbody>
</table>
<p><strong><code>messages</code> 数组中对象的结构：</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"><code>role</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">消息发送者的角色。<br /> • <code>system</code>: 系统指令，用于设定AI的行为和背景。<br /> • <code>user</code>: 用户提问。 <br />• <code>assistant</code>: AI助手的历史回答。<br /> • <code>tool</code>: 工具调用的结果。</td>
</tr>
<tr>
<td style="text-align:left"><code>content</code></td>
<td style="text-align:left">String / Array</td>
<td style="text-align:left">消息的具体内容。通常为纯文本字符串；多模态场景下可为数组，包含文本和图片等信息。</td>
</tr>
<tr>
<td style="text-align:left"><code>tool_calls</code></td>
<td style="text-align:left">Array</td>
<td style="text-align:left">当 <code>role</code> 为 <code>assistant</code> 时，模型生成的工具调用请求。</td>
</tr>
<tr>
<td style="text-align:left"><code>tool_call_id</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">当 <code>role</code> 为 <code>tool</code> 时，需提供此ID以对应到 <code>assistant</code> 发出的工具调用请求。</td>
</tr>
</tbody>
</table>
<h2 id="AIGC%E6%96%87%E7%94%9F%E6%96%87%E8%BF%94%E5%9B%9E%E5%8F%82%E6%95%B0" name="AIGC%E6%96%87%E7%94%9F%E6%96%87%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>id</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">本次请求的唯一标识符。</td>
</tr>
<tr>
<td style="text-align:left"><code>object</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">对象类型，固定为 <code>chat.completion</code>。</td>
</tr>
<tr>
<td style="text-align:left"><code>created</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">响应创建的时间戳（Unix秒）。</td>
</tr>
<tr>
<td style="text-align:left"><code>model</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">实际用于生成响应的模型版本，如 <code>&quot;gpt-5.4-2026-03-05&quot;</code>。</td>
</tr>
<tr>
<td style="text-align:left"><code>choices</code></td>
<td style="text-align:left">List</td>
<td style="text-align:left">生成结果列表。</td>
</tr>
<tr>
<td style="text-align:left">└ <code>index</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">结果在列表中的索引。</td>
</tr>
<tr>
<td style="text-align:left">└ <code>message</code></td>
<td style="text-align:left">Object</td>
<td style="text-align:left">AI生成的回复消息对象。</td>
</tr>
<tr>
<td style="text-align:left">└ <code>role</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">消息角色，固定为 <code>assistant</code>。</td>
</tr>
<tr>
<td style="text-align:left">└ <code>content</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">核心返回数据，即AI生成的文本回答。</td>
</tr>
<tr>
<td style="text-align:left">└ <code>reasoning_content</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">当开启思考模式时，模型内部推理过程的内容。</td>
</tr>
<tr>
<td style="text-align:left">└ <code>tool_calls</code></td>
<td style="text-align:left">Array</td>
<td style="text-align:left">模型生成的工具调用请求列表，具体结构参考OpenAI协议。</td>
</tr>
<tr>
<td style="text-align:left">└ <code>finish_reason</code></td>
<td style="text-align:left">String</td>
<td style="text-align:left">停止生成的原因。 • <code>stop</code>: 正常结束。 • <code>length</code>: 达到最大Token限制。 • <code>tool_calls</code>: 模型请求调用工具。 • <code>content_filter</code>: 输出被内容审核拦截。 • <code>null</code>: 流式传输未结束。</td>
</tr>
<tr>
<td style="text-align:left"><code>usage</code></td>
<td style="text-align:left">Object</td>
<td style="text-align:left">Token 使用量统计。</td>
</tr>
<tr>
<td style="text-align:left">└ <code>prompt_tokens</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">提问（输入）消耗的 Token 数。</td>
</tr>
<tr>
<td style="text-align:left">└ <code>completion_tokens</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">回答（输出）消耗的 Token 数。</td>
</tr>
<tr>
<td style="text-align:left">└ <code>total_tokens</code></td>
<td style="text-align:left">Integer</td>
<td style="text-align:left">总消耗 Token 数。</td>
</tr>
<tr>
<td style="text-align:left">└ <code>prompt_tokens_details</code></td>
<td style="text-align:left">Object</td>
<td style="text-align:left">输入Token的详细分类，如 <code>cached_tokens</code> 等。</td>
</tr>
<tr>
<td style="text-align:left">└ <code>completion_tokens_details</code></td>
<td style="text-align:left">Object</td>
<td style="text-align:left">输出Token的详细分类，如 <code>reasoning_tokens</code> 等。</td>
</tr>
</tbody>
</table>
<hr>
<p><span id="7P96iLnc"></span></p>
<h2 id="AIGC%E6%96%87%E7%94%9F%E6%96%87%E8%B0%83%E7%94%A8%E7%A4%BA%E4%BE%8B" name="AIGC%E6%96%87%E7%94%9F%E6%96%87%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/openai/api/v3/chat/completions?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; \
  -d &#39;{
    &quot;model&quot;: &quot;T0310001&quot;,
    &quot;messages&quot;: [
        {
            &quot;role&quot;: &quot;user&quot;,
            &quot;content&quot;: &quot;你好&quot;
        }
    ],
    &quot;temperature&quot;: 0.7,
    &quot;max_tokens&quot;: 1000
}&#39;
</code></pre>
<p>响应示例：</p>
<pre><code>{
    &quot;id&quot;: &quot;be0e0dce-151c-4f35-ad02-e65ebda74e83&quot;,
    &quot;object&quot;: &quot;chat.completion&quot;,
    &quot;created&quot;: 1776740913,
    &quot;model&quot;: &quot;gpt-5.4-2026-03-05&quot;,
    &quot;choices&quot;: [
        {
            &quot;index&quot;: 0,
            &quot;message&quot;: {
                &quot;role&quot;: &quot;assistant&quot;,
                &quot;content&quot;: &quot;你好！有什么我可以帮你的吗？&quot;
            },
            &quot;finish_reason&quot;: &quot;stop&quot;
        }
    ],
    &quot;usage&quot;: {
        &quot;prompt_tokens&quot;: 7,
        &quot;completion_tokens&quot;: 13,
        &quot;total_tokens&quot;: 20,
        &quot;prompt_tokens_details&quot;: {
            &quot;cached_tokens&quot;: 0,
            &quot;audio_tokens&quot;: 0
        },
        &quot;completion_tokens_details&quot;: {
            &quot;reasoning_tokens&quot;: 0,
            &quot;audio_tokens&quot;: 0,
            &quot;accepted_prediction_tokens&quot;: 0,
            &quot;rejected_prediction_tokens&quot;: 0
        }
    }
}
</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">HTTP状态码</th>
<th style="text-align:left">错误描述</th>
<th style="text-align:left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left">200</td>
<td style="text-align:left">请求成功。</td>
<td style="text-align:left">-</td>
</tr>
<tr>
<td style="text-align:left">400</td>
<td style="text-align:left">请求参数错误。</td>
<td style="text-align:left">请求体格式或参数值不合法，例如模型名错误、参数类型不匹配等。</td>
</tr>
<tr>
<td style="text-align:left">401</td>
<td style="text-align:left">认证失败。</td>
<td style="text-align:left"><code>Authorization</code> 头部缺失或API Key无效。</td>
</tr>
<tr>
<td style="text-align:left">403</td>
<td style="text-align:left">权限不足/服务停服。</td>
<td style="text-align:left">API Key无权限，或可能因账户欠费等原因导致服务被暂停。</td>
</tr>
<tr>
<td style="text-align:left">404</td>
<td style="text-align:left">模型/端点不存在。</td>
<td style="text-align:left">请求路径错误，或 <code>model</code> 参数值 <code>&quot;T0310001&quot;</code> 填写有误。</td>
</tr>
<tr>
<td style="text-align:left">429</td>
<td style="text-align:left">请求速率限制。</td>
<td style="text-align:left">超出默认并发限制（如 RPM/TPM），请稍后重试。</td>
</tr>
<tr>
<td style="text-align:left">500/502/503</td>
<td style="text-align:left">服务器错误/上游错误。</td>
<td style="text-align:left">服务内部异常，请联系运维同学排查。</td>
</tr>
</tbody>
</table>
]]></content:encoded>
      <pubDate>Sun, 26 Apr 2026 16:17:46 +0800</pubDate>
      <guid>http://doc.talkingdata.com/posts/1234</guid>
      <comments>http://doc.talkingdata.com/posts/1234#comments</comments>
    </item>
    <item>
      <title>TD云筑38</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>
<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>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%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>VoiceProfile</code></td>
<td style="text-align:left">object</td>
<td style="text-align:left">否</td>
<td style="text-align:left">音色属性。用于自定义音色特征，详细结构见下方 VoiceProfile 对象。</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">输出相关参数，可以指定输出形式等，详细结构见下方 SyncDubbingOutputOption 对象。</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>
<h4 id="VoiceProfile%20%E5%AF%B9%E8%B1%A1" name="VoiceProfile%20%E5%AF%B9%E8%B1%A1">VoiceProfile 对象</h4>
<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">Name</td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">音色名 示例值：clone-test</td>
</tr>
<tr>
<td style="text-align:left">Description</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">Gender</td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">性别枚举值：male： 男性female： 女性unknown： 未知 示例值：female</td>
</tr>
<tr>
<td style="text-align:left">Age</td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">年龄枚举值：child： 儿童teenager： 少年youth： 青年middle_aged： 中年senior： 老年unknown： 未知 示例值：middle_aged</td>
</tr>
<tr>
<td style="text-align:left">Labels</td>
<td style="text-align:left">Array of String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">标签 示例值：[&quot;磁性&quot;]</td>
</tr>
<tr>
<td style="text-align:left">Scenes</td>
<td style="text-align:left">Array of String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">使用场景 示例值：[&quot;解说&quot;]</td>
</tr>
</tbody>
</table>
<h4 id="SyncDubbingOutputOption%20%E5%AF%B9%E8%B1%A1" name="SyncDubbingOutputOption%20%E5%AF%B9%E8%B1%A1">SyncDubbingOutputOption 对象</h4>
<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">Type</td>
<td style="text-align:left">String</td>
<td style="text-align:left">否</td>
<td style="text-align:left">合成结果输出类型枚举值：data： 音频base64编码url： 音频url，有效期24小时 示例值：url</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>
  </channel>
</rss>