Explica la API de generación de imágenes, la selección de modelos, la configuración de parámetros y los métodos de llamada.

Ya está disponible la generación de imágenes con los modelos de Guishu. Puedes generar directamente, mediante una API unificada, portadas para cuentas oficiales, imágenes de producto, iconos de aplicaciones, imágenes de artículos o ilustraciones automáticas para Agent. API de generación de imágenes: POST https://api.llm-token.cn/v1/images/generations

I. Resumen: solo necesitas preparar estas 3 cosas ✨

Lo que necesitas preparar	Cómo rellenarlo
Clave Token de Guishu	Introduce `Authorization: Bearer 你的new-api-token` en el encabezado de la solicitud.
API de generación de imágenes	`https://api.llm-token.cn/v1/images/generations`
Modelo de generación de imágenes	`image-01` o `image-01-live`

Los modelos de Guishu ya unifican la integración de modelos, la adaptación de la API, la gestión de cuota y las reglas de facturación. Solo necesitas tu propia clave Token de Guishu para acceder a la generación de imágenes desde una única API.

II. Puesta en marcha en 1 minuto: ejemplo con curl 🚀

Sustituye YOUR_NEW_API_TOKEN en el siguiente ejemplo por tu propia clave Token de Guishu para probarlo directamente.

curl https://api.llm-token.cn/v1/images/generations \
  -H "Authorization: Bearer YOUR_NEW_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image-01",
    "prompt": "一张可爱的蓝色 AI 小机器人图标，白色背景，极简 3D 风格，居中构图，不要文字",
    "response_format": "url",
    "n": 1,
    "aspect_ratio": "1:1",
    "prompt_optimizer": false
  }'

Para la primera prueba, se recomienda generar 1 imagen, es decir, usar n: 1. Cuando hayas confirmado que la imagen se genera correctamente, podrás ajustar la proporción, el estilo y la cantidad según tus necesidades.

III. ¿Cómo se rellenan los parámetros de la solicitud? 🧩

Parámetro	Obligatorio	Valor habitual	Descripción
`model`	Sí	`image-01`	Nombre del modelo de generación de imágenes. Si necesitas una capacidad de generación más en tiempo real, también puedes introducir `image-01-live`.
`prompt`	Sí	Se rellena según la imagen deseada	Describe la imagen que quieres generar. Se recomienda especificar claramente el sujeto, el estilo, los colores, la composición y el uso.
`response_format`	No	`url`	Se recomienda usar `url` para recibir directamente un enlace a la imagen; también puedes usar `base64` si tu caso de uso lo requiere.
`n`	No	`1`	Número de imágenes que se generan en una sola solicitud. Para una prueba normal, se recomienda empezar con `1`.
`aspect_ratio`	No	`1:1`	Proporción de la imagen. Valores habituales: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `21:9`.
`prompt_optimizer`	No	`false`	Indica si se activa la optimización del prompt. Si quieres que la imagen siga el texto original de forma más estricta, se recomienda usar `false`.
`seed`	No	Entero	Se utiliza para mejorar la reproducibilidad. Si necesitas generar varias veces resultados similares, puedes fijar el mismo seed.
`width` / `height`	No	Normalmente no se usa	En la mayoría de los casos basta con `aspect_ratio`; utiliza estos parámetros solo cuando necesites una anchura y una altura exactas.

Si la respuesta contiene una URL de la imagen, se recomienda guardarla cuanto antes. El enlace sirve para la vista previa y la descarga temporales, pero no se recomienda usarlo como dirección permanente del recurso.

IV. ¿Por qué es más sencillo usar los modelos de Guishu? 🍬

Una integración convencional suele exigir alternar entre varias plataformas de modelos, cada una con claves, API y métodos de facturación diferentes, lo que complica el desarrollo y el mantenimiento.

Los modelos de Guishu unifican todo esto. Solo necesitas una clave Token de Guishu para llamar a la generación de imágenes mediante una API unificada. El consumo, el multiplicador y el saldo se rigen por la información mostrada en el panel de Token de Guishu, por lo que son claros y fáciles de gestionar.

Capacidad	Descripción
API unificada	La generación de imágenes usa de forma unificada `https://api.llm-token.cn/v1/images/generations`, lo que simplifica la integración.
Clave unificada	Usa el `new-api-token` generado en el panel de Token de Guishu, sin tener que alternar entre varias plataformas.
Facturación unificada	El consumo, el multiplicador y el saldo se basan en la información mostrada en el panel de Token de Guishu, lo que facilita la gestión de costes del equipo.
Adecuado para integraciones de negocio	Es adecuado para ilustraciones de cuentas oficiales, imágenes de artículos, portadas de producto, ilustraciones automáticas de Agent y generación masiva de recursos, entre otros usos.

En una frase: usa un Token de Guishu y una sola API para integrar la generación de imágenes en tu producto y tus flujos de trabajo.

V. ¿Cómo se usa image-01-live? ⚡

