> ## 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.

# 搭配 OpenAI SDK 使用 CometAPI

> 透過設定 CometAPI API key 與 base URL，為 CometAPI 設定 OpenAI Python 與 Node.js SDK。

透過變更兩個 client 設定即可將 OpenAI SDK 搭配 CometAPI 使用：API key 與 base URL。保留你現有、相容 OpenAI 的請求程式碼，接著將 model ID 替換為可用的 CometAPI model ID。

## 安裝 SDK

以下指令會安裝 OpenAI Python SDK：

```bash theme={null}
pip install openai
```

以下指令會安裝 OpenAI Node.js SDK：

```bash theme={null}
npm install openai
```

## Python client

以下 Python 範例會建立一個 CometAPI client 並送出聊天請求：

```python theme={null}
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["COMETAPI_KEY"],
    base_url="https://api.cometapi.com/v1",
)

completion = client.chat.completions.create(
    model="your-model-id",
    messages=[
        {
            "role": "user",
            "content": "Answer in one short sentence: What is CometAPI?",
        }
    ],
)

print(completion.choices[0].message.content)
```

回應物件包含 assistant 訊息：

```json theme={null}
{
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "CometAPI provides API access to models from multiple providers."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 16,
    "completion_tokens": 12,
    "total_tokens": 28
  }
}
```

## Node.js client

以下 Node.js 範例示範如何在 OpenAI SDK 中使用 `baseURL`：

```javascript theme={null}
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.COMETAPI_KEY,
  baseURL: "https://api.cometapi.com/v1",
});

const completion = await client.chat.completions.create({
  model: "your-model-id",
  messages: [
    {
      role: "user",
      content: "Answer in one short sentence: What is CometAPI?",
    },
  ],
});

console.log(completion.choices[0].message.content);
```

回應結構與相容 OpenAI 的聊天補全結構相同：

```json theme={null}
{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "CometAPI provides API access to models from multiple providers."
      }
    }
  ]
}
```

## 常見錯誤

| 錯誤              | 修正方式                                                 |
| --------------- | ---------------------------------------------------- |
| `401`           | 確認已設定 `COMETAPI_KEY`，且請求使用 `Bearer` 驗證。              |
| SDK 仍在呼叫 OpenAI | 在 Python 中設定 `base_url`，或在 Node.js 中設定 `baseURL`。    |
| 無效的 model ID    | 從[模型頁面](/zh-Hant/overview/models)選擇一個 model ID。      |
| 缺少 `/v1`        | 對於相容 OpenAI 的 SDK，請使用 `https://api.cometapi.com/v1`。 |

## 相關連結

* [CometAPI 快速開始](/zh-Hant/overview/quick-start)
* [聊天補全](/api/text/chat)
* [回應](/api/text/responses)
* [模型頁面](/zh-Hant/overview/models)
* [模型目錄](https://www.cometapi.com/models/)
* [定價](https://www.cometapi.com/pricing/)
* [OpenAI Python SDK](https://github.com/openai/openai-python)
* [OpenAI Node.js SDK](https://github.com/openai/openai-node)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "TechArticle",
        "@id": "https://apidoc.cometapi.com/guides/use-cometapi-with-openai-sdk",
        "headline": "如何使用 OpenAI SDK 搭配 CometAPI？",
        "description": "透過設定 CometAPI API 金鑰與 base URL，使用 OpenAI Python 與 Node.js SDK 搭配 CometAPI。",
        "url": "https://apidoc.cometapi.com/guides/use-cometapi-with-openai-sdk",
        "author": {
          "@type": "Organization",
          "name": "CometAPI"
        },
        "publisher": {
          "@type": "Organization",
          "name": "CometAPI",
          "url": "https://www.cometapi.com"
        }
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI 文件",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "指南",
            "item": "https://apidoc.cometapi.com/guides/use-cometapi-with-openai-sdk"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "如何使用 OpenAI SDK 搭配 CometAPI？",
            "item": "https://apidoc.cometapi.com/guides/use-cometapi-with-openai-sdk"
          }
        ]
      }
    ]
    }
    `}
</script>