# CentopeIA

> Acesso a GPT (OpenAI), Claude (Anthropic), modelos 3D a partir de imagens e modelos de imagem, vídeo, áudio e texto aberto com uma única chave, usando os SDKs oficiais de cada provedor. Consumo e limites por empresa, cobrança em reais.

## Catálogo e cobrança

- Catálogo publicado: GET https://centopeia.io/api/v1/catalog. Inclui modelos, endpoints, parâmetros, limites e revisão; a disponibilidade da sua empresa aparece no painel.
- Os exemplos abaixo ilustram a integração. A publicação no catálogo é que determina quais modelos e opções podem ser usados.
- Uma recarga adiciona reais ao saldo. A referência USDT/BRL altera o preço das próximas chamadas, sem reavaliar o saldo ou cobranças anteriores.
- Cada chamada preserva tarifa, cotação e acréscimo vigentes na admissão até a conclusão. O painel oferece extrato por operação.

## Essencial para integrar

- Uma chave CentopeIA (`sk-ctp-...`) funciona com os SDKs oficiais da OpenAI, da Anthropic e do Replicate, e com a API de modelos 3D. Use a chave e o endereço base da Centopeia. Confira os parâmetros e limites publicados para o modelo antes de integrar.
- Endereço base para GPT (SDK da OpenAI): https://centopeia.io/openai/v1
- Endereço base para Claude (SDK da Anthropic): https://centopeia.io/anthropic (o SDK completa `/v1`; em HTTP direto use https://centopeia.io/anthropic/v1)
- Endereço base para modelos 3D a partir de imagens (API compatível com a da Meshy): https://centopeia.io/meshy/openapi/v1
- Endereço base para imagem, vídeo, áudio e modelos abertos (SDK do Replicate): https://centopeia.io/replicate/v1 (no SDK Python use `base_url="https://centopeia.io/replicate"`)
- Mídia e 3D são tarefas assíncronas: crie, guarde o id e consulte até terminar. Baixe os resultados logo (1 hora para mídia, 3 dias para 3D).
- Guarde a chave na variável de ambiente `CENTOPEIA_API_KEY`. Nunca a coloque em código de navegador ou app mobile: chame a API a partir do servidor.
- Autenticação: `Authorization: Bearer <chave>` ou `x-api-key: <chave>`.
- Sempre informe o limite de saída: `max_completion_tokens` no Chat Completions, `max_output_tokens` na Responses API e `max_tokens` no Claude. Chamadas de geração de texto exigem limite de saída.
- Em streaming do Chat Completions, o último pedaço traz só o consumo, com `choices` vazio: confira antes de ler `choices[0]`.
- Modelos de exemplo: `gpt-5.5` (GPT) e `claude-sonnet-5-5` (Claude). Liste os disponíveis em `GET /models`.

## Documentação

- [Documentação completa para assistentes](https://centopeia.io/llms-full.txt): todos os exemplos em Python, Node.js e cURL, endpoints, limites e erros.
- [Documentação para pessoas](https://centopeia.io/documentacao): a mesma documentação, com navegação e exemplos copiáveis.

## Opcional

- [Lista de espera](https://centopeia.io/#lista-de-espera): pedido de acesso para novas empresas.