media

Criar uma imagem ou um vídeo com IA

O pagamento é feito com os créditos do espaço de trabalho, a um preço fixo por modelo. Primeiro, faça uma chamada com estimate_only: true (gratuita) para saber o preço exato. Em seguida, faça outra chamada com max_credits definido com esse valor. Uma imagem costuma ficar pronta dentro de wait_seconds; um vídeo leva de um a cinco minutos. Consulte a geração com GET usando o ID dela. Se a geração falhar, os créditos são devolvidos.

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>"
}

Requer media:generate, uma permissão específica: uma credencial que pode editar sites não pode gastar créditos, a menos que também tenha recebido essa permissão. Usa os créditos do espaço de trabalho.

Faça a chamada com estimate_only: true. Ela não custa nada e retorna estimated_credits (o preço exato) e balance.
Faça a chamada novamente com max_credits definido como esse preço. Sem max_credits, a chamada é recusada. Se o preço for maior que esse limite, a chamada é recusada sem cobrança: invalid_parameter em max_credits, com details.reason price_above_max_credits, details.estimated_credits e details.max_credits.

Os créditos são cobrados quando a geração começa. Se ela falhar, os créditos são devolvidos. Uma imagem costuma ficar pronta dentro de wait_seconds (50 por padrão) e é retornada com status: succeeded e sua media. Um vídeo leva de um a cinco minutos: a resposta é status: running com um id; consulte a geração até ela terminar.

O arquivo é adicionado à mídia do site como se tivesse sido enviado, com credit definido como o modelo que o criou. Nunca apresente uma imagem gerada como uma fotografia do negócio, de seus produtos, de seus funcionários ou de suas instalações.

São permitidas no máximo 10 gerações por minuto por espaço de trabalho (429 rate_limited ao ultrapassar esse limite, com details.retry_after_seconds). Se os créditos forem insuficientes: 402 insufficient_credits com details.needed e details.balance. Se o modelo estiver ocupado, a geração falha e os créditos são devolvidos: tente novamente em um minuto.

Autorizações

Authorizationbearerin headerrequired

Parâmetros de caminho

site_idstringrequired

O id do site ou seu slug (o endereço antes de .atelier201.page).

Corpo

application/jsonrequired

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

GET /v1/media/models lista cada modelo, para que ele é mais indicado e seus preços em créditos.

promptstringrequiredlength: 1–4000 chars

O que mostrar: assunto, cenário, iluminação, enquadramento, estilo.

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

Largura em relação à altura. Cada modelo aceita as proporções listadas por list_media_models. Por padrão, use a primeira (16:9 para a maioria).

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

Imagens: rascunho, padrão (default) ou alta.

durationintegerrange: 1–10

Vídeos: duração em segundos.

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

Vídeos: por padrão, a resolução do modelo (720p ou 768p para minimax e p-video).

audioboolean

Vídeos: com áudio (somente seedance).

filenamestringlength: 1–100 chars

Um nome sem extensão.

altstringlength: ≤ 300 chars

estimate_onlyboolean

true: o preço exato em créditos e o saldo. É gratuito e nada é executado.

max_creditsintegerrange: ≤ 9007199254740991

Obrigatório para executar: o valor máximo que você aceita gastar. A solicitação será recusada, sem cobrança, se o preço for maior. Use o valor de uma chamada estimate_only.

wait_secondsintegerrange: 0–55

Quanto tempo aguardar pelo resultado. O padrão é 50 para uma imagem e 0 para um vídeo.

Resposta

application/json

Crie uma imagem ou um vídeo com IA

dataRecord<string, object>required

Show child attributes

data.idstring

ID da geração: faça GET até que o status seja 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

Quem criou o conteúdo, quando a licença exige essa informação: "Photo by Jane Doe on Pixabay", "Generated with Seedream 5 Lite (ByteDance)". Null para arquivos enviados.

data.media.keep_originalbooleanrequired

Armazenado exatamente como foi enviado, sem nunca ser recodificado durante uma build. Caso contrário, imagens com mais de 200 KB são comprimidas ao chegar (no máximo 2000 px, para cerca de 150 KB, qualidade 75 ou superior, metadados removidos).

data.errorstringnull

data.creditsinteger | null

Quanto custou.

data.credits_refundedinteger | null

Devolvidos após uma falha.

data.estimated_creditsintegerrange: -9007199254740991–9007199254740991

estimate_only: o preço exato que seria cobrado.

data.balancenumber

estimate_only: os créditos disponíveis no espaço de trabalho no momento.

data.next_actionstringnullrequired

request_idstringrequired

Criar uma imagem ou um vídeo com IA

Autorizações

Parâmetros de caminho

Corpo

Resposta

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookies