media

Générer une image ou une vidéo avec l’IA

Le paiement est prélevé sur les crédits de l’espace de travail, à un tarif fixe par modèle. Appelle d’abord avec estimate_only: true (gratuit) pour connaître le prix exact, puis rappelle l’API avec max_credits défini sur ce montant. Une image est généralement prête dans le délai indiqué par wait_seconds. Une vidéo prend une à cinq minutes : récupère la génération avec GET et son identifiant. Si une génération échoue, les crédits sont recrédités.

POST/v1/sites/{site_id}/media/generations

Request

curl --request POST \
  --url 'https://api.atelier201.com/v1/sites/<site_id>/media/generations' \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gpt-image",
  "prompt": "<string>"
}'

import json
import requests

url = "https://api.atelier201.com/v1/sites/<site_id>/media/generations"
headers = {
  "Authorization": "<api-key>",
  "Content-Type": "application/json"
}
payload = json.loads("{\"model\":\"gpt-image\",\"prompt\":\"<string>\"}")

response = requests.request("POST", url, headers=headers, json=payload)
print(response.json())

const response = await fetch("https://api.atelier201.com/v1/sites/<site_id>/media/generations", {
  method: "POST",
  headers: {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "model": "gpt-image",
    "prompt": "<string>"
  }),
});

const data = await response.json();
console.log(data);

<?php
$client = curl_init();

