1. 模型对接概述

1.1 基础信息

• 模型名称：doubao-seedance-1-0-pro-fast-251015
• 模型用途：基于文本描述生成视频内容，支持多镜头场景定义及视频参数（分辨率、帧率等）配置
• 对接基础URL：https://api.6ai.chat/volc/v1/contents/generations/tasks
• 请求方式：POST
• 响应格式：application/json
• 适用场景：测试与体验级文生视频功能开发，需遵守当地法律法规，禁止用于非法用途（平台不承担非法使用导致的法律责任）

2. 接口请求规范

接口请求需包含 Header参数 和 Body参数，其中标记为“必需”的参数不可缺失，否则将导致请求失败。

2.1 Header参数

注意：尽管Authorization标记为“可选”，但实际生产环境调用需携带有效API密钥，否则将被拒绝访问。

2.2 Body参数（application/json）

Body为JSON格式，包含模型指定、输入内容等核心配置，所有“必需”参数需严格按格式传入。

3. 请求示例代码

以下提供常用开发语言的请求示例，需将 {{YOUR_API_KEY}} 替换为实际获取的API密钥，确保URL与参数格式正确。

3.1 Shell（cURL）

curl --location --request POST 'https://api.6ai.chat/volc/v1/contents/generations/tasks' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "doubao-seedance-1-0-pro-fast-251015",
    "content": [
        {
            "type": "text",
            "text": "多个镜头。一名侦探进入一间光线昏暗的房间。他检查桌上的线索，手里拿起桌上的某个物品。镜头转向他正在思索。 --rs 720p --rt 16:9 --dur 5 --fps 24 --wm true --seed 11 --cf false"
        }
    ]
}'

3.2 Python（requests库）

import requests
import json

url = "https://api.6ai.chat/volc/v1/contents/generations/tasks"
headers = {
    "Accept": "application/json",
    "Authorization": "Bearer {{YOUR_API_KEY}}",
    "Content-Type": "application/json"
}
payload = {
    "model": "doubao-seedance-1-0-pro-fast-251015",
    "content": [
        {
            "type": "text",
            "text": "多个镜头。一名侦探进入一间光线昏暗的房间。他检查桌上的线索，手里拿起桌上的某个物品。镜头转向他正在思索。 --rt 16:9"
        }
    ]
}

response = requests.post(url, headers=headers, data=json.dumps(payload))
print(response.text)

3.3 JavaScript（Node.js）

const axios = require('axios');

const url = 'https://api.6ai.chat/volc/v1/contents/generations/tasks';
const headers = {
    'Accept': 'application/json',
    'Authorization': 'Bearer {{YOUR_API_KEY}}',
    'Content-Type': 'application/json'
};
const data = {
    "model": "doubao-seedance-1-0-pro-fast-251015",
    "content": [
        {
            "type": "text",
            "text": "多个镜头。一名侦探进入一间光线昏暗的房间。他检查桌上的线索，手里拿起桌上的某个物品。镜头转向他正在思索。 --rs 720p --dur 5"
        }
    ]
};

axios.post(url, data, { headers })
    .then(response => console.log(response.data))
    .catch(error => console.error('Error:', error));

4. 响应格式说明

接口返回JSON格式数据，包含任务ID和初始状态，后续需通过任务ID查询视频生成进度及结果（查询接口需参考额外文档）。

4.1 响应示例

{
    "id": "cgt-20250918165243-bfpzb",
    "status": "submitted"
}

4.2 响应字段说明

5. 关键注意事项

1. 提示词规范：

   • 提示词需清晰描述视频场景、人物动作、镜头切换等关键信息，建议不超过500字（字数过多可能导致模型忽略细节，仅保留核心内容）。
   • 可选配置项（如--rs、--dur）需紧跟提示词末尾，格式为“–参数名 参数值”，参数值不可包含空格。

2. API密钥安全：

   • Authorization 中的API密钥属于敏感信息，需避免硬编码在前端代码或公开仓库中，建议通过后端服务转发请求，防止密钥泄露。

3. 请求频率限制：

   • 该模型接口仅用于测试与体验，平台可能存在请求频率限制（具体限制需参考平台通知），高频调用可能导致请求被拦截。

4. 合规性要求：

   • 生成的视频内容需遵守当地法律法规及平台规则，禁止生成违法、低俗、侵权等内容；非法使用导致的法律责任由调用方自行承担。

5. 结果一致性控制：

   • 若需生成相似风格的视频，可固定 --seed 参数值（如--seed 11）；若需随机生成不同结果，可省略该参数或每次使用不同的种子值。