Reve Art API-Dokumentation

Vielen Dank, dass Sie die Bildgenerierungs-API von Reve Art verwenden. Dieser Service wird über eine einfache REST-API bereitgestellt, die fortschrittliche KI-gestützte Bildgenerierungsfunktionen bietet.

Übersicht über Reve Image 1.0

Reve Image 1.0 ist unser Flaggschiff-Modell zur Text-zu-Bild-Generierung mit den folgenden Funktionen:

  • Ausgezeichnete Prompt-Treue
  • Hohe ästhetische Qualität
  • Präzises Rendering von Typografie
  • Intuitive Text-zu-Bild-Generierung

Dieses Modell ist sowohl für Anfänger als auch für erfahrene Benutzer zugänglich, ohne dass fortgeschrittene Kenntnisse im Prompt-Engineering erforderlich sind. Probieren Sie es kostenlos unter Bild erstellen aus.

Anwendungsfälle

Die Reve Art API kann in verschiedene Anwendungen integriert werden:

  • Inhaltserstellung: Generieren Sie einzigartige Grafiken für Blogs, Artikel und soziale Medien
  • E-Commerce: Erstellen Sie Produktmodelle und -variationen
  • Design & Prototyping: Visualisieren Sie schnell Designkonzepte
  • Spiele & Unterhaltung: Generieren Sie Spiel-Assets und Charakterdesigns
  • Bildung: Erstellen Sie Lehrmaterialien und Illustrationen

Authentifizierung

Alle API-Anfragen erfordern eine Authentifizierung mit einem API-Schlüssel.

Fügen Sie den API-Schlüssel dem Autorisierungs-Header hinzu:

curl -X POST https://reve-art.com/v1/reve-image/generate \
-H "Authorization: Bearer Ihr_API_Schlüssel" \
-H "Content-Type: application/json" \
-d '{"prompt": "Ihr Prompt hier", "aspect_ratio": "1:1"}'

So erhalten Sie einen API-Schlüssel

Bitte melden Sie sich an und fügen Sie Ihren API-Schlüssel auf der Seite Dashboard > API-Schlüssel hinzu.

Verwenden Sie dann den API-Schlüssel, um Bilder zu generieren.

Bild generieren

Der Endpunkt zur Bildgenerierung ermöglicht es Ihnen, Bilder aus Textbeschreibungen zu erstellen. Sie können verschiedene Aspekte des Generierungsprozesses über Parameter steuern.

Best Practices

  1. Prompt-Engineering

    • Seien Sie in Ihren Prompts spezifisch und beschreibend
    • Verwenden Sie künstlerische Begriffe für Stilvorgaben
    • Fügen Sie Details zu Beleuchtung, Perspektive und Stimmung hinzu
  2. Auswahl des Seitenverhältnisses

    • Wählen Sie basierend auf Ihrem beabsichtigten Anwendungsfall
    • 1:1 für Social-Media-Posts
    • 16:9 für Präsentationen/Banner
    • 9:16 für mobile Inhalte
  3. Asynchrone Generierung

    • Verwenden Sie async=true für längere Generierungen
    • Implementieren Sie Statusabfragen für eine bessere Benutzererfahrung

POST /v1/images/generate

Request Body

{
  "prompt": "string",           // Erforderlich: Der Prompt zur Bildgenerierung
  "negative_prompt": "string",  // Optional: Dinge, die im Bild vermieden werden sollen
  "aspect_ratio": "string",    // Erforderlich: Seitenverhältnis des Bildes (Standard: "1:1")
  "async": boolean             // Optional: Asynchrone Generierung (Standard: false)
}

Seitenverhältnis

Das Seitenverhältnis des Bildes. Unterstützte Verhältnisse: "1:1", "16:9", "4:3", "3:4", "9:16", "2:3", "3:2".

Synchrone Antwort

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

Asynchrone Antwort

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

Anwendungsbeispiel

Python:

import requests

api_key = "Ihr_API_Schlüssel"
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": "ein wunderschöner Sonnenuntergang über den Bergen",
        "aspect_ratio": "16:9"
    }
)

if response.ok:
    result = response.json()
    print(f"Bild-URL: {result['url']}")
else:
    print(f"Fehler: {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(`Fehler beim Generieren des Bildes: ${response.statusText}`);
  }

  const result = await response.json();
  
  if (result.status === "pending") {
    // Abfrage auf Fertigstellung
    return await checkImageStatus(result.id);
  }

  return result;
}

Bildstatus überprüfen

GET /v1/reve-image/status/image_id

Antwort

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

Anwendungsbeispiel

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(`Fehler beim Überprüfen des Status: ${response.statusText}`);
  }

  return await response.json();
}

Ratenbegrenzungen

API-Anfragen sind durch Ihren Abonnementplan und die verfügbaren Credits begrenzt.