Tasks and Polling

• ImageGenerationResult for completed work
• ImageRateResult for completed rating tasks
• ImageAltResult for completed alt text tasks
• TaskAsync for in-progress work

​

ImageGenerationResult

• result.id
• result.status
• result.result
• result.urls
• result.getImages()
• result.getImages({ includeFailed: true })
• result.getMetadata()

const result = await mynth.image.generate({
  prompt: "An orange bicycle leaning against a sunlit stone wall",
  metadata: { requestId: "req_123" },
});

console.log(result.urls);
console.log(result.getMetadata());

​

ImageRateResult and ImageAltResult

const rating = await mynth.image.rate({ url: "https://..." });
console.log(rating.level); // "sfw" | "nsfw"
console.log(rating.url);
console.log(rating.cost);

const altText = await mynth.image.alt({ url: "https://..." });
console.log(altText.alt);
console.log(altText.url);

​

TaskAsync

const task = await mynth.image.generateAsync(request);
const ratingTask = await mynth.image.rateAsync(request);
const altTask = await mynth.image.altAsync(request);

• task.id
• task.access.publicAccessToken
• task.wait() — polls until completion and resolves to the matching result wrapper

​

Browser-safe access token

• GET /tasks/:id/status
• GET /tasks/:id/result

​

Polling behavior

• starts polling lazily — only when first called
• reuses the same promise if called multiple times
• polls every 2.5s for the first 12s, then slows to every 5s
• times out after five minutes
• retries transient fetch failures up to 7 times, resetting the count after any successful poll

​

Error classes

• MynthAPIError
• TaskAsyncTimeoutError
• TaskAsyncUnauthorizedError
• TaskAsyncFetchError
• TaskAsyncTaskFetchError
• TaskAsyncTaskFailedError