Générer des images
La réponse JSON synchrone contient les résultats d'image dans les données.
Sur cette page
https://api.shareai.now/api/v1/imagesGénérer des images
- URL de base
https://api.shareai.now- Authentification
- Clé API Bearer ou jeton d'accès OAuth approuvé
- Portée requise
inferenceormonetization_gateway
La réponse JSON synchrone contient les résultats d'image dans data. L'alias /api/v1/images/generations est également pris en charge. Les options telles que taille, résolution, ratio d'aspect, qualité et format de sortie dépendent du modèle sélectionné. Les réponses sont limitées à 2 MiB ; réduisez le nombre ou la taille des images si nécessaire. Les images retournées sont limitées à 8192 pixels par côté.
Avant de commencer#
Configurez SHAREAI_API_KEY sur votre serveur et remplacez l'espace réservé du modèle par un modèle actuellement activé. Ne jamais exposer la clé API dans le code du navigateur. Le modèle, le compte, les identifiants et le fournisseur doivent tous autoriser cette opération. Les paramètres optionnels ci-dessous nécessitent la prise en charge du modèle ; les limites de sécurité de l'API ne garantissent pas que chaque modèle prend en charge chaque valeur.
Envoyez une requête#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/images" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_ENABLED_IMAGES_MODEL",
"prompt": "A quiet forest painted in watercolor.",
"n": 1
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_IMAGES_MODEL',
'prompt': 'A quiet forest painted in watercolor.',
'n': 1}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/images', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/images", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_IMAGES_MODEL",
"prompt": "A quiet forest painted in watercolor.",
"n": 1
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);Champs de la requête#
| Champ | Type | Signification et limites |
|---|---|---|
model requis | chaîne | Identifiant exact du modèle public activé. Doit déclarer cette opération et être autorisé par vos identifiants. |
prompt requis | chaîne | Invite de génération non vide, au maximum 256 KiB de texte UTF-8. |
n | entier | Nombre d'images optionnel, 1–10 ; par défaut 1. Votre modèle peut en permettre moins. |
size | chaîne | Taille de sortie prise en charge par le modèle, au maximum 100 caractères, par exemple 1024×1024. Tous les modèles ne prennent pas en charge cette option. |
resolution | chaîne | Sélecteur de résolution pris en charge par le modèle, au maximum 100 caractères ; doit correspondre à la variante tarifaire publiée. |
aspect_ratio | chaîne | Sélecteur de ratio d'aspect pris en charge par le modèle, au maximum 100 caractères. |
quality | chaîne | Sélecteur de qualité pris en charge par le modèle, au maximum 100 caractères ; peut sélectionner un taux différent. |
response_format | chaîne | Format de réponse pris en charge par le modèle, au maximum 100 caractères. L'opération détermine si le résultat est en JSON ou en binaire. |
output_format | chaîne | Sélecteur d'encodage de sortie pris en charge par le modèle, au maximum 100 caractères. |
background | chaîne | Paramètre optionnel de fond d'image lorsque pris en charge par le modèle. |
seed | entier | Graine optionnelle prise en charge par le modèle. La vidéo nécessite un entier non négatif ; la reproductibilité dépend de l'exécuteur. |
input_references | tableau | Au maximum 16 parties image_url typées avec image_url.url défini sur une URL HTTPS ou une URL de données d'image prise en charge. La prise en charge du modèle est requise. |
provider | objet | Préférences d'acheminement des fournisseurs facultatives. Utilisez provider.only pour les balises de fournisseurs acceptées, pas un préfixe dans l'ID du modèle. Les restrictions de compte et d'identifiants s'appliquent toujours. |
Lire le résultat#
Succès retourne HTTP 200 avec JSON. La réponse JSON synchrone contient les résultats d'image dans data. L'alias /api/v1/images/generations est également pris en charge. Les options telles que taille, résolution, ratio d'aspect, qualité et format de sortie dépendent du modèle sélectionné. Les réponses sont limitées à 2 MiB ; réduisez le nombre ou la taille des images si nécessaire. Les images retournées sont limitées à 8192 pixels par côté.
Unités de facturation#
Les tarifs d'image peuvent utiliser des images générées, des mégapixels mesurés, des références d'entrée, des requêtes ou des jetons signalés par le fournisseur. Une URL d'image n'est pas une mesure de taille d'image. Les tarifs en mégapixels nécessitent les dimensions des images retournées ; utilisez la sortie base64 pour ces routes.
Choisissez l'identifiant exact du modèle activé depuis la Console. Son opération déclarée et ses capacités d'entrée/sortie doivent correspondre à ce point de terminaison ; un modèle de chat texte ne peut pas être substitué pour une autre opération. Vos restrictions d'identifiants, de fournisseur et de compte s'appliquent toujours.
Tarification et utilisation#
Les tarifs sont publiés en crédits IA EUR pour le modèle, le fournisseur, les unités et les variantes sélectionnés. Seules les dimensions de son tarif actif sont facturées. Une estimation réserve des crédits avant l'exécution ; les frais finaux sont basés sur l'utilisation mesurée. Les prix peuvent dépendre de la résolution, du format de sortie ou d'une tranche d'utilisation. Consultez l'onglet Utilisation dans la Console pour vérifier le débit final de ShareAI. Les champs de coûts en amont et les octets multimédias ne sont pas convertis en nombres de jetons inventés.
Accès et erreurs#
Utiliser inference pour une inférence approuvée avec coût réseau ou monetization_gateway pour une majoration approuvée par le Builder et des conditions de facturation acceptées. Un accès basé uniquement sur l'identité n'autorise pas les dépenses. La validation, l'autorisation du modèle, les crédits insuffisants, les limites de taux et les échecs d'exécution renvoient une structure error. Après un délai d'attente ou une soumission incertaine, vérifiez l'onglet Utilisation ou le travail vidéo avant de créer une autre demande potentiellement payante.
Dernière mise à jour le 3 novembre 2026