Factory

O Factory Droid é uma CLI de agente de código. Adicione a OneProvider como modelo personalizado compatível com a Anthropic em ~/.factory/settings.json.

Configuração

O Factory Droid lê os modelos com a sua própria chave (bring your own key) de ~/.factory/settings.json — não há interface web para provedores. Adicione um modelo ao array customModels; deixe o baseUrl sem /v1, porque o provedor anthropic acrescenta /v1/messages sozinho.

{
"customModels": [
{
"model": "claude-sonnet-5-5",
"displayName": "OneProvider claude-sonnet-5-5",
"baseUrl": "https://api.oneprovider.dev",
"apiKey": "sk-your-key-here",
"provider": "anthropic",
"maxOutputTokens": 8192
}
]
}

Adicione mais entradas, com outro model, para outros modelos Claude. Depois execute /model no droid e escolha o modelo em Custom models.

Atribuir modelos aos droids

Todo droid do Factory tem um modelo padrão. Use claude-sonnet-5-5 como padrão prático ou claude-opus-5-5 para trabalho pesado de arquitetura.

Qual modelo escolher

Adicione uma entrada em customModels por modelo. claude-sonnet-5-5 é o padrão prático para droids; use claude-opus-5-5 para trabalho pesado de arquitetura e claude-haiku-5-5 para droids rápidos e baratos. Mantenha provider como "anthropic". Os IDs estão na página de modelos e os valores na página de preços .

Erros comuns e soluções

404

baseUrl deve ser https://api.oneprovider.dev sem /v1: o provedor anthropic acrescenta /v1/messages sozinho.

401

A chave na entrada está cortada ou tem uma aspa sobrando. Cole a chave inteira.

O modelo não aparece em /model

Salve ~/.factory/settings.json (JSON válido, sem aspas “inteligentes”) e reabra o droid; as entradas personalizadas aparecem em Custom models.

429 “Insufficient balance”

O saldo ou o limite da chave acabou. Recarregue o saldo do painel.

Perguntas frequentes

Existe uma interface web para provedores?

Não. Os modelos com a sua própria chave só se configuram em ~/.factory/settings.json.

Posso adicionar vários modelos?

Pode, adicione um objeto por modelo ao array; a mesma chave serve para todos.

Onde vejo o custo?

Na página Consumo do Dashboard da chave.

Respostas rápidas

Qual base URL devo usar?

O Claude Code e os SDKs da Anthropic usam https://api.oneprovider.dev. Os SDKs da OpenAI e os clientes compatíveis com a OpenAI usam https://api.oneprovider.dev/v1. Uma única chave funciona nos dois; a lista de modelos está na página de modelos e os preços, na página de preços .

Como me autentico?

Envie a chave sk-… pura em x-api-key ou em Authorization: Bearer: um dos dois, nunca ambos. Guarde a chave em uma variável de ambiente, não em um arquivo que vai para o commit. Mais sobre autenticação .

Onde consigo uma chave?

Abra o seu painel no bot do Telegram @oneprovider_robot ou em app.oneprovider.dev, recarregue o saldo e toque em “Emitir chave”. Cada chave pode ter o seu próprio limite de gastos. Painel e chaves de API .

O que significam 401, 404 e 429?

401: a chave está ausente, foi digitada errado ou enviada no cabeçalho errado; cole a chave inteira, sem aspas nem espaços. 404: em geral, uma base URL errada, por exemplo um /v1 ausente ou duplicado. 429 com “Insufficient balance”: o saldo do painel ou o limite de gastos da chave acabou, então recarregue em vez de tentar de novo; qualquer outro 429 é um limite de requisições, então aguarde o tempo de Retry-After. Detalhes: códigos de erro e solução de problemas .

Por que os streams são cortados ou reiniciados?

VPNs e proxies VLESS costumam armazenar SSE em buffer ou quebrar a negociação do HTTP/2. A OneProvider não tem restrições regionais e não armazena streams em buffer; desative o proxy e tente de novo.

Onde pergunto se isso não bastar?

Escreva para @Oneproviderhelpbot no Telegram ou abra “Suporte” no painel web, informando o código de status HTTP e a mensagem de erro exata. Como funciona o suporte .