Riferimento API di Seedream 5.0 Pro

Con una sola chiave API di PopNow chiami Seedream 5.0 Pro dal tuo codice. Qui trovi gli ID del modello da inviare, ogni campo di input accettato, quanti crediti costa ogni richiesta e una richiesta da incollare nel terminale così com’è.

Le descrizioni dei parametri provengono dallo schema di input del modello e sono disponibili solo in inglese.

In sintesi

Sviluppato da: ByteDance
Risultato: Immagine
Da: 5.4 crediti per immagine ($0.054)
Tempo tipico: circa 54 s
ID del modello: bytedance/seedream-5.0-pro/text-to-image
bytedance/seedream-5.0-pro/edit
bytedance/seedream-5.0-pro/layer-decomposition

1 credito = 0,01 $. All’accettazione l’attività trattiene l’importo massimo possibile e alla fine addebita il consumo reale, arrotondato al credito superiore; il resto viene sbloccato. Le attività non riuscite non vengono addebitate. Per conoscere la cifra esatta prima di eseguire, chiama POST /api/v1/jobs/quote.

Crea immagine

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

Prezzo

Opzione	Crediti (per immagine)	Dollari USA
`1k`	5.4	$0.054
`2k`	10.8	$0.108

Parametri

Campo	Tipo	Predefinito	Valori ammessi	A cosa serve
`prompt`Obbligatorio	`string`	—	fino a 5000 caratteri	Describe the image to generate: subject, composition, style, and lighting.
`aspect_ratio`Facoltativo	`string`	`1:1`	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, 3:1, … (+1)	Output aspect ratio.
`resolution`Facoltativo	`string`	`2k`	1k, 2k	Output resolution tier.
`output_format`Facoltativo	`string`	`jpeg`	jpeg, png	File format of the returned image.
`enable_thinking`Facoltativo	`boolean`	`true`	—	Run a thinking pass that refines the prompt before generating. Off is faster.

Richiesta di esempio

Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.

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

La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.

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"

Modifica immagine

bytedance/seedream-5.0-pro/edit

Prezzo

Opzione	Crediti (per immagine)	Dollari USA
`1k`	5.4	$0.054
`2k`	10.8	$0.108

Parametri

Campo	Tipo	Predefinito	Valori ammessi	A cosa serve
`prompt`Obbligatorio	`string`	—	fino a 5000 caratteri	Describe the image to produce from the source: subject, composition, style, and lighting.
`image_urls`Obbligatorio	`array<string (uri)>`	—	fino a 10 elementi	Source images that you are authorised to process.
`aspect_ratio`Facoltativo	`string`	`auto`	auto, 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.
`resolution`Facoltativo	`string`	`2k`	1k, 2k	Output resolution tier.
`output_format`Facoltativo	`string`	`jpeg`	jpeg, png	File format of the returned image.
`background`Facoltativo	`string`	`opaque`	opaque, transparent	Opaque image, or a PNG with a transparent background (png output, one PNG input with alpha).
`enable_thinking`Facoltativo	`boolean`	`true`	—	Run a thinking pass that refines the prompt before generating. Off is faster.

Richiesta di esempio

Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.

L’esempio usa file di prova di PopNow in image_urls. Sostituiscili con i tuoi link HTTPS pubblici, file caricati o asset salvati.

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

La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.

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"

Separa livelli

bytedance/seedream-5.0-pro/layer-decomposition

Prezzo

Opzione	Crediti (per immagine)	Dollari USA
`1.5k`	6.3	$0.063
`1k`	6.3	$0.063
`2k`	12.6	$0.126
`auto`	12.6	$0.126

Parametri

Campo	Tipo	Predefinito	Valori ammessi	A cosa serve
`image_url`Obbligatorio	`string (uri)`	—	—	The finished image to split into layers.
`prompt`Facoltativo	`string`	—	fino a 5000 caratteri	Optional: name the elements to separate. Leave empty to let the model pick the main elements.
`resolution`Facoltativo	`string`	`1.5k`	auto, 1k, 1.5k, 2k	Output resolution tier. auto follows the size of the source image.
`output_format`Facoltativo	`string`	`jpeg`	jpeg, png	File format of the base image. Layers are always transparent PNG.

Richiesta di esempio

Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.

L’esempio usa file di prova di PopNow in image_url. Sostituiscili con i tuoi link HTTPS pubblici, file caricati o asset salvati.

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

La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.

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"

Riferimento API di Seedream 5.0 Pro

In sintesi

Crea immagine

Prezzo

Parametri

Richiesta di esempio

Modifica immagine

Prezzo

Parametri

Richiesta di esempio

Separa livelli

Prezzo

Parametri

Richiesta di esempio

Passi successivi

In questa pagina