Generación y Edición de Imágenes

Las APIs de imágenes admiten generación y edición. Los tamaños exactos, valores de calidad, formatos y compatibilidad con streaming dependen del modelo y del canal upstream.

Puntos de conexión

Método	Ruta	Descripción
`POST`	`/v1/images/generations`	Generar imágenes
`POST`	`/v1/images/edits`	Editar imágenes, con entrada JSON o de formulario multipart
`POST`	`/v1/edits`	Ruta de compatibilidad. Se prefiere `/v1/images/edits`

Campos de la Solicitud

Campo	Tipo	Requerido	Descripción
`model`	string	Sí	ID del modelo de imagen
`prompt`	string	Requerido para generación	Prompt de la imagen
`n`	integer	No	Número de imágenes, por defecto 1
`size`	string	No	Tamaño de la imagen, como `1024x1024`. No uses el signo de multiplicación `×`
`quality`	string	No	Calidad, como `standard`, `hd` o `auto`
`response_format`	string	No	Formato de respuesta, como `url` o `b64_json`, según el modelo
`style`	any	No	Campo de extensión de imagen de OpenAI
`background`, `moderation`	any	No	Campos de extensión más recientes del modelo de imagen
`output_format`, `output_compression`	any	No	Opciones de formato de salida y compresión
`partial_images`, `stream`	any	No	Usado por modelos de imagen que admiten streaming
`image`, `images`	file/string/array	Requerido para ediciones	Imágenes a editar. Multipart acepta `image`, `image[]` o `image[n]`
`mask`	file/string	No	Máscara de edición
`input_fidelity`	any	No	Fidelidad de entrada, según el modelo
`watermark`	boolean	No	Interruptor de marca de agua, según el soporte del canal

Generar una Imagen

curl https://api.tensoraxis.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TENSORAXIS_API_KEY" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "A minimalist poster of a futuristic city",
    "size": "1024x1024"
  }'

Editar una Imagen

Usa datos de formulario multipart al subir archivos locales:

curl https://api.tensoraxis.com/v1/images/edits \
  -H "Authorization: Bearer $TENSORAXIS_API_KEY" \
  -F model="gpt-image-1" \
  -F prompt="Change the background to a night city" \
  -F image="@input.png"

Cuando el modelo seleccionado lo admite, también se pueden usar URLs de imagen en JSON:

{
  "model": "gpt-image-1",
  "prompt": "Change the background to a night city",
  "image": "https://example.com/input.png"
}

Estructura de la Respuesta

{
  "created": 1710000000,
  "data": [
    {
      "url": "https://example.com/result.png",
      "b64_json": "",
      "revised_prompt": "..."
    }
  ]
}

La generación de video no es una API de imágenes. Para los modelos de video Seedance / Doubao, usa el cuerpo de tarea asíncrona en Generación de Video.