Use Grok Imagine no Hermes Agent.
Grok Imagine é a suíte de geração de imagem e vídeo da xAI — text-to-image, image-to-image, text-to-video e image-to-video. Hermes Agent o chama pelo mesmo provider RunAPI personalizado e API key usados para chat, sem plugins extras para instalar.
Use RunAPI to generate an image with xAI Grok Imagine.
Requirements:
- Use the RunAPI API at https://runapi.ai/v1/text_to_image.
- Read the API key from RUNAPI_API_KEY environment variable.
- Use the custom:runapi provider already configured in Hermes Agent.
- Set the model to "grok-imagine-text-to-image".
- Write a descriptive prompt for the image you want.
- The response returns a task_id. Poll the task status endpoint until the task completes, then retrieve the output URL.
curl -X POST https://runapi.ai/v1/text_to_image \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-text-to-image",
"prompt": "a robot hand placing a chess piece on a board, dramatic side lighting, slow motion feel"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "grok-imagine-text-to-image"
}
Use Grok Imagine no Hermes Agent em três passos
Configure RunAPI
Defina a variável de ambiente RUNAPI_API_KEY no seu perfil de shell. Se o provider custom:runapi já está configurado no Hermes Agent para chat, a mesma key funciona para Grok Imagine — nenhuma configuração adicional necessária.
export RUNAPI_API_KEY=runapi_xxx
Chame Grok Imagine
Envie uma requisição POST ao endpoint text_to_image com model definido como grok-imagine-text-to-image. Inclua seu prompt descrevendo a imagem. Para vídeo, use text_to_video com grok-imagine-text-to-video.
text_to_image
Obtenha o resultado
A API retorna um task_id imediatamente. Faça polling do endpoint de status da tarefa até o status mudar para completed, depois recupere a URL da imagem ou vídeo de saída na resposta.
task_id: tsk_abc123
Parâmetros da API Grok Imagine
| Parâmetro | Tipo | Descrição |
|---|---|---|
model |
string |
Obrigatório. Ex. grok-imagine-text-to-image, grok-imagine-image-to-video. |
prompt |
string |
Descrição de texto da saída desejada. |
image_url |
string |
URL da imagem de origem para image-to-image ou image-to-video. |
aspect_ratio |
string |
Opcional. Proporção de aspecto de saída, ex. 16:9, 1:1. |
O que é Grok Imagine no Hermes Agent?
Grok Imagine (Aurora) é o gerador de imagens e vídeos da xAI que cobre texto para imagem, edição de imagem e texto para vídeo com sincronização de áudio. Hermes Agent o chama via provider custom:runapi, facilitando o encadeamento de saídas do Grok Imagine com outros modelos RunAPI em workflows de múltiplas etapas.
Casos de uso do Grok Imagine
Fotos de produtos geradas por IA
Crie fotografia de produto a partir de descrições de texto para listings de e-commerce, anúncios e campanhas de marketing.
Clipes de vídeo com áudio sincronizado
Gere clipes de vídeo curtos com áudio correspondente a partir de prompts de texto, prontos para redes sociais.
Design de personagens para projetos criativos
Produza designs de personagens consistentes em estilo fotorrealista ou anime para games, animações ou narrativas.
Perguntas sobre Grok Imagine + Hermes Agent
Sim. Se RunAPI já está configurado como provider personalizado (custom:runapi) no Hermes Agent, a mesma API key e base_url funcionam para Grok Imagine. Defina model como grok-imagine-text-to-image e chame o endpoint text_to_image.
Não. A mesma RUNAPI_API_KEY que você usa para chat e outros modelos também funciona para Grok Imagine. Uma key cobre todos os 113+ modelos no catálogo RunAPI.
Assíncrono. A API retorna um task_id imediatamente. Faça polling do endpoint de status da tarefa até a tarefa completar. SDKs RunAPI e o CLI fazem polling automaticamente.
Grok Imagine usa faturamento por tarefa pelo RunAPI. Verifique a página de preços do RunAPI para taxas atuais. Gerações com falha não são cobradas.
Configuração geral do Hermes Agent
Ainda não configurou? Comece com o guia de configuração do RunAPI para Hermes Agent.
Guia de configuração do Hermes Agent →Catálogo de modelos Grok Imagine
Veja todas as variantes, preços e documentação da API do Grok Imagine.
Modelos Grok Imagine →Experimente Grok Imagine no Hermes Agent hoje.
Obtenha uma API key RunAPI gratuita, configure o provider custom:runapi e comece a gerar imagens e vídeo com xAI Grok Imagine.