SamImageGenerator
Commencer
Se connecter

API

Générez des images depuis votre propre code avec une seule clé.

Connectez-vous pour créer votre clé API.

Se connecter

Générer une image

Envoyez un texte descriptif, recevez une image.

# 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"

Appelle le vrai endpoint avec la clé ci-dessus et consomme un crédit — exactement l’appel que fera votre code.

Réponse

// 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
}

// Erreurs
// 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" }

Modèle

  • samimage-miniSam Mini1 crédit
  • samimage-maxSam Max1 crédit · Max

Style

  • realisticRéaliste
  • animeAnime
  • 3d3D
  • watercolorAquarelle
  • oilPeinture à l’huile
  • pixelPixel art
  • cyberpunkCyberpunk
  • fantasyFantasy
  • minimalMinimaliste
  • sketchCroquis au crayon
  • comicBD
  • cartoonDessin animé
  • lineartDessin au trait
  • lowpolyLow poly
  • isometricIsométrique
  • vaporwaveVaporwave
  • steampunkSteampunk
  • noirNoir
  • popartPop art
  • impressionistImpressionniste
  • surrealSurréaliste
  • neonNéon
  • clayPâte à modeler
  • papercutPapier découpé
  • editModifier

Format

  • 1:1Carré
  • 16:9Large
  • 9:16Haut
  • 4:3Standard

Taille

  • 1K1024×1024
  • 2K2048×2048

Champs

  • promptstring · 5000
  • style25 × string · facultatif
  • aspect1:1 | 16:9 | 9:16 | 4:3 · facultatif
  • 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

Erreurs

  • 401unauthorizedLa clé est absente ou n’est plus valide.
  • 401browser-keyCette clé possède une liste de sites autorisés : elle est faite pour l’intégration. Les appels serveur exigent une clé sans site listé.
  • 429too-many-requests · 30/60sTrop de tentatives. Veuillez patienter quelques minutes.
  • 200no-creditsVous n’avez plus de crédits. Abonnez-vous ou achetez des crédits pour continuer à générer.
  • 200no-promptDécrivez d’abord ce que vous voulez générer.
  • 200not-configuredLa génération d’images n’est pas disponible pour le moment.
  • 200generation-failedCette génération a échoué. Veuillez réessayer.
  • 200image-too-largeCette image est trop lourde. Utilisez-en une de moins de 8 Mo.
  • 200not-allowedLa génération d’images est désactivée pour ce compte. Contactez le support.
  • 200storage-failedL’image a été créée mais n’a pas pu être enregistrée. Cela vient de nous — prévenez le support.
  • 200no-source-imageChoisissez d’abord une image à modifier.
  • 200busyTrop de demandes en même temps. Vos crédits sont intacts — réessayez dans un instant.
  • 200blockedCette instruction enfreint notre politique d’utilisation acceptable et n’a pas été envoyée. Aucun crédit n’a été utilisé.
  • 200email-unverifiedConfirmez votre adresse e-mail avant de générer. Ouvrez la page de votre compte pour recevoir un nouveau lien.