视觉模型

视频生成接口

创建视频生成任务

请求说明

  • 请求方法: POST

  • 请求路径: https://www.sophnet.com/api/open-apis/projects/easyllms/videogenerator/generate

  • Content-Type: application/json

  • Header参数

参数名类型必填说明
Authorizationstring是API Key，格式: Bearer {your_api_key}
  • Body参数
参数名类型必填说明
modelstring是模型名称，见支持的视频生成模型
contentarray是内容数组，见Content对象
content[xi].typestring是内容类型，支持：
- text：文本提示词
- image_url：图像URL
- draft_task：样片任务（仅Volces Seedance-1.5-Pro支持）
content[xi].textstring条件当type=text时必填，文本提示词，用于描述期望生成的视频内容
content[xi].negative_promptstring否反向提示词，用来描述不希望在画面中看到的内容，可以对画面进行限制
content[xi].image.urlstring条件当type=image_url时必填，表示图片，支持以下格式：
- Base64编码：例如：data:image/jpeg;base64,{BASE64_IMG}
- 公网可访问的图片URL
content[xi].rolestring条件图片位置或用途。首帧图片对应的字段role为：first_frame，尾帧图片对应的字段role为：last_frame，支持Wan2.2-12V-A14B
parametersobject否生成参数
parameters.sizestring否视频分辨率，支持多种预设尺寸：
- 480P：832*480，480*332，640*640
- 720P：1280*720，720*1280，960*960，1088*832，832*1088
- 1080P：1920*1080，1080*1920，1440*1440，1632*1248，1248*1632
parameters.durationnumber否视频时长（秒），支持：
- 1：1秒
- 5：5秒
parameters.seedstring否种子值（整数字符串），用于控制生成内容的随机性。取值范围：[0, 2^32-1]之间的整数。默认随机生成一个值
callback_urlstring否回调URL（仅Volces支持）
return_last_frameboolean否是否返回最后一帧（仅Volces支持）
service_tierstring否服务等级（仅Volces支持）：default（在线推理）、flex（离线推理）
execution_expires_afterinteger否执行过期时间，单位秒（仅Volces支持）
generate_audioboolean否是否生成音频（仅Volces Seedance-1.5-Pro支持）
draftboolean否是否开启样片模式（仅Volces Seedance-1.5-Pro支持），开启后生成预览视频，快速验证效果
subjectsarray否主体信息（仅Vidu reference2video使用），见Subject对象
支持的视频生成模型
万相系列
模型名称说明任务类型
Wan2.2-T2V-Plus万相2.2文生视频Plus版本T2V（文生视频）
Wan2.2-I2V-Plus万相2.2图生视频Plus版本I2V（图生视频）
Wan2.5-T2V-Preview万相2.5文生视频预览版T2V（文生视频）
Wan2.5-I2V-Preview万相2.5图生视频预览版I2V（图生视频）
Wan2.6-T2V万相2.6文生视频T2V（文生视频）
Wan2.6-I2V万相2.6图生视频I2V（图生视频）
开源模型
模型名称说明任务类型
Wan2.2-T2V-A14B万相2.2文生视频A14B版本（开源）T2V（文生视频）
Wan2.2-I2V-A14B万相2.2图生视频A14B版本（开源）I2V（图生视频）
字节跳动系列模型
模型名称说明任务类型
Seedance-1.5-Pro豆包Seedance 1.5专业版动态判断
Seedance-1.0-Pro豆包Seedance 1.0专业版动态判断
Seedance-1.0-Pro-Fast豆包Seedance 1.0专业版（快速）动态判断
Seedance-1.0-Lite-T2V豆包Seedance 1.0轻量版（文生视频）T2V（文生视频）
Seedance-1.0-Lite-I2V豆包Seedance 1.0轻量版（图生视频）I2V（图生视频）
Doubao-Seed3D豆包Seed3D（3D模型）动态判断
生数系列模型
模型名称说明任务类型
ViduQ2Vidu Q2动态判断
ViduQ2-turboVidu Q2 Turbo（快速版）动态判断
ViduQ2-proVidu Q2 Pro（专业版）动态判断
ViduQ2-pro-fastVidu Q2 Pro Fast（专业快速版）动态判断
ViduQ1Vidu Q1动态判断
ViduQ1-classicVidu Q1 Classic动态判断
Vidu2.0Vidu 2.0动态判断
Vidu1.5Vidu 1.5动态判断
Content对象
参数名类型必填说明
typestring是内容类型：text（文本）、image_url（图片）、draft_task（样片任务，仅Volces Seedance-1.5-Pro支持）
textstring否文本内容（当type为text时必填）
negative_promptstring否负面提示词
image_urlobject否图片URL对象，格式：{"url": "图片地址"}
audio_urlstring否音频URL（仅部分模型支持）
rolestring否图片角色：first_frame（首帧）、last_frame（尾帧）、reference_image（参考图）
draft_taskobject否样片任务对象（当type为draft_task时必填），格式：{"id": "样片任务ID"}
Subject对象
参数名类型必填说明
idstring是主体ID
imagesarray是图片URL数组
voice_idstring否声音ID

模型支持的超参和功能列表

  • 视频生成模型通用&特定参数支持表
来源模型系列resolutionratiodurationfpswatermarkseedcamera_fixedsizeframessubdivisionlevelfileformatprompt_extendshot_typeaudionegative_prompt
万相Wan2.2-T2V-Plus✅ (仅I2V时)❌✅❌✅✅❌✅ (仅T2V时)❌❌❌✅✅❌
Wan2.5-T2V-Preview✅ (仅I2V时)❌✅❌✅✅❌✅ (仅T2V时)❌❌❌✅✅❌
Wan2.6-T2V✅ (仅I2V时)❌✅❌✅✅❌✅ (仅T2V时)❌❌❌✅✅❌
字节跳动Seedance-1.5-Pro✅✅✅✅✅✅✅❌✅❌❌❌❌✅❌
Seedance-1.0-Pro✅✅✅✅✅✅✅❌✅❌❌❌❌❌❌
Doubao-Seed3D❌❌❌❌❌✅❌❌❌✅✅❌❌❌❌
生数ViduQ2✅❌✅❌✅✅❌❌❌❌❌❌✅❌
ViduQ1✅❌✅❌✅✅❌❌❌❌❌❌✅❌
Vidu2.0✅❌✅❌✅✅❌❌❌❌❌❌✅❌
  • 视频生成模型请求级别参数支持表
模型系列callback_urlreturn_last_frameservice_tierexecution_expires_aftergenerate_audiodraftsubjects
万相❌❌❌❌❌❌❌
字节跳动✅✅✅✅✅✅❌
生数❌❌❌❌❌❌✅（仅reference2video模式）

补充说明

  1. 标记说明：✅ 表示支持（括号内为特殊适用条件），❌ 表示不支持；
  2. 阿里系列：resolution 仅图生视频（I2V）场景可用，size 仅文生视频（T2V）场景可用；
  3. 字节跳动系列：
    • Doubao-Seed3D是3D模型，仅支持seed、subdivisionlevel、fileformat参数，不支持视频相关参数（resolution、ratio、duration、fps、frames、camera_fixed等）
    • Volces参数格式：推荐使用新格式（参数作为请求体顶层字段，强校验）。旧格式（在text中添加--参数名 值，弱校验）仍兼容但不推荐
    • Seedance-1.5-Pro支持的参数范围：
      • resolution: 480p、720p、1080p（默认720p）
      • duration: 4-12秒（整数）或-1（自动选择），默认5秒
      • 支持generate_audio参数控制是否生成音频
    • Draft样片模式（仅Seedance-1.5-Pro）：设置draft: true生成预览视频（480p），验证效果后可使用draft_task类型基于样片生成最终高质量视频
  4. 生数系列额外支持 endpoint/movement_amplitude/style 等专属进阶参数。

响应说明

  • 响应头参数
名称值描述
Content-Typeapplication/json返回JSON格式数据
  • 响应体参数
名称类型描述
codeinteger状态码，0表示成功
dataobject响应数据对象
data.task_idstring任务id
msgstring响应消息，成功时为"success"

查询视频生成任务

查询指定视频生成任务的状态和结果。

请求示例

HTTP API（Bash）
curl --location -g --request GET 'https://www.sophnet.com/api/open-apis/projects/easyllms/videogenerator/generate/{taskId}' \
--header "Authorization: Bearer {your_api_key}" \
--header "Content-Type: application/json"

响应参数

参数名类型说明
codeinteger状态码，0表示成功
dataobject任务详情对象
data.idstring任务UUID（内部标识）
data.modelstring使用的模型名称
data.statusstring任务状态：queued（排队中）、running（执行中）、succeeded（成功）、failed（失败）、cancelled（已取消）
data.contentobject生成内容（任务成功时返回）
data.content.video_urlstring生成的视频链接
data.usageobject计费原始数据（任务完成后返回）
data.usage.durationinteger视频时长（秒）
data.usage.resolutionstring视频分辨率（如720p、832*480）
data.usage.video_countinteger视频数量
data.usage.ratiostring视频宽高比（如16:9）
data.created_atinteger任务创建时间（Unix时间戳，秒）
data.updated_atinteger任务更新时间（Unix时间戳，秒）
msgstring响应消息，成功时为"success"

删除视频生成任务

删除指定的视频生成任务。

接口信息

  • 请求方法: DELETE
  • 请求路径: https://www.sophnet.com/api/open-apis/projects/easyllms/videogenerator/generate/{taskId}

请求头

参数名类型必填说明
Authorizationstring是API Key，格式: Bearer {your_api_key}

路径参数

参数名类型必填说明
taskIdstring是任务ID

响应参数

参数名类型必填说明
codeinteger是状态码，0表示成功
dataobject是删除结果对象
data.successboolean是是否删除成功
data.taskIdstring是被删除的任务ID
data.messagestring是文本说明，描述删除结果/失败原因
msgstring是响应消息，成功时为"success"

图片生成接口

创建图片生成任务

创建一个异步图片生成任务。

接口信息

  • 请求方法: POST
  • 请求路径: https://www.sophnet.com/api/open-apis/projects/easyllms/imagegenerator/task
  • Content-Type: application/json

请求头

参数名类型必填说明
Authorizationstring是API Key，格式: Bearer {your_api_key}

请求体参数

参数名类型必填说明
modelstring是模型名称，见支持的模型列表；当前支持 Qwen-Image，Z-Image-Turbo，Qwen-Image-Edit-2509
inputobject是输入对象，包含生成图像的提示词、输入图像等信息
input.promptstring是正向提示词，用来描述生成图像中期望包含的元素和视觉特点
input.imagesarray(string)否Qwen-Image-Edit-2509必填，输入图像的URL或Base64编码数据。支持传入1-3张图像；多图输入时，按数组顺序定义图像顺序，输出图像比例以最后一张为准
input.negative_promptstring否反向提示词，用来描述不希望在画面中看到的内容，可对画面进行限制；支持 Qwen-Image、Qwen-Image-Edit-2509
parametersobject否生成参数，控制图像生成的分辨率、种子值等属性
parameters.sizestring否生成图像的分辨率：
- Qwen-Image支持1328*1328、1664*928等，默认1328*1328
- Z-Image-Turbo支持1024*1024等，默认1024*1024
- Qwen-Image-Edit-2509默认生成1280*1280像素图像，宽高比与输入图像一致（多图以最后一张为准），还支持1280*1280、1024*1024等尺寸
parameters.seedint否图片生成的种子值，不提供则自动使用随机数
parameters.prompt_extendbool否是否开启prompt智能改写（仅对正向提示词有效），默认True；支持 Qwen-Image、Qwen-Image-Edit-2509；开启后提升短prompt效果，但增加3-4秒耗时
parameters.watermarkbool否是否添加水印（位于图片右下角），默认false
parameters.save_to_jpegbool否是否输出jpg格式图像，默认false
Input对象
参数名类型必填说明
promptstring是提示词
imagesarray否参考图片URL数组（图生图时使用）
negative_promptstring否负面提示词

支持的图片生成模型

模型名称说明任务类型
Qwen-Image通义千问图像生成（开源）T2I（文生图）
Qwen-Image-Plus通义千问图像生成Plus版T2I（文生图）
Qwen-Image-Edit-2509通义千问图像编辑（开源）I2I（图生图）
Z-Image-TurboZ-Image高速版（开源）T2I（文生图）
Wan2.6-T2I万相2.6文生图T2I（文生图）

响应参数

参数名类型说明
requestIdstring请求ID
outputobject输出对象，见Output对象
usageobject使用量对象，见图片Usage对象
codestring错误码（失败时返回）
messagestring错误信息（失败时返回）
Output对象
参数名类型说明
taskIdstring任务ID
taskStatusstring任务状态：PENDING（待处理）、RUNNING（执行中）、SUCCEEDED（成功）、FAILED（失败）、UNKNOWN（未知）、CANCELED（已取消）
resultsarray图片结果列表，每个元素是包含url字段的对象
codestring错误码（失败时返回）
messagestring错误信息（失败时返回）
图片Usage对象
参数名类型说明
imageCountinteger图片数量

响应示例

{
  "requestId": "req-12345678",
  "output": {
    "taskId": "img-task-12345678",
    "taskStatus": "PENDING"
  },
  "usage": {
    "imageCount": 1
  }
}

查询图片生成任务

查询指定图片生成任务的状态和结果。

接口信息

  • 请求方法: GET
  • 请求路径: https://www.sophnet.com/api/open-apis/projects/easyllms/imagegenerator/task/{taskId}

请求头

参数名类型必填说明
Authorizationstring是API Key，格式: Bearer {your_api_key}

路径参数

参数名类型必填说明
taskIdstring是任务ID（创建任务时返回的taskId）

响应参数

