阿里 Pix 平台接口参考 - SocialVision AI Gateway

图片结果查询接口

GET /openapi/v2/image/result/{image_id} 根据 image_id 查询图片模版生成任务的状态与结果。

请求参数 (Query / Path)

string

required

图片 ID

string

平台 API Key（请求头）

请求示例 (cURL)

curl "https://socialvision.tisyk.xyz/openapi/v2/image/result/{image_id}" \
  -H "Authorization: Bearer sk-YOUR_API_KEY"

响应示例 (200 OK)

{
  "ErrCode": 0,
  "ErrMsg": "success",
  "RespData": {
    "id": 123456
  }
}

获取TTS 音色

GET /openapi/v2/video/lip_sync/tts_list 分页获取可用的 TTS 音色列表，供对口型视频生成使用。

请求参数 (Query / Path)

string

required

页码（从 1 开始）

string

required

每页条数

string

平台 API Key（请求头）

请求示例 (cURL)

curl "https://socialvision.tisyk.xyz/openapi/v2/video/lip_sync/tts_list" \
  -H "Authorization: Bearer sk-YOUR_API_KEY"

响应示例 (200 OK)

{
  "ErrCode": 0,
  "ErrMsg": "success",
  "RespData": {
    "id": 123456
  }
}

获取视频状态

GET /openapi/v2/video/result/{video_id} 根据 video_id 查询视频生成任务的状态与结果。

请求参数 (Query / Path)

string

required

视频任务 ID

string

required

平台 API Key（请求头）

请求示例 (cURL)

curl "https://socialvision.tisyk.xyz/openapi/v2/video/result/{video_id}" \
  -H "Authorization: Bearer sk-YOUR_API_KEY"

响应示例 (200 OK)

{
  "ErrCode": 0,
  "ErrMsg": "success",
  "RespData": {
    "id": 123456
  }
}

图片模版生成接口

POST /openapi/v2/image/template/generate 使用已上传图片与模版 ID 生成图片，返回 image_id 供结果查询。

请求参数 (Query / Path)

string

请求体 Content-Type，一般为 application/json

string

平台 API Key（请求头）

请求体参数 (Body)

array

required

图片资源 ID 列表

integer

required

模板 ID

请求示例 (JSON)

{
  "img_ids": [
    0
  ],
  "template_id": 384631857552768
}

请求示例 (cURL)

curl -X POST "https://socialvision.tisyk.xyz/openapi/v2/image/template/generate" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "img_ids": [
    0
  ],
  "template_id": 384631857552768
}'

响应示例 (200 OK)

{
  "ErrCode": 0,
  "ErrMsg": "success",
  "RespData": {
    "id": 123456
  }
}

上传图片

POST /openapi/v2/image/upload 图生视频/首尾帧都需要先上传图片, 通过img_id 完成生成. 生成时需要传image文件的路径支持格式 : “png”, “webp”, “jpeg”, “jpg” . 支持 mime-type “image/jpeg”,“image/jpg”,“image/png”,“image/webp” 最大支持 10000px 以内的图片

请求参数 (Query / Path)

string

平台 API Key（请求头）

请求体参数 (Body)

string

重要提示：上传图片时，必须使用携带本地图片文件路径的 form-data 格式，目前不支持通过 URL 上传图片。

string

支持url 上传. 只传 image or image_url即可. 只支持一下格式/mime-type: “image/jpeg”,“image/jpg”,“image/png”,“image/webp”

请求示例 (JSON)

{
  "image": "",
  "image_url": ""
}

请求示例 (cURL)

curl -X POST "https://socialvision.tisyk.xyz/openapi/v2/image/upload" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "image": "",
  "image_url": ""
}'

响应示例 (200 OK)

{
  "ErrCode": 0,
  "ErrMsg": "success",
  "RespData": {
    "id": 123456
  }
}

上传资源(视频/音频)

POST /openapi/v2/media/upload

