简创AIGC官方文档

主题切换

返回顶部
当前页导航

CREATE_DRAFT API 接口文档

接口信息 

POST /v1/create_draft

功能描述

创建剪映草稿。该接口用于创建一个新的剪映草稿项目，可以自定义视频的宽度和高度。创建成功后会返回草稿URL和帮助文档URL，为后续的视频编辑操作提供基础。

请求参数

json
{
  "width": 1920,
  "height": 1080
}

参数说明

参数名类型必填默认值说明
widthnumber❌1920视频宽度(像素)，必须大于等于1
heightnumber❌1080视频高度(像素)，必须大于等于1

参数详解

尺寸参数

  • width: 草稿视频的宽度

    • 最小值：1像素
    • 建议常用值：1920、1280、720
    • 支持自定义尺寸

  • height: 草稿视频的高度

    • 最小值：1像素
    • 建议常用值：1080、720、480
    • 支持自定义尺寸

常用分辨率

分辨率名称宽度高度适用场景
1080P19201080高清视频制作
720P1280720标清视频制作
4K38402160超高清视频制作
竖屏短视频10801920手机短视频
正方形10801080社交媒体内容

响应格式

成功响应 (200)

json
{
  "draft_url": "https://ts.fyshark.com/#/cozeToJianyin?drafId=https://video-snot-12220.oss-cn-shanghai.aliyuncs.com/2025-05-28/draft/2f52a63b-8c6a-4417-8b01-1b2a569ccb6c.json",
  "tip_url": "https://help.example.com/draft-usage"
}

响应字段说明

字段名类型说明
draft_urlstring新创建的草稿URL，用于后续的编辑操作
tip_urlstring草稿使用帮助文档URL

错误响应 (4xx/5xx)

json
{
  "detail": "错误信息描述"
}

使用示例

cURL 示例

1. 创建默认分辨率草稿

bash
curl -X POST https://api.example.com/v1/create_draft \
  -H "Content-Type: application/json" \
  -d '{}'

2. 创建自定义分辨率草稿

bash
curl -X POST https://api.example.com/v1/create_draft \
  -H "Content-Type: application/json" \
  -d '{
    "width": 1280,
    "height": 720
  }'

3. 创建竖屏短视频草稿

bash
curl -X POST https://api.example.com/v1/create_draft \
  -H "Content-Type: application/json" \
  -d '{
    "width": 1080,
    "height": 1920
  }'

JavaScript 示例

javascript
const createDraft = async (width = 1920, height = 1080) => {
  const response = await fetch('/v1/create_draft', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ width, height })
  });
  return response.json();
};

// 创建默认分辨率草稿
const defaultDraft = await createDraft();

// 创建720P草稿
const hdDraft = await createDraft(1280, 720);

// 创建正方形草稿
const squareDraft = await createDraft(1080, 1080);

console.log('草稿创建成功:', {
  default: defaultDraft.draft_url,
  hd: hdDraft.draft_url,
  square: squareDraft.draft_url
});

高级JavaScript示例

javascript
class DraftManager {
  constructor(baseUrl = 'https://api.example.com') {
    this.baseUrl = baseUrl;
  }

  async createDraft(config = {}) {
    const { width = 1920, height = 1080 } = config;
    
    const response = await fetch(`${this.baseUrl}/v1/create_draft`, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ width, height })
    });
    
    if (!response.ok) {
      throw new Error(`创建草稿失败: ${response.statusText}`);
    }
    
    return response.json();
  }

  // 预设分辨率创建方法
  async create1080p() {
    return this.createDraft({ width: 1920, height: 1080 });
  }

  async create720p() {
    return this.createDraft({ width: 1280, height: 720 });
  }

  async create4K() {
    return this.createDraft({ width: 3840, height: 2160 });
  }

  async createVertical() {
    return this.createDraft({ width: 1080, height: 1920 });
  }

  async createSquare() {
    return this.createDraft({ width: 1080, height: 1080 });
  }

  // 批量创建多种规格草稿
  async createMultipleFormats() {
    const formats = [
      { name: '1080P', width: 1920, height: 1080 },
      { name: '720P', width: 1280, height: 720 },
      { name: '竖屏', width: 1080, height: 1920 },
      { name: '正方形', width: 1080, height: 1080 }
    ];

    const results = {};
    
    for (const format of formats) {
      try {
        const draft = await this.createDraft({
          width: format.width,
          height: format.height
        });
        results[format.name] = draft;
        
        // 添加延迟避免请求过快
        await new Promise(resolve => setTimeout(resolve, 100));
      } catch (error) {
        console.error(`创建${format.name}草稿失败:`, error);
        results[format.name] = { error: error.message };
      }
    }
    
    return results;
  }
}

// 使用示例
const draftManager = new DraftManager();

// 创建单个草稿
const draft = await draftManager.create1080p();
console.log('草稿URL:', draft.draft_url);

// 批量创建多种格式
const multipleDrafts = await draftManager.createMultipleFormats();
console.log('多种格式草稿:', multipleDrafts);

Python 示例

python
import requests
from typing import Optional, Dict

class DraftCreator:
    def __init__(self, base_url: str = "https://api.example.com"):
        self.base_url = base_url

    def create_draft(self, width: int = 1920, height: int = 1080) -> Dict:
        """创建草稿"""
        response = requests.post(
            f'{self.base_url}/v1/create_draft',
            headers={'Content-Type': 'application/json'},
            json={
                "width": width,
                "height": height
            }
        )
        response.raise_for_status()
        return response.json()

    # 预设分辨率方法
    def create_1080p(self) -> Dict:
        return self.create_draft(1920, 1080)

    def create_720p(self) -> Dict:
        return self.create_draft(1280, 720)

    def create_4k(self) -> Dict:
        return self.create_draft(3840, 2160)

    def create_vertical(self) -> Dict:
        return self.create_draft(1080, 1920)

    def create_square(self) -> Dict:
        return self.create_draft(1080, 1080)

# 使用示例
creator = DraftCreator()

# 创建不同分辨率的草稿
drafts = {
    "1080p": creator.create_1080p(),
    "720p": creator.create_720p(),
    "vertical": creator.create_vertical(),
    "square": creator.create_square()
}

for name, draft in drafts.items():
    print(f"{name} 草稿URL: {draft['draft_url']}")

错误码说明

错误码错误信息说明解决方案
400width必须大于等于1宽度参数无效提供大于等于1的宽度值
400height必须大于等于1高度参数无效提供大于等于1的高度值
400参数类型错误参数类型不正确确保width和height为数字类型
500草稿创建失败内部服务错误联系技术支持
503服务不可用系统维护中稍后重试

注意事项

  1. 参数验证: width和height必须为正整数
  2. 分辨率建议: 建议使用常见的视频分辨率以确保兼容性
  3. 性能考虑: 超高分辨率可能影响后续处理性能
  4. 存储占用: 高分辨率草稿会占用更多存储空间
  5. URL有效期: 返回的draft_url具有一定的有效期

工作流程

  1. 接收并验证请求参数
  2. 创建草稿基础结构
  3. 设置画布尺寸
  4. 生成草稿URL
  5. 返回草稿信息和帮助文档链接

下一步操作

创建草稿后，您可以使用以下接口继续编辑：

  • add_videos: 添加视频素材
  • add_audios: 添加音频素材
  • add_images: 添加图片素材
  • save_draft: 保存草稿
  • gen_video: 导出视频

相关接口

版权所有 © 2025 简创AIGC