快速开始

影造AI 提供 RESTful API 与多语言 SDK，三行代码即可接入视频生成、图片生成、语音合成等核心能力。

1. 获取 API Key

前往 SDK 下载页 的「API Key 管理」区域创建你的第一个 Key。创建后请妥善保存，Key 仅在创建时完整展示一次。

2. 认证鉴权

所有 API 请求均需在 HTTP Header 中携带认证信息：

# 请求头格式
Authorization: Bearer sk-****3f2a
Content-Type: application/json

请确保 Key 具备对应接口权限，并妥善保管，避免泄露。

3. 视频生成 API

向以下地址发起 POST 请求创建视频生成任务：

# 请求示例
curl https://yingzao.love/v1/video/generate \
  -H "Authorization: Bearer sk-****3f2a" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "雨夜古城墙，女将军拔剑",
    "duration": 10,
    "resolution": "1080p"
  }'

请求参数说明：

参数类型必填说明
promptstring是画面描述文本，支持中英文
durationint否视频时长（秒），默认 5，范围 3-60
resolutionstring否分辨率，可选 720p / 1080p / 4K，默认 1080p
stylestring否风格预设，如 cinematic / anime / realistic
callback_urlstring否任务完成后的 Webhook 通知地址

响应示例：

# 成功响应 200
{
  "code": 0,
  "data": {
    "task_id": "vid_20260930142107",
    "status": "queued",
    "estimated_time": 120
  }
}

4. 响应格式

所有接口统一返回 JSON，包含 code、message、data 三个字段。code 为 0 表示成功，非 0 表示失败，message 为错误描述。

5. 错误码

错误码说明处理建议
0成功-
40001API Key 无效或已过期检查 Key 是否正确，或重新创建
40003权限不足确认 Key 已开通对应接口权限
40029请求频率超限降低调用频率或联系客服提升配额
50000服务器内部错误稍后重试，持续失败请联系技术支持
本页内容
快速开始 获取 Key 发起请求 响应格式 错误码