支持以下mime/type & 后缀 “video/mp4”: “mp4”, “video/mov”: “mov”, “video/webm”: “webm”, “video/quicktime”: “mov” “audio/mpeg”: “mp3”, “audio/wav”: “wav”, “audio/vnd.wave”: “wav”, “audio/x-wav”: “wav”, “audio/x-m4a”: “m4a”, “audio/aac”: “aac”, “audio/x-aac”: “aac”, “audio/wave”: “wav”, “audio/mp4”: “mp3” 2. 视频文件限制最大分辨率：1920 最大文件大小：50MB 最大时长：30秒 3. 音频文件限制最大文件大小：50MB 最大时长：30秒

请求参数 (Query / Path)

string

平台 API Key（请求头）

请求体参数 (Body)

string

file or file_url 二选一

string

可以使用url 上传资源. 支持以下mime-type/ 后缀 “video/mp4”: “mp4”, “video/mov”: “mov”, “video/webm”: “webm”, “video/quicktime”: “mov” “audio/mpeg”: “mp3”, “audio/wav”: “wav”, “audio/vnd.wave”: “wav”, “audio/x-wav”: “wav”, “audio/x-m4a”: “m4a”, “audio/aac”: “aac”, “audio/x-aac”: “aac”, “audio/wave”: “wav”, “audio/mp4”: “mp3”

请求示例 (JSON)

{
  "file": "",
  "file_url": ""
}

请求示例 (cURL)

curl -X POST "https://socialvision.tisyk.xyz/openapi/v2/media/upload" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "file": "",
  "file_url": ""
}'

响应示例 (200 OK)

{
  "ErrCode": 0,
  "ErrMsg": "success",
  "RespData": {
    "id": 123456
  }
}

生成延长(Extend)视频

POST /openapi/v2/video/extend/generate 基于已有视频延长生成时长，可指定 prompt 与模型参数。

请求参数 (Query / Path)

string

请求体 Content-Type，一般为 application/json

string

平台 API Key（请求头）

请求体参数 (Body)

integer

required

视频生成时长 v.3.5/v4/v4.5 : 5/8 (v3.5 1080p 无法使用 8) v5 : 5/8 v5.5 : 5/8/10 (1080p 无法使用 10) v6 : 1~15

string

required

模型 “v3.5”,“v4”,“v4.5”,“v5”,“v5.5“,“v6”

string

“normal”,“fast”. “fast” 不支持 8s, “v5” 不支持此字段

string

required

2048 Characters 以内

string

required

“360p”,“540p”,“720p”,“1080p”

integer

随机种子；相同种子便于复现

integer

必传source_video_id 或 video_media_id

string

风格，可选：“anime”、“3d_animation”、“day”、“cyberpunk”、“comic”，如非必要可不传

integer

必传source_video_id 或 video_media_id

boolean

required

是否添加水印

请求示例 (JSON)

{
  "duration": 8,
  "model": "v5",
  "motion_mode": "normal",
  "prompt": "across the universe",
  "quality": "540p",
  "seed": 123123,
  "source_video_id": 123123,
  "water_mark": false
}

请求示例 (cURL)

curl -X POST "https://socialvision.tisyk.xyz/openapi/v2/video/extend/generate" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "duration": 8,
  "model": "v5",
  "motion_mode": "normal",
  "prompt": "across the universe",
  "quality": "540p",
  "seed": 123123,
  "source_video_id": 123123,
  "water_mark": false
}'

响应示例 (200 OK)

{
  "ErrCode": 0,
  "ErrMsg": "success",
  "RespData": {
    "id": 123456
  }
}

多主体(多参考)生成视频

POST /openapi/v2/video/fusion/generate 使用多张参考图（主体/背景）与 prompt 生成融合视频，支持 @ref_name 引用。

请求参数 (Query / Path)

string

请求体 Content-Type，一般为 application/json

string

平台 API Key（请求头）

请求体参数 (Body)

string

required

1.基础提供 “16:9”,“9.16”,“4:3”,“3:4”,“1:1” 画幅比 2.v6, c1 额外支持 “2:3”,“3:2”,“21:9”

integer

required

视频生成时长 v4.5 : 5/8 (v3.5 1080p 无法使用 8) v5 : 5/8 v5.5/5.6 : 5/8/10 (1080p 无法使用 10)

