GPT Image 2.6 API er live. Prøv billedgenerering →
PoYoPoYo
tutorials

API-guide til Seedream 5.0 Pro: generér og rediger billeder med kode

Poyo.ai Team
5 min read
Share:

API-guide til Seedream 5.0 Pro

Seedream 5.0 Pro API giver udviklere adgang til ByteDances flagskibsmodel til billedgenerering og billedredigering gennem et produktionsorienteret asynkront workflow. Denne guide viser, hvordan du sender jobs med tekst til billede og billedredigering via Poyo.ai og derefter henter resultatet med polling eller en webhook.

Den aktuelle pris er 15 kreditter, cirka $0.075 pr. genereret billede, for begge modelvarianter.

API-modeller og parametre

WorkflowModel-ID
Tekst til billedeseedream-5.0-pro
Billedredigeringseedream-5.0-pro-edit

Understøttede input omfatter:

  • prompt: påkrævet instruktion til generering eller redigering
  • size: en opløsningsforudindstilling som 1K eller 2K eller et billedformat som 1:1, 4:3, 3:4, 16:9 eller 9:16
  • n: antal billeder, der skal genereres
  • output_format: jpeg eller png
  • image_urls: referencebilleder til redigeringsmodellen, op til 10
  • callback_url: valgfrit HTTPS-endpoint til besked om færdiggørelse

Se den aktuelle API-reference for det gældende skema.

1. Opret en API-nøgle

Opret en Poyo.ai-konto, åbn administration af API-nøgler, og gem nøglen i en miljøvariabel. Udlevér aldrig en produktionsnøgle i browserkode, og commit den aldrig til Git.

export POYO_API_KEY="your-api-key"

2. Send en anmodning om tekst til billede

Alle jobs bruger det samlede endpoint til indsendelse:

POST https://api.poyo.ai/api/generate/submit

cURL

curl --request POST \
  --url https://api.poyo.ai/api/generate/submit \
  --header "Authorization: Bearer $POYO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "seedream-5.0-pro",
    "callback_url": "https://example.com/webhooks/poyo",
    "input": {
      "prompt": "Editorial science magazine cover about clean energy cities, title \"THE ELECTRIC CITY\", structured grid, accurate icons, dark navy and electric green palette",
      "size": "3:4",
      "n": 1,
      "output_format": "png"
    }
  }'

Svaret indeholder et opgave-ID:

{
  "code": 200,
  "data": {
    "task_id": "task-unified-example",
    "status": "not_started",
    "created_time": "2026-07-16T10:10:00"
  }
}

3. Kald Seedream 5.0 Pro med JavaScript

const API_URL = 'https://api.poyo.ai/api/generate/submit';

async function generateSeedreamImage(prompt) {
  const response = await fetch(API_URL, {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${process.env.POYO_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      model: 'seedream-5.0-pro',
      input: {
        prompt,
        size: '2K',
        n: 1,
        output_format: 'png',
      },
    }),
  });

  const payload = await response.json();
  if (!response.ok || payload.code !== 200) {
    throw new Error(payload.error?.message || 'Seedream request failed');
  }
  return payload.data.task_id;
}

Brug 2K, når opløsningen betyder mere end et fast billedformat. Brug en værdi for billedformat, når placeringsformatet er den vigtigste begrænsning.

4. Kald Seedream 5.0 Pro med Python

import os
import requests

API_URL = "https://api.poyo.ai/api/generate/submit"

def generate_seedream_image(prompt: str) -> str:
    response = requests.post(
        API_URL,
        headers={
            "Authorization": f"Bearer {os.environ['POYO_API_KEY']}",
            "Content-Type": "application/json",
        },
        json={
            "model": "seedream-5.0-pro",
            "input": {
                "prompt": prompt,
                "size": "16:9",
                "n": 1,
                "output_format": "jpeg",
            },
        },
        timeout=30,
    )
    response.raise_for_status()
    payload = response.json()
    if payload.get("code") != 200:
        raise RuntimeError(payload.get("error", {}).get("message", "Request failed"))
    return payload["data"]["task_id"]

