media

Bild oder Video mit KI erstellen

Die Kosten werden zum festen Modellpreis in Credits des Arbeitsbereichs abgerechnet. Rufe zuerst estimate_only: true auf (kostenlos), um den genauen Preis zu erfahren, und dann erneut mit entsprechendem max_credits. Ein Bild ist normalerweise innerhalb von wait_seconds fertig. Ein Video dauert ein bis fünf Minuten: Rufe die Generierung per GET und ihrer ID ab. Bei einer fehlgeschlagenen Generierung werden die Credits zurückerstattet.

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

Erfordert media:generate, eine eigene Berechtigung: Zugangsdaten mit Bearbeitungsrechten für Websites können keine Credits ausgeben, solange sie diese Berechtigung nicht ebenfalls erhalten haben. Die Credits des Workspace werden belastet.

Rufen Sie den Endpunkt mit estimate_only: true auf. Das ist kostenlos und liefert estimated_credits (den exakten Preis) sowie balance.
Rufen Sie ihn erneut auf und setzen Sie max_credits auf diesen Preis. Ohne max_credits wird der Aufruf abgelehnt. Ein höherer Preis wird ebenfalls abgelehnt und es wird nichts berechnet: invalid_parameter bei max_credits, mit details.reason price_above_max_credits, details.estimated_credits und details.max_credits.

Die Credits werden beim Start der Generierung abgebucht. Schlägt sie fehl, werden sie zurückerstattet. Ein Bild ist normalerweise innerhalb von wait_seconds fertig (standardmäßig 50) und wird mit status: succeeded und den zugehörigen media zurückgegeben. Ein Video dauert ein bis fünf Minuten: Die Antwort enthält status: running und eine id; rufen Sie die Generierung ab, bis sie abgeschlossen ist.

Die Datei wird wie ein Upload in den Medien der Website abgelegt, wobei credit auf das verwendete Modell gesetzt ist. Stellen Sie ein generiertes Bild niemals als Foto des Unternehmens, seiner Produkte, seiner Mitarbeiter oder seiner Geschäftsräume dar.

Pro Workspace sind höchstens 10 Generierungen pro Minute möglich (darüber hinaus 429 rate_limited mit details.retry_after_seconds). Bei unzureichendem Guthaben wird 402 insufficient_credits mit details.needed und details.balance zurückgegeben. Ist ein Modell ausgelastet, schlägt die Generierung fehl und die Credits werden zurückerstattet. Versuchen Sie es in einer Minute erneut.

Autorisierung

Authorizationbearerin headerrequired

Pfadparameter

site_idstringrequired

ID der Website oder ihr Slug (die Adresse vor .atelier201.page).

Body

application/jsonrequired

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

GET /v1/media/models listet alle Modelle, ihre Stärken und ihre Preise in Credits auf.

promptstringrequiredlength: 1–4000 chars

Was angezeigt werden soll: Motiv, Umgebung, Licht, Bildausschnitt, Stil.

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

Breite zu Höhe. Jedes Modell akzeptiert die von list_media_models ausgegebenen Seitenverhältnisse. Standardmäßig wird das erste verwendet (bei den meisten Modellen 16:9).

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

Bilder: draft, standard (Standard) oder high.

durationintegerrange: 1–10

Videos: Dauer in Sekunden.

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

Videos: Standard ist die Auflösung des Modells (720p oder bei minimax und p-video 768p).

audioboolean

Videos: mit Ton (nur seedance).

filenamestringlength: 1–100 chars

Ein Name ohne Erweiterung.

altstringlength: ≤ 300 chars

estimate_onlyboolean

true: der genaue Preis in Credits und das Guthaben. Kostenlos, es wird nichts ausgeführt.

max_creditsintegerrange: ≤ 9007199254740991

Zum Ausführen erforderlich: der Höchstbetrag, den du ausgeben möchtest. Wird abgelehnt und nichts berechnet, wenn der Preis höher ist. Übernimm den Wert aus einem estimate_only-Aufruf.

wait_secondsintegerrange: 0–55

Wie lange auf das Ergebnis gewartet werden soll. Standardmäßig 50 bei einem Bild und 0 bei einem Video.

Antwort

application/json

Ein Bild oder Video mit KI erstellen

dataRecord<string, object>required

Show child attributes

data.idstring

Die ID der Generierung. Rufe sie per GET ab, bis der Status succeeded oder failed lautet.

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

Wer es erstellt hat, sofern eine Lizenzangabe erforderlich ist: "Photo by Jane Doe on Pixabay", "Generated with Seedream 5 Lite (ByteDance)". Bei Uploads null.

data.media.keep_originalbooleanrequired

Wird exakt so gespeichert, wie hochgeladen, und beim Build nie neu kodiert. Andernfalls wird ein Bild über 200 KB beim Eingang komprimiert (maximal 2000 px, Zielgröße etwa 150 KB, Qualität mindestens 75, Metadaten entfernt).

data.errorstringnull

data.creditsinteger | null

Die Kosten.

data.credits_refundedinteger | null

Bei einem Fehler zurückerstattet.

data.estimated_creditsintegerrange: -9007199254740991–9007199254740991

estimate_only: der genaue Preis der Generierung.

data.balancenumber

estimate_only: das aktuelle Credit-Guthaben des Arbeitsbereichs.

data.next_actionstringnullrequired

request_idstringrequired

Bild oder Video mit KI erstellen

Autorisierung

Pfadparameter

Body

Antwort

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookies