🎬 AIGC - AI视频/图片生成平台

← 返回首页

📋 API 概述

欢迎使用 AIGC 平台的 API 文档。本平台提供丰富的 AI 内容生成功能，包括视频生成、图片生成、图像编辑等。

基础信息

API 基础地址：https://www.openwan.art

认证方式：Bearer Token（API Key）

数据格式：JSON

请求方法：GET / POST / DELETE

请求头

所有 API 请求都需要在请求头中携带 API Key：

Authorization: Bearer ${YOUR_API_KEY}
Content-Type: application/json

获取 API Key

登录网站后，点击首页的用户名即可查看您的 API Key。API Key 格式为 sk-xxxxxxxxxxxxxxxx。

响应格式

所有 API 响应均为 JSON 格式：

{
  "code": 200,
  "message": "success",
  "data": { ... }
}

🔐 认证说明

用户注册

POST /api/auth/register

注册新用户账户，注册成功后会自动生成 API Key。

参数 类型 必填 说明
username string 必填 用户名（3-20个字符）
password string 必填 密码（6位以上）

用户登录

POST /api/auth/login

用户登录获取 JWT Token。

参数 类型 必填 说明
username string 必填 用户名
password string 必填 密码

获取用户信息

GET /api/user/info

获取当前登录用户的信息，包括积分、状态等。

获取 API Key

GET /api/user/api_key

获取当前用户的 API Key，用于 API 调用认证。

获取积分记录

GET /api/user/credit_logs

获取当前用户的积分使用记录。

📝 文生视频

通过文字描述生成视频，支持多种分辨率和时长设置。

POST /v1/videos/generations

请求参数

参数 类型 必填 说明
model string 必填 模型名称，如 happyhorse-1.1-t2v
prompt string 必填 文本提示词，描述要生成的视频内容，最长2000字符
resolution string 可选 分辨率：720P、1080P，默认 1080P
durationSeconds integer 可选 视频时长（秒），范围 3-15，默认 5
seed integer 可选 随机数种子，用于结果复现

请求示例

curl --request POST 'https://www.openwan.art/v1/videos/generations' \
  --header 'Authorization: Bearer ${API_KEY}' \
  --header 'Content-Type: application/json' \
  --header 'X-DashScope-Async: enable' \
  --data-raw '{
    "model": "happyhorse-1.1-t2v",
    "prompt": "一只金色的狮子在未来的霓虹城市中慢步",
    "resolution": "1080P",
    "durationSeconds": 5
  }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "xxx-xxx-xxx",
    "task_status": "PENDING"
  }
}

查询任务状态

GET /api/task/{task_id}

使用返回的 task_id 查询任务状态，任务完成后会返回视频 URL。

🖼️ 图生视频

将静态图片转换为动态视频，支持首帧图片驱动。

POST /v1/videos/generations

请求参数

参数 类型 必填 说明
model string 必填 模型名称，如 happyhorse-1.1-i2v
prompt string 可选 文本提示词，描述视频动态效果
images array 必填 首帧图片数组，包含 url 和 role
images[].url string 必填 图片公网可访问 URL
images[].role string 必填 固定为 first_frame
resolution string 可选 分辨率：720P、1080P
durationSeconds integer 可选 视频时长（秒），范围 3-15

图片要求

• 格式：JPEG、JPG、PNG、WEBP

• 分辨率：宽和高不小于 300 像素

• 宽高比：1:2.5 ~ 2.5:1

• 文件大小：不超过 20MB

• 链接需长期有效且无防盗链限制

请求示例

curl --request POST 'https://www.openwan.art/v1/videos/generations' \
  --header 'Authorization: Bearer ${API_KEY}' \
  --header 'Content-Type: application/json' \
  --header 'X-DashScope-Async: enable' \
  --data-raw '{
    "model": "happyhorse-1.1-i2v",
    "prompt": "让角色从静态首帧自然转身并开口说话",
    "images": [
      {
        "role": "first_frame",
        "url": "https://example.com/image.png"
      }
    ],
    "resolution": "1080P",
    "durationSeconds": 6
  }'

🎯 参考生视频

基于参考图片（最多9张）生成新视频，支持多参考图驱动。

POST /v1/videos/generations

请求参数

参数 类型 必填 说明
model string 必填 模型名称，如 happyhorse-1.1-r2v
prompt string 必填 文本提示词
images array 必填 参考图片数组，最多9张
durationSeconds integer 可选 视频时长（秒）

请求示例

