Documentation

Présentation

Intégrez la génération d’images et de vidéos dans votre propre produit.

L’API expose exactement ce qu’utilise le studio : les mêmes modèles, le même calcul de coût, la même chaîne de rendu. Tout ce que vous produisez dans le navigateur, vous le produisez avec une clé, et les résultats atterrissent de la même façon dans votre bibliothèque de ressources.

Ce qui est possible

Texte / image vers imageImages de référence, formats d’image et paliers de qualité 1K/2K/4K. Jusqu’à 4 images par requête.
Texte / image vers vidéoPremière et dernière image, images de référence, plusieurs résolutions. La durée est ramenée dans les bornes du palier choisi.
Choix du modèleTous les modèles proposés sont appelables. Les ids et tarifs disponibles viennent de /v1/models.
Solde de créditsConsultez le solde à tout moment pour éviter qu’un traitement par lot ne s’arrête en cours de route.

Conception de l’API

La forme suit OpenAI : les clés commencent par sk-, voyagent dans Authorization: Bearer, les chemins sont sous /v1, et les échecs renvoient un objet error de structure fixe. Si vous avez déjà utilisé le SDK OpenAI, changer l’URL de base suffit presque.

La génération d’images accepte les deux modes. Par défaut elle est synchrone : l’appel attend que l’image soit prête et répond dans la même forme que le point d’accès images/generations d’OpenAI — le SDK OpenAI et les passerelles de relais peuvent donc brancher la plateforme telle quelle comme fournisseur compatible. Avec async: true vous passez en asynchrone : vous recevez immédiatement un id de tâche et lisez le résultat via GET /v1/tasks/{id}.

La vidéo est uniquement asynchrone : le rendu se compte en minutes, attendre en synchrone collerait la connexion au délai d’expiration de la passerelle, et une nouvelle tentative après ce délai facturerait deux fois. Pour les traitements par lots, une forte concurrence ou une latence sensible, préférez aussi l’asynchrone pour les images.

URL de base de tous les points d’accès : https://open.pikpikgo.com/v1

Étapes suivantes