Chuyển đến nội dung chính

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.

Dùng tài liệu text model của CometAPI bằng cách đối chiếu định dạng request của bạn với trang triển khai nó. Với chat tương thích OpenAI, hãy bắt đầu với Chat Completions hoặc Responses; với các định dạng gốc của nhà cung cấp, hãy dùng trang tương ứng của nhà cung cấp đó.

​
Chọn một text API

Chat Completions

Gửi chat messages tương thích OpenAI với một mảng messages.

Responses

Dùng reasoning, đầu ra multimodal và các công cụ tích hợp sẵn thông qua Responses API.

Anthropic Messages

Gọi các workflow Claude-compatible Messages với các field gốc của nhà cung cấp.

Gemini content generation

Gửi các request tạo content gốc của Gemini.

​
Gọi một text model

Dùng bất kỳ model ID có hỗ trợ text nào từ Models page hoặc model directory. Các ví dụ dưới đây gọi OpenAI-compatible Chat Completions endpoint.
Các ví dụ này dùng placeholder your-model-id. Hãy thay nó bằng một text model ID khả dụng từ Models page hoặc model directory trước khi chạy request.
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"])

​
Ví dụ response

Một response thành công có thể trông như sau. Giá trị của các field thay đổi theo model và request: 
{
  "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
  }
}

​
Ví dụ bản ghi model

Response ví dụ của catalog model này hiển thị envelope /api/models và một dạng bản ghi text model. Đây không phải là danh sách model đầy đủ.
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
      }
    }
  ]
}

​
Lỗi thường gặp

Gửi Authorization: Bearer $COMETAPI_KEY.
Dùng https://api.cometapi.com/v1 cho các request tương thích OpenAI.
Chọn một model có hỗ trợ text từ Models page.
Xóa các field tùy chọn, rồi thêm lại từng field một.

​
Mã lỗi và chiến lược retry

Không retry cho đến khi phần thân request được sửa.
Không retry cho đến khi API key có mặt và hợp lệ.
Kiểm tra lại base URL, path và model ID trước khi retry.
Retry với exponential backoff và giảm concurrency.
Retry với backoff cho các lỗi tạm thời từ provider hoặc service.
Để xem các mẫu triển khai, hãy xem Error codes and retry strategy và Rate limits and concurrency.

​
Giá cả và model directory

Models page

Đọc cách CometAPI hiển thị model IDs trong tài liệu.

Model directory

Duyệt khả dụng và năng lực của model.

Pricing

Kiểm tra giá trước khi bạn gọi một model.
Last modified on May 28, 2026