Documentación de la API de Reve Art

Bienvenido a la API de generación de imágenes de Reve Art. El servicio proporciona capacidades de generación de imágenes impulsadas por IA de última generación a través de una API REST simple.

Introducción a Reve Image 1.0

Reve Image 1.0 es nuestro modelo de generación de texto a imagen insignia, diseñado con un enfoque en:

Adherencia superior a las indicaciones
Alta calidad estética
Renderizado preciso de tipografía
Generación intuitiva de texto a imagen

El modelo está diseñado para producir resultados de alta calidad sin requerir experiencia avanzada en ingeniería de indicaciones, lo que lo hace accesible tanto para principiantes como para usuarios experimentados. Puedes probarlo gratis en Crear Imagen.

Casos de Uso

La API de Reve Art se puede integrar en varias aplicaciones:

Creación de contenido: Genera imágenes únicas para blogs, artículos y redes sociales
Comercio electrónico: Crea maquetas y variaciones de productos
Diseño y prototipado: Visualiza rápidamente conceptos de diseño
Juegos y entretenimiento: Genera recursos para juegos y diseños de personajes
Educación: Crea materiales educativos e ilustraciones

Autenticación

Todas las solicitudes de la API requieren autenticación mediante una clave API.

Añade la clave API al encabezado Authorization:

curl -X POST https://reve-art.com/v1/reve-image/generate \
-H "Authorization: Bearer your_api_key" \
-H "Content-Type: application/json" \
-d '{"prompt": "your prompt here", "aspect_ratio": "1:1"}'

Cómo obtener la clave API

Por favor, inicia sesión y añade tu clave API en la página Dashboard > API Key.

Luego, usa la clave API para generar imágenes.

Generar Imagen

El punto final de generación de imágenes te permite crear imágenes a partir de descripciones de texto. Puedes controlar varios aspectos del proceso de generación a través de parámetros.

Mejores prácticas

Ingeniería de indicaciones
- Sé específico y descriptivo en tus indicaciones
- Usa términos artísticos para la guía de estilo
- Incluye detalles sobre la iluminación, la perspectiva y el estado de ánimo
Selección de la relación de aspecto
- Elige según tu caso de uso previsto
- 1:1 para publicaciones en redes sociales
- 16:9 para presentaciones/banners
- 9:16 para contenido móvil
Generación asíncrona
- Usa async=true para generaciones más largas
- Implementa la consulta de estado para una mejor experiencia de usuario

POST /v1/images/generate

Cuerpo de la solicitud

{
  "prompt": "string",           // Requerido: La indicación de generación de imágenes
  "negative_prompt": "string",  // Opcional: Cosas a evitar en la imagen
  "aspect_ratio": "string",    // Requerido: Relación de aspecto de la imagen (por defecto: "1:1")
  "async": boolean             // Opcional: Generación asíncrona (por defecto: false)
}

Relación de aspecto

La relación de aspecto de la imagen. Relaciones admitidas: "1:1", "16:9", "4:3", "3:4", "9:16", "2:3", "3:2".

Respuesta síncrona

{
  "id": "img_123",
  "status": "completed",
  "url": "https://cdn.reve-art.com/img_123.png",
  "metadata": {
    "prompt": "tu indicación",
    "width": 1024,
    "height": 1024,
    "created_at": "2024-01-01T00:00:00Z"
  }
}

Respuesta asíncrona

{
  "id": "img_123",
  "status": "pending"
}

Ejemplo de uso

Python:

import requests

api_key = "tu_api_key"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

response = requests.post(
    "https://api.reve-art.com/v1/reve-image/generate",
    headers=headers,
    json={
        "prompt": "una hermosa puesta de sol sobre montañas",
        "aspect_ratio": "16:9"
    }
)

if response.ok:
    result = response.json()
    print(f"URL de la imagen: {result['url']}")
else:
    print(f"Error: {response.text}")

Node.js:

async function generateImage(prompt: string) {
  const response = await fetch("https://api.reve-art.com/v1/reve-image/generate", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${apiKey}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      prompt,
      aspect_ratio: "1:1",
      async: true,
    }),
  });

  if (!response.ok) {
    throw new Error(`Failed to generate image: ${response.statusText}`);
  }

  const result = await response.json();
  
  if (result.status === "pending") {
    // Encuesta para completar
    return await checkImageStatus(result.id);
  }

  return result;
}

Comprobar el estado de la imagen

GET /v1/reve-image/status/image_id

Respuesta

{
  "id": "img_123",
  "status": "completed",
  "url": "https://cdn.reve-art.com/img_123.png",
  "metadata": {
    "prompt": "indicación original",
    "width": 1024,
    "height": 1024,
    "model": "text2image_v1",
    "created_at": "2024-01-01T00:00:00Z"
  }
}

Ejemplo de uso

async function checkImageStatus(imageId: string) {
  const response = await fetch(
    `https://reve-art.com/v1/reve-image/status/${imageId}/`,
    {
      headers: {
        "Authorization": `Bearer ${apiKey}`,
      },
    }
  );

  if (!response.ok) {
    throw new Error(`Failed to check status: ${response.statusText}`);
  }

  return await response.json();
}

Límites de tasa

Las solicitudes de la API están limitadas por tu plan de suscripción y los créditos disponibles.

Cada generación de imagen cuesta 1 crédito
Plan gratuito: 3 créditos incluidos
Plan Básico: 100 créditos por mes
Límite de tasa: 10 solicitudes por minuto
Si necesitas más créditos, por favor actualiza tu plan o compra más créditos.