boolean

支持v5.6,v6, c1 / 控制开关Audio. true: Audio on , false: Audio off

array

required

图像引用数组（1–3 项），包含“主体”或“背景” v4.5/v5 : 最多3张 v5.5/v5.6/v6 : 最多7张

string

required

“v4.5”,“v5”,“v5.5”,“v5.6”,,“v6”, “c1”

string

required

使用 @ref_name 精确描述场景 1. @ref_name 后必须有空格，如 @cat plays 2. prompt 中引用的名称必须与 image_references 中的 ref_name 完全一致

string

required

“360p”,“540p”,“720p”,“1080p”

integer

随机种子；相同种子便于复现

请求示例 (JSON)

{
  "aspect_ratio": "16:9",
  "duration": 5,
  "image_references": [
    {
      "img_id": 0,
      "ref_name": "dog",
      "type": "subject"
    },
    {
      "img_id": 0,
      "ref_name": "room",
      "type": "background"
    }
  ],
  "model": "v5.6",
  "prompt": "@dog plays at @room",
  "quality": "720p",
  "seed": 123456789
}

请求示例 (cURL)

curl -X POST "https://socialvision.tisyk.xyz/openapi/v2/video/fusion/generate" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "aspect_ratio": "16:9",
  "duration": 5,
  "image_references": [
    {
      "img_id": 0,
      "ref_name": "dog",
      "type": "subject"
    },
    {
      "img_id": 0,
      "ref_name": "room",
      "type": "background"
    }
  ],
  "model": "v5.6",
  "prompt": "@dog plays at @room",
  "quality": "720p",
  "seed": 123456789
}'

响应示例 (200 OK)

{
  "ErrCode": 0,
  "ErrMsg": "success",
  "RespData": {
    "id": 123456
  }
}

生成视频模版

POST /openapi/v2/video/img/generate 基于已上传图片与模版 ID 生成图生视频，支持单图或多图模版。

请求参数 (Query / Path)

string

请求体 Content-Type，一般为 application/json

string

平台 API Key（请求头）

请求体参数 (Body)

integer

required

传5即可, 实际duration 按照模版时长生成

integer

required

单图模版时使用

array

多图模版时使用 ex) “img_ids ”:[0,0]

string

required

传任何模型即可, 模版与模型不相关

string

required

模版不识别prompt, 传空即可

string

required

“360p”,“540p”,“720p”,“1080p”

boolean

true时, 会有背景音乐

integer

required

模版ID

请求示例 (JSON)

{
  "duration": 5,
  "img_id": 1,
  "model": "v6",
  "prompt": "string",
  "quality": "720p",
  "template_id": 0
}

请求示例 (cURL)

curl -X POST "https://socialvision.tisyk.xyz/openapi/v2/video/img/generate" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "duration": 5,
  "img_id": 1,
  "model": "v6",
  "prompt": "string",
  "quality": "720p",
  "template_id": 0
}'

响应示例 (200 OK)

{
  "ErrCode": 0,
  "ErrMsg": "success",
  "RespData": {
    "id": 123456
  }
}

生成对口型(Lipsync)视频

POST /openapi/v2/video/lip_sync/generate 为视频添加对口型效果，可使用 TTS 音色或上传音频驱动口型。

请求参数 (Query / Path)

string

请求体 Content-Type，一般为 application/json

string

平台 API Key（请求头）

请求体参数 (Body)

integer

必传audio_media_id 或 lip_sync_tts_speaker_id + lip_sync_tts_conent. 使用用户上传的音频

string

必传audio_media_id 或 lip_sync_tts_speaker_id + lip_sync_tts_conent 使用我们的TTS 服务

string

必传audio_media_id 或 lip_sync_tts_speaker_id + lip_sync_tts_conent. 使用我们的TTS 服务. 通过接口获取TTS 音色.

integer

必传 source_video_id 或 video_media_id. 通过用户上传的视频

integer

必传 source_video_id 或 video_media_id 通过pixverse 生成的视频

请求示例 (JSON)

{
  "lip_sync_tts_content": "hello this is harry, where are you from?",
  "lip_sync_tts_speaker_id": "auto",
  "video_media_id": 0
}

