申請フロー
MiniMax H3 タスク照会 API を使用するには、まず Ace Data Cloud コンソール で API Token を取得し、控えておきます。
まだログインまたは登録していない場合は、自動的にログインページへ移動し、登録とログインを促されます。完了すると自動的に現在のページへ戻ります。
1 つの API Token でプラットフォーム上のすべてのサービスを呼び出すことができ、サービスごとに個別で申請する必要はありません。 初回申請時には無料枠が付与され、無料でお試しいただけます。残高が不足した場合は、コンソール で共通残高をチャージできます。
📘 完全なドキュメント：MiniMax H3 タスク照会 API →タスクを照会する際は、そのタスクを作成したものと同じ 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 秒ごとに照会し、タスクが終端状態に入るまで続けることを推奨します。
リクエストパラメータ
3 種類のアクションの用途は次のとおりです。
単一タスクの照会
タスクステータス
succeeded、failed、および cancelled はすべて終端状態です。終端状態に入った後はポーリングを継続しないでください。
task レスポンスフィールド
Python ポーリング完全例
以下のコードは環境変数から Token を読み取り、タスク作成後に 10 秒ごとに 1 回クエリします：429 および一時的な 5xx に対して指数バックオフを使用する必要があります。ネットワークタイムアウトは生成失敗を意味するものではなく、同じ task_id を使用してクエリを継続できます。
一括クエリ
複数のタスク ID を指定します：items は単一タスククエリと同じ task フィールドを使用し、total はフィルタ条件に一致するタスクの総数です：
task_id は無効なタスクを返す可能性があります。業務システムではタスク作成時に ID を保存し、成功後に結果 URL を速やかに永続化する必要があります。
タスクのキャンセルまたは削除
削除成功の例：
失敗レスポンスとトラブルシューティング
失敗したタスクも HTTP 200 で task オブジェクトを返し、理由はtask.error に示されます：
400 を返す場合は action と条件パラメータを確認する必要があります。401 は Token が無効であることを示し、429 はクエリ頻度が高すぎることを示し、500 はサービスが一時的に利用できないことを示します。生成に失敗したタスクは課金されません。成功したタスクは最終的な usage に基づいて使用量が記録されます。