Skip to main content

How It Works

All generation requests in ModelHunter.AI are asynchronous. When you submit a request, you receive a task ID immediately. The actual generation happens in the background.

Task Lifecycle

Every task progresses through these states:

Getting Results

There are two ways to receive results:

Option 1: Polling (Simple)

Poll GET /api/v1/tasks/{id} until the status is succeeded or failed.
Recommended polling interval: Start at 2 seconds, increase to 5 seconds after 30 seconds. Pass a webhookUrl in the generation request. ModelHunter.AI will POST the result directly to your server when the task completes.
See Webhooks for full details on payload format and signature verification.

Result URLs

Result URLs are signed URLs valid for 15 minutes. If a URL expires, fetch the task again to get a fresh URL.