> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 使用常見問題

> 關於 CometAPI 使用方式的常見問題，包括 model 選擇、OpenAI 相容的 Claude 用法、嵌入、API 錯誤代碼與帳戶基礎資訊。

## **1. 文字轉圖片生成應該使用哪些模型？**

請先從 [Models 頁面](/zh-Hant/overview/models) 查看目前可用的模型，接著再到 [pricing page](https://www.cometapi.com/models/) 確認價格。

如果你正在不同供應商之間做選擇，請先聚焦於你需要的工作流程：

* 文字轉圖片生成
* 圖片編輯或變體工作流程
* API 參考文件中顯示的供應商特定請求格式

請求範例請參考 [Quick Start](/zh-Hant/overview/quick-start) 與對應的圖片 API 文件。

***

## **2. 文字轉影片生成應該使用哪些模型？**

請先從 [Models 頁面](/zh-Hant/overview/models) 查看目前可用的影片模型，接著再到 [pricing page](https://www.cometapi.com/models/) 確認價格。

如果你需要非同步任務處理、輪詢或供應商特定的請求格式，請以 [Quick Start](/zh-Hant/overview/quick-start) 和相關影片 API 文件作為參考。

***

## **3. 我可以使用 o-series 推理模型嗎？**

可以。請查看 [Models 頁面](/zh-Hant/overview/models) 以取得可用的 o-series model ID，然後使用相同的 CometAPI base URL 和 API key 呼叫你需要的模型。

***

## **4. CometAPI 支援文字嵌入嗎？**

支援。CometAPI 支援嵌入模型以及相關的 OpenAI 相容工作流程。

***

## **5. API 介面錯誤回傳代碼的含義**

請以 [Error Codes & Handling](/zh-Hant/errors/error-codes-handling) 作為權威參考。

該頁面說明了 CometAPI 對 `400`、`401` 與路徑/base URL 錯誤的實際行為，並提供 `429` 與逾時類錯誤的實用重試指引。

***

## **6. 介面支援 OpenAI 微調嗎？**

**不支援微調（Fine-tuning）。**\
原因：CometAPI 是聚合型 API 平台，而微調需要專屬於帳戶端的擁有權與生命週期管理。

***

## **7. 支援與開源軟體整合嗎？**

支援。CometAPI 可搭配許多開源工具與本機應用程式使用，包括 **ChatBox**、**Dify** 和 **Cline**。

設定細節請參閱文件中的相關整合指南。

***

## **8. Claude 支援 MCP 嗎？支援 v1/messages 介面嗎？**

不支援此介面（`v1/messages`）。
如果你需要使用 Claude，請透過 OpenAI 相容路徑，搭配 [Models 頁面](/zh-Hant/overview/models) 中的 Claude model ID。

***

## **9. 我可以使用 `.env` 檔案來儲存 API key 嗎？**

可以。請將 key 儲存在你的 `.env` 檔案中，並確認 **Base URL** 與你使用的請求格式相符。

對於 OpenAI 相容範例，常見的 Base URL 是 `https://api.cometapi.com/v1`。

***

## **10. 範例程式碼使用 OpenAI，我可以改成使用 Claude 4.6 嗎？**

可以。如果範例使用的是 OpenAI 相容 SDK 或請求格式，你通常只需要：

1. 保持相同的 CometAPI base URL 和 API key。
2. 將 **`model`** 的值改為 [Models 頁面](/zh-Hant/overview/models) 中的 Claude 4.6 model ID。
3. 除非你選擇的模型需要供應商特定參數，否則其餘請求格式維持不變。

除非你想改用 Anthropic 原生的 Messages 格式，否則不需要切換 SDK。

***

## **11. 我該如何將影片傳送給 Gemini 模型？**

CometAPI 不支援將影片上傳到獨立的 Gemini Files API 路徑，並在之後重複使用該已上傳檔案。

對於 Gemini `generateContent`，請直接在請求中傳送影片：

* 對於你以 base64 編碼的本機影片，使用 `inlineData`。
* 對於公開的 HTTPS 影片 URL，使用 `fileData.fileUri`。

可複製的 curl 範例請參閱 [Gemini 產生內容](/api/text/gemini-generating-content)。

***

## **12. 我如何找回忘記的密碼？**

1. 在登入頁面上，點擊 **「重設密碼」** 按鈕。
2. 依照提示輸入註冊時使用的電子郵件地址。
3. 檢查您的電子郵件，並依照郵件中的說明完成密碼重設。

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "FAQPage",
        "@id": "https://apidoc.cometapi.com/support/confusion-about-use",
        "url": "https://apidoc.cometapi.com/support/confusion-about-use",
        "name": "使用常見問題",
        "description": "關於 CometAPI 使用的常見問題，涵蓋模型選擇、與 OpenAI 相容的 Claude 用法、嵌入、API 錯誤碼與帳戶基本問題。",
        "mainEntity": [
          {
            "@type": "Question",
            "name": "文字轉圖片生成應該使用哪些模型？",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "先從 Models 頁面查看目前可用的模型，然後到 pricing 頁面確認價格。如果您正在不同供應商之間做選擇，請先專注於您需要的工作流程：- 文字轉圖片生成 - 圖片編輯或變體工作流程 - API 參考文件中顯示的供應商特定請求格式 如需請求範例，請參閱 Quick Start 與對應的圖片 API 文件。"
            }
          },
          {
            "@type": "Question",
            "name": "文字轉影片生成應該使用哪些模型？",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "先從 Models 頁面查看目前可用的影片模型，然後到 pricing 頁面確認價格。如果您需要非同步任務處理、輪詢或供應商特定的請求格式，請以 Quick Start 與相關影片 API 文件作為參考。"
            }
          },
          {
            "@type": "Question",
            "name": "我可以使用 o-series 推理模型嗎？",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "可以。請先到 Models 頁面查看可用的 o-series model ID，然後使用相同的 CometAPI base URL 和 API key 呼叫您需要的模型。"
            }
          },
          {
            "@type": "Question",
            "name": "CometAPI 支援文字嵌入嗎？",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "支援。CometAPI 支援嵌入模型以及相關的 OpenAI 相容工作流程。"
            }
          },
          {
            "@type": "Question",
            "name": "API 介面錯誤回傳碼的含義",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "請以 Error Codes & Handling 作為權威參考。該頁面涵蓋了 CometAPI 在 400、401 與 path/base URL 錯誤方面的實際行為，並提供 429 與逾時類錯誤的實用重試指引。"
            }
          },
          {
            "@type": "Question",
            "name": "介面支援 OpenAI 微調（Fine-tuning）嗎？",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "不支援微調（Fine-tuning）。原因是：CometAPI 是聚合式 API 平台，而微調需要專屬的帳戶端所有權與生命週期管理。"
            }
          },
          {
            "@type": "Question",
            "name": "是否支援與開源軟體整合？",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "支援。CometAPI 可搭配許多開源工具與本機應用程式使用，包括 ChatBox、Dify 與 Cline。設定細節請參閱文件中對應的整合指南。"
            }
          },
          {
            "@type": "Question",
            "name": "Claude 支援 MCP 嗎？支援 v1/messages 介面嗎？",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "不支援此介面（v1/messages）。如果您需要使用 Claude，請透過 OpenAI 相容路徑，並使用 Models 頁面中的 Claude model ID。"
            }
          },
          {
            "@type": "Question",
            "name": "我可以用 .env 檔案儲存 API key 嗎？",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "可以。請將 key 儲存在 .env 檔案中，並確保 Base URL 與您使用的請求格式一致。對於 OpenAI 相容範例，常見的 Base URL 是 https://api.cometapi.com/v1。"
            }
          },
          {
            "@type": "Question",
            "name": "範例程式碼使用 OpenAI，我可以改成使用 Claude 4.6 嗎？",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "可以。如果範例使用的是 OpenAI 相容的 SDK 或請求格式，通常您只需要：1. 保持相同的 CometAPI base URL 和 API key。2. 將 model 值改為 Models 頁面中的 Claude 4.6 model ID。3. 除非您選擇的模型需要供應商特定參數，否則請保持其餘請求格式不變。您不需要切換 SDK，除非您想改用 Anthropic 的 na"
            }
          },
          {
            "@type": "Question",
            "name": "如何將影片傳送給 Gemini 模型？",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "CometAPI 不支援將影片上傳到獨立的 Gemini Files API 路徑，並在之後重複使用該已上傳檔案。對於 Gemini generateContent，請直接在請求中傳送影片：- 對於您以 base64 編碼的本機影片，使用 inlineData。- 對於公開的 HTTPS 影片 URL，使用 fileData.fileUri。可複製的 curl 範例請參閱 Gemini 產生內容。"
            }
          },
          {
            "@type": "Question",
            "name": "我如何找回忘記的密碼？",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "1. 在登入頁面上，點擊「重設密碼」按鈕。2. 依照提示輸入註冊時使用的電子郵件地址。3. 檢查您的電子郵件，並依照郵件中的說明完成密碼重設。"
            }
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI 文件",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "支援",
            "item": "https://apidoc.cometapi.com/support/help-center"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "使用常見問題",
            "item": "https://apidoc.cometapi.com/support/confusion-about-use"
          }
        ]
      }
    ]
    }
    `}
</script>