Skip to main content

Integrar el modelo de generación de imágenes

Llame a un modelo de generación de imágenes de Token Plan desde una herramienta de agente, genere una imagen a partir de una descripción de texto y descárguela localmente.

Modelos compatibles

ModeloDescripción
qwen-image-3.0-proQwen Image Generation and Editing 3.0 Pro, admite texto a imagen e imagen a imagen
qwen-image-2.0-proQwen Image Generation 2.0 Pro (solo Team Edition)
qwen-image-2.0Qwen Image Generation 2.0 (solo Team Edition)
wan2.7-imageGeneración de imágenes Wan
wan2.7-image-proGeneración de imágenes Wan Pro
Para conocer más modelos, consulte los modelos compatibles con Token Plan Personal Edition y los modelos compatibles con Token Plan Team Edition.

Requisitos previos

  • Una suscripción a Token Plan y una clave de API que comience con sk-sp-. Para obtener más información, consulte Descripción general de la integración.
  • Su herramienta de codificación de IA admite Slash Commands. Para consultar las rutas de configuración de otras herramientas, consulte Otras herramientas.

Interfaz

POST https://token-plan.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation Utilice Authorization: Bearer $ANTHROPIC_AUTH_TOKEN en el encabezado de la solicitud. Para los campos del cuerpo de la solicitud y de la respuesta, consulte las secciones siguientes.

Paso 1: Crear un Slash Command

Configure la clave de API de Token Plan como la variable de entorno $ANTHROPIC_AUTH_TOKEN. Cree el archivo .claude/commands/text-to-image.md en la raíz del proyecto y agregue el siguiente contenido: 
Llame a la API de generación de imágenes de Token Plan para generar una imagen a partir de una descripción y descargarla localmente.

Descripción de la imagen: $ARGUMENTS

## Pasos

1. Extraiga el prompt (descripción de la imagen), el modelo (predeterminado: qwen-image-3.0-pro) y el tamaño (predeterminado: 1024*1024) de la descripción. Si la descripción especifica un modelo, use ese modelo.
2. Use la herramienta Bash para ejecutar el siguiente comando:
```bash
curl -s -X POST "https://token-plan.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<model>",
    "input": {"messages": [{"role": "user", "content": [{"text": "<prompt>"}]}]},
    "parameters": {"size": "<size>"}
  }'
```
3. Extraiga la URL de la imagen de `output.choices[0].message.content[0].image` en el JSON de respuesta.
4. Descargue la imagen con `curl -s -o "generated_$(date +%Y%m%d_%H%M%S).png" "<URL>"`.
5. Muestre la ruta del archivo de imagen generado.

Paso 2: Generar una imagen

En Claude Code, introduzca /text-to-image draw a cat. Para usar otro modelo, especifique el modelo en el comando, por ejemplo /text-to-image use wan2.7-image to draw a cat.

Parámetros de la solicitud

ParámetroObligatorioDescripción
modelSíID del modelo de generación de imágenes.
input.messages[0].content[0].textSíDescripción de la imagen.
parameters.sizeNoTamaño de la imagen, por ejemplo 1024*1024. Si se omite, el modelo selecciona un tamaño automáticamente.
Para conocer más parámetros, consulte API de generación y edición de imágenes de Qwen.

Respuesta

  • URL de la imagen: output.choices[0].message.content[0].image.
  • Uso: usage.image_count, usage.width, usage.height.
  • Las URL de las imágenes caducan. Descargue la imagen a la brevedad.

Límites

  • Los tamaños de imagen y los modelos compatibles dependen de la documentación de cada modelo.
  • La facturación se basa en la cantidad de imágenes de salida. El consumo real de Credits se muestra en Usage en la consola.

Otras herramientas

Para conocer los mecanismos de extensión y las rutas de configuración de otras herramientas, consulte Descripción general de la integración. Guarde el Slash Command anterior en la ruta correspondiente.