Reve Art API Dokumentation

Velkommen til Reve Arts billedgenererings-API. Tjenesten leverer state-of-the-art AI-drevne billedgenereringsfunktioner gennem en simpel REST API.

Introduktion til Reve Image 1.0

Reve Image 1.0 er vores førende text-to-image-genereringsmodel, der er designet med fokus på:

• Overlegen overholdelse af prompts
• Høj æstetisk kvalitet
• Nøjagtig typografirendering
• Intuitiv text-to-image-generering

Modellen er udviklet til at producere resultater af høj kvalitet uden at kræve avanceret prompt-engineering-ekspertise, hvilket gør den tilgængelig for både begyndere og erfarne brugere. Du kan prøve den gratis på Create Image.

Anvendelsesområder

Reve Art API kan integreres i forskellige applikationer:

• Indholdsskabelse: Generer unikke billeder til blogs, artikler og sociale medier
• E-handel: Opret produktmockups og -variationer
• Design & Prototyping: Visualiser hurtigt designkoncepter
• Spil & Underholdning: Generer spilaktiver og karakterdesign
• Uddannelse: Opret undervisningsmaterialer og illustrationer

Godkendelse

Alle API-anmodninger kræver godkendelse ved hjælp af en API-nøgle.

Tilføj API-nøglen til Authorization-headeren:

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

Sådan får du en API-nøgle

Log ind, og tilføj din API-nøgle på siden Dashboard > API Key.

Brug derefter API-nøglen til at generere billeder.

Generer billede

Billedgenereringsslutpunktet giver dig mulighed for at oprette billeder ud fra tekstbeskrivelser. Du kan kontrollere forskellige aspekter af genereringsprocessen via parametre.

Bedste praksis

1. Prompt Engineering

   • Vær specifik og beskrivende i dine prompts
   • Brug kunstneriske udtryk til stilvejledning
   • Medtag detaljer om belysning, perspektiv og stemning

2. Valg af billedformat

   • Vælg baseret på dit tilsigtede brugsscenarie
   • 1:1 til opslag på sociale medier
   • 16:9 til præsentationer/bannere
   • 9:16 til mobilindhold

3. Asynkron generering

   • Brug async=true til længere genereringer
   • Implementer statusafstemning for en bedre brugeroplevelse

POST /v1/images/generate

Anmodningsbrødtekst

{
  "prompt": "string",           // Påkrævet: Promot til billedgenerering
  "negative_prompt": "string",  // Valgfrit: Ting, der skal undgås i billedet
  "aspect_ratio": "string",    // Påkrævet: Billedets billedformat (standard: "1:1")
  "async": boolean             // Valgfrit: Asynkron generering (standard: false)
}

Billedformat

Billedets billedformat. Understøttede formater: "1:1", "16:9", "4:3", "3:4", "9:16", "2:3", "3:2".

Synkron svar

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

Asynkront svar

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

Eksempel på brug

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") {
    // Afstem for fuldførelse
    return await checkImageStatus(result.id);
  }

  return result;
}

Kontroller billedstatus

GET /v1/reve-image/status/image_id

Svar

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

Eksempel på brug

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

Begrænsninger for brug

API-anmodninger er begrænsede af dit abonnement og tilgængelige kreditter.

• Hver billedgenerering koster 1 kredit
• Gratis plan: 3 kreditter inkluderet
• Basisplan: 100 kreditter pr. måned
• Begrænsning: 10 anmodninger pr. minut
• Hvis du har brug for flere kreditter, skal du opgradere din plan eller købe flere kreditter.