GPT Image 2.6 API er lansert. Prøv bildegenerering →
PoYoPoYo
tutorials

API-guide for Seedream 5.0 Pro: generer og rediger bilder med kode

Poyo.ai Team
5 min read
Share:

API-guide for Seedream 5.0 Pro

Seedream 5.0 Pro API gir utviklere tilgang til ByteDances flaggskipmodell for bildegenerering og bilderedigering gjennom en asynkron arbeidsflyt tilpasset produksjon. Denne guiden viser hvordan du sender inn jobber for tekst-til-bilde og bilderedigering via Poyo.ai, og deretter henter resultatet med polling eller en webhook.

Gjeldende pris er 15 kreditter, omtrent $0.075 per generert bilde, for begge modellvariantene.

API-modeller og parametere

ArbeidsflytModell-ID
Tekst til bildeseedream-5.0-pro
Bilderedigeringseedream-5.0-pro-edit

Støttet input omfatter:

  • prompt: påkrevd instruksjon for generering eller redigering
  • size: en forhåndsinnstilt oppløsning som 1K eller 2K, eller et sideforhold som 1:1, 4:3, 3:4, 16:9 eller 9:16
  • n: antall bilder som skal genereres
  • output_format: jpeg eller png
  • image_urls: referansebilder for redigeringsmodellen, opptil 10
  • callback_url: valgfritt HTTPS-endepunkt for varsler når jobben er ferdig

Se den oppdaterte API-referansen for gjeldende skjema.

1. Opprett en API-nøkkel

Opprett en Poyo.ai-konto, åpne administrasjon av API-nøkler, og lagre nøkkelen i en miljøvariabel. Ikke eksponer en produksjonsnøkkel i nettleserkode, og ikke commit den til Git.

export POYO_API_KEY="your-api-key"

2. Send inn en tekst-til-bilde-forespørsel

Alle jobber bruker det felles innsendingsendepunktet:

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 inneholder en oppgave-ID:

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

3. Kall 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;
}

Bruk 2K når oppløsningen betyr mer enn et fast sideforhold. Bruk en verdi for sideforhold når plasseringsformatet er den viktigste begrensningen.

4. Kall 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 bilder med flere referanser

Bytt modell-ID og oppgi image_urls. Fortell modellen hva hver referanse bidrar 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ålitelige redigeringer bør du dele prompten inn i tre deler: referanseroller, ønskede endringer og hva som skal bevares.

6. Hent resultatet

Innsendingen er asynkron. Når du har mottatt task_id, kan du enten:

  • polle det felles statusendepunktet for oppgaver hos Poyo.ai; eller
  • oppgi callback_url og behandle webhooken som sendes når jobben er ferdig.

Følg dokumentasjonen for oppgavehåndtering for gjeldende statusrute og svarobjekt. I produksjon bør du bruke eksponentiell backoff i stedet for å polle kontinuerlig.

Feilhåndtering

Håndter disse tilfellene eksplisitt:

  • 400: ugyldige modellparametere, størrelser som ikke støttes, bilde-URL-er som ikke er tilgjengelige, eller feilformatert JSON
  • 401: manglende eller ugyldig API-nøkkel
  • mislykket asynkron oppgave: genereringen feilet etter en gyldig innsending
  • nye forsøk på webhook: den samme fullføringshendelsen kan bli levert mer enn én gang

Lagre oppgave-ID-en sammen med den interne jobb-ID-en din, gjør webhook-håndteringen idempotent, og logg feilmeldinger fra leverandøren uten å logge hemmeligheter.

Sjekkliste for produksjon

  • Hold API-nøkler på serversiden.
  • Valider promptlengde og typer bilde-URL-er før innsending.
  • Bruk referansebilder over HTTPS som genereringstjenesten har tilgang til.
  • Angi tidsavbrudd for innsendingskall.
  • Prøv på nytt ved midlertidige nettverksfeil, men ikke prøv ugyldige forespørsler på nytt i blinde.
  • Beregn kostnad som number of requested outputs × 15 credits (antall forespurte resultater × 15 kreditter) med gjeldende priser.
  • Gå gjennom generert tekst, produktdetaljer og faktapåstander før publisering.
  • Legg til innholdsmoderering som passer for produktet og markedet ditt.

Når du bør bruke Pro i stedet for Lite

Bruk Seedream 5.0 Pro til strukturerte design, tette layouter, flerspråklig tekst og kontrollerte redigeringer. Bruk Seedream 5.0 Lite til rimeligere bildejobber i større volum der designpresisjon på Pro-nivå ikke er nødvendig.

For en ikke-teknisk oversikt kan du lese funksjoner og priser for Seedream 5.0 Pro. Du kan også teste API-payloaden visuelt på modellsiden for Seedream 5.0 Pro.

Ofte stilte spørsmål

Hva er API-endepunktet for Seedream 5.0 Pro?

Send inn genererings- og redigeringsjobber til POST https://api.poyo.ai/api/generate/submit.

Hva er modell-ID-en for redigering?

Bruk seedream-5.0-pro-edit og ta med én eller flere verdier i input.image_urls.

Hvor mange referansebilder støttes?

Den gjeldende dokumentasjonen fra Poyo.ai støtter opptil 10 referansebilder ved redigering med Seedream 5.0 Pro.

Hva koster ett bilde via API-et?

Gjeldende pris hos Poyo.ai er 15 kreditter, omtrent $0.075, for hvert genererte eller redigerte bilde.

Share: