SamImageGenerator
Inizia ora
Accedi

API

Genera immagini dal tuo codice con un’unica chiave.

Accedi per creare la tua chiave API.

Accedi

Genera un’immagine

Invia un testo descrittivo, ricevi un’immagine.

# 1) Send the prompt. The endpoint does not wait for the image:
#    it queues the job and answers 202 with an id.
curl https://samimagegenerator.com/api/v1/generate \
  -H "Authorization: Bearer sig_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"a red fox in the snow","style":"realistic","aspect":"1:1","resolution":"1K","count":1,"model":"samimage-mini"}'

# 2) Ask for the result every couple of seconds until status is no longer "pending".
#    Generation takes 20-60s. Polling is safe to repeat: it never spends a credit.
curl "https://samimagegenerator.com/api/v1/generate?id=<ID>" \
  -H "Authorization: Bearer sig_your_key_here"

Chiama l’endpoint reale con la chiave qui sopra e consuma un credito: la stessa chiamata che farà il tuo codice.

Risposta

// 1) POST — the job is accepted, nothing is generated yet (202)
{ "ok": true, "id": "…", "status": "pending" }

// 2) GET ?id=… — while the worker is on it (200)
{ "ok": true, "status": "pending" }

// 2) GET ?id=… — finished (200)
{
  "ok": true,
  "status": "done",
  "generations": [
    { "id": "…", "model": "samimage-mini", "url": "https://samimagegenerator.com/api/generations/…/file" }
  ],
  "refunded": 0,
  // credits: null on an unlimited plan — there is no number to count down.
  "credits": 96
}

// Errori
// The job failed: HTTP is still 200 — the poll itself worked, the generation did not.
{ "ok": false, "status": "error", "error": "no-credits" }

// generation-failed / storage-failed: the credit was spent and refunded,
// so the fresh balance comes back with the error.
{ "ok": false, "status": "error", "error": "generation-failed", "credits": 96 }

// Unknown or expired id (404). Jobs are kept for one day.
{ "ok": false, "error": "not-found" }

Modello

  • samimage-miniSam Mini1 credito
  • samimage-maxSam Max1 credito · Max

Stile

  • realisticRealistico
  • animeAnime
  • 3d3D
  • watercolorAcquerello
  • oilPittura a olio
  • pixelPixel art
  • cyberpunkCyberpunk
  • fantasyFantasy
  • minimalMinimale
  • sketchSchizzo a matita
  • comicFumetto
  • cartoonCartone animato
  • lineartDisegno a tratto
  • lowpolyLow poly
  • isometricIsometrico
  • vaporwaveVaporwave
  • steampunkSteampunk
  • noirNoir
  • popartPop art
  • impressionistImpressionista
  • surrealSurreale
  • neonNeon
  • clayPlastilina
  • papercutCarta ritagliata
  • editModifica

Formato

  • 1:1Quadrato
  • 16:9Panoramico
  • 9:16Verticale
  • 4:3Standard

Dimensione

  • 1K1024×1024
  • 2K2048×2048

Campi

  • promptstring · 5000
  • style25 × string · facoltativo
  • aspect1:1 | 16:9 | 9:16 | 4:3 · facoltativo
  • resolution1K | 2K
  • count1-1
  • model2 × string
  • isPublicboolean
  • removeBgboolean
  • enhanceboolean
  • cleanboolean
  • useSeedboolean
  • sourceImagedata URI · 8 MB
  • markedImagedata URI · 8 MB
  • maskedboolean
  • regionsstring[] · 8 × 300
  • langen | de | es | fr | it | nl | pl | sv | tr | pt | hi | id | ko | ja | ar
  • referenceImages(url | data URI)[] · 4 × 8 MB

Errori

  • 401unauthorizedLa chiave manca o non è più valida.
  • 401browser-keyQuesta chiave ha un elenco di siti consentiti, quindi serve per l’incorporamento. Le chiamate da server richiedono una chiave senza siti elencati.
  • 429too-many-requests · 30/60sTroppi tentativi. Attendi qualche minuto.
  • 200no-creditsHai esaurito i crediti. Abbonati o acquista crediti per continuare a generare.
  • 200no-promptDescrivi prima cosa vuoi generare.
  • 200not-configuredLa generazione di immagini non è disponibile in questo momento.
  • 200generation-failedQuesta generazione non è riuscita. Riprova.
  • 200image-too-largeQuesta immagine è troppo grande. Usane una sotto gli 8 MB.
  • 200not-allowedLa generazione di immagini è disattivata per questo account. Contatta il supporto.
  • 200storage-failedL’immagine è stata creata ma non è stato possibile salvarla. È colpa nostra: avvisa il supporto.
  • 200no-source-imageScegli prima un’immagine da modificare.
  • 200busyTroppe richieste insieme. I tuoi crediti sono al sicuro: riprova tra poco.
  • 200blockedQuesta richiesta viola la nostra politica di uso accettabile e non è stata inviata. Nessun credito è stato utilizzato.
  • 200email-unverifiedConferma il tuo indirizzo e-mail prima di generare. Apri la pagina del tuo account per richiedere un nuovo link.