Un modelo ligero de texto a imagen para generación rápida, con renderizado de texto en chino e inglés, y resoluciones flexibles.
Ejemplos
Prompt de entrada | Imagen de salida |
|---|---|
Fotografía de una joven elegante con cabello negro corto, posando con seguridad frente a un vibrante mural de estilo caricaturesco. Viste un conjunto completamente negro: una chaqueta bomber acolchada con cuello de volantes, pantalones cortos cargo, medias de red y botas Doc Martens negras de suela gruesa, con una cadena dorada colgando de su cintura. El fondo presenta cuatro paneles coloridos al estilo cómic: uno dice “GRAND STAGE” e incluye zapatillas deportivas y una botella de Gatorade; otro muestra zapatillas Nike verdes y una rebanada de pizza; el tercero dice “HARAJUKU st” con zapatos flotantes; y el cuarto muestra un ratón azul montando una patineta con el texto “Takeshita WELCOME.”. Los colores brillantes predominantes incluyen amarillo, verde azulado, naranja, rosa y verde. Globos de diálogo, patrones de semitonos y personajes lúdicos realzan la estética de arte callejero urbano. La luz diurna ilumina uniformemente la escena, y el suelo bajo sus pies es un pavimento de baldosas blancas. Retrato de cuerpo entero, composición centrada, postura ligeramente inclinada, contacto visual directo con la cámara. Alto nivel de detalle, enfoque nítido, encuadre dinámico. | ![]() |
Resumen de modelos
Nombre del modelo | Descripción | Especificaciones de la imagen de salida |
|---|---|---|
z-image-turbo | Un modelo ligero y rápido de generación de imágenes | Resolución de imagen: de 512×512 a 2048×2048 píxeles. Consulte las resoluciones recomendadas en la configuración del parámetro size. Formato de imagen: png Número de imágenes: Fijo en 1. |
Requisitos previos
Cree una clave API y configure la clave API como una variable de entorno.
Llamada HTTP síncrona
Singapur:POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
Beijing:POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
Reemplace {WorkspaceId} con su ID de espacio de trabajo real.
Parámetros de solicitudEncabezados de solicitudContent-Typestring (Requerido)El tipo de contenido de la solicitud. Debe ser application/json.Authorization string (Requerido)Autentica la solicitud con una clave API de Model Studio. Ejemplo: Bearer sk-xxxx.Cuerpo de la solicitudmodelstring (Obligatorio)Nombre del modelo: z-image-turbo.input object (Obligatorio)Contenido de entrada.
Propiedades messages array (Obligatorio)Matriz de contenido de la solicitud. Solo turno único — pase un conjunto de rol y contenido. No se admiten múltiples turnos.
Propiedades role string (Obligatorio)Rol del mensaje: user.contentarray (Obligatorio)Matriz de contenido del mensaje. Debe contener un objeto de texto.
Propiedades text string(Obligatorio)Prompt positivo que describe el contenido, estilo y composición deseados.Admite chino e inglés. Máximo 800 caracteres (cada carácter, letra, número o símbolo cuenta como uno). Los caracteres adicionales se truncan.Ejemplo: Un gato naranja sentado con una expresión feliz, animado y tierno, realista y preciso.Nota: Solo se admite un objeto de texto. Pasar cero o múltiples objetos de texto devuelve un error.object (Opcional)Parámetros de generación de imagen.
Propiedades size string (Opcional)Resolución de la imagen de salida en formato ancho×alto.
Resoluciones recomendadas para un total de 1024*1024 píxeles:
Resoluciones recomendadas para un total de 1280*1280 píxeles:
Resoluciones recomendadas para un total de 1536*1536 píxeles:
bool (Opcional)Habilite la reescritura inteligente de prompts mediante optimización LLM y salida de razonamiento.
integer (opcional)Semilla de número aleatorio. Rango válido: [0,2147483647].Usar la misma seed produce resultados similares. Si se omite, el algoritmo utiliza una semilla aleatoria.Nota: La generación de imágenes es probabilística. Incluso con la misma seed, los resultados pueden variar. |
Este ejemplo devuelve una imagen directamente para obtener una respuesta más rápida. Para habilitar la reescritura inteligente, configure prompt_extend=true; el sistema devolverá el prompt optimizado, el razonamiento y la imagen (lo que aumenta el tiempo de respuesta). |
Parámetros de respuestaoutputobjectSalida del modelo.
Propiedades choices arrayContenido de salida del modelo. La matriz contiene un elemento.
Propiedades finish_reason stringMotivo de finalización. El valor stop indica éxito.message objectMensaje de respuesta del modelo.
Propiedades role stringRol del mensaje. El valor es assistant.contentarray
Propiedades imagen stringURL de la imagen generada (PNG). Válida por 24 horas — descárguela pronto.text stringEsto devuelve el prompt de entrada (prompt_extend=false) o el prompt reescrito (prompt_extend=true).stringProceso de razonamiento del modelo. Solo se devuelve cuando prompt_extend=true.objectEsto incluye estadísticas de uso solo para generaciones exitosas.
Propiedades width integerAncho de la imagen generada (píxeles).height integerAltura de la imagen generada (píxeles).image_count integerNúmero de imágenes generadas: 1.input_tokens integerTokens de entrada (0 cuando prompt_extend=false).output_tokens integerTokens de salida (0 cuando prompt_extend=false).output_tokens_detailsobjectDetalles de tokens de salida (solo cuando prompt_extend=true).
Propiedades reasoning_tokens integerTokens utilizados para el razonamiento.integerTokens totales (0 cuando prompt_extend=false).stringIdentificador único de solicitud para rastreo y solución de problemas.code stringCódigo de error. Se devuelve solo para solicitudes fallidas. Consulte Códigos de error.message stringMensaje de error detallado. Se devuelve solo para solicitudes fallidas. Consulte Códigos de error. |
Los datos de la tarea (estado de la tarea y URL de imágenes) se conservan solo durante 24 horas y luego se eliminan automáticamente. Guarde las imágenes generadas con prontitud. |
Límites
- Las URL de las imágenes son válidas durante 24 horas. Descárguelas pronto.
- Moderación de contenido: Tanto el
promptde entrada como la imagen de salida pasan por moderación de contenido. El contenido no conforme devuelve un errorIPInfringementSuspectoDataInspectionFailed. Consulte Códigos de error.
Facturación y limitación de tasa
- Para precios y cuota gratuita, consulte Precios de modelos.
- Para límites de tasa, consulte Z-Image.
- La facturación se basa en el recuento de imágenes generadas correctamente y en el estado de prompt_extend. Las llamadas fallidas no generan cargos ni consumen la cuota gratuita.
