Générer une image

Utilisez un modèle d'image actuellement activé sur ShareAI et autorisé par vos identifiants. Le modèle détermine les tailles, niveaux de qualité et options de sortie qu'il prend en charge.

Envoyez une requête#

curl --fail-with-body --request POST \
  "https://api.shareai.now/api/v1/images/generations" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_IMAGE_MODEL",
  "prompt": "A quiet forest painted in watercolor.",
  "n": 1,
  "size": "1024x1024"
}'

import json
import os
import urllib.request

headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'model': 'YOUR_IMAGE_MODEL', 'prompt': 'A quiet forest painted in watercolor.', 'n': 1, 'size': '1024x1024'}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/images/generations', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=180) as response:
    print(json.load(response))

const url = "https://api.shareai.now/api/v1/images/generations";
const headers: Record = {
  Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
  "model": "YOUR_IMAGE_MODEL",
  "prompt": "A quiet forest painted in watercolor.",
  "n": 1,
  "size": "1024x1024"
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());

Champs de la requête#

Lire l'image#

Inspectez les data entrées retournées. Selon le modèle et le format demandé, une entrée contient une URL d'image HTTPS ou des données d'image en base64. Utilisez le format réellement retourné ; ne supposez pas que chaque fournisseur retourne une URL. L'API ne télécharge pas les URL d'images retournées pour vous.

Limites de taille et de temps#

Les requêtes sont synchrones. Le texte combiné est limité à 256 KiB, l'appel au fournisseur à 120 secondes et la réponse à 2 MiB. Les grandes images en base64 peuvent dépasser cette limite de réponse. Sélectionnez une taille de sortie appropriée ou un modèle prenant en charge la sortie URL.

Réessayez avec précaution#

Générer une image peut entraîner des frais d'utilisation. Après un délai d'attente ou une défaillance réseau ambiguë, vérifiez l'activité avant de réessayer ; répéter la requête peut générer et facturer une autre image. L'API ne réessaie pas automatiquement une requête d'image après soumission à un fournisseur.

Opérations prises en charge#

Cette route génère des images à partir de texte. Les modifications d'images, variations, téléchargements multipartites et génération d'images en streaming ne sont pas pris en charge. La facturation actuelle nécessite un contrat d'utilisation de jetons modèle/fournisseur compatible ; les fournisseurs uniquement par image peuvent être indisponibles.

Utilisez l'autorisation du client#

Pour un flux OAuth approuvé, envoyez le jeton d'accès en tant que Bearer. La génération d'images financée par le compte nécessite surcharge et un plan d'utilisation accepté. Toutes les restrictions de modèle, fournisseur et compte restent en vigueur.