grok2api: converte o Grok em uma API gratuita para bate-papo e geração de imagens

O grok2api é um projeto de código aberto baseado em uma refatoração da estrutura FastAPI, com o objetivo de trazer o X (antigo Twitter) Grok O formato de chamada da Web para modelos grandes é convertido em uma interface totalmente compatível com a API OpenAI. Isso permite que os desenvolvedores integrem facilmente os recursos avançados do Grok em uma variedade de aplicativos e serviços existentes. O projeto não apenas oferece suporte a diálogos de streaming, pesquisa em rede e modos de pensamento profundo, mas também implementa recursos multimídia, como geração de imagens, edição de imagens e geração de vídeos. Para gerenciar com eficiência várias contas do Grok, o grok2api tem um mecanismo integrado de agrupamento de chamadas simultâneas e de balanceamento automático de carga, que pode monitorar e alocar o número de chamadas para cada conta em tempo real, maximizando assim o uso de recursos. O projeto também fornece um backend de gerenciamento visual para que os usuários configurem parâmetros, gerenciem contas e monitorem o status do serviço.

Lista de funções

• Compatível com a interface OpenAIOs pontos de extremidade da API fornecidos pelo projeto são totalmente compatíveis com a interface oficial da OpenAI, facilitando a migração e a integração dos desenvolvedores.
• processamento multimídiaSuporte para gerar imagens diretamente no diálogo ou vídeos baseados em imagens e palavras de alerta por meio de um modelo específico.
• Suporte a vários modelos: Suporte grok-3-fast, grok-4-fast, grok-4-expert etc. Os usuários podem escolher diferentes modelos para ligar de acordo com suas necessidades.
• Pooling de contas e balanceamento de cargaSuporte à adição de contas Grok em lote: o sistema equilibrará automaticamente o número de chamadas para todas as contas para evitar que uma única conta seja restrita devido ao uso excessivo.
• diálogo estruturadoResposta de streaming é suportada, permitindo que você produza conteúdo literalmente como um site oficial, aprimorando a experiência interativa.
• mecanismo de cacheO sistema armazena automaticamente em cache os arquivos de imagem e vídeo gerados localmente para resolver o problema de não ser possível acessar diretamente o link oficial do Grok e, ao configurar oBase Urlpara garantir que os arquivos de mídia sejam exibidos corretamente. [cite:1-2]
• Back Office de gerenciamento visualInterface de gerenciamento da Web: fornece uma interface de gerenciamento da Web que permite aos usuários fazer login no backend para configurar o sistema, gerenciar tokens de conta, visualizar estatísticas de uso e limpar o cache.
• Opções flexíveis de armazenamentoSuporte ao uso de arquivos locais, bancos de dados MySQL ou Redis como back-end de armazenamento para informações de conta e configuração, adaptando-se a diferentes ambientes de implementação.

Usando a Ajuda

O grok2api oferece várias maneiras de implantá-lo e usá-lo, sendo o Docker Compose a maneira mais fácil e rápida.

1. metodologia de implantação

Recomendado docker-compose Realizar implementações com um clique, o que pode simplificar a complexidade da configuração do ambiente.

Primeiro, crie um arquivo chamado docker-compose.yml e copie o seguinte para ele:

services:
grok2api:
image: ghcr.io/chenyme/grok2api:latest
container_name: grok2api
ports:
- "8000:8000"
volumes:
- grok_data:/app/data
- ./logs:/app/logs
environment:
# 存储模式，可选值为 file, mysql 或 redis，默认为 file
- STORAGE_MODE=file
# 如果使用 mysql 或 redis，需要配置下面的数据库连接URL
# - DATABASE_URL=mysql://user:password@host:3306/grok2api
volumes:
grok_data:

Em seguida, no diretório que contém o arquivo, abra um terminal e execute o seguinte comando para iniciar o serviço:

docker-compose up -d

O serviço será iniciado em segundo plano e ouvirá as mensagens de 8000 Portos.

2 Configuração de inicialização

Depois que o serviço for iniciado pela primeira vez, você precisará executar uma configuração inicial por meio do backend de administração.

1. Acesso ao histórico de gerenciamento
   Abrir em seu navegador http://<你的服务器地址>:8000/login.
   O nome de usuário padrão do administrador é adminA senha é admin.
2. Alterar a senha do administrador
   Depois de fazer login, altere o nome de usuário e a senha padrão do administrador na página "System Configuration" (Configuração do sistema) do plano de fundo de gerenciamento para garantir a segurança do serviço.
3. Configuração do URL básico
   Essa é uma etapa muito importante, especialmente se você precisar usar o recurso de geração de imagens ou vídeos.base_url é para que os arquivos de mídia gerados sejam acessados corretamente. Defina-o como um endereço que seu servidor possa acessar, como http://192.168.1.10:8000 talvez https://your-domain.com.
4. Adicionar conta do Grok
   Na página "Gerenciamento de token" no plano de fundo da administração, clique no botão "Adicionar token em massa" e adicione as informações da sua conta Grok (por exemplo, seu token, token, token, token, token, token, token, token, token, token, token, token, token, token).cf_clearance responder cantando auth_token) adicionado. Essas informações precisam ser obtidas pelo usuário nas ferramentas de desenvolvimento do navegador.

3. como chamar a API

O grok2api faz interface com o chat/completions As interfaces são totalmente compatíveis. Você pode chamá-la usando qualquer cliente ou biblioteca compatível com a API OpenAI.

