De GPT Image 2.6 API is live. Probeer afbeeldingen genereren →
PoYoPoYo
tutorials

Seedream 5.0 Pro API-gids: afbeeldingen genereren en bewerken met code

Poyo.ai Team
5 min read
Share:

Gids voor de Seedream 5.0 Pro API

Met de Seedream 5.0 Pro API krijgen ontwikkelaars toegang tot het vlaggenschipmodel van ByteDance voor het genereren en bewerken van afbeeldingen, via een asynchrone workflow die is gemaakt voor productie. Deze gids laat zien hoe je via Poyo.ai taken voor tekst naar afbeelding en voor het bewerken van afbeeldingen indient en het resultaat daarna ophaalt met polling of een webhook.

De huidige prijs is 15 credits, ongeveer $0.075 per gegenereerde afbeelding, voor beide modelvarianten.

API-modellen en parameters

WorkflowModel-ID
Tekst naar afbeeldingseedream-5.0-pro
Afbeeldingen bewerkenseedream-5.0-pro-edit

Ondersteunde invoer:

  • prompt: verplichte instructie voor het genereren of bewerken
  • size: een resolutievoorinstelling zoals 1K of 2K, of een beeldverhouding zoals 1:1, 4:3, 3:4, 16:9 of 9:16
  • n: aantal te genereren afbeeldingen
  • output_format: jpeg of png
  • image_urls: referentieafbeeldingen voor het bewerkingsmodel, maximaal 10
  • callback_url: optioneel HTTPS-endpoint voor meldingen bij voltooiing

Bekijk de actuele API-referentie voor het huidige schema.

1. Maak een API-sleutel aan

Maak een Poyo.ai-account aan, open het beheer van API-sleutels en bewaar de sleutel in een omgevingsvariabele. Zet een productiesleutel nooit in code die in de browser draait en commit hem nooit naar Git.

export POYO_API_KEY="your-api-key"

2. Dien een verzoek voor tekst naar afbeelding in

Alle taken gebruiken het uniforme submit-endpoint:

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

Het antwoord bevat een taak-ID:

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

3. Roep Seedream 5.0 Pro aan met 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;
}

Gebruik 2K als de resolutie belangrijker is dan een vaste beeldverhouding. Gebruik een beeldverhouding als het formaat van de plaatsing de belangrijkste beperking is.

4. Roep Seedream 5.0 Pro aan met 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. Bewerk afbeeldingen met meerdere referenties

Wissel het model-ID om en geef image_urls mee. Vertel het model wat elke referentie bijdraagt.

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

Voor betrouwbare bewerkingen deel je de prompt op in drie onderdelen: de rol van elke referentie, de gewenste wijzigingen en de beperkingen voor wat behouden moet blijven.

6. Haal het resultaat op

Het indienen verloopt asynchroon. Nadat je de task_id hebt ontvangen, kun je:

  • het uniforme endpoint voor taakstatus van Poyo.ai pollen; of
  • een callback_url meegeven en de webhook bij voltooiing verwerken.

Volg de documentatie over taakbeheer voor de actuele statusroute en het antwoordobject. Gebruik in productie exponentiële backoff in plaats van continu te pollen.

Foutafhandeling

Behandel deze gevallen expliciet:

  • 400: ongeldige modelparameters, niet-ondersteunde formaten, onbereikbare afbeeldings-URL's of onjuist opgemaakte JSON
  • 401: ontbrekende of ongeldige API-sleutel
  • mislukte asynchrone taak: de generatie is mislukt na een geldige indiening
  • webhook-retry: dezelfde voltooiingsmelding kan meer dan eens worden bezorgd

Bewaar de taak-ID samen met je interne job-ID, maak de verwerking van webhooks idempotent en log foutmeldingen van de aanbieder zonder geheimen mee te loggen.

Checklist voor productie

  • Bewaar API-sleutels uitsluitend aan de serverkant.
  • Controleer de lengte van de prompt en het type afbeeldings-URL's voordat je indient.
  • Gebruik referentieafbeeldingen via HTTPS waar de generatieservice bij kan.
  • Stel time-outs in voor indieningsverzoeken.
  • Probeer het opnieuw bij tijdelijke netwerkfouten, maar herhaal ongeldige verzoeken niet blindelings.
  • Reken de kosten uit als aantal gevraagde outputs × 15 credits tegen de huidige prijs.
  • Controleer gegenereerde tekst, productdetails en feitelijke beweringen voordat je publiceert.
  • Voeg contentmoderatie toe die past bij je product en markt.

Wanneer je Pro kiest in plaats van Lite

Gebruik Seedream 5.0 Pro voor gestructureerde ontwerpen, dichte lay-outs, meertalige tekst en gecontroleerde bewerkingen. Gebruik Seedream 5.0 Lite voor goedkopere afbeeldingstaken in grotere volumes, waarbij ontwerpnauwkeurigheid op Pro-niveau niet nodig is.

Voor een niet-technisch overzicht lees je functies en prijzen van Seedream 5.0 Pro. Je kunt de API-payload ook visueel testen op de modelpagina van Seedream 5.0 Pro.

Veelgestelde vragen

Wat is het endpoint van de Seedream 5.0 Pro API?

Dien taken voor genereren en bewerken in via POST https://api.poyo.ai/api/generate/submit.

Wat is het model-ID voor bewerken?

Gebruik seedream-5.0-pro-edit en geef één of meer waarden mee in input.image_urls.

Hoeveel referentieafbeeldingen worden ondersteund?

De huidige documentatie van Poyo.ai ondersteunt maximaal 10 referentieafbeeldingen bij het bewerken met Seedream 5.0 Pro.

Hoeveel kost één afbeelding via de API?

De huidige prijs bij Poyo.ai is 15 credits, ongeveer $0.075, voor elke gegenereerde of bewerkte afbeelding.

Share: