메인 콘텐츠로 건너뛰기

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"])

​
응답 예시

성공적인 응답은 다음과 같을 수 있습니다. 필드 값은 모델과 요청에 따라 달라집니다. 
{
  "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 record

이 예시 model catalog 응답은 /api/models envelope와 하나의 텍스트 model record 형태를 보여줍니다. 완전한 model list는 아닙니다.
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, path, model ID를 확인하세요.
지수 백오프로 재시도하고 동시성을 줄이세요.
일시적인 제공자 또는 서비스 오류에는 백오프로 재시도하세요.
구현 패턴은 Error codes and retry strategy 및 Rate limits and concurrency를 참조하세요.

​
가격 및 model directory

Models page

CometAPI가 문서에서 model ID를 어떻게 노출하는지 읽어보세요.

Model directory

model의 사용 가능 여부와 기능을 살펴보세요.

Pricing

model을 호출하기 전에 가격을 확인하세요.
Last modified on May 28, 2026