请求示例 (cURL)

curl -X POST "https://socialvision.tisyk.xyz/openapi/v2/video/lip_sync/generate" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "lip_sync_tts_content": "hello this is harry, where are you from?",
  "lip_sync_tts_speaker_id": "auto",
  "video_media_id": 0
}'

响应示例 (200 OK)

{
  "ErrCode": 0,
  "ErrMsg": "success",
  "RespData": {
    "id": 123456
  }
}

主体替换(Swap) Mask 生成

POST /openapi/v2/video/mask/selection 为指定视频帧生成主体替换所需的 Mask，供后续 Swap 视频生成使用。

请求参数 (Query / Path)

string

请求体 Content-Type，一般为 application/json

string

平台 API Key（请求头）

请求体参数 (Body)

integer

从1 到最后视频帧. 如果不提供默认为1

integer

通过拍我API 生成的video_id, 必传source_video_id 或 video_media_id 编码需要为 h.264/h.265

integer

通过接口上传的视频 media_id,必传source_video_id 或 video_media_id

请求示例 (JSON)

{
  "keyframe_id": 1,
  "source_video_id": 0
}

请求示例 (cURL)

curl -X POST "https://socialvision.tisyk.xyz/openapi/v2/video/mask/selection" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "keyframe_id": 1,
  "source_video_id": 0
}'

响应示例 (200 OK)

{
  "ErrCode": 0,
  "ErrMsg": "success",
  "RespData": {
    "id": 123456
  }
}

动作模仿(Mimic) 视频生成

POST /openapi/v2/video/mimic/generate 让参考图片中的人物模仿源视频中的动作，生成 Mimic 效果视频。

请求参数 (Query / Path)

string

请求体 Content-Type，一般为 application/json

string

平台 API Key（请求头）

请求体参数 (Body)

integer

required

上传图片后获取的img_id

string

required

“360p”,“540p”,“720p”,“1080p”

integer

通过拍我API 生成的video_id, 必传source_video_id 或 video_media_id

integer

通过接口上传的视频 media_id,必传source_video_id 或 video_media_id

请求示例 (JSON)

{
  "img_id": 0,
  "quality": "360p",
  "video_media_id": 0
}

请求示例 (cURL)

curl -X POST "https://socialvision.tisyk.xyz/openapi/v2/video/mimic/generate" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "img_id": 0,
  "quality": "360p",
  "video_media_id": 0
}'

响应示例 (200 OK)

{
  "ErrCode": 0,
  "ErrMsg": "success",
  "RespData": {
    "id": 123456
  }
}

视频编辑(Modify) 生成视频

POST /openapi/v2/video/modify/generate 对视频指定帧进行编辑，支持 mask 选区与参考图片替换，通过 prompt 描述编辑意图。

请求参数 (Query / Path)

string

required

请求体 Content-Type，一般为 application/json

string

required

平台 API Key（请求头）

请求体参数 (Body)

array

通过上传接口获取的img_id, 最多支持3个

integer

指定使用视频中的哪一帧进行替换(编辑)

array

通过swap-mask接口获取的mask_id, 最多支持3个

string

required

如果 Prompt 中使用了 mask，请使用 @selection0、@selection1；如果使用参考图片，请使用 @img0、@img1 , 支持 5000字符

string

required

“360p”,“540p”,“720p”

string

required

通过拍我AI 生成的视频video_id,必传source_video_id 或 video_media_id

integer

通过接口上传的视频 media_id,必传source_video_id 或 video_media_id

请求示例 (JSON)

{
  "img_ids": [
    123
  ],
  "keyframe_ids": 1,
  "mask_ids": [
    "3847593904"
  ],
  "prompt": "@selection0 subject is swapped with @img0",
  "quality": "540p",
  "source_video_id": "1234",
  "video_media_id": 1234
}

请求示例 (cURL)