image-01-live utiliza la misma API de generación de imágenes. Los demás parámetros no cambian; solo tienes que sustituir el valor de model por image-01-live.

{
  "model": "image-01-live",
  "prompt": "一张赛博风格的蓝色产品宣传图，干净背景，科技感，适合公众号封面",
  "response_format": "url",
  "n": 1,
  "aspect_ratio": "16:9",
  "prompt_optimizer": false
}

Si este modelo está habilitado para tu cuenta, puedes llamarlo directamente de esta forma.

VI. Ejemplo en Python: cómo usarlo en un proyecto 🐍

import requests

url = "https://api.llm-token.cn/v1/images/generations"
headers = {
    "Authorization": "Bearer YOUR_NEW_API_TOKEN",
    "Content-Type": "application/json",
}
payload = {
    "model": "image-01",
    "prompt": "一张科技感很强的蓝色应用图标，白色背景，极简 3D 风格，居中构图，不要文字",
    "response_format": "url",
    "n": 1,
    "aspect_ratio": "1:1",
    "prompt_optimizer": False,
}

resp = requests.post(url, headers=headers, json=payload, timeout=120)
resp.raise_for_status()
print(resp.json())

La generación de imágenes tarda más que una conversación de texto normal. Se recomienda establecer el tiempo de espera del cliente en unos 120 segundos para evitar que este cierre la solicitud antes de que termine de generarse la imagen.

VII. ¿Cómo describir una imagen para obtener mejores resultados? 🪄

Al describir una imagen, puedes seguir este orden para lograr resultados más estables:

Sujeto: qué quieres representar, por ejemplo, «robot de IA azul» o «cartel de análisis del Mundial».
Escena: dónde se sitúa, por ejemplo, «fondo blanco», «bajo las luces de un estadio» o «sobre un escritorio de oficina».
Estilo: minimalista, realista, 3D, ilustración, cartel comercial, aspecto fotográfico, etc.
Composición: centrada, vista cenital, medio cuerpo, espacio negativo, portada horizontal, etc.
Colores: color principal y colores secundarios, por ejemplo, azul y blanco, negro y dorado, o contraste entre rojo y azul.
Restricciones: por ejemplo, «sin texto», «sin marca de agua» o «fondo limpio».

Puedes usar directamente esta pequeña plantilla:

一张【比例】的【用途】图片，主体是【主体】，场景是【场景】，整体风格为【风格】，主色为【颜色】，构图【构图要求】，细节要求【限制或补充】。

Ejemplo:

一张 1:1 的应用图标，主体是蓝色发光的 AI 芯片，白色背景，极简 3D 风格，居中构图，边缘清晰，不要文字。

VIII. Si tienes problemas, consulta primero esta sección 🛟

Situación	Solución
Error de autenticación	Comprueba que el encabezado de la solicitud sea `Authorization: Bearer YOUR_NEW_API_TOKEN` y confirma que no hayas copiado espacios adicionales en el token.
El modelo no existe	Comprueba que el nombre del modelo sea exactamente `image-01` o `image-01-live`, sin cambiar las mayúsculas y minúsculas.
La proporción de la imagen no es la esperada	Ajusta primero `aspect_ratio`. Para una portada habitual de una cuenta oficial puedes usar `16:9`; para un avatar o icono, `1:1`.
El enlace de la imagen no se abre	Es posible que la URL de la imagen haya caducado. Se recomienda descargarla poco después de generarla o guardarla en tu propia biblioteca de recursos.
La solicitud tarda mucho	La generación de imágenes requiere tiempo; se recomienda establecer un tiempo de espera superior a 120 segundos.
El resultado generado no es suficientemente estable	Describe los requisitos con más detalle y reduce las indicaciones contradictorias. Si necesitas resultados similares, puedes fijar el valor de `seed`.

IX. Versión que puedes copiar directamente para el equipo de desarrollo 📮

Usamos los modelos de Guishu para llamar a la generación de imágenes mediante la API POST https://api.llm-token.cn/v1/images/generations. El encabezado de la solicitud usa Authorization: Bearer YOUR_NEW_API_TOKEN; en el cuerpo, se introduce model: image-01 o model: image-01-live, junto con parámetros como prompt, response_format: url, n y aspect_ratio.

X. ¿Para qué escenarios es adecuado? 📚

Escenario	Cómo puede usarse
Imágenes para cuentas oficiales / Xiaohongshu	Genera rápidamente portadas, imágenes de cabecera, carteles de eventos e ilustraciones para artículos.
Páginas de producto y SaaS	Genera iconos de aplicaciones, imágenes de funciones, banners e ilustraciones de estados vacíos.
Comercio electrónico y recursos de producto	Genera fondos de producto, imágenes promocionales e imágenes ambientales para páginas de detalle.
Flujos de trabajo automatizados de Agent	Permite que el agente genere ilustraciones automáticamente a partir del contenido para aumentar la eficiencia de producción.

Your privacy choices

Tutorial de generación de imágenes con los modelos de Guishu