---
title: "Używaj Z Image w Hermes Agent przez RunAPI — Przewodnik API obrazów"
url: "https://runapi.ai/pl/hermes-z-image.md"
canonical: "https://runapi.ai/pl/hermes-z-image"
locale: "pl"
model: "z-image"
---

# Używaj Z Image w Hermes Agent.

Z Image to szybki model generowania obrazów Alibaba z dwujęzycznym renderowaniem tekstu w języku chińskim i angielskim. Hermes Agent wywołuje go przez niestandardowy endpoint providera RunAPI — ten sam base_url i klucz API, którego używasz do czatu, bez dodatkowych wtyczek ani wynajmu GPU.

## API example

```bash
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"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "z-image"
}

```

## How it works

1. **Skonfiguruj RunAPI** — Ustaw klucz API RunAPI jako zmienną środowiskową. Jeśli już skonfigurowałeś RunAPI jako niestandardowego providera w Hermes Agent, ten sam klucz i base_url działają do generowania obrazów.
2. **Wywołaj Z Image** — Wyślij żądanie POST do endpointu text_to_image z modelem ustawionym na z-image i tekstowym promptem. Z Image obsługuje zarówno chińskie, jak i angielskie prompty z dokładnym renderowaniem tekstu.
3. **Pobierz wynik** — API zwraca task_id natychmiast. Odpytuj endpoint statusu zadania, aż status zmieni się na completed, a następnie pobierz wygenerowany URL obrazu z wyjścia odpowiedzi.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Wymagane. Użyj z-image. |
| `prompt` | `string` | Opis tekstowy. Obsługuje język chiński i angielski. |
| `negative_prompt` | `string` | Opcjonalne. Czego unikać na obrazie. |
| `size` | `string` | Opcjonalne. Wymiary wyjściowe, np. 1024x1024. |

## FAQ

### Czy mogę używać Z Image w Hermes Agent?

Tak. Jeśli masz skonfigurowany RunAPI jako niestandardowy provider w Hermes Agent, ten sam klucz API i base_url obsługują żądania Z Image. Wyślij POST do endpointu text_to_image z modelem ustawionym na z-image.

### Czy potrzebuję osobnego klucza API dla Z Image?

Nie. Ten sam RUNAPI_API_KEY, którego używasz do czatu i innych modeli, działa również dla Z Image. Wszystkie modele RunAPI korzystają z jednego klucza i jednego salda kredytów.

### Czy Z Image jest asynchroniczny czy synchroniczny?

Z Image jest asynchroniczny. API zwraca task_id natychmiast. Odpytuj endpoint statusu zadania lub użyj webhook callback, aby wiedzieć, kiedy obraz jest gotowy. SDK RunAPI obsługują odpytywanie automatycznie.

### Ile kosztuje Z Image?

Z Image używa rozliczenia pay-as-you-go z naliczaniem per-task. Sprawdź stronę cenową RunAPI, aby zobaczyć aktualną stawkę. Nie ma miesięcznej subskrypcji ani minimalnych wydatków.


## Links

- [Przewodnik konfiguracji Hermes Agent →](https://runapi.ai/pl/hermes-agent)
- [Modele Z Image →](https://runapi.ai/pl/models/z-image)
- [Model catalog](https://runapi.ai/pl/models)
- [API docs](https://runapi.ai/pl/docs)