Get Task | Yeehoo Developers

This is the recommended default task lookup endpoint.

GET /v1/tasks/{task_id}

Overview

Item	Description
Route	`GET /v1/tasks/{task_id}`
Auth	`Authorization: Bearer sk_yeehoo_xxx`
Path parameter	`task_id`
Response	`200 OK` + task object

Why use this endpoint

One status checker for both image and video tasks
Easier to build a single application-side state machine
Works well together with webhook delivery

Authorizations

Authorization: Bearer sk_yeehoo_your_api_key

Path Parameters

Parameter	Type	Required	Description
`task_id`	`string`	Yes	Task ID returned by task creation

Response

{
  "task_id": "task_01jxyz...",
  "object": "task",
  "kind": "image",
  "model": "gpt-image-2",
  "status": "succeeded",
  "progress": 100,
  "created_at": 1784779200,
  "completed_at": 1784779260,
  "result": {
    "data": [
      { "url": "https://cdn.aibubu.cn/generated/image.png" }
    ]
  }
}

Response fields

Field	Type	Description
`task_id`	`string`	Task ID
`kind`	`string`	Task type such as `image` or `video`
`model`	`string`	Actual execution model
`status`	`string`	Current state such as `queued`, `running`, `succeeded`, `failed`
`progress`	`integer`	Task progress
`created_at`	`integer`	Creation timestamp
`completed_at`	`integer`	Completion timestamp
`result`	`object`	Success payload
`error`	`object`	Failure payload

Terminal states are succeeded, failed, canceled, and expired. completed_at is returned after completion and is normally omitted while running; do not rely on a fixed 0.

Successful results

result.data is the list of generated assets. Every item includes the platform-hosted url; video outputs additionally include thumbnail_url when a usable cover is available.

{
  "kind": "video",
  "status": "succeeded",
  "result": {
    "data": [
      {
        "url": "https://cdn.aibubu.cn/generated/video.mp4",
        "thumbnail_url": "https://cdn.aibubu.cn/generated/cover.png"
      }
    ]
  }
}

Public API responses never expose provider payloads, routing details, internal billing, or usage. Use top-level kind to distinguish the output; url is always present and thumbnail_url is returned only for video with an available cover.

Download and archive outputs when your business requires long-term retention; do not treat platform URLs as a permanent-storage guarantee.

Integration notes

Even after receiving a webhook, it is still safer to query the task once more in critical flows
Avoid polling too aggressively; use a fixed interval or backoff
Treat task lookup as the final source of truth