curl_setopt($client, CURLOPT_URL, "https://api.atelier201.com/v1/sites/<site_id>/media/generations");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
    "Content-Type: application/json",
]);
curl_setopt($client, CURLOPT_POSTFIELDS, "{\"model\":\"gpt-image\",\"prompt\":\"<string>\"}");
curl_setopt($client, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($client);
curl_close($client);
echo $response;

package main

import (
  "bytes"
  "fmt"
  "io"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("POST", "https://api.atelier201.com/v1/sites/<site_id>/media/generations", bytes.NewBuffer([]byte("{\"model\":\"gpt-image\",\"prompt\":\"<string>\"}")))
  req.Header.Set("Authorization", "<api-key>")
  req.Header.Set("Content-Type", "application/json")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var request = HttpRequest.newBuilder(URI.create("https://api.atelier201.com/v1/sites/<site_id>/media/generations"))
    .header("Authorization", "<api-key>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"model\":\"gpt-image\",\"prompt\":\"<string>\"}"))
    .build();

var response = HttpClient.newHttpClient().send(
    request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require 'net/http'
require 'json'

uri = URI("https://api.atelier201.com/v1/sites/<site_id>/media/generations")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "<api-key>"
request["Content-Type"] = "application/json"
request.body = "{\"model\":\"gpt-image\",\"prompt\":\"<string>\"}"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

puts response.body

application/json

{
  "data": {
    "id": "<string>",
    "status": "running",
    "media": {
      "path": "<string>",
      "url_path": "<string>",
      "mime": "<string>",
      "size": 123,
      "alt": null,
      "credit": null,
      "keep_original": true
    },
    "error": null,
    "credits": 123,
    "credits_refunded": 123,
    "estimated_credits": 123,
    "balance": 123.45,
    "next_action": null
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

Nécessite media:generate, une autorisation distincte : un identifiant qui permet de modifier des sites ne peut pas dépenser de crédits à moins que cette autorisation lui ait aussi été accordée. Les crédits de l’espace de travail sont utilisés.

Appelez l’endpoint avec estimate_only: true. Cela ne coûte rien et renvoie estimated_credits (le prix exact) et balance.
Rappelez l’endpoint en définissant max_credits sur ce prix. Sans max_credits, l’appel est refusé. Si le prix dépasse cette limite, l’appel est refusé sans frais : invalid_parameter sur max_credits, avec details.reason défini sur price_above_max_credits, ainsi que details.estimated_credits et details.max_credits.

Les crédits sont débités au démarrage de la génération. En cas d’échec, ils sont restitués. Une image est généralement prête dans le délai indiqué par wait_seconds (50 par défaut) ; la réponse contient alors status: succeeded et son media. Une vidéo prend entre une et cinq minutes : la réponse indique status: running avec un id ; récupérez la génération jusqu’à ce qu’elle soit terminée.

Le fichier est ajouté aux fichiers multimédias du site comme après un téléversement, avec credit défini sur le modèle qui l’a créé. Ne présentez jamais une image générée comme une photographie de l’entreprise, de ses produits, de ses employés ou de ses locaux.

La limite est de 10 générations par minute et par espace de travail (au-delà, 429 rate_limited avec details.retry_after_seconds). Crédits insuffisants : 402 insufficient_credits avec details.needed et details.balance. Si un modèle est occupé, la génération échoue et les crédits sont restitués : réessayez dans une minute.

Autorisations

Authorizationbearerin headerrequired

Paramètres de chemin

site_idstringrequired

L’identifiant du site ou son slug (l’adresse avant .atelier201.page).

Corps

application/jsonrequired

modelenum<string>requiredone of: gpt-image, nano-banana, flux, p-image, wan, minimax, seedance, p-video

GET /v1/media/models renvoie la liste des modèles, leurs points forts et leurs prix en crédits.

promptstringrequiredlength: 1–4000 chars

À décrire : sujet, décor, lumière, cadrage, style.

aspect_ratioenum<string>one of: 16:9, 1:1, 9:16, 4:3, 3:4, 3:2, 2:3

Rapport largeur/hauteur. Chaque modèle accepte les ratios indiqués par list_media_models. Par défaut, le premier ratio est utilisé (16:9 pour la plupart des modèles).

qualityenum<string>one of: draft, standard, high

Images : draft, standard (par défaut) ou high.

durationintegerrange: 1–10

Vidéos : durée en secondes.

resolutionenum<string>one of: 480p, 720p, 768p, 1080p, 2k

Vidéos : par défaut, la résolution du modèle (720p, ou 768p pour minimax et p-video).

audioboolean

Vidéos : avec son (seedance uniquement).

filenamestringlength: 1–100 chars

Nom sans extension.

altstringlength: ≤ 300 chars

estimate_onlyboolean

true : prix exact en crédits et solde. Gratuit, aucune génération n’est lancée.

max_creditsintegerrange: ≤ 9007199254740991

Obligatoire pour lancer la génération : montant maximal que vous acceptez de dépenser. Si le prix le dépasse, la demande est refusée et rien n’est débité. Reprenez le montant d’un appel avec estimate_only.

wait_secondsintegerrange: 0–55

Durée d’attente du résultat. Par défaut : 50 pour une image, 0 pour une vidéo.

Réponse

application/json

Génère une image ou une vidéo avec l’IA

dataRecord<string, object>required

Show child attributes

data.idstring

Identifiant de la génération : récupère-la avec GET jusqu’à ce que son statut soit succeeded ou failed.

data.statusenum<string>one of: running, succeeded, failed

data.mediaobject | null

Show child attributes

data.media.pathstringrequired

data.media.url_pathstringrequired

data.media.mimestringrequired

data.media.sizeintegerrequiredrange: -9007199254740991–9007199254740991

data.media.altstringnullrequired

data.media.creditstringnullrequired

Auteur, lorsque la licence l’exige : « Photo by Jane Doe on Pixabay », « Generated with Seedream 5 Lite (ByteDance) ». Null pour un fichier importé.

data.media.keep_originalbooleanrequired

Stocké exactement comme lors de l’importation, sans jamais être réencodé lors d’une génération. Sinon, toute image de plus de 200 KB est compressée à l’importation (2000 px maximum, cible de 150 KB, qualité de 75 ou plus, métadonnées supprimées).

data.errorstringnull

data.creditsinteger | null

Coût de la génération.

data.credits_refundedinteger | null

Crédits recrédités en cas d’échec.

data.estimated_creditsintegerrange: -9007199254740991–9007199254740991

estimate_only : le prix exact de la génération.

data.balancenumber

estimate_only : solde actuel de l’espace de travail en crédits.

data.next_actionstringnullrequired

request_idstringrequired

Générer une image ou une vidéo avec l’IA

Autorisations

Paramètres de chemin

Corps

Réponse

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookies