TUIWOTUIWO
Quick start

Quick start

Create a token and run your first video task.

1. Create a token

Create an API token in the TUIWO console and bind it to a concrete group. /ai does not accept the auto group.

2. Choose a model

Find a Seedance model ID available to the current group in the console. Examples use <seedance-model-id>.

3. Create a task

curl https://ai.tuiwo.vip/ai/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer $TUIWO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<seedance-model-id>",
    "content": [
      {"type": "text", "text": "A calm lake at sunrise, cinematic lighting"}
    ]
  }'

Response:

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

id may be empty when the service has no compatible task ID; task_id is always the platform task ID.

4. Query the task

curl https://ai.tuiwo.vip/ai/api/v3/contents/generations/tasks/<id> \
  -H "Authorization: Bearer $TUIWO_API_KEY"

Poll until status becomes succeeded, failed, cancelled or expired.

5. Get the video

On success, read content.video_url. directly reachable media URLs are returned as-is; other media URLs use the platform-signed proxy valid for about 24 hours.

Next

Last updated on