Use Z Image no Hermes Agent.
Z Image é o modelo de geração de imagens rápido da Alibaba com renderização bilíngue de texto em chinês e inglês. Hermes Agent o chama pelo endpoint RunAPI personalizado — a mesma base_url e API key que você usa para chat, sem plugins extras ou aluguel de GPU.
Use the RunAPI text_to_image endpoint to generate an image with Z Image.
Requirements:
- Use the RUNAPI_API_KEY environment variable for authentication.
- Send a POST request to https://runapi.ai/v1/text_to_image.
- Set model to "z-image".
- Write a descriptive prompt for the image you want to generate.
- The response returns a task_id. Poll the task status endpoint until the task completes, then retrieve the image URL from the output.
- Use the custom:runapi provider configured in your Hermes Agent config.yaml.
curl -X POST https://runapi.ai/v1/text_to_image \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "z-image",
"prompt": "A neon-lit Tokyo street at night with Japanese shop signs, cinematic lighting, 8K detail"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "z-image"
}
Use Z Image no Hermes Agent em três passos
Configure RunAPI
Defina sua API key RunAPI como variável de ambiente. Se você já configurou RunAPI como provider personalizado no Hermes Agent, a mesma key e base_url funcionam para geração de imagem.
export RUNAPI_API_KEY=runapi_xxx
Chame Z Image
Envie uma requisição POST ao endpoint text_to_image com model definido como z-image e um prompt de texto. Z Image suporta prompts em chinês e inglês com renderização precisa de texto.
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 gerada na saída da resposta.
task_id: tsk_abc123
Parâmetros da API Z Image
| Parâmetro | Tipo | Descrição |
|---|---|---|
model |
string |
Obrigatório. Use z-image. |
prompt |
string |
Descrição de texto. Suporta chinês e inglês. |
negative_prompt |
string |
Opcional. O que evitar na imagem. |
size |
string |
Opcional. Dimensões de saída, ex. 1024x1024. |
O que é Z Image no Hermes Agent?
Z Image entrega o que usuários descrevem como "velocidade e realismo insanos" — gera imagens fotorrealistas em menos de um segundo com forte aderência ao prompt e detalhes faciais precisos. Construído sobre pesos de código aberto Apache 2.0, é ao mesmo tempo o modelo de imagem mais rápido e mais barato no RunAPI a cerca de US$0,004 por imagem.
Casos de uso do Z Image
Storyboard para cinema e animação
Gere frames de storyboard em velocidade inferior a um segundo e itere rapidamente sobre composições de cenas.
Visualização de produtos para e-commerce
Gere imagens de listagem de produto com materiais e fundos realistas para lojas online.
Ilustrações educacionais
Crie diagramas e ilustrações educacionais com legendas bilíngues para materiais didáticos.
Perguntas sobre Z Image + Hermes Agent
Sim. Se você tem RunAPI configurado como provider personalizado no Hermes Agent, a mesma API key e base_url gerenciam requisições Z Image. Envie um POST ao endpoint text_to_image com model definido como z-image.
Não. A mesma RUNAPI_API_KEY que você usa para chat e outros modelos também funciona para Z Image. Todos os modelos RunAPI compartilham uma key e um saldo de créditos.
Z Image é assíncrono. A API retorna um task_id imediatamente. Faça polling do endpoint de status da tarefa ou use um callback webhook para saber quando a imagem está pronta. SDKs RunAPI fazem polling automaticamente.
Z Image usa precificação pay-as-you-go com faturamento por tarefa. Verifique a página de preços do RunAPI para a taxa atual. Não há assinatura mensal ou gasto mínimo.
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 Z Image
Veja todas as variantes, preços e documentação da API do Z Image.
Modelos Z Image →Experimente Z Image no Hermes Agent hoje.
Obtenha uma API key RunAPI gratuita, configure o provider personalizado e comece a gerar imagens com renderização bilíngue de texto.