# Einmal pro neuem Generierungsvorgang erstellen; bei Wiederholungen den ursprünglichen Wert beibehalten.
IDEMPOTENCY_KEY="$(uuidgen)"

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-APIMart-Response-Version: 2026-07-27' \
  --header "Idempotency-Key: ${IDEMPOTENCY_KEY}" \
  --data '{
    "model": "gpt-image-2.5-ext",
    "version": "flare",
    "prompt": "Eine gemütliche Leseecke am Fenster an einem regnerischen Tag, eine warm leuchtende Tischlampe, filmische Beleuchtung",
    "size": "1:1",
    "resolution": "1K",
    "n": 1
  }'

import uuid
import requests

# Einmal pro neuem Generierungsvorgang erstellen; bei Wiederholungen die ursprünglichen headers und payload wiederverwenden.
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json",
    "X-APIMart-Response-Version": "2026-07-27",
    "Idempotency-Key": str(uuid.uuid4()),
}
payload = {
    "model": "gpt-image-2.5-ext",
    "version": "flare",
    "prompt": "Eine gemütliche Leseecke am Fenster an einem regnerischen Tag, eine warm leuchtende Tischlampe, filmische Beleuchtung",
    "size": "1:1",
    "resolution": "1K",
    "n": 1,
}

response = requests.post(
    "https://api.apimart.ai/v1/images/generations",
    headers=headers,
    json=payload,
)

print(response.status_code, response.json())

// Einmal pro neuem Generierungsvorgang erstellen; bei Wiederholungen die ursprünglichen headers und body wiederverwenden.
const headers = {
  Authorization: "Bearer <token>",
  "Content-Type": "application/json",
  "X-APIMart-Response-Version": "2026-07-27",
  "Idempotency-Key": crypto.randomUUID(),
};
const body = JSON.stringify({
  model: "gpt-image-2.5-ext",
  version: "flare",
  prompt: "Eine gemütliche Leseecke am Fenster an einem regnerischen Tag, eine warm leuchtende Tischlampe, filmische Beleuchtung",
  size: "1:1",
  resolution: "1K",
  n: 1,
});

const response = await fetch(
  "https://api.apimart.ai/v1/images/generations",
  { method: "POST", headers, body },
);

console.log(response.status, await response.json());

{
  "code": 202,
  "request_id": "req_example",
  "data": {
    "id": "task_01EXAMPLE",
    "object": "generation.task",
    "type": "image",
    "status": "pending",
    "progress": 0,
    "poll_url": "/v1/tasks/task_01EXAMPLE"
  }
}

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01EXAMPLE"
    }
  ]
}

{
  "error": {
    "message": "n must be an integer between 1 and 4",
    "type": "invalid_request_error",
    "param": "",
    "code": "invalid_request_error"
  }
}