Images

À utiliser quand

• Ton app utilise déjà le format OpenAI Images API.
• Tu veux générer une ou plusieurs images depuis un prompt avec la même clé Prismatic que les endpoints texte.
• Le modèle sélectionné et sa route provider supportent tous les deux les images.

Exemples de code

curl https://api.prismaticapi.com/v1/images/generations   -H "Authorization: Bearer $PRISMATIC_API_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "imagen-4",
    "prompt": "A clean product mockup on a neutral desk",
    "image_url": ["https://example.com/reference.png"],
    "negative_prompt": "clutter, text artifacts",
    "aspect_ratio": "16:9",
    "quality": "high",
    "style": "natural",
    "seed": 42,
    "response_format": "b64_json",
    "n": 1
  }'

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.PRISMATIC_API_KEY,
  baseURL: "https://api.prismaticapi.com/v1"
});

const image = await client.images.generate({
  model: "imagen-4",
  prompt: "A clean product mockup on a neutral desk",
  image_url: "https://example.com/reference.png",
  negative_prompt: "clutter, text artifacts",
  aspect_ratio: "16:9",
  quality: "high",
  style: "natural",
  seed: 42,
  response_format: "b64_json",
  n: 1
});

Paramètres

• model (string, requis) — ID public retourné par GET /v1/models.
• prompt (string, requis) — Prompt texte décrivant l’image à générer.
• image_url (string ou array, optionnel) — URL(s) d’image de référence transmises en natif ou converties en contenu chat multimodal pour les providers chat-completions.
• negative_prompt, aspect_ratio, seed, quality, style, response_format, size et n sont acceptés et transmis quand la route provider sélectionnée les supporte.

Billing et limites

• Les limites API key et compte sont vérifiées avant la génération.
• Le quota subscription est réservé avant génération puis réglé après.
• Le coût PAYG génération vaut retail_generation_usd * n; la requête est refusée avant upstream si le prix génération manque ou si le wallet ne couvre pas l’estimation précise.
• Si le modèle ou la route provider ne supporte pas les images, la requête échoue avant tout appel upstream.

Notes

• GET /v1/models peut lister plusieurs IDs publics qui résolvent vers le même modèle canonique.
• Active le toggle Images sur un provider dans l’admin pour qu’il puisse recevoir du trafic de génération image.
• L’endpoint réécrit le modèle vers l’ID upstream avant le proxy.