API tạo ảnh Seedream 5.0 Pro

Khả năng hỗ trợ

Seedream 5.0 Pro hỗ trợ tạo ảnh từ văn bản và tạo ảnh từ ảnh, dùng định dạng tương thích OpenAI Images API. Mã mô hình là doubao-seedream-5-0-pro.

Endpoint và xác thực

Địa chỉ gốc của API: https://api.88api.ai

Authorization: Bearer $API_KEY
Content-Type: application/json

Tình huống	Phương thức	Endpoint
Tạo ảnh từ văn bản	`POST`	`/v1/images/generations`
Chỉnh sửa bằng ảnh tham chiếu công khai	`POST`	`/v1/images/generations`
Chỉnh sửa ảnh cục bộ	`POST`	`/v1/images/edits`

Tạo ảnh từ văn bản

curl https://api.88api.ai/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-pro",
    "prompt": "Một chú chó Shiba nhỏ mặc áo Đường trang màu đỏ, phong cách minh họa quốc triều, vui tươi và ấm áp",
    "n": 1,
    "size": "1K",
    "quality": "1K",
    "response_format": "url"
  }'

Tạo ảnh từ ảnh

Ảnh tham chiếu công khai

Dùng image cho một ảnh tham chiếu, dùng images cho nhiều ảnh tham chiếu. Ảnh tham chiếu phải là URL HTTP(S) công khai, tổng cộng cả hai trường tối đa 14 ảnh.

curl https://api.88api.ai/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-pro",
    "prompt": "Giữ nguyên nhân vật chính và bố cục, đổi trang phục thành áo khoác dã ngoại màu xanh lam",
    "image": "https://example.com/reference.jpg",
    "size": "2K",
    "quality": "2K",
    "response_format": "url"
  }'

Ví dụ với nhiều ảnh tham chiếu:

{
  "model": "doubao-seedream-5-0-pro",
  "prompt": "Kết hợp chủ thể và màu sắc trong các ảnh tham chiếu",
  "images": [
    "https://example.com/reference-1.jpg",
    "https://example.com/reference-2.jpg"
  ],
  "size": "2K",
  "quality": "2K"
}

Ảnh cục bộ

Ảnh cục bộ được gửi bằng yêu cầu multipart, mỗi lần tải lên một ảnh:

curl https://api.88api.ai/v1/images/edits \
  -H "Authorization: Bearer $API_KEY" \
  -F "model=doubao-seedream-5-0-pro" \
  -F "prompt=Đổi nền thành phòng chụp ảnh tông sáng" \
  -F "image=@reference.png" \
  -F "size=2K" \
  -F "quality=2K" \
  -F "response_format=url"

Tham số yêu cầu

Tham số	Kiểu	Bắt buộc	Mặc định	Mô tả
`model`	string	Có	—	`doubao-seedream-5-0-pro`
`prompt`	string	Có	—	Mô tả để tạo ảnh từ văn bản, hoặc chỉ dẫn chỉnh sửa khi tạo ảnh từ ảnh
`n`	integer	Không	`1`	Từ `1` đến `4`
`size`	string	Không	—	`1K` hoặc `2K`
`quality`	string	Không	—	`1K` hoặc `2K`
`response_format`	string	Không	`url`	`url` hoặc `b64_json`
`image`	string / file	Không	—	URL của một ảnh tham chiếu công khai, hoặc tệp tải lên ở endpoint chỉnh sửa
`images`	array[string]	Không	—	Mảng URL ảnh tham chiếu công khai, tối đa 14 ảnh

Định dạng phản hồi

{
  "created": 1760000000,
  "data": [
    {
      "url": "https://..."
    }
  ],
  "model": "doubao-seedream-5-0-pro"
}

Khi response_format là url, đọc data[].url; khi là b64_json, đọc data[].b64_json.