Saltar para o conteúdo principal

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.

Use a documentação de modelos de texto do CometAPI combinando o formato da sua requisição com a página que o implementa. Para chat compatível com OpenAI, comece com Chat Completions ou Responses; para formatos nativos do provedor, use a página correspondente do provedor.

​
Escolha uma API de texto

Chat Completions

Envie mensagens de chat compatíveis com OpenAI com um array messages.

Responses

Use raciocínio, saída multimodal e ferramentas integradas por meio da API Responses.

Anthropic Messages

Chame fluxos de trabalho Messages compatíveis com Claude com campos nativos do provedor.

Gemini content generation

Envie requisições nativas de geração de conteúdo do Gemini.

​
Chame um modelo de texto

Use qualquer model ID com suporte a texto da página Models ou do diretório de modelos. Os exemplos abaixo chamam o endpoint Chat Completions compatível com OpenAI.
Estes exemplos usam o placeholder your-model-id. Substitua-o por um model ID de texto disponível na página Models ou no diretório de modelos antes de executar a requisição.
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"])

​
Exemplo de resposta

Uma resposta bem-sucedida pode se parecer com esta. Os valores dos campos variam conforme o modelo e a requisição: 
{
  "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
  }
}

​
Exemplos de registros de modelo

Esta resposta de exemplo do catálogo de modelos mostra o envelope /api/models e o formato de um registro de modelo de texto. Não é uma lista completa de modelos.
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
      }
    }
  ]
}

​
Erros comuns

Envie Authorization: Bearer $COMETAPI_KEY.
Use https://api.cometapi.com/v1 para requisições compatíveis com OpenAI.
Escolha um modelo com suporte a texto na página Models.
Remova os campos opcionais e, em seguida, adicione-os de volta um de cada vez.

​
Códigos de erro e estratégia de retry

Não tente novamente até corrigir o corpo da requisição.
Não tente novamente até que a chave de API esteja presente e válida.
Verifique a URL base, o path e o model ID antes de tentar novamente.
Tente novamente com backoff exponencial e reduza a concorrência.
Tente novamente com backoff para erros transitórios do provedor ou do serviço.
Para padrões de implementação, veja Error codes and retry strategy e Rate limits and concurrency.

​
Preços e diretório de modelos

Página Models

Leia como o CometAPI expõe model IDs na documentação.

Diretório de modelos

Navegue pela disponibilidade e pelas capacidades dos modelos.

Preços

Verifique os preços antes de chamar um modelo.
Last modified on May 28, 2026