VI
Chọn ngôn ngữ
EnglishFrançaisPortuguês (Brasil)日本語한국어Русский简体中文DeutschEspañolItalianoTürkçeTiếng ViệtBahasa Indonesia
Dashboard
Tất cả bài viết
Các hướng dẫn7 phút đọc

Seedream 5.0 Pro API hướng dẫn: Tạo và chỉnh sửa hình ảnh với mã

Thép lại Seedream 5.0 Pro API với cURL, JavaScript, hoặc Python. Tìm hiểu ID mô hình, giá cả, tham số, chỉnh sửa hình ảnh, thăm dò và thực tiễn sản xuất.

Poyo.ai Team
Seedream 5.0 Pro API hướng dẫn: Tạo và chỉnh sửa hình ảnh với mã
Các hướng dẫn

Seedream 5.0 Pro API hướng dẫn

Seedream 5.0 Pro API cung cấp cho các nhà phát triển quyền truy cập vào mô hình tạo hình ảnh và chỉnh sửa hàng đầu của ByteDance thông qua một dòng công việc không đồng bộ hướng đến sản xuất. Hướng dẫn này cho thấy cách gửi các công việc chỉnh sửa văn bản-đến hình ảnh qua Poyo.ai, sau đó lấy kết quả bằng cách thăm dò hoặc một webhook.

Giá hiện tại là 15 tín dụng, khoảng $0.075 cho mỗi hình ảnh được tạo, cho cả hai phiên bản mô hình.

API Mô hình và tham số

Phòng chảy công việc Mô hình ID
Văn bản sang hình ảnh seedream-5.0-pro
Chỉnh sửa hình ảnh seedream-5.0-pro-edit

Các đầu vào được hỗ trợ bao gồm:

  • prompt: yêu cầu hướng dẫn tạo hoặc chỉnh sửa
  • size: một độ phân giải được thiết lập sẵn như 1K hoặc 2K, hoặc tỷ lệ hình ảnh như 1:1, 4:3, 3:4, 16:9, hoặc 9:16
  • n: số hình ảnh để tạo
  • output_format: jpeg hoặc png
  • image_urls: hình ảnh tham chiếu cho mô hình chỉnh sửa, lên đến 10
  • callback_url: điểm cuối HTTPS tùy chọn cho các thông báo hoàn thành

Xem các tham chiếu API trực tiếp cho kế hoạch hiện tại.

1. Tạo một khóa API

Tạo tài khoản Poyo.ai, mở API Quản lý khóa, và lưu trữ chìa khóa trong một biến môi trường. Không bao giờ phơi bày một khóa sản xuất trong mã trình duyệt hoặc cam kết nó vào Git.

export POYO_API_KEY="your-api-key"

2. Sending a Text-to-Image Request

Tất cả các công việc sử dụng điểm cuối gửi đơn vị:

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

Phản ứng chứa ID nhiệm vụ:

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

3. Call Seedream 5.0 Pro với 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;
}

Sử dụng 2K khi độ phân giải quan trọng hơn tỷ lệ cố định. Sử dụng giá trị tỷ lệ khía cạnh khi định dạng vị trí là hạn chế chính.

4. Call Seedream 5.0 Pro với 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. Thay hình ảnh với nhiều tham chiếu

Thay đổi ID mô hình và cung cấp image_urlsHãy cho người mô hình biết mỗi tham chiếu đóng góp gì.

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

Để có thể sửa đổi đáng tin cậy, hãy phân chia prompt thành ba ý tưởng: vai trò tham chiếu, thay đổi yêu cầu và hạn chế bảo tồn.

6. Thụy lại kết quả

Việc gửi là không đồng bộ. task_id, hoặc:

  • Poll điểm cuối trạng thái nhiệm vụ thống nhất của Poyo.ai; hoặc
  • cung cấp callback_url và xử lý hoàn thành webhook.

