Génération d'images

POST /api/v1/images/generations crée une à quatre images à partir d'une description textuelle. Portée requise : images:generate.

Corps JSON

Champ	Type	Obligatoire	Défaut	Règles
`prompt`	string	oui	—	espaces retirés, 5 à 2 000 caractères
`aspect_ratio`	string	non	`1:1`	`1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `5:4`, `4:5` ou `21:9`
`resolution`	string	non	`2K`	`2K` ou `4K`
`count`	integer	non	`1`	1 à 4

Les champs inconnus sont rejetés. La requête publique ne propose aucune option d'acheminement de capacité.

Crédits

Résolution	Crédits par image
`2K`	5
`4K`	20

La réservation totale vaut le coût unitaire multiplié par count. Les crédits sont réservés de façon atomique à l'acceptation du job, réglés en cas de succès et libérés en cas d'échec définitif.

cURL

curl https://sci-draw.com/api/v1/images/generations \
  -H 'Authorization: Bearer sd_YOUR_KEY' \
  -H 'Idempotency-Key: manuscript-42-panel-a' \
  -H 'Prefer: wait=10' \
  -H 'Content-Type: application/json' \
  -d '{"prompt":"A labeled plant cell diagram","aspect_ratio":"4:3","resolution":"2K","count":1}'

JavaScript

const response = await fetch('https://sci-draw.com/api/v1/images/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SCIDRAW_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json'

Python

import os, uuid, requests

response = requests.post(
    "https://sci-draw.com/api/v1/images/generations",
    headers={
        "Authorization": f"Bearer {os.environ['SCIDRAW_API_KEY']}"

Renvoie 202 tant que le job est en attente ou en cours, et 200 si l'attente bornée atteint un état terminal. Voir Jobs pour le schéma de réponse et la boucle d'interrogation.

Corps JSON

Crédits

cURL

JavaScript

Python

Table des matières