AI API

Présentation

Overview

Ce que propose l'API

What the API offers

L'API génère des images, des vidéos et des modèles 3D pour un compte client. Les moteurs disponibles dépendent du plan : ChatGpt, Leonardo et Tripo. Chaque génération consomme des crédits. Le fichier obtenu se télécharge par une URL signée, valable une heure, sans jeton.

The API generates images, videos and 3D models for a customer account. Available engines depend on the plan: ChatGpt, Leonardo and Tripo. Each generation spends credits. The file is downloaded from a signed URL, valid for one hour, without a token.

ChatGpt
Leonardo
Tripo

Demande de création de clés

Requesting credentials

Pour obtenir vos clés de connexion à l'API, il vous suffit de soumettre votre adresse mail, ainsi que les noms et prénoms de l'utilisateur principal ci dessous, vous recevrez alors un lien à usage unique vous permettant de récupérer vos identifiants et qui permettra d'activer votre compte.

To obtain your API access keys, simply submit your email address along with the first and last name of the primary user below, you will then receive a one-time-use link that will allow you to retrieve your credentials and activate your account.

Authentification des appels suivants

Authenticating later calls

Reconstituer le PEM : -----BEGIN PUBLIC KEY-----, le corps coupé tous les 64 caractères, puis -----END PUBLIC KEY-----.
Rebuild the PEM: -----BEGIN PUBLIC KEY-----, the body wrapped every 64 characters, then -----END PUBLIC KEY-----.
Concaténer le corps de la clé et le secret, sans séparateur.
Concatenate the key body and the secret, with no separator.
Découper cette chaîne en blocs de 200 caractères.
Split that string into 200-character chunks.
Chiffrer chaque bloc en RSA-OAEP avec la clé publique, puis l'encoder en Base64.
Encrypt each chunk with RSA-OAEP using the public key, then Base64-encode it.
Joindre les blocs avec un point. Cette chaîne est api_key.
Join the chunks with a dot. That string is api_key.

POST /auth
Content-Type: application/json

{ "api_key": "BASE64_CHUNK.BASE64_CHUNK" }

Le champ jwt s'envoie tel quel dans Authorization: Bearer. Il contient déjà le jeton, le caractère $ et api_key. Il expire au timestamp jwt_exp, 24 heures après sa création.

Send the jwt field as-is in Authorization: Bearer. It already contains the token, the $ character and api_key. It expires at the jwt_exp timestamp, 24 hours after it was created.

Utiliser l'API

Using the API

GET /person/getModels donne les modèles du plan. Les champs propres à un modèle se placent dans data.
GET /person/getModels returns the plan models. Model-specific fields go in data.
POST /tools/getCost estime le coût en crédits avant une génération.
POST /tools/getCost estimates the cost in credits before a generation.
POST /media/upload envoie une image source en Base64. L'object_id renvoyé sert à une génération qui part d'une image.
POST /media/upload sends a source image as Base64. The returned object_id is used by a generation that starts from an image.
POST /image/create, /video/create, /3dmodel/create et /3dmodel/createmultiview lancent une génération. Le succès contient une URL dans file ou url, et le coût dans real_cost.
POST /image/create, /video/create, /3dmodel/create and /3dmodel/createmultiview start a generation. Success contains a URL in file or url, and the cost in real_cost.
POST /tools/checkTask relit une tâche du compte. GET /person/getBalance et GET /person/getData donnent le solde et la fiche.
POST /tools/checkTask reads a task that belongs to the account. GET /person/getBalance and GET /person/getData return the balance and the account summary.

Référence

Reference

Le contrat OpenAPI est inclus dans cette page. Le fichier openapi.yaml reste disponible à côté.

The OpenAPI contract is included in this page. The openapi.yaml file stays beside it.