Aller au contenu principal

Intégrations

Intégrez l’image, la vidéo et certains modèles de langage via une API cohérente.

Utilisez les appels compatibles OpenAI pour le chat et le jeu de rôle, ou l’API de tâches pour les images, vidéos et fichiers audio. Choisissez un modèle, gardez la clé sur votre serveur et suivez le parcours adapté au résultat souhaité.

Choisissez votre voie

Une clé API, quatre façons de se connecter

Commencez là où vous travaillez déjà. Chaque voie mène aux mêmes modèles, aux mêmes tarifs.

Démarrage en 5 minutes

Votre première image en quatre étapes

Créez une tâche, gardez son ID, puis récupérez le fichier terminé. Le même schéma vaut pour tous les modèles d’image, de vidéo et d’audio.

  1. 01

    Choisir un modèle

    Comparer usage, entrées, politique, disponibilité actuelle et prix.

  2. 02

    Copier la requête

    Remplacez l’ID de modèle et l’input de l’exemple par les champs exacts affichés sur la page de ce modèle. Ne devinez jamais les paramètres d’après un autre modèle.

  3. 03

    Envoyer depuis le serveur

    HTTP 202 signifie que la tâche est acceptée, pas que la génération est terminée ; le code métier de l’enveloppe reste code: 200. Enregistrez data.taskId immédiatement ; estimatedCost est le montant réservé pour cette tâche.

  4. 04

    Interroger le statut avec un nombre limité de tentatives

    queued et running sont encore en cours ; succeeded, failed et expired sont terminaux. Arrêtez d’interroger dès qu’un état terminal apparaît, au lieu d’attendre seulement le succès.

curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-8814-render-1" \
  -d '{
    "model": "alibaba/z-image-turbo/text-to-image",
    "input": { "prompt": "A ceramic teapot on a linen cloth, soft window light" }
  }'

alibaba/z-image-turbo/text-to-image est un véritable point de terminaison texte-vers-image. Pour un autre modèle de médias, utilisez son identifiant exact et son schéma.

Annuaire

Toutes les intégrations au même endroit

Choisissez l’outil que vous utilisez déjà. Chaque carte ouvre son guide de configuration.

Sécurité côté serveur

Trois points à traiter avant la production

Ces trois règles couvrent la fuite de clé, la double facturation et la perte de tâche. C’est le minimum avant la mise en production.

Garder la clé API côté serveur

N’exposez jamais la clé dans le navigateur, l’application mobile, un prompt, un journal ou une sortie d’agent. Envoyez les requêtes depuis un backend sous votre contrôle.

Idempotency-Key

Envoyez un Idempotency-Key stable à chaque création de tâche. Si le résultat réseau est incertain, rejouez le même travail avec la même clé pour ne jamais créer deux tâches facturables.

Suivre les tâches média acceptées

Conservez l’ID de tâche et utilisez un webhook signé ou des vérifications bornées. Une tâche acceptée démarre et ne peut pas être annulée. Les tâches échouées ou expirées ne sont généralement pas facturées. Certains modèles facturent les refus de contenu comme indiqué sur leur page ; consultez ces conditions avant l’envoi.

Documentation API

Ouvrir la référence qui répond à votre question