curl -X POST "https://socialvision.tisyk.xyz/openapi/v2/video/modify/generate" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "img_ids": [
    123
  ],
  "keyframe_ids": 1,
  "mask_ids": [
    "3847593904"
  ],
  "prompt": "@selection0 subject is swapped with @img0",
  "quality": "540p",
  "source_video_id": "1234",
  "video_media_id": 1234
}'

响应示例 (200 OK)

{
  "ErrCode": 0,
  "ErrMsg": "success",
  "RespData": {
    "id": 123456
  }
}

多帧(Multi-transition) 视频生成

POST /openapi/v2/video/multi_transition/generate 使用 2–7 张图片按序生成多段过渡视频，每段可独立设置时长与 prompt。

请求参数 (Query / Path)

string

请求体 Content-Type，一般为 application/json

string

平台 API Key（请求头）

请求体参数 (Body)

string

required

“v3.5”,“v4”,“v4.5”,“v5”

array

required

multi_transition 必须是一个包含 2 到 7 个元素的数组。2 . multi_transition 中的每个元素应包含：img_id（必填，整数）、duration（必填，整数，最后一个元素可选）、prompt（可选，字符串）。

string

required

“360p”,“540p”,“720p”,“1080p”

请求示例 (JSON)

{
  "model": "v5",
  "motion_mode": "normal",
  "multi_transition": [
    {
      "duration": 3,
      "img_id": 0,
      "prompt": ""
    },
    {
      "duration": 3,
      "img_id": 0,
      "prompt": ""
    },
    {
      "duration": 3,
      "img_id": 0,
      "prompt": ""
    },
    {
      "duration": 3,
      "img_id": 0,
      "prompt": ""
    },
    {
      "duration": 0,
      "img_id": 0,
      "prompt": ""
    }
  ],
  "quality": "360p"
}

请求示例 (cURL)

curl -X POST "https://socialvision.tisyk.xyz/openapi/v2/video/multi_transition/generate" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "v5",
  "motion_mode": "normal",
  "multi_transition": [
    {
      "duration": 3,
      "img_id": 0,
      "prompt": ""
    },
    {
      "duration": 3,
      "img_id": 0,
      "prompt": ""
    },
    {
      "duration": 3,
      "img_id": 0,
      "prompt": ""
    },
    {
      "duration": 3,
      "img_id": 0,
      "prompt": ""
    },
    {
      "duration": 0,
      "img_id": 0,
      "prompt": ""
    }
  ],
  "quality": "360p"
}'

响应示例 (200 OK)

{
  "ErrCode": 0,
  "ErrMsg": "success",
  "RespData": {
    "id": 123456
  }
}

重绘视频生成视频

POST /openapi/v2/video/restyle/generate 对已有视频应用重绘风格，可通过 restyle_id 或 restyle_prompt 指定效果。

请求参数 (Query / Path)

string

请求体 Content-Type，一般为 application/json

string

平台 API Key（请求头）

请求体参数 (Body)

integer

从重绘效果列表获取的ID, restyle_id 或restyle_prompt 需要填写

string

支持提示词替换风格, restyle_id 或restyle_prompt 需要填写 5000 字符以内

integer

随机种子；相同种子便于复现

integer

用户用拍我API 生成过的视频, 必传source_video_id 或 video_media_id

integer

用户上传的视频,必传source_video_id 或 video_media_id

请求示例 (JSON)

{
  "restyle_id": 0,
  "seed": 0,
  "source_video_id": 0
}

请求示例 (cURL)

curl -X POST "https://socialvision.tisyk.xyz/openapi/v2/video/restyle/generate" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "restyle_id": 0,
  "seed": 0,
  "source_video_id": 0
}'

响应示例 (200 OK)

{
  "ErrCode": 0,
  "ErrMsg": "success",
  "RespData": {
    "id": 123456
  }
}

音效生成(sound_effect)接口

POST /openapi/v2/video/sound_effect/generate 为已有视频生成或叠加音效，可保留原声或指定音效内容。

请求参数 (Query / Path)

string

请求体 Content-Type，一般为 application/json

string

平台 API Key（请求头）

请求体参数 (Body)

boolean

控制是否播放背景音乐。必须为布尔值。

string

可选。如果未提供，则会生成随机音效。

integer

