SMS Images

v1.0.0

Génération d'images par SMS. Envoyez un SMS avec un prompt pour recevoir une image générée par IA, livrée par MMS.

Base URL : https://sms-images.s33d.fr

📸 Comment ça marche ?

📱
1. SMS avec un prompt
"un chat cyberpunk avec des lunettes néon"
🎨
2. Génération de l'image par IA
Votre image est créée en quelques instants
📬
3. Réception par MMS
L'image arrive sur votre téléphone

Authentification

L'API REST d'administration utilise une clé dans le header Authorization :

# Avec curl
curl -H "Authorization: Bearer VOTRE_ADMIN_KEY" \
https://sms-images.s33d.fr/health

Les utilisateurs SMS sont identifiés automatiquement par leur numéro de téléphone associé à leur compte Portal.

Quotas par plan

La génération d'images par SMS/MMS est limitée selon le plan de l'utilisateur Portal.

Free
3 images/jour
Pro
30 images/jour
Enterprise
100 images/jour

POST /generate

Génère une image à partir d'un prompt et l'envoie par MMS au numéro spécifié.

Paramètres (JSON body)

Paramètre Type Requis Description
to string oui Numéro de téléphone du destinataire
prompt string oui Description de l'image à générer

Exemple

curl -X POST https://sms-images.s33d.fr/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer VOTRE_CLÉ" \
  -d '{
    "to": "+33612345678",
    "prompt": "un paysage de montagne enneigée au coucher de soleil"
  }'

Réponse

{
  "success": true,
  "message_id": "mms_a1b2c3d4",
  "port_used": "/dev/ttyUSB2"
}

GET /status

Retourne l'état du service, des modems et de la boucle de traitement.

Réponse

{
  "status": "ok",
  "loop_running": true,
  "modems": [
    {
      "port": "/dev/ttyUSB2",
      "model": "GSM-LTE",
      "signal": 24,
      "operator": "Free",
      "mms_ready": true
    }
  ]
}

POST /loop/start · /loop/stop

Démarre ou arrête la boucle de traitement automatique des SMS/MMS entrants.

Quand la boucle est active, le service :

  • Lit les SMS/MMS entrants depuis les modems
  • Identifie l'utilisateur par son numéro de téléphone Portal
  • SMS texte → génération d'image par IA
  • Envoie le résultat par MMS

POST /modems/detect

Force un re-scan des modems connectés.

GET /health

Health check (sans authentification).

{"status": "ok", "service": "S33D-API-SMS-IMAGES"}

🚀 Exemples d'intégration

🐍 Python

import requests
 
resp = requests.post(
  "https://sms-images.s33d.fr/generate",
  headers={"Authorization": "Bearer KEY"},
  json={
    "to": "+33612345678",
    "prompt": "un chat astronaute"
  }
)
print(resp.json())
# Le destinataire recevra un MMS

📦 JavaScript

const res = await fetch(
  "https://sms-images.s33d.fr/generate",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${KEY}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      to: "+33612345678",
      prompt: "un paysage futuriste"
    })
  }
);
console.log(await res.json());
📱 Utilisation par SMS : Aucune API n'est nécessaire ! Envoyez simplement un SMS avec votre prompt au numéro du service. Si votre numéro est lié à un compte Portal, vous recevrez l'image par MMS.
← Documentation ← Accueil