> ## 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.

# Génération d'images Z-Image-Turbo

>  - Mode de traitement asynchrone, retourne un identifiant de tâche pour les requêtes ultérieures
- Génération d'images légère et rapide, prend en charge le chinois et l'anglais
- Prend en charge les niveaux de résolution 1K/2K, prend en charge la réécriture intelligente du prompt 

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

## Modèles pris en charge

| Modèle | Description | Images par requête | Tarification |
| - | - | - | - |
| `z-image-turbo` | Génération d'images légère et rapide, prend en charge le chinois et l'anglais | 1 image fixe | Prix fixe |

## Autorisations

**Authorization** `string` *required*

Tous les points de terminaison nécessitent une authentification Bearer Token

Obtenez votre clé API :

Visitez la [gestion des clés API](https://gccai.heqingsong.uk/keys) pour obtenir votre clé API

Ajoutez à l'en-tête de la requête :

```
Authorization: Bearer YOUR_API_KEY
```

## Body

**model** `string` *required*

Nom du modèle

* `z-image-turbo` — génération d'images légère et rapide, prend en charge le chinois et l'anglais

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

Indique s'il faut modérer le contenu avant d'envoyer la tâche d'image.

* `true` : vérifier les prompts et les images d'entrée avec `omni-moderation-latest`
* `false` ou omis : ne pas envoyer de requête de modération, sans coût ni latence de modération supplémentaires (par défaut)

**prompt** `string` *required*

Description textuelle pour la génération d'images, jusqu'à 800 caractères

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

Rapport d'aspect de l'image

Rapports pris en charge :

* `1:1` — Carré (par défaut)
* `4:3` — Paysage 4:3
* `3:4` — Portrait 3:4
* `16:9` — Paysage écran large
* `9:16` — Portrait vertical
* `3:2` — Paysage 3:2
* `2:3` — Portrait 2:3

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

Niveau de résolution

* `1K` — résolution standard (par défaut)
* `2K` — résolution haute définition

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

Réécriture intelligente du prompt

Lorsqu'elle est activée, l'IA optimise automatiquement le prompt pour de meilleurs résultats, et les coûts augmentent.

* `false` — désactivé (par défaut)
* `true` — activé

## Tableau de référence des résolutions

La taille de sortie est contrôlée par la combinaison `size` (rapport) + `resolution` (niveau de résolution).

| Rapport | Niveau 1K | Niveau 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 |

## Exemples d'utilisation

**Texte-vers-image de base (requête minimale)**

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

**Spécifier rapport et résolution**

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

**Activer la réécriture intelligente du prompt**

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

## Response

**code** `integer`

Code de statut de la réponse

**data** `array`

Tableau de données de la réponse

**Propriétés**

**status** `string`

Statut de la tâche

* `submitted` — Soumise

**task\_id** `string`

Identifiant unique de la tâche

## Remarques

1. **Traitement asynchrone** : après la soumission, un `task_id` est retourné. Interrogez `/v1/tasks/{task_id}` pour obtenir les résultats
2. **Stockage des images** : les images générées sont mises en miroir sur le CDN de la plateforme et sont valides à long terme
3. **Règles de facturation** : facturé par image générée avec succès, aucun frais en cas d'échec
4. **Nombre fixe** : Z-Image-Turbo génère exactement 1 image par requête, le paramètre `n` n'est pas pris en charge


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