必传source_video_id 或 video_media_id

integer

必传source_video_id 或 video_media_id

请求示例 (JSON)

{
  "original_sound_switch": true,
  "sound_effect_content": "",
  "source_video_id": 343252978602905
}

请求示例 (cURL)

curl -X POST "https://socialvision.tisyk.xyz/openapi/v2/video/sound_effect/generate" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "original_sound_switch": true,
  "sound_effect_content": "",
  "source_video_id": 343252978602905
}'

响应示例 (200 OK)

{
  "ErrCode": 0,
  "ErrMsg": "success",
  "RespData": {
    "id": 123456
  }
}

主体替换(Swap) 视频生成

POST /openapi/v2/video/swap/generate 使用 Mask 与参考图片替换视频中的主体，生成 Swap 效果视频。

请求参数 (Query / Path)

string

请求体 Content-Type，一般为 application/json

string

平台 API Key（请求头）

请求体参数 (Body)

integer

required

图片资源 ID

integer

required

从1 到最后视频帧. 如果不提供默认为1

string

required

蒙版 ID

string

required

输出质量档位

integer

通过拍我API 生成的video_id, 必传source_video_id 或 video_media_id

integer

通过接口上传的视频 media_id,必传source_video_id 或 video_media_id

请求示例 (JSON)

{
  "img_id": 0,
  "keyframe_id": 1,
  "mask_id": "0",
  "quality": "360p",
  "source_video_id": 0
}

请求示例 (cURL)

curl -X POST "https://socialvision.tisyk.xyz/openapi/v2/video/swap/generate" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "img_id": 0,
  "keyframe_id": 1,
  "mask_id": "0",
  "quality": "360p",
  "source_video_id": 0
}'

响应示例 (200 OK)

{
  "ErrCode": 0,
  "ErrMsg": "success",
  "RespData": {
    "id": 123456
  }
}

生成文生视频

POST /openapi/v2/video/text/generate 通过 prompt 进行文生视频生成，支持多种模型、画幅比与时长配置。

请求参数 (Query / Path)

string

API-KEY 来自拍我API开放平台

string

请求体 Content-Type，一般为 application/json

请求体参数 (Body)

string

required

基础提供 “16:9”,“9.16”,“4:3”,“3:4”,“1:1” 画幅比
v6,c1 支持 “16:9”,“9.16”,“4:3”,“3:4”,“1:1”,“2:3”,“3:2”,“21:9”

string

可以在文/图生视频添加运镜(支持v4,v4.5版本) 支持参数: “horizontal_left”,“horizontal_right”,“vertical_up”,“vertical_down”, “zoom_in”,“zoom_out”,“crane_up”, “quickly_zoom_in”,“quickly_zoom_out”,“smooth_zoom_in”, “camera_rotation”,“robo_arm”,“super_dolly_out”,“whip_pan”,“hitchcock”, “left_follow”,“right_follow”,“pan_left”,“pan_right”,“fix_bg”

integer

required

视频生成时长视频生成时长 v.3.5/v4/v4.5 : 5/8 (v3.5 1080p 无法使用 8) v5 : 5/8 v5.5/5.6 : 5/8/10 (1080p 无法使用 10) v6/c1 : 1~15 任意时长

boolean

支持 v5.5,v5.6,v6,c1 / 控制开关Audio. true: Audio on , false: Audio off

boolean

支持:v5.5,v6 控制单镜头, 多镜头 true: 多镜头 , false: 单镜头/

string

~140Chracters (UTF-8). 可输入想要的tts 内容

string

获取TTS 音色后的id

boolean

true, false 如果想一起使用对口型请传为true

string

required

模型 “v3.5”,“v4”,“v4.5”, “v5”,“v5.5”,“v5.6”,“v6”,“c1”

string

“normal”,“fast”. “fast” 不支持 8s, “v5” 以上版本不支持此字段

string

required

5000 Characters 以内

string

required

“360p”,“540p”,“720p”,“1080p”

integer

可传随机数 0 - 2147483647

string

v5 以下 or 有template_id时可使用.可输入想要的音效, 如果不填写会根据视频内容生成音效

