---
title: "Submit Task"
method: POST
path: "/v1/common_task/image_edit/task/submit"
tags: ["Image Edit"]
---

# Submit Task

`POST /v1/common_task/image_edit/task/submit`

Submit an image editing task. The system will apply AI-powered edits to the reference images based on the provided prompt and model specifications.

## Headers

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

## Request body

- object
  - `model` string, required — Model name (required), e.g., 'Nano Banana 2', 'Seedream 5.0'
  - `prompt` string, required — Edit prompt (required) describing the editing modifications to apply
  - `inputImageFileIds` string[], required — Reference image file IDs (required). These are the file IDs of images to be edited.
  - `aspectRatio` string — Aspect ratio, e.g., '1:1', '16:9', '9:16', '4:3', 'auto' (auto means follow input image ratio)
  - `generateCount` integer — Number of edited images to generate (1-4)
  - `resolution` string — Resolution, e.g., '1K', '2K', '4K', '512p'
  - `boardId` string — Board ID (optional). If provided, the task will be associated with this board.
  - `noticeUrl` string — Callback URL for task completion notifications (optional). The system will send a POST request to this URL when the task is completed with task status and results.

## Response `200`

Task submitted successfully

- object
  - `code` string — Response code
  - `message` string — Response message
  - `result` object
    - `taskId` string — Unique task identifier
    - `status` 'init' | 'running' | 'success' | 'fail' — Task status
    - `errorMsg` string, nullable — Error message if task submission failed
    - `subTaskId` string, nullable — Sub-task identifier (optional)
    - `boardTaskIds` string[], nullable — List of board task IDs (if task is associated with a board)
    - `boardId` string, nullable — Associated board ID (if provided in request)
    - `noticeUuid` string, nullable — UUID for callback notification tracking
    - `data` object, nullable — Additional data (if any)

---

[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)