Introduction

L'API Sprite AI transforme un prompt texte en sprites prêts pour le jeu et en animations sur sprite sheet. Appelez-la depuis un script, une étape de build, un serveur MCP ou une extension d'éditeur.

Les requêtes sont en JSON, authentifiées par une clé Bearer. Les images générées reviennent en base64 dans la réponse. Aucun fichier à télécharger à part.

Ce que vous pouvez faire

Générez ou importez une fois et vous obtenez un id de sprite. Animer un sprite (source_generation_id), changer son style, le pivoter, générer sa normal map et retirer son arrière-plan prennent tous cet id dans le même champ. Pour accorder un nouveau sprite à son style, passez-le en reference_asset_id. Vous ne renvoyez jamais les octets de l'image. Pour un fichier local, importez-le d'abord.

1. Créer une clé

Ouvrez l'onglet Clés API et générez-en une. Elle commence par sai_sk_ et s'affiche une seule fois. Copiez-la tout de suite.

2. Envoyer une requête

Envoyez un prompt et un type d'asset en POST, avec votre clé comme token Bearer.

curl https://www.sprite-ai.art/api/sprites \
-H "Authorization: Bearer sai_sk_your_key_here" \
-H "Content-Type: application/json" \
-d '{ "prompt": "a knight with a blue cape", "asset_type": "character" }'

const res = await fetch("https://www.sprite-ai.art/api/sprites", {
method: "POST",
headers: {
  Authorization: "Bearer sai_sk_your_key_here",
  "Content-Type": "application/json",
},
body: JSON.stringify({
  prompt: "a knight with a blue cape",
  asset_type: "character",
}),
});
const data = await res.json();

import base64, requests

res = requests.post(
  "https://www.sprite-ai.art/api/sprites",
  headers={"Authorization": "Bearer sai_sk_your_key_here"},
  json={"prompt": "a knight with a blue cape", "asset_type": "character"},
)
data = res.json()

3. Enregistrer l'image

Le PNG est dans image.pngBase64. Décodez-le et écrivez-le dans un fichier.

echo "iVBORw0KGgoAAAANS..." | base64 -d > knight.png

import { writeFile } from "fs/promises";

await writeFile("knight.png", Buffer.from(data.image.pngBase64, "base64"));

with open("knight.png", "wb") as f:
  f.write(base64.b64decode(data["image"]["pngBase64"]))

Synchrone ou asynchrone

Les sprites fixes sont synchrones. Une requête, l'image finie dans la réponse. Les animations prennent environ 15 secondes et tournent une à la fois par compte. Elles s'exécutent donc comme une tâche que vous lancez, puis interrogez jusqu'à la fin.

Vous ne choisissez pas de modèle. Décrivez ce que vous voulez, et la requête est routée selon le type d'asset et la taille.