Tasks & Polling

Image and video generation are asynchronous.

Tasks and their generated assets are permanently scoped to the API key's team workspace; request headers cannot move them to another workspace.

Lifecycle

• queued
• running
• succeeded
• failed

Polling endpoint

curl https://aibubu.ai/v1/tasks/task_image_xxx \
  -H "Authorization: Bearer sk_yeehoo_your_key"

Suggested polling cadence

• First 30 seconds: every 2 to 3 seconds
• Long-running video jobs: every 5 to 10 seconds
• Stop polling on succeeded or failed

Response handling

When the task succeeds, keep the terminal response as source of truth for:

• status
• result.data[].url
• optional result.data[].thumbnail_url for video

Provider payloads, internal usage, and billing details are not exposed.

Webhook is a notification channel. Polling remains the canonical fallback.