boolean

v5 以下 or 有template_id时可使用. true, false 如果想一起使用sound_effect 请传为true

integer

模版(特效)ID , 使用之前需要激活

请求示例 (JSON)

{
  "aspect_ratio": "16:9",
  "duration": 5,
  "model": "v6",
  "motion_mode": "normal",
  "prompt": "string",
  "quality": "540p",
  "seed": 0
}

请求示例 (cURL)

curl -X POST "https://socialvision.tisyk.xyz/openapi/v2/video/text/generate" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "aspect_ratio": "16:9",
  "duration": 5,
  "model": "v6",
  "motion_mode": "normal",
  "prompt": "string",
  "quality": "540p",
  "seed": 0
}'

响应示例 (200 OK)

{
  "ErrCode": 0,
  "ErrMsg": "success",
  "RespData": {
    "id": 123456
  }
}

首尾帧生成视频

POST /openapi/v2/video/transition/generate 使用首帧与尾帧图片生成过渡视频，支持运镜与音效等扩展参数。

请求参数 (Query / Path)

string

请求体 Content-Type，一般为 application/json

string

平台 API Key（请求头）

请求体参数 (Body)

integer

required

视频生成时长 v.3.5/v4/v4.5 : 5/8 (v3.5 1080p 无法使用 8) v5 : 5/8 v5.5/v5.6 : 5/8/10 (1080p 无法使用 10) v6/c1 : 1~15

integer

required

上传图片后获取的img_id

boolean

支持 v5.5, v5.6, v6,c1 使用 / 控制开关Audio. true: Audio on , false: Audio off

integer

required

上传图片后获取的img_id

string

~140Chracters (UTF-8). 可输入想要的tts 内容可适用范围 : “v3.5”,“v4”,“v4.5”,“v5”

string

获取TTS 音色后的id 可适用范围 : “v3.5”,“v4”,“v4.5”,“v5”

boolean

true, false 如果想一起使用对口型请传为true

string

required

模型 “v3.5”,“v4”,“v4.5”, “v5”,“v5.5”,“v5.6”,“v6”,“c1”

string

“normal”,“fast”. “fast” 不支持 8s, “v5” 不支持此字段

string

required

2048 Characters 以内

string

required

“360p”,“540p”,“720p”,“1080p”

integer

可传随机数 0 - 2147483647

string

可输入想要的音效, 如果不填写会根据视频内容生成音效

boolean

v5 以下 or 有template_id时可使用.true, false 如果想一起使用sound_effect 请传为true

请求示例 (JSON)

{
  "duration": 5,
  "first_frame_img": 0,
  "last_frame_img": 0,
  "model": "v4.5",
  "motion_mode": "normal",
  "prompt": "trasnfrom into character",
  "quality": "540p",
  "seed": 937433858
}

请求示例 (cURL)

curl -X POST "https://socialvision.tisyk.xyz/openapi/v2/video/transition/generate" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "duration": 5,
  "first_frame_img": 0,
  "last_frame_img": 0,
  "model": "v4.5",
  "motion_mode": "normal",
  "prompt": "trasnfrom into character",
  "quality": "540p",
  "seed": 937433858
}'

响应示例 (200 OK)

{
  "ErrCode": 0,
  "ErrMsg": "success",
  "RespData": {
    "id": 123456
  }
}

​图片结果查询接口

​请求参数 (Query / Path)

​请求示例 (cURL)

​响应示例 (200 OK)

​获取TTS 音色

​请求参数 (Query / Path)

​请求示例 (cURL)

​响应示例 (200 OK)

​获取视频状态

​请求参数 (Query / Path)

​请求示例 (cURL)

​响应示例 (200 OK)

​图片模版生成接口

​请求参数 (Query / Path)

​请求体参数 (Body)

​请求示例 (JSON)

​请求示例 (cURL)

​响应示例 (200 OK)

​上传图片

​请求参数 (Query / Path)

​请求体参数 (Body)

​请求示例 (JSON)

​请求示例 (cURL)

​响应示例 (200 OK)

​上传资源(视频/音频)

​请求参数 (Query / Path)

