MiniMax H3 Tasks API Integration Guide

Use POST https://api.acedata.cloud/minimax/tasks to retrieve, batch-retrieve, or delete task records created by /minimax/videos. Task retrieval is free and never charges the generation again.

¶ Retrieve one task

curl -X POST 'https://api.acedata.cloud/minimax/tasks' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"action":"retrieve","id":"YOUR_TASK_ID"}'

action defaults to retrieve, so a request containing only id is also valid.

¶ Batch retrieval

{
  "action": "retrieve_batch",
  "ids": ["TASK_ID_1", "TASK_ID_2"]
}

The batch response contains items and count. You can also filter your own tasks with trace_ids, application_id, created_at_min, created_at_max, offset, and limit.

¶ Delete a task record

{
  "action": "delete",
  "id": "YOUR_TASK_ID"
}

Deletion removes only the stored AceDataCloud task record. It does not cancel an already running generation or delete a video you have downloaded.