---
title: "New Endpoint"
method: POST
path: "/v1/common_task/video2aiAvatar/submit"
---

# New Endpoint

`POST /v1/common_task/video2aiAvatar/submit`

This is your first endpoint! Edit this page to start documenting your API.

## Headers

- `Topview-Uid` string, required
- `Authorization` string, required

## Request body

- object
  - `avatarName` string — the name of custom avatar, If it is empty, use taskId
  - `videoFileId` string, required — video file id. video conditions resolution：360p ~ 4k format：mp4, mov duration：4s ~ 3min size：< 1GB
  - `noticeUrl` string — Please refer to the [API documentation](https://docs.topview.ai/reference/post_notice-notice-url-check#/) for details NoticeUrl

## Response `200`

Successful response

---

[API](https://skmtc.net/topview/apis/image-character-swap-apis-editable-in-readme.md) · [All operations](https://skmtc.net/topview/apis/image-character-swap-apis-editable-in-readme/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/topview/image-character-swap-apis-editable-in-readme/revisions/83cd46ca7859/schema)