与创建任务的响应结构相同，但当任务成功时，output.results 字段会包含生成的图片URL列表。

响应示例

任务成功:

{
  "requestId": "req-12345678",
  "output": {
    "taskId": "img-task-12345678",
    "taskStatus": "SUCCEEDED",
    "results": [
      {
        "url": "https://example.com/image1.jpg"
      },
      {
        "url": "https://example.com/image2.jpg"
      }
    ]
  },
  "usage": {
    "imageCount": 2
  }
}

任务失败:

{
  "requestId": "req-12345678",
  "output": {
    "taskId": "img-task-12345678",
    "taskStatus": "FAILED",
    "code": "InvalidParameter",
    "message": "Invalid prompt"
  },
  "usage": {
    "imageCount": 0
  }
}

请求示例

异步视频生成示例（文生视频）

curl -X POST "https://www.sophnet.com/api/open-apis/projects/easyllms/videogenerator/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Wan2.6-T2V",
    "content": [
      {
        "type": "text",
        "text": "一只可爱的小猫在阳光下玩耍"
      }
    ],
    "parameters": {
      "duration": 5,
      "resolution": "720p",
      "ratio": "16:9",
      "fps": "24",
      "watermark": false
    }
  }'

响应示例：

{
  "code": 0,
  "data": {
    "task_id": "70iRUM0CnSEyBmeWkIUUTo"
  },
  "msg": "success"
}

异步视频生成示例（图生视频）

curl -X POST "https://www.sophnet.com/api/open-apis/projects/easyllms/videogenerator/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Wan2.6-I2V",
    "content": [
      {
        "type": "image_url",
        "image_url": {
          "url": "https://example.com/reference.jpg"
        }
      },
      {
        "type": "text",
        "text": "让图片中的人物动起来"
      }
    ],
    "parameters": {
      "duration": 5,
      "resolution": "720p",
      "watermark": false
    }
  }'

响应示例：

{
  "code": 0,
  "data": {
    "task_id": "8KpQxN2VmRTyHnWeLjFvXo"
  },
  "msg": "success"
}

异步图片生成示例（文生图）

curl -X POST "https://www.sophnet.com/api/open-apis/projects/easyllms/imagegenerator/task" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Qwen-Image-Plus",
    "input": {
      "prompt": "一幅美丽的山水画，水墨风格",
      "negative_prompt": "模糊，低质量"
    },
    "parameters": {
      "size": "1024*1024",
      "n": 1,
      "watermark": false,
      "prompt_extend": true
    }
  }'

异步图片生成示例（图生图）

curl -X POST "https://www.sophnet.com/api/open-apis/projects/easyllms/imagegenerator/task" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Qwen-Image-Edit-2509",
    "input": {
      "prompt": "将图片风格改为油画风格",
      "images": [
        "https://example.com/source.jpg"
      ]
    },
    "parameters": {
      "size": "1024*1024",
      "n": 1,
      "watermark": false
    }
  }'

查询任务状态示例

# 查询视频生成任务
curl -X GET "https://www.sophnet.com/api/open-apis/projects/easyllms/videogenerator/generate/70iRUM0CnSEyBmeWkIUUTo" \
  -H "Authorization: Bearer YOUR_API_KEY"

# 查询图片生成任务
curl -X GET "https://www.sophnet.com/api/open-apis/projects/easyllms/imagegenerator/task/img-task-12345678" \
  -H "Authorization: Bearer YOUR_API_KEY"

视频生成任务查询响应示例：

{
  "code": 0,
  "data": {
    "id": "70iRUM0CnSEyBmeWkIUUTo",
    "model": "Wan2.6-T2V",
    "status": "succeeded",
    "content": {
      "video_url": "https://example.com/generated-video.mp4"
    },
    "usage": {
      "duration": 5,
      "resolution": "720p",
      "video_count": 1,
      "ratio": "16:9"
    },
    "created_at": 1706789012,
    "updated_at": 1706789123
  },
  "msg": "success"
}

注意事项

  1. 认证: 所有接口都需要在请求头中携带有效的API Key
  2. 任务状态轮询: 异步接口创建任务后需要通过查询接口轮询任务状态，建议轮询间隔为3-5秒
  3. URL有效期: 生成的视频和图片URL有一定的有效期，建议及时下载保存
  4. 参数兼容性: 不同模型支持的参数可能不同，请根据模型文档选择合适的参数
  5. 文生图与图生图:
    • 文生图(T2I)：只需要提供文本提示词
    • 图生图(I2I)：需要提供参考图片和文本提示词
  6. 文生视频与图生视频:
    • 文生视频(T2V)：只需要提供文本描述
    • 图生视频(I2V)：需要提供参考图片和文本描述