> For the complete documentation index, see [llms.txt](https://docs.apismart.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.apismart.ai/documentation/zh-tw/api-shi-yong-liang/sheng-cheng-mei-ti-li-shi.md).

# 生成媒體歷史

了解如何擷取最近的圖片與影片生成歷史、檢視生成媒體 URL、成本、時間戳記以及儲存狀態。

ApiSmart 提供專用 API，可擷取您最近生成的圖片和影片。

使用這些端點來檢視已完成的媒體生成、存取已儲存的結果 URL、查看生成細節，並以程式方式擷取最近的輸出。

### 🖼️ 圖片歷史記錄

使用圖片歷史記錄 API 來擷取您最近生成的圖片。

**方法：** `GET`

**端點：** `/v1/images`

**完整 URL：**

`https://gw.apismart.ai/v1/images`

範例：

```bash
curl "https://gw.apismart.ai/v1/images?page=1&page_size=20" \
  -H "Authorization: Bearer <your-api-key>"
```

不需要請求本文。

#### 查詢參數

| 參數          | 類型      |  預設值 | 說明             |
| ----------- | ------- | ---: | -------------- |
| `page`      | integer |  `1` | 頁碼，從 1 開始      |
| `page_size` | integer | `20` | 每頁記錄數，最多 100 筆 |

#### 範例回應

```json
{
  "object": "list",
  "data": [
    {
      "id": "cv8k2p3l9abc",
      "model": "doubao-seedream-5-0",
      "urls": [
        "https://oss.apismart.ai/image/2026-07-16/cv8k2p3l9abc.jpg",
        "https://oss.apismart.ai/image/2026-07-16/cv8k2p3l9abc_2.jpg"
      ],
      "image_count": 2,
      "resolution": "2048x2048",
      "cost": "0.44",
      "created": 1721107800,
      "created_at": "2026-07-16 10:30:00",
      "on_our_storage": true
    }
  ],
  "page": 1,
  "page_size": 20,
  "has_more": true
}
```

#### 圖片歷史記錄欄位

| 欄位               | 說明                          |
| ---------------- | --------------------------- |
| `id`             | 生成記錄的唯一識別碼                  |
| `model`          | 用於生成的模型 ID                  |
| `urls`           | 與該次生成相關的生成圖片 URL            |
| `image_count`    | 生成的圖片數量                     |
| `resolution`     | 生成圖片解析度                     |
| `cost`           | 該次生成實際收取的金額                 |
| `created`        | 以 Unix 時間戳表示的生成時間           |
| `created_at`     | 以本地日期與時間格式表示的生成時間           |
| `on_our_storage` | 所有結果是否已轉移至 ApiSmart 管理的儲存空間 |
| `has_more`       | 是否還有下一頁結果                   |

對於多圖片或序列生成請求， `urls` 可能包含多個生成圖片結果。

### 🎬 影片歷史記錄

使用影片歷史記錄 API 來擷取最近已完成的影片生成。

**方法：** `GET`

**端點：** `/v1/videos`

**完整 URL：**

`https://gw.apismart.ai/v1/videos`

範例：

```bash
curl "https://gw.apismart.ai/v1/videos?page=1&page_size=20" \
  -H "Authorization: Bearer <your-api-key>"
```

#### 查詢參數

| 參數          | 類型      |  預設值 | 說明             |
| ----------- | ------- | ---: | -------------- |
| `page`      | integer |  `1` | 頁碼，從 1 開始      |
| `page_size` | integer | `20` | 每頁記錄數，最多 100 筆 |

#### 範例回應

```json
{
  "object": "list",
  "data": [
    {
      "id": "cv9m4x7q2def",
      "task_id": "task_2026xxxxxx",
      "model": "happyhorse-1.0",
      "urls": [
        "https://oss.apismart.ai/video/2026-07-16/cv9m4x7q2def.mp4"
      ],
      "duration": 5,
      "resolution": "720p",
      "cost": "0.725",
      "created": 1721107800,
      "created_at": "2026-07-16 10:30:00",
      "on_our_storage": true
    }
  ],
  "page": 1,
  "page_size": 20,
  "has_more": false
}
```

#### 影片歷史記錄欄位

| 欄位               | 說明                     |
| ---------------- | ---------------------- |
| `id`             | 生成影片記錄的唯一識別碼           |
| `task_id`        | 與該次生成相關的影片任務 ID        |
| `model`          | 用於生成的模型 ID             |
| `urls`           | 生成影片 URL               |
| `duration`       | 生成影片長度（秒）              |
| `resolution`     | 生成影片解析度                |
| `cost`           | 該次生成實際收取的金額            |
| `created`        | 以 Unix 時間戳表示的生成時間      |
| `created_at`     | 以本地日期與時間格式表示的生成時間      |
| `on_our_storage` | 影片是否已轉移至 ApiSmart 儲存空間 |
| `has_more`       | 是否還有下一頁結果              |

只有 **成功生成的影片** 才會顯示在影片歷史記錄中。

排隊中、執行中、失敗或已取消的影片任務不包含在內。

### 🔄 影片歷史記錄 vs. 影片任務狀態

影片歷史記錄和影片任務狀態用途不同。

| API                        | 用途              |
| -------------------------- | --------------- |
| `GET /v1/video/tasks/{id}` | 檢查特定影片生成任務的目前狀態 |
| `GET /v1/videos`           | 檢視最近已完成的影片生成    |

當影片仍在生成時，使用任務端點。

在生成成功後，若要檢視已完成結果，請使用影片歷史記錄。

### 💾 媒體儲存狀態

該 `on_our_storage` 欄位表示生成的媒體是否已轉移至由 ApiSmart 管理的儲存空間。

#### `true`

生成的媒體已轉移至 ApiSmart 儲存空間。

#### `false`

結果可能仍在轉移中，並可能暫時引用一個短效結果 URL。

對於重要的生成媒體，請將最終結果儲存到您自己的儲存空間，而不要把歷史記錄或暫時 URL 當作永久儲存。

### 🕘 歷史記錄可用性

圖片和影片歷史記錄端點目前可讓您查詢最近 **7 天**.

超出可用歷史記錄時間範圍的記錄，無法透過這些清單端點擷取。

對於圖片，生成的檔案可能會在可搜尋的歷史索引之外保留更久，因此在歷史記錄 API 不再可用之前，應先儲存重要的輸出 URL 或檔案。

> 生成媒體歷史記錄是為了檢視最近結果，而不是作為永久媒體儲存空間。

### 💰 檢視生成成本

圖片和影片歷史記錄都可能包含一個 `cost` 欄位，顯示該次生成的實際收費金額。

當您想查看特定媒體結果的相關成本時，請使用此欄位。

若要查看更廣泛的請求層級用量與成本資訊，請使用 [**用量記錄與成本**](https://docs.apismart.ai/documentation/zh-tw/api-shi-yong-liang/shi-yong-ji-lu-yu-cheng-ben.md).

若要了解圖片與影片成本的計算方式，請參閱 [**模型定價與計費**](https://docs.apismart.ai/documentation/zh-tw/mo-xing-yu-jia-ge/mo-xing-jia-ge-yu-ji-fei.md).

### 🔍 何時使用生成媒體歷史記錄

當您需要以下用途時，生成媒體歷史記錄很有用：

* 檢視最近生成的圖片或影片
* 擷取先前生成的媒體 URL
* 查看是哪個模型產生了結果
* 檢視生成時間
* 查看圖片數量或影片長度
* 檢視特定生成的成本
* 確認結果是否已轉移至 ApiSmart 儲存空間
* 將已完成的影片與其原始 `task_id`

### ⚠️ 如果找不到結果

如果您找不到生成結果：

1. **檢查歷史記錄時間範圍**\
   只有最近的記錄可透過歷史記錄 API 取得。
2. **對於影片，請檢查任務狀態**\
   仍在 `排隊中` 或 `執行中` 的影片不會出現在影片歷史記錄中。
3. **確認生成是否成功**\
   失敗的影片任務不包含在已完成的影片歷史記錄清單中。
4. **檢查正確的帳號與 API 金鑰**\
   請確認您檢視的是與預期 ApiSmart 帳號相關的活動。

若要進行請求層級的疑難排解，請參閱 [**用量記錄與成本**](https://docs.apismart.ai/documentation/zh-tw/api-shi-yong-liang/shi-yong-ji-lu-yu-cheng-ben.md) 以及 [**HTTP 狀態碼與 API 錯誤**](https://docs.apismart.ai/documentation/zh-tw/yi-nan-pai-jie/http-zhuang-tai-ma-yu-api-cuo-wu.md).

### ➡️ 下一步

繼續查看：

* [**用量記錄與成本**](https://docs.apismart.ai/documentation/zh-tw/api-shi-yong-liang/shi-yong-ji-lu-yu-cheng-ben.md) — 檢視請求層級的用量、效能與成本
* [**圖片生成 API**](https://docs.apismart.ai/documentation/zh-tw/api-zhi-nan/tu-pian-sheng-cheng-api.md) — 生成與編輯圖片
* [**影片生成 API**](https://docs.apismart.ai/documentation/zh-tw/api-zhi-nan/ying-pian-sheng-cheng-api.md) — 建立並查詢影片生成任務
* [**模型定價與計費**](https://docs.apismart.ai/documentation/zh-tw/mo-xing-yu-jia-ge/mo-xing-jia-ge-yu-ji-fei.md) — 了解圖片與影片計費
* [**HTTP 狀態碼與 API 錯誤**](https://docs.apismart.ai/documentation/zh-tw/yi-nan-pai-jie/http-zhuang-tai-ma-yu-api-cuo-wu.md) — 排解 API 失敗
