API-Schlüssel holen

von ByteDance

Detailreiche Bilder und Edits aus bis zu zehn Referenzen

bytedance/seedream-5.0-pro/layer-decompositionAb 7 Creditspro Bild · 0,07 $
  • Bis 2K
  • Bis zu 10 Referenzbilder
  • 15 Seitenverhältnisse
  • Bild erstellen
  • Bild bearbeiten
  • Ebenen-Splitter
Pro layers late shiftBeispiele ansehen

Du rufst es mit dem Modellnamen bytedance/seedream-5.0-pro/layer-decomposition über POST /jobs/createTask auf, ab 7 Credits pro Bild (0,07 $). Neue Konten bekommen 30 kostenlose Credits, damit du es zuerst im Playground testen kannst.

Modellnamebytedance/seedream-5.0-pro/layer-decomposition
EndpunktPOST https://api.popnow.ai/api/v1/jobs/createTask
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "bytedance/seedream-5.0-pro/layer-decomposition",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "resolution": "1.5k",
    "output_format": "jpeg"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Der input ist aus dem Schema unten gebaut und besteht die Prüfung so, wie er dasteht. Ersetz Prompt und Links durch deine eigenen.

Preis

OptionCredits pro Bild≈ USD
resolution 1.5K6,30,063 $
resolution 1K6,30,063 $
resolution 2K12,60,13 $
resolution auto12,60,13 $

1 Credit = 0,01 $ · Alle Optionen und Preise: GET /models/bytedance/seedream-5.0-pro/layer-decomposition

Jede Aufgabe wird auf ganze Credits aufgerundet, ein Lauf in der günstigsten Stufe kostet also 7 Credits pro Bild (0,07 $).

Limits

Auflösungen
auto · 1K · 1.5K · 2K
Prompt-Länge (Zeichen)
5,000
Größter Upload
30 MB

Parameter

Diese Felder stammen aus demselben Schema, gegen das wir jede Anfrage prüfen. Nicht aufgeführte Felder werden abgelehnt.

  • image_urlstringPflicht

    Das Bild, von dem aus es losgeht.

    Bereich
    1 – … chars · image/jpeg, image/png, image/webp, image/gif · ≤ 30 MB
  • promptstringOptional

    Optional: name the elements to separate. Leave empty to let the model pick the main elements.

    Bereich
    1 – 5000 chars
  • resolutionstringOptionalÄndert den Preis

    Ausgabegröße. Größere Formate sind schärfer und kosten mehr.

    Standardwert
    "1.5k"
    Erlaubte Werte
    "auto""1k""1.5k""2k"
  • output_formatstringOptional

    Dateiformat des Ergebnisses.

    Standardwert
    "jpeg"
    Erlaubte Werte
    "jpeg""png"
Rohes JSON-Schema
{
  "additionalProperties": false,
  "properties": {
    "image_url": {
      "contentMediaType": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/gif"
      ],
      "description": "The finished image to split into layers.",
      "format": "uri",
      "minLength": 1,
      "type": "string"
    },
    "output_format": {
      "default": "jpeg",
      "description": "File format of the base image. Layers are always transparent PNG.",
      "enum": [
        "jpeg",
        "png"
      ],
      "type": "string"
    },
    "prompt": {
      "description": "Optional: name the elements to separate. Leave empty to let the model pick the main elements.",
      "maxLength": 5000,
      "minLength": 1,
      "type": "string"
    },
    "resolution": {
      "default": "1.5k",
      "description": "Output resolution tier. auto follows the size of the source image.",
      "enum": [
        "auto",
        "1k",
        "1.5k",
        "2k"
      ],
      "type": "string"
    }
  },
  "required": [
    "image_url"
  ],
  "type": "object"
}

Ein echtes Ergebnis von Seedream 5.0 Pro