curl --request POST 'https://www.openwan.art/v1/videos/generations' \
  --header 'Authorization: Bearer ${API_KEY}' \
  --header 'Content-Type: application/json' \
  --header 'X-DashScope-Async: enable' \
  --data-raw '{
    "model": "happyhorse-1.1-r2v",
    "prompt": "根据参考图片生成连贯的视频内容",
    "images": [
      { "url": "https://example.com/ref1.png" },
      { "url": "https://example.com/ref2.png" }
    ],
    "durationSeconds": 5
  }'

✂️ 视频编辑

对已有视频进行风格编辑和修改。

POST /v1/videos/generations

请求参数

参数 类型 必填 说明
model string 必填 模型名称，如 happyhorse-1.1-video-edit
prompt string 必填 编辑指令，描述要进行的修改
video_url string 必填 原视频的公网 URL

请求示例

curl --request POST 'https://www.openwan.art/v1/videos/generations' \
  --header 'Authorization: Bearer ${API_KEY}' \
  --header 'Content-Type: application/json' \
  --header 'X-DashScope-Async: enable' \
  --data-raw '{
    "model": "happyhorse-1.1-video-edit",
    "prompt": "将视频风格改为赛博朋克风格",
    "video_url": "https://example.com/video.mp4"
  }'

🎨 文生图

通过文字描述生成图片，支持多种分辨率。

POST /api/image/text

请求参数

参数 类型 必填 说明
model string 必填 模型名称：wan2.7-image-pro 或 wan2.7-image
prompt string 必填 文本提示词，描述要生成的图片内容
resolution string 可选 分辨率：1K、2K、4K
ratio string 可选 宽高比：1:1、16:9、9:16、4:3、3:4
count integer 可选 生成数量，默认 1

请求示例

curl --request POST 'https://www.openwan.art/api/image/text' \
  --header 'Authorization: Bearer ${API_KEY}' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "model": "wan2.7-image-pro",
    "prompt": "一只可爱的猫咪在花园中",
    "resolution": "2K",
    "ratio": "1:1"
  }'

🖌️ 图像编辑

上传图片并进行 AI 编辑修改。

POST /api/image/edit

请求参数

参数 类型 必填 说明
model string 必填 模型名称
prompt string 必填 编辑指令
image_url string 必填 原图片的公网 URL

请求示例

curl --request POST 'https://www.openwan.art/api/image/edit' \
  --header 'Authorization: Bearer ${API_KEY}' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "model": "wan2.7-image-pro",
    "prompt": "将背景改为星空",
    "image_url": "https://example.com/image.png"
  }'

🎮 交互式编辑

通过框选区域进行精准图像编辑。

POST /api/image/interactive

请求参数

参数 类型 必填 说明
model string 必填 模型名称
prompt string 必填 编辑指令
image_url string 必填 原图片 URL
mask object 必填 编辑区域坐标 {x, y, width, height}

📚 组图生成

生成具有连续性的多图组，适合制作连环画、分镜等。

POST /api/image/sequential

请求参数

参数 类型 必填 说明
model string 必填 模型名称
prompt string 必填 整体描述
count integer 可选 生成图片数量，默认 4
style string 可选 风格：漫画、写实、水彩等

📁 素材管理

管理用户上传的素材文件。

获取素材列表

GET /api/assets

获取当前用户的所有素材。

上传素材

POST /api/assets

上传文件或通过 URL 保存素材。

参数 类型 必填 说明
file file 可选 上传的文件（与 url 二选一）
url string 可选 素材 URL（与 file 二选一）

删除素材

DELETE /api/assets/{asset_id}

删除指定素材。

🤖 AI 模型

平台支持的 AI 模型列表。

视频模型

模型名称 文生视频 图生视频 参考生视频 视频编辑
HappyHorse happyhorse-1.1-t2v happyhorse-1.1-i2v happyhorse-1.1-r2v happyhorse-1.1-video-edit
万相2.7 wanxiang-v2.7 wanxiang-v2.7 wanxiang-v2.7 wanxiang-v2.7-video-edit

图片模型

模型名称 说明
wan2.7-image-pro 高质量图片生成（专业版）
wan2.7-image 标准版图片生成

💰 积分规则

使用 API 生成内容需要消耗积分。

积分消耗

功能 积分消耗
图片生成 每张图片 1 积分
视频生成 积分 = 视频时长（秒）
图像编辑 每次 1 积分

积分获取

• 新注册用户默认获得 5 积分

• 联系管理员购买更多积分

• 生成失败时积分会自动退还

查询积分

可以通过以下接口查询积分余额和使用记录：

GET /api/user/info - 获取当前积分余额
GET /api/user/credit_logs - 获取积分使用记录