Theo dõi Tài liệu quản lý nhiệm vụ cho đường trạng thái hiện tại và đối tượng phản ứng. Trong sản xuất, sử dụng backkoff theo số lượng cao hơn là thăm dò liên tục.

Việc xử lý lỗi

Hãy xử lý các trường hợp này một cách rõ ràng:

  • 400: các tham số mô hình không hợp lệ, kích thước không được hỗ trợ, URL hình ảnh không thể truy cập hoặc có dạng JSON sai
  • 401: mất hoặc không hợp lệ API key
  • tác vụ bất đồng bộ không thành công: phát triển đã thất bại sau khi gửi một bản hợp lệ
  • webhook thử lại: cùng một sự kiện hoàn thành có thể được giao nhiều hơn một lần

Cung cấp ID nhiệm vụ với ID công việc nội bộ của bạn, làm cho việc xử lý webhook idempotent, và ghi lại các thông điệp lỗi của nhà cung cấp không ghi lại bí mật.

Danh sách kiểm tra sản xuất

  • Giữ khóa API bên máy chủ.
  • Thiết lập các kiểu hình ảnh và chiều dài yêu cầu URL trước khi gửi.
  • Sử dụng hình ảnh tham chiếu HTTPS mà dịch vụ tạo có thể truy cập.
  • Đặt thời gian yêu cầu cho các cuộc gọi gửi.
  • Hãy thử lại các lỗi mạng tạm thời, nhưng đừng mù quáng thử lại các yêu cầu không hợp lệ.
  • Chi phí theo dõi như number of requested outputs × 15 credits giá hiện tại.
  • Xem lại văn bản được tạo ra, chi tiết sản phẩm và tuyên bố thực tế trước khi xuất bản.
  • Thêm sự điều chỉnh nội dung phù hợp với sản phẩm và thị trường của bạn.

Khi nào nên sử dụng Pro thay vì Lite

Sử dụng Seedream 5.0 Pro cho các thiết kế có cấu trúc, bố cục dày đặc, văn bản đa ngôn ngữ và chỉnh sửa được kiểm soát. Sử dụng Seedream 5.0 Lite cho các công việc hình ảnh chi phí thấp hơn, khối lượng lớn hơn, nơi không cần thiết độ chính xác thiết kế cấp độ Pro.

Để xem tổng quan phi kỹ thuật, đọc Các tính năng và giá cả của Seedream 5.0 ProBạn cũng có thể kiểm tra tải trọng hữu ích API trực quan trên Trang mô hình Seedream 5.0 Pro.

Những câu hỏi thường được hỏi

Điểm cuối Seedream 5.0 Pro API là gì?

Đưa ra các công việc tạo và chỉnh sửa POST https://api.poyo.ai/api/generate/submit.

ID mô hình edit là gì?

Sử dụng seedream-5.0-pro-edit và bao gồm một hoặc nhiều giá trị trong input.image_urls.

Có bao nhiêu hình ảnh tham chiếu được hỗ trợ?

Tài liệu Poyo.ai hiện tại hỗ trợ đến hình ảnh tham chiếu 10 cho chỉnh sửa Seedream 5.0 Pro.

Một hình ảnh API có giá bao nhiêu?

Giá Poyo.ai hiện tại là 15 tín dụng, khoảng $0.075, cho mỗi hình ảnh được tạo hoặc chỉnh sửa.

Blog · PoYo.aiTất cả bài viết
KẾT NỐI

Bạn đang có dự án?

Hãy chia sẻ nhu cầu của bạn. Chúng tôi sẽ tư vấn API AI phù hợp.

Chúng tôi chỉ dùng thông tin để phản hồi yêu cầu này.

PoYo AI

Sẵn sàng khám phá mô hình?

Xem các mô hình hình ảnh, video, âm thanh và ngôn ngữ trên PoYo.

Xem mô hình AI
PoYo Blog
Tất cả bài viết