Create Task

Request

Create a task with the POST method. The request path is composed of BASE_URL and endpoint. The request body is the model parameter object itself and does not need an input wrapper.

Complete request example:

Image generation

export BASE_URL="https://cloud.seaart.ai/model"
export ENDPOINT="nano_banana_2"

curl -sS -X POST "${BASE_URL}/v1/queue/${ENDPOINT}" \
  "${COMMON_HEADERS[@]}" \
  -d '{
    "prompt": "a cinematic photo of a cat astronaut"
  }'

Video generation

export BASE_URL="https://cloud.seaart.ai/model"
export ENDPOINT="wan26_i2v"

curl -sS -X POST "${BASE_URL}/v1/queue/${ENDPOINT}" \
  "${COMMON_HEADERS[@]}" \
  -d '{
    "prompt": "a golden retriever running on the beach at sunset",
    "img_url": "https://example.com/first-frame.jpg"
  }'

Tip

The same lifecycle APIs apply to image, video, audio, and 3D models. Only replace ENDPOINT and the request-body fields.

Success response

200

{
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://cloud.seaart.ai/model/v1/queue/nano_banana_2/requests/mmsu_01hxyz.../response",
  "status_url": "https://cloud.seaart.ai/model/v1/queue/nano_banana_2/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://cloud.seaart.ai/model/v1/queue/nano_banana_2/requests/mmsu_01hxyz.../cancel",
  "queue_position": 0
}

Field	Type	Description
request_id	string	Task ID used for later status queries, result retrieval, and cancellation
response_url	string	URL for retrieving the final result
status_url	string	URL for polling task status
cancel_url	string	URL for canceling the task
queue_position	number	Queue position, currently returned as a fixed value of 0

Tip

request_id is the primary identifier for polling status, retrieving results, and canceling the task. Save it instead of relying only on returned URLs.