Pro layers late shift
PromptSeparate the LATE SHIFT title, the tagline, the woman in the red trench coat, the diner building and the ADMIT ONE ticket stub into their own layers
Dieselbe Anfrage über die API
{
  "model": "bytedance/seedream-5.0-pro/layer-decomposition",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "resolution": "1.5k",
    "output_format": "png",
    "prompt": "Separate the LATE SHIFT title, the tagline, the woman in the red trench coat, the diner building and the ADMIT ONE ticket stub into their own layers"
  }
}

Dieses Ergebnis startete mit einer hochgeladenen Datei: Setz deinen eigenen Link dort ein, wo der Beispiel-Link steht.

Antworten, Polling und Callbacks

Alle Modelle funktionieren gleich: Task anlegen, dann pollen oder auf den Callback warten.

Erst den Preis prüfen

cURL
curl -X POST https://api.popnow.ai/api/v1/jobs/quote \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bytedance/seedream-5.0-pro/layer-decomposition",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "resolution": "1.5k",
    "output_format": "jpeg"
  }
}'

Gleicher Body wie bei createTask. Liefert die erwartete und die höchstmögliche Abbuchung und startet nichts.

Angenommen

HTTP
HTTP/1.1 202 Accepted

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "state": "queued"
  },
  "request_id": "req_example_create"
}

HTTP 202 heißt: Der Task ist angenommen, die Credits sind reserviert, aber noch nicht abgebucht. Die endgültige Abbuchung liegt nie über der Reservierung.

Status abfragen

cURL
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Frag alle paar Sekunden mit wachsendem Abstand ab und hör auf, sobald state succeeded, failed, canceled oder expired ist.

Fertiger Task

JSON
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "bytedance/seedream-5.0-pro/layer-decomposition",
    "state": "succeeded",
    "output": {
      "assets": [
        {
          "url": "https://cdn.popnow.ai/tasks/task_01k3m8x9q2z4v7n5p6r8s0t1w3/output.png?signature=FROM_RESPONSE",
          "expiresAt": "2026-10-17T12:20:00Z",
          "mime": "image/png",
          "width": 1024,
          "height": 1024
        }
      ]
    },
    "settled": true
  },
  "request_id": "req_example_record"
}

Lad über die url vor expiresAt herunter. Später einen frischen Link nötig? Frag POST /common/download-url.

Callback prüfen

Node.js
import { createHash, createHmac, timingSafeEqual } from "node:crypto";
import express from "express";

const app = express();
// express.raw keeps the exact bytes that were signed; express.json would not match.
app.post("/hooks/popnow", express.raw({ type: "application/json" }), (req, res) => {
  const timestamp = req.header("X-Webhook-Timestamp");
  const signature = req.header("X-Webhook-Signature") ?? "";
  const body = JSON.parse(req.body.toString("utf8"));
  const taskId = body.data?.taskId ?? body.task_id;
  const digest = createHash("sha256").update(req.body).digest("hex");
  const expected = createHmac("sha256", process.env.POPNOW_WEBHOOK_SECRET)
    .update(`${taskId}.${timestamp}.${digest}`)
    .digest("base64");
  const ok = expected.length === signature.length && timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
  // Check the signature first, then reject anything older than five minutes.
  if (!ok || Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return res.status(401).end();
  res.status(200).end(); // answer fast, then fetch the task and store its files
});

Mit gesetzter callBackUrl schicken wir dir den fertigen Task. Prüf die Signatur am rohen Body, bevor du ihm vertraust.

Lokale Datei schicken

cURL
curl -X POST https://api.popnow.ai/api/v1/common/upload-url \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contentType": "image/png", "bytes": 482113}'

# PUT the file bytes to data.uploadUrl with every header in data.headers, then commit it:
curl -X POST https://api.popnow.ai/api/v1/files/$FILE_ID/commit \
  -H "Authorization: Bearer $POPNOW_API_KEY"
# The commit returns a popnow://f/... reference. Put it in any image, video or
# audio field of the task input instead of a public https URL.

Öffentliche https-Links funktionieren direkt. Lokale Dateien laufen vorher über upload-url und commit.