Topview-api
  1. image2Video
Topview-api
  • API文档
  • Avatar Marketing Video
    • script
      • list script content
      • update script content
    • submit task
      POST
    • query task
      GET
    • export
      POST
  • Video Avatar
    • Video Avatar API Usage
    • submit task
      POST
    • query task
      GET
  • Product Avatar
    • Product Avatar API Usage
    • Replace Product Image
      • submit task
      • query task
    • Image2Video
      • submit task
      • query task
    • Category Query
      GET
    • Public product avatar Query
      GET
  • Product AnyShoot
    • Replace Product Image
      • submit task
      • query task
    • Template Category
      GET
    • Template List
      GET
  • Common Task
    • image2Video
      • submit task
        POST
      • query task
        GET
  • Scraper
    • submit scraper task
      POST
    • query scraper task
      GET
  • Upload
    • Get Upload Credential
      GET
    • Get Upload Check
      GET
  • check notice url
    POST
  • Voice Query
    GET
  • Ethnicity Query
    GET
  • AiAvatar Query
    GET
  • Caption List
    GET
  1. image2Video

submit task

Developing
POST
/v1/common_task/image2video/submit

Request

Header Params
Authorization
string 
optional
Topview-Uid
string 
optional
Body Params application/json
imageFileId
string 
required
图片文件id
prompt
string 
optional
prompt
negativePrompt
string 
optional
负面prompt
duration
enum<integer> 
required
视频时长,只支持5/10
Allowed values:
510
mode
enum<string> 
required
生成视频质量
Allowed values:
liteproplusbest
generatingCount
integer 
required
生成视频数量,范围1-4
noticeUrl
string 
optional
回调地址。详情看api文档
Example
{
    "imageFileId": "string",
    "prompt": "string",
    "negativePrompt": "string",
    "duration": 5,
    "mode": "lite",
    "generatingCount": 0,
    "noticeUrl": "string"
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.topview.ai/v1/common_task/image2video/submit' \
--header 'Authorization;' \
--header 'Topview-Uid;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "imageFileId": "string",
    "prompt": "string",
    "negativePrompt": "string",
    "duration": 5,
    "mode": "lite",
    "generatingCount": 0,
    "noticeUrl": "string"
}'

Responses

🟢200OK
application/json
Body
code
string 
required
message
string 
required
result
object 
required
taskId
string 
required
status
string 
required
errorMsg
string 
required
Example
{
    "code": "string",
    "message": "string",
    "result": {
        "taskId": "string",
        "status": "string",
        "errorMsg": "string"
    }
}
Modified at 2025-06-06 03:37:51
Previous
Template List
Next
query task
Built with