Référence API

Images : réponse directe

Aucun modèle disponible pour l'instant

Aucun modèle du catalogue ne prend en charge cette route actuellement. La page reste disponible pour référence.
POST/v1/images/generations

Génération d'images synchrone pour les modèles qui servent cette route, dans un seul corps au format OpenAI. La réponse contient les URL finales des images.

#Paramètres de la requête

  • modelstringobligatoire

    Un modèle d'image qui sert cette route synchrone. Les modèles fonctionnant uniquement par tâche la rejettent — utilisez /v1/images/tasks.

  • promptstringobligatoire

    Ce qu'il faut dessiner.

  • nintegerfacultatif

    Nombre d'images (la facturation est multipliée par image).

  • sizestringfacultatif

    Format prédéfini comme "16:9" — ce qu'attendent la plupart des modèles d'image ; les valeurs exactes figurent sur la fiche du modèle. Certains modèles plus anciens acceptent aussi WIDTHxHEIGHT.

  • resolutionstringfacultatif

    Palier de résolution de sortie comme "1K", "2K" ou "4K", si la fiche du modèle le mentionne — également une dimension de palier.

  • qualitystringfacultatif

    Niveau de qualité du fournisseur (par ex. standard / hd) — également une dimension de palier.

  • response_formatstringfacultatif

    "url" (par défaut) ou "b64_json" pour des octets intégrés.

Tarification par palier

size, quality et duration déterminent le palier facturé — la fiche du modèle indique le prix exact de chaque palier, et les appels échoués sont remboursés automatiquement.

#Erreurs associées

  • 422 unprocessable_entityLe fournisseur a rejeté des valeurs de paramètres transmises par la passerelle (par ex. taille ou durée non prise en charge).
  • 401Jeton bearer invalide ou manquant. Pas de error.code sur ce chemin — basez-vous sur le statut.
  • 402 insufficient_user_quotaLe solde du portefeuille ne couvre pas l'estimation préréservée.
  • 429Limitation par clé. Corps vide ; attendez Retry-After. Un 429 qui contient insufficient_user_quota correspond en revanche à un plafond de dépenses quotidien.
  • 503 model_not_foundModèle inconnu, ou aucun canal opérationnel ne le sert actuellement.

Table complète des codes d'erreur →

#Exemple de requête

curl https://www.aisplice.store/v1/images/generations \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_SYNC_IMAGE_MODEL",
    "prompt": "A cyberpunk skyline at dusk, neon rain",
    "size": "1:1"
  }'

#Réponse

response.json
{
  "created": 1720000000,
  "data": [{"url": "https://…"}]
}

Toujours bloqué ?

Envoyez-nous l'ID de requête ou le message d'erreur, et nous examinerons le problème.