​请求体参数 (Body)

​请求示例 (JSON)

​请求示例 (cURL)

​响应示例 (200 OK)

​生成延长(Extend)视频

​请求参数 (Query / Path)

​请求体参数 (Body)

​请求示例 (JSON)

​请求示例 (cURL)

​响应示例 (200 OK)

​多主体(多参考)生成视频

​请求参数 (Query / Path)

​请求体参数 (Body)

​请求示例 (JSON)

​请求示例 (cURL)

​响应示例 (200 OK)

​生成视频模版

​请求参数 (Query / Path)

​请求体参数 (Body)

​请求示例 (JSON)

​请求示例 (cURL)

​响应示例 (200 OK)

​生成对口型(Lipsync)视频

​请求参数 (Query / Path)

​请求体参数 (Body)

​请求示例 (JSON)

​请求示例 (cURL)

​响应示例 (200 OK)

​主体替换(Swap) Mask 生成

​请求参数 (Query / Path)

​请求体参数 (Body)

​请求示例 (JSON)

​请求示例 (cURL)

​响应示例 (200 OK)

​动作模仿(Mimic) 视频生成

​请求参数 (Query / Path)

​请求体参数 (Body)

​请求示例 (JSON)

​请求示例 (cURL)

​响应示例 (200 OK)

​视频编辑(Modify) 生成视频

​请求参数 (Query / Path)

​请求体参数 (Body)

​请求示例 (JSON)

​请求示例 (cURL)

​响应示例 (200 OK)

​多帧(Multi-transition) 视频生成

​请求参数 (Query / Path)

​请求体参数 (Body)

​请求示例 (JSON)

​请求示例 (cURL)

​响应示例 (200 OK)

​重绘视频生成视频

​请求参数 (Query / Path)

图片结果查询接口

请求参数 (Query / Path)

请求示例 (cURL)

响应示例 (200 OK)

获取TTS 音色

请求参数 (Query / Path)

请求示例 (cURL)

响应示例 (200 OK)

获取视频状态

请求参数 (Query / Path)

请求示例 (cURL)

响应示例 (200 OK)

图片模版生成接口

请求参数 (Query / Path)

请求体参数 (Body)

请求示例 (JSON)

请求示例 (cURL)

响应示例 (200 OK)

上传图片

请求参数 (Query / Path)

请求体参数 (Body)

请求示例 (JSON)

请求示例 (cURL)

响应示例 (200 OK)

上传资源(视频/音频)

请求参数 (Query / Path)

请求体参数 (Body)

请求示例 (JSON)

请求示例 (cURL)

响应示例 (200 OK)

生成延长(Extend)视频

请求参数 (Query / Path)

请求体参数 (Body)

请求示例 (JSON)

请求示例 (cURL)

响应示例 (200 OK)

多主体(多参考)生成视频

请求参数 (Query / Path)

请求体参数 (Body)

请求示例 (JSON)

请求示例 (cURL)

响应示例 (200 OK)

生成视频模版

请求参数 (Query / Path)

请求体参数 (Body)

请求示例 (JSON)

请求示例 (cURL)

响应示例 (200 OK)

生成对口型(Lipsync)视频

请求参数 (Query / Path)

请求体参数 (Body)

请求示例 (JSON)

请求示例 (cURL)

响应示例 (200 OK)

主体替换(Swap) Mask 生成

请求参数 (Query / Path)

请求体参数 (Body)

请求示例 (JSON)

请求示例 (cURL)

响应示例 (200 OK)

动作模仿(Mimic) 视频生成

请求参数 (Query / Path)

请求体参数 (Body)

请求示例 (JSON)

请求示例 (cURL)

响应示例 (200 OK)

视频编辑(Modify) 生成视频

请求参数 (Query / Path)

请求体参数 (Body)

请求示例 (JSON)

请求示例 (cURL)

响应示例 (200 OK)

多帧(Multi-transition) 视频生成

请求参数 (Query / Path)

请求体参数 (Body)

请求示例 (JSON)

请求示例 (cURL)

响应示例 (200 OK)

重绘视频生成视频

请求参数 (Query / Path)