POST
/
v3
/
async
/
txt2video
curl --request POST \
  --url https://api.ppinfra.com/v3/async/txt2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '{
  "extra": {
    "response_video_type": "<string>"
  },
  "model_name": "<string>",
  "height": 123,
  "width": 123,
  "steps": 123,
  "prompts": [
    {
      "frames": 123,
      "prompt": "<string>"
    }
  ],
  "negative_prompt": "<string>",
  "guidance_scale": {},
  "loras": [
    {
      "model_name": "<string>",
      "strength": {}
    }
  ],
  "embeddings": [
    {
      "model_name": "<string>"
    }
  ],
  "closed_loop": true,
  "clip_skip": {}
}'
{
  "task_id": "<string>"
}

文生视频 API 能基于用户输入的内容,生成符合语义描述的视频。

请求头

Content-Type
string
required

枚举值: application/json

Authorization
string
required

Bearer 身份验证格式,例如:Bearer {{API 密钥}}。

请求体

extra
object

额外参数

model_name
string
required

可以调用 /v3/model 接口并指定请求参数 filter.types=checkpoint 来获取可用模型列表。

height
integer
required

生成视频的高度,取值范围:[256, 1024]。

width
integer
required

生成视频的宽度,取值范围:[256, 1024]。

steps
integer
required

迭代步数,图片创建过程的迭代数,取值范围:[1, 50]。

prompts
object[]
required

视频总帧数是所有片段的帧数和,总帧数需要小于或等于 128

frames
integer
required

该片段的帧数,取值范围:[8, 64]

prompt
string
required

正向提示词,取值范围:[1, 1024]。

negative_prompt
string

反向提示词,取值范围 [1, 1024]。

guidance_scale
number(float32)
required

提示词引导系数,取值越大越接近于提示词描述,取值范围:[1, 30]。

loras
object[]

LoRA 模型,最多支持指定 5 个。

embeddings
object[]

Textual Inversion 模型,最多支持 5 个。

closed_loop
boolean

closed_loop 参数控制动画循环时的行为。具体来说,它决定动画的最后一帧是否会平滑过渡回第一帧。

clip_skip
integer¦null

CLIP 跳过层数,取值范围:[1, 12]。

响应参数

task_id
string
required

异步任务的 task_id。您应该使用该 task_id 请求 查询任务结果 API 以获取生成结果