Início → Guias → Chatbox com uma API personalizada: host, caminho, Claude e geração de imagens

Chatbox com uma API personalizada: host, caminho, Claude e geração de imagens

No Chatbox, uma API personalizada pode dar errado em três lugares: no par Anfitrião da API / Caminho da API, no modo Claude que exige /v1 quando o Claude Code proíbe, e no Criador de Imagens, que ignora completamente os fornecedores personalizados. Lemos o código-fonte do Chatbox 1.23.5, testamos cada combinação no nosso gateway e reunimos os erros de usuários reais.

Adicionando o fornecedor

1. Abra Definições → Fornecedor do Modelo e clique em Adicionar fornecedor personalizado. Dê um nome e escolha Compatível com API OpenAI em Modo API.
2. Digite https://apiclan.us como Anfitrião da API e deixe o Caminho da API vazio.
3. Cole sua chave de API do console.
4. Clique em Obter para carregar os modelos do grupo da sua chave e depois em Verificar.

Anfitrião da API	Caminho da API	O Chatbox chama
https://apiclan.us	(vazio)	/v1/chat/completions ✓
https://apiclan.us/v1	/chat/completions	/v1/chat/completions ✓
https://apiclan.us	/chat/completions	/chat/completions ✗ 404

O Chatbox só acrescenta /v1 ao host quando o Caminho da API está vazio. Assim que você digita um caminho, o host é usado como está — então https://apiclan.us com /chat/completions pula o /v1 e devolve um 404 com corpo vazio. Deixe o caminho vazio ou coloque /v1 no host.

Adicionando o Claude

Há duas formas, e a regra do endereço muda:

Modo API	Anfitrião da API	O Chatbox chama
Compatível com API OpenAI	https://apiclan.us	/v1/chat/completions ✓
Compatível com API Claude	https://apiclan.us/v1	/v1/messages ✓
Compatível com API Claude	https://apiclan.us	/messages ✗ 404

O mais simples é um segundo fornecedor personalizado no modo Compatível com API OpenAI com uma chave de um grupo Claude — 29 das 43 requisições do Chatbox registradas foram claude-fable-5-1 enviado exatamente assim. Se preferir Compatível com API Claude, o host precisa terminar em /v1, porque o Chatbox só acrescenta /messages. É o oposto do Claude Code, em que ANTHROPIC_BASE_URL não pode ter /v1.

Gerando imagens no Chatbox

O Criador de Imagens só lista o fornecedor OpenAI embutido (além do próprio Chatbox e do Gemini). Fornecedores personalizados estão programados para não ter modelo de imagem e falham com Provider doesnt support image generation.

1. Abra Definições → Fornecedor do Modelo → OpenAI (o embutido, não o seu fornecedor personalizado).
2. Coloque https://api.apiclan.us no Anfitrião da API e cole uma chave criada em um grupo de imagens.
3. Adicione o modelo gpt-image-2.5 e defina o Tipo de Modelo como Imagem.
4. Abra o Criador de Imagens e escolha gpt-image-2.5.

Mantenha os modelos de chat no fornecedor personalizado: cada chave pertence a um só grupo, então a chave de imagens no fornecedor OpenAI não roda os modelos de chat GPT. Usamos api.apiclan.us aqui porque uma imagem grande pode levar minutos e o endereço principal corta as respostas aos 100 segundos. Nossa requisição de teste no formato do Chatbox devolveu uma imagem de 1024×1024 em 21 segundos.

Quanto custam requisições reais do Chatbox

Todas as 43 requisições do Chatbox recebidas pelo nosso gateway nos 30 dias até 12 de outubro de 2026, todas em streaming via /v1/chat/completions:

Modelo	Requisições	Primeiro token (mediana)	Média por mensagem
claude-fable-5-1	29	5.2 s	$0.039
gpt-6-astra	8	1.4 s	$0.006
gpt-5.6-sol	6	7.6 s	$0.004

Uma resposta do Claude custou cerca de sete vezes uma resposta do GPT, principalmente porque as respostas foram mais longas (622 tokens de saída em média). O Chatbox reenvia a conversa inteira a cada turno, mas no Claude uma média de 4.071 tokens por requisição foi cobrada como leitura de cache em vez de entrada a preço cheio, o que mantém conversas longas acessíveis. O gpt-5.6-sol foi o mais barato, mas o mais lento para começar, porque raciocina antes de responder.

Erros que usuários reais do Chatbox tiveram

• 404 com corpo vazio → um Caminho da API sem /v1 no host, ou Compatível com API Claude sem /v1. Veja as tabelas acima.
• 400 This model is not supported on the Chat Completions endpoint → o gpt-image-2.5 foi escolhido como modelo de chat. Modelos de imagem só funcionam no Criador de Imagens.
• 403 Image generation is not enabled for this group → a chave no fornecedor OpenAI não é de um grupo de imagens.
• 404 model_not_found (is not supported by any configured account in this group) → o modelo não está no grupo da sua chave (um usuário digitou gpt-5.2-pro, que não oferecemos). Use Obter em vez de digitar nomes.
• Provider doesnt support image generation → o Criador de Imagens está apontando para um fornecedor personalizado. Use o fornecedor OpenAI embutido.

Outros clientes de desktop: Cherry Studio com uma API personalizada · URL base para o Claude Code.

Comece a usar

Sem assinatura, sem mínimo mensal, sem conversa com vendedor. Recarregue com USDT e gaste o que usar — 1 USDT dá 2 créditos de saldo de API.

Leia o início rápido de 30 segundos

Idioma: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

Os preços desta página são preenchidos automaticamente com dados reais de cobrança. Condições de terceiros são citadas da documentação deles.