Documentação da API Reve Art

Bem-vindo à API de geração de imagens da Reve Art. O serviço fornece capacidades de geração de imagens impulsionadas por IA de última geração através de uma API REST simples.

Introdução ao Reve Image 1.0

Reve Image 1.0 é o nosso modelo de geração de texto para imagem de ponta, projetado com foco em:

• Aderência superior ao prompt
• Alta qualidade estética
• Renderização precisa de tipografia
• Geração intuitiva de texto para imagem

O modelo é projetado para produzir resultados de alta qualidade sem exigir experiência avançada em engenharia de prompts, tornando-o acessível tanto para iniciantes quanto para usuários experientes. Você pode experimentá-lo gratuitamente em Criar Imagem.

Casos de Uso

A API Reve Art pode ser integrada em várias aplicações:

• Criação de Conteúdo: Gere visuais únicos para blogs, artigos e redes sociais
• E-commerce: Crie maquetes e variações de produtos
• Design e Prototipagem: Visualize rapidamente conceitos de design
• Jogos e Entretenimento: Gere recursos de jogos e designs de personagens
• Educação: Crie materiais e ilustrações educacionais

Autenticação

Todas as requisições da API exigem autenticação usando uma chave de API.

Adicione a chave de API ao cabeçalho de Autorização:

bash
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"}'

Como obter a Chave da API

Por favor, faça login e adicione sua chave de API na página Painel > Chave de API.

Em seguida, use a chave de API para gerar imagens.

Gerar Imagem

O endpoint de geração de imagens permite que você crie imagens a partir de descrições de texto. Você pode controlar vários aspectos do processo de geração por meio de parâmetros.

Melhores Práticas

1. Engenharia de Prompt

   • Seja específico e descritivo em seus prompts
   • Use termos artísticos para orientação de estilo
   • Inclua detalhes sobre iluminação, perspectiva e humor

2. Seleção de Proporção

   • Escolha com base no seu caso de uso pretendido
   • 1:1 para postagens em redes sociais
   • 16:9 para apresentações/banners
   • 9:16 para conteúdo mobile

3. Geração Assíncrona

   • Use async=true para gerações mais longas
   • Implemente a pesquisa de status para uma melhor experiência do usuário

POST /v1/images/generate

Corpo da Requisição

{
  "prompt": "string",           // Obrigatório: O prompt de geração de imagem
  "negative_prompt": "string",  // Opcional: Coisas a evitar na imagem
  "aspect_ratio": "string",    // Obrigatório: Proporção da imagem (padrão: "1:1")
  "async": boolean             // Opcional: Geração assíncrona (padrão: false)
}

Proporção

A proporção da imagem. Proporções suportadas: "1:1", "16:9", "4:3", "3:4", "9:16", "2:3", "3:2".

Resposta Síncrona

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

Resposta Assíncrona

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

Exemplo de Uso

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") {
    // Polling for completion
    return await checkImageStatus(result.id);
  }

  return result;
}

Verificar Status da Imagem

GET /v1/reve-image/status/image_id

Resposta

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

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

Limites de Taxa

As requisições da API são limitadas pelo seu plano de assinatura e créditos disponíveis.

• Cada geração de imagem custa 1 crédito
• Plano gratuito: 3 créditos incluídos
• Plano básico: 100 créditos por mês
• Limite de taxa: 10 requisições por minuto
• Se você precisar de mais créditos, por favor atualize seu plano ou compre mais créditos.