PopNowAPI-Doku
Hauptinhalt

Seedream 5.0 Pro API-Referenz

Detailreiche Bilder und Edits aus bis zu zehn Referenzen

Mit einem einzigen PopNow-API-Schlüssel rufst du Seedream 5.0 Pro aus deinem eigenen Code auf. Hier findest du die Modell-IDs, jedes Eingabefeld, die Kosten pro Anfrage in Credits und eine Anfrage, die du direkt ins Terminal kopieren kannst.

Die Parameterbeschreibungen stammen aus dem Eingabeschema des Modells und sind nur auf Englisch verfügbar.

Auf einen Blick

Hersteller
ByteDance
Ergebnis
Bild
Ab
5.4 Credits pro Bild ($0.054)
Typische Dauer
etwa 54 s

1 Credit = 0,01 $. Bei Annahme reserviert ein Task den höchstmöglichen Betrag und rechnet am Ende den tatsächlichen Verbrauch ab, auf ganze Credits aufgerundet; der Rest wird freigegeben. Fehlgeschlagene Tasks kosten nichts. Den genauen Betrag vorab liefert POST /api/v1/jobs/quote.

Bild erstellen

bytedance/seedream-5.0-pro/text-to-image

Preis

OptionCredits (pro Bild)US-Dollar
1k5.4$0.054
2k10.8$0.108

Parameter

FeldTypStandardwertErlaubtBedeutung
promptPflichtstring—bis zu 5.000 ZeichenDescribe the image to generate: subject, composition, style, and lighting.
aspect_ratioOptionalstring1:11:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 4:5, 5:4, 21:9, 9:21, 2:1, 1:2, 3:1, … (+1)Output aspect ratio.
resolutionOptionalstring2k1k, 2kOutput resolution tier.
output_formatOptionalstringjpegjpeg, pngFile format of the returned image.
enable_thinkingOptionalbooleantrue—Run a thinking pass that refines the prompt before generating. Off is faster.

Beispielanfrage

Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.

POST /api/v1/jobs/createTask
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: $(uuidgen)" \
  -d '{
  "model": "bytedance/seedream-5.0-pro/text-to-image",
  "input": {
    "prompt": "A cozy reading nook beside a rain-streaked window, warm lamp light, a sleeping orange cat on a knitted blanket, soft film grain",
    "resolution": "2k"
  }
}'

Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.

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

Bild bearbeiten

bytedance/seedream-5.0-pro/edit

Preis

OptionCredits (pro Bild)US-Dollar
1k5.4$0.054
2k10.8$0.108

Parameter

FeldTypStandardwertErlaubtBedeutung
promptPflichtstring—bis zu 5.000 ZeichenDescribe the image to produce from the source: subject, composition, style, and lighting.
image_urlsPflichtarray<string (uri)>—bis zu 10 EinträgeSource images that you are authorised to process.
aspect_ratioOptionalstringautoauto, 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 4:5, 5:4, 21:9, 9:21, 2:1, 1:2, … (+2)Output aspect ratio. auto picks the supported ratio closest to the first reference image.
resolutionOptionalstring2k1k, 2kOutput resolution tier.
output_formatOptionalstringjpegjpeg, pngFile format of the returned image.
backgroundOptionalstringopaqueopaque, transparentOpaque image, or a PNG with a transparent background (png output, one PNG input with alpha).
enable_thinkingOptionalbooleantrue—Run a thinking pass that refines the prompt before generating. Off is faster.

Beispielanfrage

Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.

Das Beispiel nutzt in image_urls Beispieldateien von PopNow. Ersetze sie durch eigene öffentliche HTTPS-Links, Uploads oder gespeicherte Assets.

POST /api/v1/jobs/createTask
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: $(uuidgen)" \
  -d '{
  "model": "bytedance/seedream-5.0-pro/edit",
  "input": {
    "prompt": "Change the orange jacket to deep forest green and add soft golden-hour light; keep the face, pose and background unchanged",
    "image_urls": [
      "https://media.popnow.ai/influencer/examples/marco.webp"
    ],
    "resolution": "2k"
  }
}'

Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.

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

Ebenen trennen

bytedance/seedream-5.0-pro/layer-decomposition

Preis

OptionCredits (pro Bild)US-Dollar
1.5k6.3$0.063
1k6.3$0.063
2k12.6$0.126
auto12.6$0.126

Parameter

FeldTypStandardwertErlaubtBedeutung
image_urlPflichtstring (uri)——The finished image to split into layers.
promptOptionalstring—bis zu 5.000 ZeichenOptional: name the elements to separate. Leave empty to let the model pick the main elements.
resolutionOptionalstring1.5kauto, 1k, 1.5k, 2kOutput resolution tier. auto follows the size of the source image.
output_formatOptionalstringjpegjpeg, pngFile format of the base image. Layers are always transparent PNG.

Beispielanfrage

Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.

Das Beispiel nutzt in image_url Beispieldateien von PopNow. Ersetze sie durch eigene öffentliche HTTPS-Links, Uploads oder gespeicherte Assets.

POST /api/v1/jobs/createTask
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: $(uuidgen)" \
  -d '{
  "model": "bytedance/seedream-5.0-pro/layer-decomposition",
  "input": {
    "prompt": "A bright, cheerful scene with soft natural light",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "resolution": "1.5k"
  }
}'

Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.

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

Weiter geht’s

Auf dieser Seite