APIs de texto e chat

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

Escolha uma API de texto e chat

Criar uma conclusão de chat

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

Criar uma resposta do modelo

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

Criar uma Message

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

Gerar conteúdo

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

Chamar um modelo de texto

Use qualquer model ID com capacidade de 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 solicitaçã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"])

const response = await fetch("https://api.cometapi.com/v1/chat/completions", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "your-model-id",
    messages: [
      {
        role: "user",
        content: "Write one sentence about CometAPI.",
      },
    ],
  }),
});

if (!response.ok) {
  throw new Error(await response.text());
}

const result = await response.json();
console.log(result.choices[0].message.content);

curl https://api.cometapi.com/v1/chat/completions \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "messages": [
      {
        "role": "user",
        "content": "Write one sentence about CometAPI."
      }
    ]
  }'

Exemplo de resposta

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

Registos de modelo de exemplo

Esta resposta de exemplo do catálogo de modelos mostra o envelope de /api/models e o formato de um registo 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

API key em falta ou inválida

Envie Authorization: Bearer $COMETAPI_KEY.

URL base incorreta

Use https://api.cometapi.com/v1 para pedidos compatíveis com OpenAI.

Tipo de modelo incorreto

Escolha um modelo com capacidade de texto na página de modelos.

Erro de parâmetro específico do provider

Remova os campos opcionais e, em seguida, volte a adicioná-los um de cada vez.

Códigos de erro e estratégia de retry

400

Não tente novamente até que o corpo do pedido seja corrigido.

401

Não tente novamente até que a API key esteja presente e seja válida.

404

Verifique a URL base, o caminho e o model ID antes de tentar novamente.

429

Tente novamente com exponential backoff e reduza a concorrência.

500 or 503

Tente novamente com backoff para erros transitórios do provider ou do serviço.

Para padrões de implementação, consulte Códigos de erro e estratégia de retry e Limites de taxa e concorrência.

Preços e diretório de modelos

Página de modelos

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

Diretório de modelos

Explore a disponibilidade e as capacidades dos modelos.

Preços

Verifique os preços antes de chamar um modelo.

Moderação de conteúdo

Chaves de API

Escolha uma API de texto e chat

Criar uma conclusão de chat

Criar uma resposta do modelo

Criar uma Message

Gerar conteúdo

Chamar um modelo de texto

Exemplo de resposta

Registos de modelo de exemplo

Erros comuns

Códigos de erro e estratégia de retry

Preços e diretório de modelos

Página de modelos

Diretório de modelos

Preços

​Escolha uma API de texto e chat

Criar uma conclusão de chat

Criar uma resposta do modelo

Criar uma Message

Gerar conteúdo

​Chamar um modelo de texto

​Exemplo de resposta

​Registos de modelo de exemplo

​Erros comuns

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

​Preços e diretório de modelos

Página de modelos

Diretório de modelos

Preços

Escolha uma API de texto e chat

Chamar um modelo de texto

Exemplo de resposta

Registos de modelo de exemplo

Erros comuns

Códigos de erro e estratégia de retry

Preços e diretório de modelos