Documentación de la API de generación de imágenes AI (v1)

Este punto final proporciona una pasarela proxy segura, lo que le permite activar modelos de generación de imágenes de IA sin exponer las credenciales de su proveedor de servicios subyacente.

1. Resumen

Endpoint URL

https://www.aigosearch.com/wp-json/my-proxy/v1/generate-image

Method

POST

Content-Type

application/json

2. Autenticación

Todas las solicitudes deben incluir un token de seguridad en el encabezado HTTP para evitar el acceso no autorizado. Debe obtener este token de su administrador.

Header

X-Proxy-Token: YOUR_API_TOKEN_HERE

3. Parámetros de solicitud

Todos los parámetros deben enviarse en el cuerpo de la solicitud JSON.

Parámetro	Tipo	Requerido	Descripción
Prompt	Cadena de texto	Sí	Descripción de texto de la imagen que desea generar.
Tamaño	Cadena de texto	No	Resolución de la imagen. Por defecto: `1024x1024`Valores admitidos: `256x256`, `512x512`, `1024x1024`
Número de imágenes a generar	integer	No	Número de imágenes a generar. Por defecto: `1`Rango recomendado: `1–4`

4. Ejemplo de cURL

curl https://www.aigosearch.com/wp-json/my-proxy/v1/generate-image \
  -X POST \
  -H "Content-Type: application/json" \
  -H "X-Proxy-Token: YOUR_API_TOKEN_HERE" \
  -d '{
    "prompt": "A futuristic mechanical cat, photorealistic",
    "size": "1024x1024",
    "n": 1
  }'

5. Ejemplo en JavaScript

📄

const API_TOKEN = 'YOUR_API_TOKEN_HERE'; // Replace with your actual token

fetch('https://www.aigosearch.com/wp-json/my-proxy/v1/generate-image', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'X-Proxy-Token': API_TOKEN
    },
    body: JSON.stringify({
        "prompt": "A futuristic mechanical cat, photorealistic",
        "size": "1024x1024",
        "n": 1
    })
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

6. Formato de respuesta

📄

5. Response Format

{
    "created": 1773223961,
    "data": [
        {
            "url": "https://example-image-url.com/generated.png"
        }
    ],
    "output_format": "png",
    "usage": {
        "total_tokens": 4182
    }
}

7. Respuestas de error

Si ocurre un error, la API devolverá un mensaje de error en formato JSON.

📋

{
  "error": {
    "message": "Invalid API token",
    "code": 403
  }
}

8. Códigos de estado

Código	Significado
200	Solicitud exitosa
400	Parámetros de solicitud no válidos
403	Token de API inválido o faltante
500	Error o tiempo de espera agotado del servicio de IA remoto