Documentation de l'API de génération d'images AI (v1)

Ce point de terminaison fournit une passerelle proxy sécurisée, vous permettant de déclencher des modèles de génération d'images IA sans exposer les identifiants de votre fournisseur de services sous-jacent.

1. Aperçu

Endpoint URL

https://www.aigosearch.com/wp-json/my-proxy/v1/generate-image

Method

POST

Content-Type

application/json

2. Authentification

Toutes les requêtes doivent inclure un jeton de sécurité dans l'en-tête HTTP pour empêcher tout accès non autorisé. Vous devez obtenir ce jeton auprès de votre administrateur.

Header

X-Proxy-Token: YOUR_API_TOKEN_HERE

3. Paramètres de requête

Tous les paramètres doivent être envoyés dans le corps de la requête JSON.

Paramètre	Type	Requis	Description
Invite	Chaîne de caractères	Oui	Description textuelle de l'image que vous souhaitez générer.
Taille	Chaîne de caractères	Non	Résolution de l'image. Par défaut : `1024x1024`Valeurs prises en charge : `256x256`, `512x512`, `1024x1024`
Nombre d'images à générer	integer	Non	Nombre d'images à générer. Par défaut : `1`Plage recommandée : `1–4`

4. Exemple cURL

curl https://www.aigosearch.com/wp-json/my-proxy/v1/generate-image \
  -X POST \
  -H "Content-Type: application/json" \
  -H "X-Proxy-Token: YOUR_API_TOKEN_HERE" \
  -d '{
    "prompt": "A futuristic mechanical cat, photorealistic",
    "size": "1024x1024",
    "n": 1
  }'

5. Exemple en JavaScript

📄

const API_TOKEN = 'YOUR_API_TOKEN_HERE'; // Replace with your actual token

fetch('https://www.aigosearch.com/wp-json/my-proxy/v1/generate-image', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'X-Proxy-Token': API_TOKEN
    },
    body: JSON.stringify({
        "prompt": "A futuristic mechanical cat, photorealistic",
        "size": "1024x1024",
        "n": 1
    })
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

6. Format de réponse

📄

5. Response Format

{
    "created": 1773223961,
    "data": [
        {
            "url": "https://example-image-url.com/generated.png"
        }
    ],
    "output_format": "png",
    "usage": {
        "total_tokens": 4182
    }
}

7. Réponses d'erreur

Si une erreur se produit, l'API renverra un message d'erreur au format JSON.

📋

{
  "error": {
    "message": "Invalid API token",
    "code": 403
  }
}

8. Codes de statut

Code	Signification
200	Requête réussie
400	Paramètres de requête invalides
403	Jeton API invalide ou manquant
500	Échec ou expiration du service IA distant