5. Rediger billeder med flere referencer

Skift model-ID, og angiv image_urls. Fortæl modellen, hvad hver reference bidrager med.

curl --request POST \
  --url https://api.poyo.ai/api/generate/submit \
  --header "Authorization: Bearer $POYO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "seedream-5.0-pro-edit",
    "input": {
      "prompt": "Use the room from reference 1. Replace only the chair with the chair from reference 2. Put the logo from reference 3 on the wall. Preserve the original camera, windows, floor, and afternoon lighting.",
      "image_urls": [
        "https://example.com/room.jpg",
        "https://example.com/chair.png",
        "https://example.com/logo.png"
      ],
      "size": "16:9",
      "n": 1,
      "output_format": "png"
    }
  }'

For pålidelige redigeringer bør du dele prompten op i tre elementer: referencernes roller, de ønskede ændringer og begrænsninger for, hvad der skal bevares.

6. Hent resultatet

Indsendelsen er asynkron. Når du har modtaget task_id, kan du enten:

  • polle Poyo.ais samlede endpoint for opgavestatus, eller
  • angive callback_url og behandle webhooken, når opgaven er færdig.

Følg dokumentationen til opgavestyring for den aktuelle statusrute og det aktuelle svarobjekt. I produktion bør du bruge eksponentiel backoff i stedet for at polle uafbrudt.

Fejlhåndtering

Håndtér disse tilfælde eksplicit:

  • 400: ugyldige modelparametre, ikke-understøttede størrelser, utilgængelige billed-URL'er eller ugyldig JSON
  • 401: manglende eller ugyldig API-nøgle
  • mislykket asynkron opgave: genereringen mislykkedes efter en gyldig indsendelse
  • gentagne webhooks: den samme hændelse om færdiggørelse kan blive leveret mere end én gang

Gem opgave-ID'et sammen med dit interne job-ID, gør håndteringen af webhooks idempotent, og log udbyderens fejlbeskeder uden at logge hemmeligheder.

Tjekliste til produktion

  • Hold API-nøgler på serversiden.
  • Valider promptens længde og typen af billed-URL'er, før du sender.
  • Brug HTTPS-referencebilleder, som genereringstjenesten kan tilgå.
  • Angiv timeouts for kald til indsendelse.
  • Prøv igen ved forbigående netværksfejl, men gentag ikke blindt ugyldige anmodninger.
  • Følg omkostningerne som antal ønskede output × 15 kreditter ved den nuværende pris.
  • Gennemgå genereret tekst, produktdetaljer og faktuelle påstande, før du udgiver.
  • Tilføj indholdsmoderering, der passer til dit produkt og dit marked.

Hvornår du skal bruge Pro i stedet for Lite

Brug Seedream 5.0 Pro til strukturerede designs, tætte layouts, tekst på flere sprog og kontrollerede redigeringer. Brug Seedream 5.0 Lite til billigere billedjobs i større mængder, hvor designpræcision på Pro-niveau ikke er nødvendig.

Vil du have en ikke-teknisk introduktion, kan du læse funktioner og priser for Seedream 5.0 Pro. Du kan også teste API-payloaden visuelt på modelsiden for Seedream 5.0 Pro.

Ofte stillede spørgsmål

Hvad er endpointet for Seedream 5.0 Pro API?

Send jobs til generering og redigering til POST https://api.poyo.ai/api/generate/submit.

Hvad er model-ID'et for redigeringsmodellen?

Brug seedream-5.0-pro-edit, og angiv en eller flere værdier i input.image_urls.

Hvor mange referencebilleder understøttes?

Den aktuelle dokumentation fra Poyo.ai understøtter op til 10 referencebilleder til redigering med Seedream 5.0 Pro.

Hvad koster ét API-billede?

Den aktuelle pris på Poyo.ai er 15 kreditter, cirka $0.075, for hvert genereret eller redigeret billede.

Share: