Процесс получения
Чтобы использовать API запросов задач MiniMax H3, сначала получите ваш API Token в консоли Ace Data Cloud и сохраните его для дальнейшего использования.
Если вы ещё не вошли в систему или не зарегистрировались, вы будете автоматически перенаправлены на страницу входа, где вам будет предложено зарегистрироваться и войти в систему, после завершения вы автоматически вернётесь на текущую страницу.
Один API Token позволяет вызывать все сервисы платформы, не нужно подавать отдельную заявку для каждого сервиса. При первом получении предоставляется бесплатный лимит, позволяющий бесплатно опробовать сервис; при недостатке лимита можно пополнить общий баланс в консоли.
📘 Полная документация: API запросов задач MiniMax H3 →При запросе задачи следует использовать тот же Token, с помощью которого была создана эта задача. Рекомендуется сохранять Token в качестве переменной окружения, не записывать его в исходный код и не отправлять в репозиторий версий:
Обзор интерфейса
- Base URL：
https://api.acedata.cloud - Endpoint：
POST /minimax/tasks - Способ аутентификации：в HTTP Header передаётся
authorization: Bearer {token} - Заголовки запроса：
accept: application/jsoncontent-type: application/json
- Запрос одной задачи：
action=retrieve, передайтеid - Пакетный запрос задач：
action=retrieve_batch, можно фильтровать по ID задачи, временному диапазону и условиям пагинации - Удаление задачи：
action=delete, передайтеid - Описание тарификации：запрос задач бесплатен, повторная тарификация не производится
task_id. Рекомендуется выполнять запрос примерно раз в 10 секунд, пока задача не перейдёт в конечное состояние.
Параметры запроса
Назначение трёх действий следующее:
Запрос одной задачи
Статусы задач
succeeded, failed и cancelled являются конечными состояниями. Не продолжайте опрос после перехода в конечное состояние.
Поля ответа task
Полный пример опроса в Python
Следующий код считывает Token из переменной окружения, создаёт задачу и затем запрашивает её каждые 10 секунд:429 и временных 5xx. Сетевой тайм-аут не равнозначен неудаче генерации: можно продолжать запросы с тем же task_id.
Пакетный запрос
Укажите несколько ID задач:items в пакетном ответе использует те же поля task, что и запрос одной задачи, а total — это общее количество задач, соответствующих условиям фильтрации:
task_id, превышающий это окно, может вернуть недействительную задачу; бизнес-система должна сохранять ID при создании задачи и своевременно сохранять URL результата после успеха.
Отмена или удаление задачи
Пример успешного удаления:
Ответы об ошибках и устранение неполадок
Неудачные задачи всё равно возвращают объект task с HTTP 200 и указывают причину вtask.error:
400, следует проверить action и параметры условий; 401 означает недействительный Token, 429 означает слишком частые запросы, а 500 означает, что сервис временно недоступен. За задачи с неудачной генерацией плата не взимается; для успешных задач использование учитывается по итоговому usage.