Dokumentacja API Reve Art

Witamy w dokumentacji API generowania obrazów Reve Art. Usługa zapewnia najnowocześniejsze możliwości generowania obrazów oparte na sztucznej inteligencji za pośrednictwem prostego interfejsu REST API.

Wprowadzenie do Reve Image 1.0

Reve Image 1.0 to nasz flagowy model generowania tekstu na obraz, zaprojektowany z naciskiem na:

• Znakomitą zgodność z promptami
• Wysoką jakość estetyczną
• Dokładne renderowanie typografii
• Intuicyjne generowanie tekstu na obraz

Model został opracowany w celu uzyskania wysokiej jakości wyników bez konieczności posiadania zaawansowanej wiedzy z zakresu inżynierii promptów, co sprawia, że jest on dostępny zarówno dla początkujących, jak i doświadczonych użytkowników. Możesz wypróbować go za darmo na Create Image.

Przypadki użycia

API Reve Art można zintegrować z różnymi aplikacjami:

• Tworzenie treści: Generowanie unikalnych wizualizacji dla blogów, artykułów i mediów społecznościowych
• E-commerce: Tworzenie makiet produktów i ich wariantów
• Projektowanie i prototypowanie: Szybka wizualizacja koncepcji projektowych
• Gry i rozrywka: Generowanie zasobów do gier i projektów postaci
• Edukacja: Tworzenie materiałów edukacyjnych i ilustracji

Uwierzytelnianie

Wszystkie żądania API wymagają uwierzytelniania za pomocą klucza API.

Dodaj klucz API do nagłówka 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"}'

Jak zdobyć klucz API

Zaloguj się i dodaj swój klucz API na stronie Dashboard > API Key.

Następnie użyj klucza API do generowania obrazów.

Generowanie obrazu

Punkt końcowy generowania obrazu pozwala tworzyć obrazy z opisów tekstowych. Możesz kontrolować różne aspekty procesu generowania za pomocą parametrów.

Najlepsze praktyki

1. Inżynieria promptów

   • Bądź precyzyjny i opisowy w swoich promptach
   • Używaj terminów artystycznych do wskazówek dotyczących stylu
   • Zawrzyj szczegóły dotyczące oświetlenia, perspektywy i nastroju

2. Wybór proporcji obrazu

   • Wybierz na podstawie zamierzonego przypadku użycia
   • 1:1 dla postów w mediach społecznościowych
   • 16:9 dla prezentacji/banerów
   • 9:16 dla treści mobilnych

3. Generowanie asynchroniczne

   • Użyj async=true dla dłuższych generacji
   • Zaimplementuj sprawdzanie statusu dla lepszego doświadczenia użytkownika

POST /v1/images/generate

Treść żądania

{
  "prompt": "string",           // Wymagane: Prompt generowania obrazu
  "negative_prompt": "string",  // Opcjonalne: Czego unikać na obrazie
  "aspect_ratio": "string",    // Wymagane: Proporcje obrazu (domyślnie: "1:1")
  "async": boolean             // Opcjonalne: Generowanie asynchroniczne (domyślnie: false)
}

Proporcje obrazu

Proporcje obrazu. Obsługiwane proporcje: "1:1", "16:9", "4:3", "3:4", "9:16", "2:3", "3:2".

Odpowiedź synchroniczna

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

Odpowiedź asynchroniczna

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

Przykładowe użycie

Python:

import requests

api_key = "your_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": "a beautiful sunset over mountains",
        "aspect_ratio": "16:9"
    }
)

if response.ok:
    result = response.json()
    print(f"Image URL: {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") {
    // Poll for completion
    return await checkImageStatus(result.id);
  }

  return result;
}

Sprawdzanie statusu obrazu

GET /v1/reve-image/status/image_id

Odpowiedź

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

Przykładowe użycie

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();
}

Limity żądań

Żądania API są ograniczone przez Twój plan subskrypcji i dostępne kredyty.

• Każde generowanie obrazu kosztuje 1 kredyt
• Plan darmowy: 3 kredyty w zestawie
• Plan podstawowy: 100 kredytów miesięcznie
• Limit żądań: 10 żądań na minutę
• Jeśli potrzebujesz więcej kredytów, zaktualizuj swój plan lub kup więcej kredytów.