API WAF v1

Générez des images, des sons et des modèles 3D par API. Authentification par clé (Authorization: Bearer wafk_…) — créez votre clé dans Mon compte (ce qu’elle fabrique entre dans votre galerie). Description machine : /openapi.json. Les créations sont épinglées sur IPFS automatiquement.

🎨 Image — POST /api/v1/generate

curl -X POST https://weareforger.data-space.world/api/v1/generate \
  -H "Authorization: Bearer wafk_VOTRE_CLE" -H "Content-Type: application/json" \
  -d '{"prompt":"un vaisseau spatial","style":"sci-fi","ratio":"16:9","count":2}'

→ { "images": [{ "id":"…", "url":"…", "seed":123 }], "prompt":"…" }

Options : style (30 presets ou « aleatoire »), ratio (1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9), count (1-4), magic ("on" = enrichissement IA), negative, seed, ready3d (true = optimisé conversion 3D).

🔊 Son — POST /api/v1/sfx

curl -X POST https://weareforger.data-space.world/api/v1/sfx \
  -H "Authorization: Bearer wafk_VOTRE_CLE" -H "Content-Type: application/json" \
  -d '{"prompt":"laser gun shot, sci-fi game","duration":2}'

→ { "sound": { "id":"…", "url":"…" } }   (synchrone, 30-120 s)

🧊 Modèle 3D — POST /api/v1/model3d

# 1) générez une image (ready3d:true conseillé), puis :
curl -X POST https://weareforger.data-space.world/api/v1/model3d \
  -H "Authorization: Bearer wafk_VOTRE_CLE" -H "Content-Type: application/json" \
  -d '{"imageId":"ID_DE_L_IMAGE"}'

→ 202 { "jobId":"…", "poll":"…/api/v1/jobs/…" }

# 2) suivez le job :
curl -H "Authorization: Bearer wafk_VOTRE_CLE" https://weareforger.data-space.world/api/v1/jobs/JOB_ID
→ { "status":"done", "result": { "url":"…glb", "ipfs":"ipfs://…", "pack":"…zip" } }

Limites

120 req/h (images) · 60 req/h (sons) · 30 jobs 3D/h par clé. Résultats adressés par contenu (CID IPFS) — récupérables sur n'importe quelle passerelle. Gratuit pendant la bêta.