GPT Image

Los modelos de imagen GPT de Tianshu (la serie gpt-image) sirven para texto a imagen y edición de imágenes, dentro del grupo 生图专用.

Preparación

1. Crea un token en el grupo 生图专用 desde la Consola.
2. Confirma un nombre de modelo de imagen disponible en el grupo 生图专用 en el Catálogo de modelos (los ejemplos a continuación usan gpt-image-2).

Usa la ruta directa

La generación de imágenes es una solicitud de larga duración, así que usa la ruta directa https://api.tian-shu.org como endpoint para evitar tiempos de espera agotados en el gateway.

Opción 1: llamada a la API (recomendado)

Para generar imágenes, usa la API de Images, que tiene dos endpoints: texto a imagen y edición de imágenes.

Texto a imagen /v1/images/generations

curl 'https://api.tian-shu.org/v1/images/generations' \
  -H 'Authorization: Bearer your-image-group-token' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-image-2",
    "prompt": "an orange cat wearing an orange scarf hugging an otter, warm illustration style",
    "size": "1024x1024",
    "quality": "high",
    "output_format": "png",
    "response_format": "url",
    "n": 1
  }'

Edición de imágenes / imagen a imagen /v1/images/edits

Sube una imagen usando multipart/form-data y describe el cambio con claridad en prompt:

curl 'https://api.tian-shu.org/v1/images/edits' \
  -H 'Authorization: Bearer your-image-group-token' \
  -F 'model=gpt-image-2' \
  -F 'prompt=Keep the subject, add a red stamp in the top-right corner reading DEMO' \
  -F 'image=@/path/to/your-image.jpg' \
  -F 'size=1024x1024' \
  -F 'quality=high' \
  -F 'output_format=png' \
  -F 'response_format=url'

Parámetros comunes

Parámetro	Notas
model	Siempre el nombre del modelo de imagen, p. ej. gpt-image-2.
prompt	Descripción de la imagen; detalla el sujeto, la escena, el estilo, la relación de aspecto y cualquier texto.
n	Solo se admite 1 — una imagen por llamada.
size	Admite auto y tamaños comunes como 1024x1024, 1536x1024, 1024x1536.
quality	low / medium / high / auto; usa low para borradores y high para la salida final.
response_format	url o b64_json; se recomienda url por defecto.
output_format	Se recomienda png o jpeg; webp no es recomendable.
stream	No se admite — no lo habilites.

Opción 2: generar imágenes en Cherry Studio

1. Crea y copia un token en el grupo 生图专用.
2. Cherry Studio → Configuración → Servicios de modelos → agrega un proveedor de tipo OpenAI:
   • Dirección de la API: https://api.tian-shu.org
   • Clave de API: tu token del grupo de imágenes
3. En "Administrar", agrega un modelo de imagen (como gpt-image-2).
4. Asegúrate de desactivar la "salida en streaming" (el endpoint de imágenes no transmite por streaming); de lo contrario, la generación puede fallar.
5. Selecciona el modelo de imagen y podrás comenzar a generar.

Nota sobre el método de llamada

Para la generación con gpt-image, usa la API de Images (/v1/images/generations, /v1/images/edits). Los endpoints de Chat Completions / Responses no son el punto de entrada para la generación de imágenes.