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

# Generación de imágenes Z-Image-Turbo

>  - Modo de procesamiento asíncrono, devuelve un ID de tarea para consultas posteriores
- Generación de imágenes ligera y rápida, compatible con chino e inglés
- Admite niveles de resolución 1K/2K y reescritura inteligente del 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"
  }
}
```

## Modelos admitidos

| Modelo | Descripción | Imágenes por solicitud | Precio |
| - | - | - | - |
| `z-image-turbo` | Generación de imágenes ligera y rápida, compatible con chino e inglés | 1 imagen fija | Precio fijo |

## Autorización

**Authorization** `string` *required*

Todos los endpoints requieren autenticación mediante Bearer Token

Obtener la clave de API:

Visite [Gestión de claves de API](https://gccai.heqingsong.uk/keys) para obtener su clave de API

Añádala a la cabecera de la solicitud:

```
Authorization: Bearer YOUR_API_KEY
```

## Cuerpo de la solicitud

**model** `string` *required*

Nombre del modelo

* `z-image-turbo` - Generación de imágenes ligera y rápida, compatible con chino e inglés

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

Indica si se debe moderar el contenido antes de enviar la tarea de imagen.

* `true`: revisar los prompts y las imágenes de entrada con `omni-moderation-latest`
* `false` u omitido: no enviar una solicitud de moderación, sin coste ni latencia de moderación adicionales (predeterminado)

**prompt** `string` *required*

Descripción textual para la generación de la imagen, hasta 800 caracteres

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

Proporción de la imagen

Proporciones admitidas:

* `1:1` - Cuadrado (predeterminado)
* `4:3` - Horizontal 4:3
* `3:4` - Vertical 3:4
* `16:9` - Panorámico horizontal
* `9:16` - Vertical alargado
* `3:2` - Horizontal 3:2
* `2:3` - Vertical 2:3

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

Nivel de resolución

* `1K` - Resolución estándar (predeterminada)
* `2K` - Resolución de alta definición

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

Reescritura inteligente del prompt

Cuando está activada, la IA optimiza automáticamente el prompt para obtener mejores resultados, lo que aumenta los costes.

* `false` - Desactivada (predeterminada)
* `true` - Activada

## Tabla de referencia de resoluciones

El tamaño de salida se controla mediante la combinación de `size` (proporción) + `resolution` (nivel de resolución).

| Proporción | Nivel 1K | Nivel 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 |

## Ejemplos de uso

**Text-to-Image básico (solicitud mínima)**

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

**Especificar proporción y resolución**

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

**Activar la reescritura inteligente del prompt**

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

## Respuesta

**code** `integer`

Código de estado de la respuesta

**data** `array`

Array de datos de la respuesta

**Propiedades**

**status** `string`

Estado de la tarea

* `submitted` - Enviada

**task\_id** `string`

Identificador único de la tarea

## Notas

1. **Procesamiento asíncrono**: tras el envío se devuelve un `task_id`. Consulte `/v1/tasks/{task_id}` para obtener los resultados
2. **Almacenamiento de imágenes**: las imágenes generadas se replican en la CDN de la plataforma y son válidas a largo plazo
3. **Reglas de facturación**: se factura por cada imagen generada correctamente; no se cobran los fallos
4. **Cantidad fija**: Z-Image-Turbo genera exactamente 1 imagen por solicitud; el parámetro `n` no está admitido


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