Iniciar uma solicitação de bate-papo

A seguir, um exemplo de como usar o curl Exemplo de um comando para iniciar uma solicitação de bate-papo por streaming:

curl https://你的服务器地址/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <你在后台设置的API_KEY>" \
-d '{
"model": "grok-4-fast",
"messages": [
{
"role": "user",
"content": "你好，请介绍一下你自己"
}
],
"stream": true
}'

• comandante-em-chefe (militar) 你的服务器地址 Substitua pelo endereço IP ou nome de domínio onde o serviço grok2api está implantado.
• comandante-em-chefe (militar) <你在后台设置的API_KEY> Substitua-o pelo que você definiu no backend do administrador api_key. Se não estiver definido, não há necessidade de Authorization Cabeçalho da solicitação.

Gerar imagem

Inclua "Draw one" (Desenhar um) ou um comando semelhante na caixa de diálogo para acionar a função de geração de imagem.

curl https://你的服务器地址/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <你在后台设置的API_KEY>" \
-d '{
"model": "grok-4-fast",
"messages": [
{
"role": "user",
"content": "请帮我画一只正在写代码的猫"
}
]
}'

O sistema retorna duas imagens no formato Markdown e consome quatro créditos. Os links de imagem retornados são baseados em sua configuração base_url.

Gerar vídeo

Para gerar o vídeo, você precisa selecionar grok-imagine-0.9 modelar e passar uma imagem e a palavra-chave correspondente.

curl https://你的服务器地址/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <你在后台设置的API_KEY>" \
-d '{
"model": "grok-imagine-0.9",
"messages": [
{
"role": "user",
"content": [
{
"type": "text",
"text": "让画面中的风车转动起来"
},
{
"type": "image_url",
"image_url": {
"url": "https://your-image-url.jpg"
}
}
]
}
]
}'

O retorno será um HTML contendo um link para o vídeo <video> Etiquetas.

cenário do aplicativo

1. Expansão de aplicativos
   Para todos os tipos de aplicativos que já integraram a API OpenAI (por exemplo, chatbots, ferramentas de criação de conteúdo etc.), os desenvolvedores podem usar o grok2api para integrar rapidamente os recursos dos modelos Grok sem praticamente nenhuma alteração no código, apenas com alterações no endereço e na chave de base da API, oferecendo aos usuários uma grande seleção adicional de modelos com pesquisas em rede e um estilo de humor exclusivo.
2. Gerenciamento eficiente de várias contas
   Para usuários ou equipes com várias contas do Grok, é muito tedioso gerenciar e alternar as contas manualmente. Os recursos de agrupamento de números e balanceamento automático de carga do grok2api podem resolver esse problema. Os usuários só precisam adicionar todas as contas ao plano de fundo, e o sistema alocará automaticamente as solicitações para garantir que a frequência de uso de cada conta seja equilibrada, para evitar interrupções de serviço devido à ultrapassagem do limite e para maximizar o uso de todos os recursos da conta.
3. Alternativas de API de baixo custo
   Para desenvolvedores individuais, pesquisadores ou startups que precisam usar uma API de modelo grande, mas têm um orçamento limitado, o grok2api oferece uma solução muito econômica. Ele permite que os usuários acessem o poder do Grok para experimentação, criação de protótipos ou aplicativos de pequena escala quase sem custo, convertendo as operações do lado da Web em uma interface de API.
4. Geração de conteúdo multimídia
   Os criadores de conteúdo ou aplicativos de automação que precisam gerar imagens ou vídeos curtos podem aproveitar os recursos de geração de multimídia do grok2api. Com uma simples chamada de API, o conteúdo visual pode ser gerado com base em dicas de texto ou imagem para publicações em mídias sociais, materiais de marketing ou processos automatizados de produção de vídeo.

QA

1. Preciso pagar para usar o grok2api?
   O projeto grok2api em si é de código aberto e gratuito. No entanto, você precisa ter pelo menos uma conta Grok (regular ou Super) para usar seus recursos. De acordo com a política oficial do Grok, há um limite no número de chamadas (por exemplo, 80 por 20 horas) para contas regulares.
2. Esse projeto é uma API oficial?
   Não é. Este projeto é uma ferramenta de terceiros que encapsula sua funcionalidade em uma interface API, simulando a interação de um navegador com a versão web do Grok. Dessa forma, sua estabilidade pode ser afetada por atualizações da versão oficial do Grok na Web.
3. Como obter as informações de autenticação da conta do Grok (cf_clearance responder cantando auth_token)?
   Será necessário fazer login no site oficial da Grok e, em seguida, usar as ferramentas de desenvolvedor do navegador (geralmente abertas pressionando F12) para encontrar o cookie apropriado e solicitar informações de cabeçalho na guia Rede ou Aplicativo. Essa é uma operação altamente técnica, portanto, trate suas informações pessoais de autenticação com cuidado.
4. Por que as imagens ou os vídeos gerados não podem ser exibidos?
   Isso geralmente se deve ao fato de não definir obase_urlparâmetros. Os links para arquivos de mídia retornados pelo Grok têm restrições de acesso e o grok2api os armazena em cache localmente. Você deve definir o parâmetrobase_urlDefinido como o endereço publicamente acessível do serviço (por exemplo https://yourdomain.com talvez http://<服务器IP>:8000) para que os links de mídia retornados pela API sejam acessíveis.