跳轉到主要內容

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 文字模型文件。若是 OpenAI 相容的聊天，請從 Chat Completions 或 Responses 開始；若是供應商原生格式，則使用對應的供應商頁面。

​
選擇文字 API

Chat Completions

使用 messages 陣列傳送與 OpenAI 相容的聊天訊息。

Responses

透過 Responses API 使用推理、多模態輸出和內建工具。

Anthropic Messages

使用供應商原生欄位呼叫相容於 Claude 的 Messages 工作流程。

Gemini content generation

傳送 Gemini 原生內容生成請求。

​
呼叫文字模型

請使用 Models page 或 model directory 中任何支援文字的 model ID。以下範例會呼叫與 OpenAI 相容的 Chat Completions 端點。
這些範例使用預留位置 your-model-id。在執行請求前，請將其替換為 Models page 或 model directory 中可用的文字 model ID。
import os
import requests

response = requests.post(
    "https://api.cometapi.com/v1/chat/completions",
    headers={
        "Authorization": "Bearer " + os.environ["COMETAPI_KEY"],
        "Content-Type": "application/json",
    },
    json={
        "model": "your-model-id",
        "messages": [
            {
                "role": "user",
                "content": "Write one sentence about CometAPI.",
            }
        ],
    },
    timeout=30,
)

response.raise_for_status()
result = response.json()
print(result["choices"][0]["message"]["content"])

​
回應範例

成功回應可能如下所示。欄位值會因 model 和請求而異： 
{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1779960520,
  "model": "your-model-id",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "CometAPI lets developers route model requests through one API surface."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 14,
    "total_tokens": 26
  }
}

​
範例 model 記錄

此範例 model 目錄回應顯示 /api/models 包裝結構以及一筆文字 model 記錄的格式。這不是完整的 model 清單。
cURL
curl https://api.cometapi.com/api/models

{
  "success": true,
  "page": 1,
  "page_size": 20,
  "total": 302,
  "data": [
    {
      "created": 1773798949,
      "id": "your-text-model-id",
      "code": "your-text-model-id",
      "provider": "ExampleProvider",
      "provider_code": "example",
      "name": "Example text model",
      "model_type": "text",
      "features": [
        "text-to-text"
      ],
      "endpoints": "{\n  \"openai-chat\": {\n    \"path\": \"/v1/chat/completions\",\n    \"method\": \"POST\"\n  }\n}",
      "pricing": {
        "currency": "USD / M Tokens",
        "input": 0.5,
        "output": 1.5,
        "per_request": null,
        "per_second": null
      }
    }
  ]
}

​
常見錯誤

傳送 Authorization: Bearer $COMETAPI_KEY。
對於與 OpenAI 相容的請求，請使用 https://api.cometapi.com/v1。
請從 Models page 選擇支援文字的 model。
移除可選欄位，然後一次加回一個欄位。

​
錯誤代碼與重試策略

在修正請求主體之前不要重試。
在 API key 存在且有效之前不要重試。
重試前請檢查 base URL、路徑和 model ID。
請以指數退避方式重試，並降低並發量。
對暫時性的供應商或服務錯誤，請以退避方式重試。
如需實作模式，請參閱 Error codes and retry strategy 與 Rate limits and concurrency。

​
定價與 model 目錄

Models page

閱讀 CometAPI 如何在文件中公開 model ID。

Model directory

瀏覽 model 的可用性與能力。

Pricing

在呼叫 model 之前先查看定價。
Last modified on May 28, 2026