---
title: "H3 History"
method: GET
path: "/v2/hailuo/histories"
tags: ["H3 Video"]
---

# H3 History

`GET /v2/hailuo/histories`

## Request

- Base URL: `https://genaipro.io/api`
- URL: `https://genaipro.io/api/v2/hailuo/histories`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/genaipro/apis/genaipro-api/docs/v2/hailuo/histories/get.ts> (a function with typed inputs; its response is checked against the schema)

Get your `/v2/hailuo` tasks, newest first. GTMage-2.5 Sunburst / Flare image tasks are listed here too (`task_type: create_image`); for images prefer the **GTMage-2.5** endpoints.

> **Rate limit:** 60 requests/minute. Use `page_size=100` to check the status of many tasks in one request instead of polling each task.

## Query parameters

- `page` integer
- `page_size` integer

## Response `200`

Paginated history

- object
  - `data` H3Task[]
    - `id` string: Task ID (use for `GET /v2/hailuo/tasks/{id}`)
    - `prompt` string: The prompt used for generation (for Boost HD, the source task's prompt)
    - `file_urls` string[]: URLs of the generated files (empty while processing). Public; deleted about 90 days after creation (then `404`) — download them yourself.
    - `status` 'processing' | 'completed' | 'failed': Task status
    - `error` string: Error message — present only when `status` is `failed`
    - `failed_slots` object[]: Outputs that failed while the rest completed (their credits are refunded). Present only when `status` is `completed` and some outputs failed; `file_urls` contains only the generated files.
      - `index` integer: 0-based position of the failed output in the request
      - `error` string
    - `task_type` string: `text_to_video`, `frames_to_video`, `reference_to_video` or `upscale_video` (image tasks: `create_image`)
    - `aspect_ratio` string: Aspect ratio of the task — `Auto` for frames-to-video (follows the start image)
    - `model` string: Model and options of the task. Video: `<model>_<resolution>_<duration>s` (e.g. `h3_768p_10s`, `h3_max_480p_5s`); Boost HD: `upscale_<resolution>` (e.g. `upscale_1440p`).
    - `number_of_outputs` integer: Number of videos (or images) requested
    - `created_at` string, date-time: Timestamp when the task was created
  - `total` integer: Total number of items
  - `page` integer: Current page number
  - `page_size` integer: Number of items per page
  - `total_pages` integer: Total number of pages

## Other responses

- `401`: Missing or invalid API token
- `429`: Rate limit exceeded

## Changes

- **2026-10-29** `8e065c159192`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/genaipro/apis/genaipro-api/changes/v2/hailuo/histories/get.md)

---

[API](https://skmtc.dev/genaipro/apis/genaipro-api.md) - [All operations](https://skmtc.dev/genaipro/apis/genaipro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/genaipro/apis/genaipro-api/revisions/264ca07ba262?raw)