> 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-zhi-nan/tu-pian-sheng-cheng-api.md).

# 圖片生成 API

使用 Image Generation API 搭配支援的 ApiSmart 圖像模型來建立圖片。

指定精確的 **模型 ID**，提供提示詞，並傳送所選模型所需的任何額外欄位。

關於 API 基礎 URL、驗證與一般請求規則，請參閱 [**API 基礎**](/documentation/zh-tw/api-zhi-nan/api-ji-chu.md).

***

### API 端點

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

必要標頭：

```http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

> ⚠️ **重要：** 圖像模型可能支援不同的參數和輸入類型。請務必遵循所選模型的 **程式碼範例**.

***

### 送出基本請求

以下範例顯示一個基本的文字轉圖片請求：

```bash
curl https://gw.apismart.ai/v1/images/generations \
  -H "Authorization: Bearer $APISMART_API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "model": "YOUR_MODEL_ID",
    "prompt": "晨光中的山間村莊"
  }'
```

替換 `YOUR_MODEL_ID` 替換為所選模型詳細資料頁面上顯示的精確模型 ID。

***

### 理解請求

一個基本的圖像請求可能包含：

| 欄位       | 說明          |
| -------- | ----------- |
| `model`  | 要使用的精確模型 ID |
| `prompt` | 要生成的圖像描述    |

範例：

```json
{
  "model": "YOUR_MODEL_ID",
  "prompt": "晨光中的山間村莊"
}
```

視模型而定，額外欄位可控制：

* 圖像尺寸或解析度
* 生成的圖像數量
* 圖像品質
* 參考圖像
* 圖生圖生成
* 其他模型特定設定

請勿假設每個圖像模型都接受相同的欄位或值。

***

### Python 範例

```python
import os
import requests

api_key = os.getenv("APISMART_API_KEY")

if not api_key:
    raise RuntimeError("未設定 APISMART_API_KEY。")

response = requests.post(
    "https://gw.apismart.ai/v1/images/generations",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    json={
        "model": "YOUR_MODEL_ID",
        "prompt": "晨光中的山間村莊",
    },
    timeout=120,
)

response.raise_for_status()

result = response.json()
print(result)
```

實際的回應欄位取決於所選的圖像模型。請查看該模型的 **程式碼範例** 之後，再於您的應用程式中擷取生成的圖像資料。

***

### 圖生圖與參考輸入

某些模型可能支援圖生圖生成或參考圖像工作流程。

這些模型可能需要除外的額外欄位，超出 `prompt`.

在傳送請求之前：

1. 確認所選模型支援所需的功能。
2. 請查看其 **程式碼範例**.
3. 使用其中顯示的確切欄位名稱與輸入格式。

***

### 了解計費方式

圖像模型可能使用如下計費方式：

```
$0.04/張圖片
```

定價也可能取決於模型特定設定。

請查看該模型的 **價格設定** 後，再傳送大量請求。

詳情請參閱 [**了解模型定價與計費**](/documentation/zh-tw/mo-xing-yu-ding-jia/mo-xing-ding-jia-yu-ji-fei.md).

***

### 🛠️ 常見問題

| 問題         | 檢查項目                |
| ---------- | ------------------- |
| **驗證失敗**   | API 權杖狀態與 Bearer 標頭 |
| **找不到模型**  | 精確的模型 ID 與大小寫       |
| **無效的請求**  | 必要欄位與模型特定參數         |
| **不支援的輸入** | 該模型是否支援所要求的圖像工作流程   |
| **餘額不足**   | 目前餘額與 API 權杖剩餘額度    |

排除問題時，請檢查 [**使用紀錄與成本**](/documentation/zh-tw/api-shi-yong/shi-yong-ji-lu-yu-fei-yong.md) 中的相關請求，並在可用時儲存 **Request ID** 。

> 🔐 絕不要向支援提供你的完整 API Token。

***

### 🚀 下一步

繼續進行：

* [**選擇模型並尋找其模型 ID**](/documentation/zh-tw/mo-xing-yu-ding-jia/mo-xing-yu-mo-xing-id.md)
* [**了解模型定價與計費**](/documentation/zh-tw/mo-xing-yu-ding-jia/mo-xing-ding-jia-yu-ji-fei.md)
* [**影片生成 API**](/documentation/zh-tw/api-zhi-nan/ying-pian-sheng-cheng-api.md)
* [**使用紀錄與成本**](/documentation/zh-tw/api-shi-yong/shi-yong-ji-lu-yu-fei-yong.md)