Create task

Request

POST /ai/api/v3/contents/generations/tasks
Authorization: Bearer <TUIWO_API_TOKEN>
Content-Type: application/json

{
  "model": "<seedance-model-id>",
  "content": [
    {"type": "text", "text": "A calm lake at sunrise, cinematic lighting"}
  ],
  "callback_url": "https://example.com/callback"
}

Parameters

Field	Type	Required	Description
`model`	string	yes	Model ID available to the current group
`content`	array	yes	Ark-style content array
`resolution`	string	no	Resolution; supported values depend on the model
`duration`	number	no	Duration in seconds; range depends on the model
`ratio`	string	no	Aspect ratio; support depends on the model
`seed`	number	no	Random seed
`generate_audio`	boolean	no	Whether to generate audio; support depends on the model
`callback_url`	string	no	Terminal callback URL; must be public HTTPS

Available content types (text, image, video, etc.) depend on the model and service. The Ark structure is compatible, but not every model supports every content type.

Response

{
  "id": "cgt-xxxxxxxx",
  "task_id": "task_xxxxxxxx"
}

id is the compatible task ID and may be empty.
task_id is the TUIWO platform task ID.
Do not assume id exists; use task_id or either ID for queries.

Errors

HTTP	code	Description
400	`InvalidParameter`	Invalid body, missing `model` or parse failure
401	`AuthenticationError`	Invalid token
403	`AccessDenied`	Insufficient group/model access
404	`NotFound`	Model not available in this group
409	`AmbiguousServiceConfiguration`	Multiple service configurations match
409	`SubmissionUncertain`	Submission result uncertain; query with the returned `task_id`
429	`RateLimitExceeded`	Too many requests
503	`ServiceUnavailable`	Task service unavailable

Idempotency

Creation uses platform idempotency. Do not create tasks to probe models, because it may incur charges.

Request

Parameters

Response

Errors

Idempotency

On this page