> ## Documentation Index
> Fetch the complete documentation index at: https://gccai.heqingsong.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# Z-Image-Turbo Bildgenerierung

>  - Asynchroner Verarbeitungsmodus, gibt eine Aufgaben-ID für nachfolgende Abfragen zurück
- Leichte und schnelle Bildgenerierung, unterstützt Chinesisch und Englisch
- Unterstützt Auflösungsstufen 1K/2K, unterstützt intelligente Prompt-Umschreibung 

```bash cURL theme={null}
curl --request POST \
  --url https://gccai.heqingsong.uk/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "z-image-turbo",
    "prompt": "Ink painting style landscape scenery"
  }'
```

```python Python theme={null}
import requests

url = "https://gccai.heqingsong.uk/v1/images/generations"

payload = {
    "model": "z-image-turbo",
    "prompt": "Ink painting style landscape scenery"
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```

```javascript JavaScript theme={null}
const url = "https://gccai.heqingsong.uk/v1/images/generations";

const payload = {
  model: "z-image-turbo",
  prompt: "Ink painting style landscape scenery",
};

const headers = {
  Authorization: "Bearer <token>",
  "Content-Type": "application/json",
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload),
})
  .then((response) => response.json())
  .then((data) => console.log(data))
  .catch((error) => console.error("Error:", error));
```

```json 200 theme={null}
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01JGXYZ1234567890ABCDEF"
    }
  ]
}
```

```json 400 theme={null}
{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}
```

```json 401 theme={null}
{
  "error": {
    "code": 401,
    "message": "Authentication failed, please check your API key",
    "type": "authentication_error"
  }
}
```

```json 402 theme={null}
{
  "error": {
    "code": 402,
    "message": "Insufficient balance, please top up",
    "type": "payment_required"
  }
}
```

## Unterstützte Modelle

| Modell | Beschreibung | Bilder pro Anfrage | Preis |
| - | - | - | - |
| `z-image-turbo` | Leichte und schnelle Bildgenerierung, unterstützt Chinesisch und Englisch | Fest 1 Bild | Festpreis |

## Autorisierung

**Authorization** `string` *required*

Alle Endpunkte erfordern eine Bearer-Token-Authentifizierung

API-Key abrufen:

Besuchen Sie die [API-Key-Verwaltung](https://gccai.heqingsong.uk/keys), um Ihren API-Key zu erhalten

Zum Request-Header hinzufügen:

```
Authorization: Bearer YOUR_API_KEY
```

## Body

**model** `string` *required*

Modellname

* `z-image-turbo` – Leichte und schnelle Bildgenerierung, unterstützt Chinesisch und Englisch

**nsfw\_check** `boolean` (default: false)

Legt fest, ob der Inhalt vor dem Absenden des Bildauftrags moderiert wird.

* `true`: Prompts und Eingabebilder mit `omni-moderation-latest` prüfen
* `false` oder nicht angegeben: keine Moderationsanfrage und damit keine zusätzlichen Moderationskosten oder Verzögerung (Standard)

**prompt** `string` *required*

Textbeschreibung für die Bildgenerierung, bis zu 800 Zeichen

**size** `string` (default: 1:1)

Seitenverhältnis des Bildes

Unterstützte Seitenverhältnisse:

* `1:1` – Quadrat (Standard)
* `4:3` – Querformat 4:3
* `3:4` – Hochformat 3:4
* `16:9` – Querformat Breitbild
* `9:16` – Hochformat vertikal
* `3:2` – Querformat 3:2
* `2:3` – Hochformat 2:3

**resolution** `string` (default: 1K)

Auflösungsstufe

* `1K` – Standardauflösung (Standard)
* `2K` – Hochauflösend

**prompt\_extend** `boolean` (default: false)

Intelligente Prompt-Umschreibung

Wenn aktiviert, optimiert die KI den Prompt automatisch für bessere Ergebnisse, wobei die Kosten steigen.

* `false` – Deaktiviert (Standard)
* `true` – Aktiviert

## Auflösungs-Referenztabelle

Die Ausgabegröße wird durch die Kombination von `size` (Verhältnis) + `resolution` (Auflösungsstufe) gesteuert.

| Verhältnis | Stufe 1K | Stufe 2K |
| - | - | - |
| `1:1` | 1024×1024 | 2048×2048 |
| `4:3` | 1152×864 | 2048×1536 |
| `3:4` | 864×1152 | 1536×2048 |
| `16:9` | 1280×720 | 2048×1152 |
| `9:16` | 720×1280 | 1152×2048 |
| `3:2` | 1248×832 | 2048×1360 |
| `2:3` | 832×1248 | 1360×2048 |

## Anwendungsbeispiele

**Einfaches Text-zu-Bild (minimale Anfrage)**

```json theme={null}
{
  "model": "z-image-turbo",
  "prompt": "Ink painting style landscape scenery"
}
```

**Verhältnis und Auflösung angeben**

```json theme={null}
{
  "model": "z-image-turbo",
  "prompt": "Minimalist style cafe interior design",
  "size": "16:9",
  "resolution": "2K"
}
```

**Intelligente Prompt-Umschreibung aktivieren**

```json theme={null}
{
  "model": "z-image-turbo",
  "prompt": "A cat",
  "prompt_extend": true
}
```

## Response

**code** `integer`

Antwort-Statuscode

**data** `array`

Antwortdaten-Array

**Eigenschaften**

**status** `string`

Aufgabenstatus

* `submitted` – Eingereicht

**task\_id** `string`

Eindeutige Aufgaben-ID

## Hinweise

1. **Asynchrone Verarbeitung**: Nach dem Senden wird eine `task_id` zurückgegeben. Fragen Sie `/v1/tasks/{task_id}` ab, um die Ergebnisse zu erhalten
2. **Bildspeicherung**: Generierte Bilder werden auf das Plattform-CDN gespiegelt und sind langfristig gültig
3. **Abrechnungsregeln**: Abrechnung pro erfolgreich generiertem Bild, keine Gebühr bei Fehlern
4. **Feste Anzahl**: Z-Image-Turbo generiert genau 1 Bild pro Anfrage, der Parameter `n` wird nicht unterstützt


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.