Kling 4.0 API yayında. Video oluşturmayı deneyin →
PoYoPoYo
öğreticiler

Seedream 5.0 Pro API Kılavuzu: Kodla Görüntü Oluşturma ve Düzenleme

Poyo.ai Team
5 min read
Share:

Seedream 5.0 Pro API kılavuzu

Seedream 5.0 Pro API, geliştiricilere üretim odaklı eşzamansız iş akışı aracılığıyla ByteDance'in amiral gemisi görüntü oluşturma ve düzenleme modeline erişim sağlar. Bu kılavuz, metinden görüntüye ve görüntü düzenleme işlerinin Poyo.ai aracılığıyla nasıl gönderileceğini ve ardından yoklama veya webhook ile sonucun nasıl alınacağını gösterir.

Her iki model çeşidi için de mevcut fiyat 15 kredi, yani oluşturulan görüntü başına yaklaşık $0.075'dur.

API Modelleri ve Parametreleri

İş AkışıModel Kimliği
Metinden resmeseedream-5.0-pro
Resim düzenlemeseedream-5.0-pro-edit

Desteklenen girişler şunları içerir:

  • prompt: gerekli oluşturma veya düzenleme talimatı
  • size: 1K veya 2K gibi bir çözünürlük ön ayarı veya 1:1, 4:3, 3:4, 16:9 veya 9:16 gibi bir en boy oranı
  • n: oluşturulacak görüntü sayısı
  • output_format: jpeg veya png
  • image_urls: 10'a kadar düzenleme modeli için referans görselleri
  • callback_url: tamamlama bildirimleri için isteğe bağlı HTTPS uç noktası

Geçerli şema için canlı API referansına bakın.

1. API Anahtarı Oluşturun

Bir Poyo.ai hesabı oluşturun, API Anahtar Yönetimi öğesini açın ve anahtarı bir ortam değişkeninde saklayın. Bir üretim anahtarını asla tarayıcı kodunda açığa çıkarmayın veya Git'e commit etmeyin.

export POYO_API_KEY="your-api-key"

2. Metinden Görüntüye Dönüştürme İsteği Gönderin

Tüm işler birleştirilmiş gönderme uç noktasını kullanır:

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

Yanıt bir görev kimliği içeriyor:

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

3. JavaScript ile Seedream 5.0 Pro'yu çağırın

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;
}

Çözünürlük sabit bir orandan daha önemli olduğunda 2K kullanın. Yerleştirme biçimi birincil kısıtlama olduğunda en boy oranı değeri kullanın.

4. Python ile Seedream 5.0 Pro'yu çağırın

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. Çoklu Referanslı Görselleri Düzenleme

Model kimliğini değiştirin ve image_urls alanını sağlayın. Modele her referansın ne katkı sağladığını söyleyin.

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

Güvenilir düzenlemeler için istemi üç fikre ayırın: referans rolleri, istenen değişiklikler ve koruma kısıtlamaları.

6. Sonucu Alının

Gönderim eş zamanlı değildir. task_id değerini aldıktan sonra:

  • Poyo.ai'nin birleşik görev durumu uç noktasını yoklayın; veya
  • callback_url alanını sağlayın ve tamamlama webhook'u işleyin.

Geçerli durum rotası ve yanıt nesnesi için görev yönetimi belgelerini izleyin. Üretimde sürekli yoklama yerine üstel backoff'u kullanın.

Hata İşleme

Bu durumları açıkça ele alın:

  • 400: geçersiz model parametreleri, desteklenmeyen boyutlar, erişilemeyen resim URL'leri veya hatalı biçimlendirilmiş JSON
  • 401: eksik veya geçersiz API anahtarı
  • eşzamansız görev başarısız oldu: geçerli bir gönderimden sonra oluşturma işlemi başarısız oldu
  • webhook yeniden denemesi: aynı tamamlama olayı birden fazla kez gerçekleştirilebilir

Görev kimliğini dahili iş kimliğiniz ile birlikte saklayın, webhook işlemeyi idempotent hale getirin ve sırları günlüğe kaydetmeden sağlayıcı hata mesajlarını günlüğe kaydedin.

Üretim Kontrol Listesi

  • API anahtarlarını sunucu tarafında tutun.
  • Göndermeden önce istem uzunluğunu ve görüntü URL türlerini doğrulayın.
  • Üretim hizmetinin erişebileceği HTTPS referans görüntülerini kullanın.
  • Gönderim çağrıları için istek zaman aşımlarını ayarlayın.
  • Geçici ağ hatalarını yeniden deneyin, ancak geçersiz istekleri körü körüne yeniden denemeyin.
  • Maliyeti mevcut fiyatlandırmada number of requested outputs × 15 credits olarak takip edin.
  • Yayınlamadan önce oluşturulan metni, ürün ayrıntılarını ve gerçek iddiaları inceleyin.
  • Ürününüze ve pazarınıza uygun içerik denetimi ekleyin.

Lite Yerine Ne Zaman Pro Kullanılmalı?

Yapılandırılmış tasarımlar, yoğun düzenler, çok dilli metinler ve kontrollü düzenlemeler için Seedream 5.0 Pro'yu kullanın. Profesyonel düzeyde tasarım hassasiyetinin gerekli olmadığı daha düşük maliyetli, daha yüksek hacimli görüntü işleri için Seedream 5.0 Lite kullanın.

Teknik olmayan bir genel bakış için Seedream 5.0 Pro özellikleri ve fiyatlandırması bölümünü okuyun. Ayrıca API yükünü Seedream 5.0 Pro model sayfasında görsel olarak test edebilirsiniz.

Sıkça Sorulan Sorular

Seedream 5.0 Pro API uç noktası nedir?

Oluşturma ve düzenleme işlerini POST https://api.poyo.ai/api/generate/submit adresine gönderin.

Düzenleme modeli kimliği nedir?

seedream-5.0-pro-edit kullanın ve input.image_urls alanına bir veya daha fazla değer ekleyin.

Kaç tane referans görseli destekleniyor?

Geçerli Poyo.ai belgeleri, Seedream 5.0 Pro düzenleme için en fazla 10 referans görüntüsünü destekler.

Bir API görselinin maliyeti ne kadardır?

Geçerli Poyo.ai fiyatı, oluşturulan veya düzenlenen her görüntü için 15 kredidir, yaklaşık $0.075'tir.

Share: