Документация API Reve Art

Добро пожаловать в API генерации изображений Reve Art. Сервис предоставляет современные возможности генерации изображений на основе искусственного интеллекта через простой REST API.

Введение в Reve Image 1.0

Reve Image 1.0 - это наша флагманская модель генерации изображений из текста, разработанная с акцентом на:

• Превосходное соответствие запросу
• Высокое эстетическое качество
• Точная отрисовка типографики
• Интуитивная генерация текста в изображение

Модель разработана для получения высококачественных результатов без необходимости продвинутых знаний в области составления запросов, что делает ее доступной как для начинающих, так и для опытных пользователей. Вы можете попробовать это бесплатно на странице Создать изображение.

Варианты использования

API Reve Art может быть интегрирован в различные приложения:

• Создание контента: Генерация уникальных визуальных материалов для блогов, статей и социальных сетей
• Электронная коммерция: Создание макетов и вариаций продуктов
• Дизайн и прототипирование: Быстрая визуализация концепций дизайна
• Игры и развлечения: Генерация игровых активов и дизайнов персонажей
• Образование: Создание учебных материалов и иллюстраций

Аутентификация

Все запросы к API требуют аутентификации с использованием API ключа.

Добавьте API ключ в заголовок 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"}'

Как получить API ключ

Пожалуйста, войдите в систему и добавьте свой API ключ на странице Панель управления > API ключи.

Затем используйте API ключ для генерации изображений.

Генерация изображения

Конечная точка генерации изображений позволяет создавать изображения из текстовых описаний. Вы можете управлять различными аспектами процесса генерации с помощью параметров.

Лучшие практики

1. Разработка запроса

   • Будьте конкретны и описательны в своих запросах
   • Используйте художественные термины для руководства по стилю
   • Включайте детали об освещении, перспективе и настроении

2. Выбор соотношения сторон

   • Выбирайте в зависимости от предполагаемого варианта использования
   • 1:1 для публикаций в социальных сетях
   • 16:9 для презентаций/баннеров
   • 9:16 для мобильного контента

3. Асинхронная генерация

   • Используйте async=true для более длительных генераций
   • Реализуйте опрос статуса для лучшего взаимодействия с пользователем

POST /v1/images/generate

Тело запроса

{
  "prompt": "string",           // Обязательно: Запрос на генерацию изображения
  "negative_prompt": "string",  // Необязательно: Чего следует избегать на изображении
  "aspect_ratio": "string",    // Обязательно: Соотношение сторон изображения (по умолчанию: "1:1")
  "async": boolean             // Необязательно: Асинхронная генерация (по умолчанию: false)
}

Соотношение сторон

Соотношение сторон изображения. Поддерживаемые соотношения: "1:1", "16:9", "4:3", "3:4", "9:16", "2:3", "3:2".

Синхронный ответ

{
  "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"
  }
}

Асинхронный ответ

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

Пример использования

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

Проверка статуса изображения

GET /v1/reve-image/status/image_id

Ответ

{
  "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"
  }
}

Пример использования

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

Ограничения скорости

Запросы к API ограничены вашим тарифным планом и доступными кредитами.

• Генерация каждого изображения стоит 1 кредит
• Бесплатный план: 3 кредита включены
• Базовый план: 100 кредитов в месяц
• Ограничение скорости: 10 запросов в минуту
• Если вам нужно больше кредитов, пожалуйста, обновите свой план или купите больше кредитов.