Documentation de l'API Reve Art

Bienvenue dans la documentation de l'API de génération d'images de Reve Art. Le service offre des capacités de génération d'images basées sur l'IA de pointe grâce à une simple API REST.

Introduction à Reve Image 1.0

Reve Image 1.0 est notre modèle phare de génération de texte en image, conçu en mettant l'accent sur :

Une adhésion supérieure aux instructions
Une qualité esthétique élevée
Un rendu précis de la typographie
Une génération texte-image intuitive

Le modèle est conçu pour produire des résultats de haute qualité sans nécessiter une expertise avancée en ingénierie des instructions, ce qui le rend accessible aux débutants comme aux utilisateurs expérimentés. Vous pouvez l'essayer gratuitement sur Créer une image.

Cas d'utilisation

L'API Reve Art peut être intégrée dans diverses applications :

Création de contenu : Générer des visuels uniques pour les blogs, les articles et les réseaux sociaux
Commerce électronique : Créer des maquettes et des variantes de produits
Conception et prototypage : Visualiser rapidement les concepts de conception
Jeux et divertissement : Générer des ressources de jeu et des conceptions de personnages
Éducation : Créer du matériel éducatif et des illustrations

Authentification

Toutes les requêtes API nécessitent une authentification à l'aide d'une clé API.

Ajoutez la clé API à l'en-tête d'autorisation :

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

Comment obtenir une clé API

Veuillez vous connecter et ajouter votre clé API dans la page Tableau de bord > Clés API.

Utilisez ensuite la clé API pour générer des images.

Générer une image

Le point de terminaison de génération d'images vous permet de créer des images à partir de descriptions textuelles. Vous pouvez contrôler divers aspects du processus de génération via des paramètres.

Meilleures pratiques

Ingénierie des instructions
- Soyez précis et descriptif dans vos instructions
- Utilisez des termes artistiques pour le guidage de style
- Incluez des détails sur l'éclairage, la perspective et l'ambiance
Sélection du rapport d'aspect
- Choisissez en fonction de votre cas d'utilisation prévu
- 1:1 pour les publications sur les réseaux sociaux
- 16:9 pour les présentations/bannières
- 9:16 pour le contenu mobile
Génération asynchrone
- Utilisez async=true pour les générations plus longues
- Mettez en œuvre un sondage d'état pour une meilleure expérience utilisateur

POST /v1/images/generate

Corps de la requête

{
  "prompt": "string",           // Requis : L'instruction de génération d'image
  "negative_prompt": "string",  // Optionnel : Les choses à éviter dans l'image
  "aspect_ratio": "string",    // Requis : Rapport d'aspect de l'image (par défaut : "1:1")
  "async": boolean             // Optionnel : Génération asynchrone (par défaut : false)
}

Rapport d'aspect

Le rapport d'aspect de l'image. Rapports pris en charge : "1:1", "16:9", "4:3", "3:4", "9:16", "2:3", "3:2".

Réponse synchrone

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

Réponse asynchrone

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

Exemple d'utilisation

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

Vérifier l'état de l'image

GET /v1/reve-image/status/image_id

Réponse

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

Exemple d'utilisation

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 débit

Les requêtes API sont limitées par votre plan d'abonnement et les crédits disponibles.

Chaque génération d'image coûte 1 crédit
Plan gratuit : 3 crédits inclus
Plan de base : 100 crédits par mois
Limite de débit : 10 requêtes par minute
Si vous avez besoin de plus de crédits, veuillez mettre à niveau votre plan ou acheter plus de crédits.