Seedream 5.0 Pro API

Tài liệu tham khảo API đầy đủ cho các mô hình Seedream 5.0 Pro của ByteDance.

Các biến thể mô hình

API này hỗ trợ hai biến thể mô hình:

So sánh nhanh

Tỷ lệ khung hình được hỗ trợ

16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 21:9

Seedream 5.0 Pro (Văn bản thành hình ảnh)

Điểm cuối

POST /api/v1/image/task

Tham số yêu cầu

Bắt buộc

Lưu ý: Tỷ lệ chiều rộng:chiều cao phải là một trong các giá trị sau: 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 21:9

Yêu cầu mẫu

javascriptSao chép
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedream-v5.0-pro',
    prompt: 'Editorial fashion portrait, soft window light, muted palette',
    resolution: '1k',
    width: 16,
    height: 9
  })
});

const { data } = await response.json();
const taskId = data.task_id;

// Poll for results
const pollResponse = await fetch(
  `https://api.flaq.ai/api/v1/image/${taskId}`,
  {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  }
);

const result = await pollResponse.json();
console.log(result.data.task_result.images[0].url);

Seedream 5.0 Pro Edit (Chỉnh sửa hình ảnh)

Điểm cuối

POST /api/v1/image/task

Tham số yêu cầu

Bắt buộc

Lưu ý: Tỷ lệ chiều rộng:chiều cao phải là một trong các giá trị sau: 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 21:9

Lưu ý về tính phí: Bắt đầu từ hình ảnh tham chiếu thứ hai, mỗi hình ảnh bổ sung được tính phí theo mức cố định đã cấu hình cho mỗi hình ảnh.

Yêu cầu mẫu

javascriptSao chép
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedream-v5.0-pro-edit',
    prompt: 'Change the hairstyle',
    image_url_list: [
      'https://img.bestimage.ai/test/2026/7/1/ad8e011a-3e9b-49f0-9397-282bf51e2e45_162640331.jpeg'
    ],
    resolution: '1k',
    width: 16,
    height: 9
  })
});

const { data } = await response.json();
const taskId = data.task_id;

// Poll for results
const pollResponse = await fetch(
  `https://api.flaq.ai/api/v1/image/${taskId}`,
  {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  }
);

const result = await pollResponse.json();
console.log(result.data.task_result.images[0].url);

Ví dụ chỉnh sửa một hình ảnh

javascriptSao chép
{
  model_name: 'seedream-v5.0-pro-edit',
  image_url_list: ['https://img.bestimage.ai/test/2026/7/1/ad8e011a-3e9b-49f0-9397-282bf51e2e45_162640331.jpeg'],
  prompt: 'Change the hairstyle',
  resolution: '1k',
  width: 16,
  height: 9
}

Ví dụ chỉnh sửa nhiều hình ảnh

javascriptSao chép
{
  model_name: 'seedream-v5.0-pro-edit',
  image_url_list: [
    'https://example.com/image1.jpg',
    'https://example.com/image2.jpg'
  ],
  prompt: 'Blend these images into a cohesive composition',
  resolution: '1k',
  width: 16,
  height: 9
}

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

Phản hồi ban đầu

jsonSao chép
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "0ca5f379-327b-4d49-ba19-e38782ceb2f0",
    "response_url": "https://api.flaq.ai/api/v1/image/0ca5f379-327b-4d49-ba19-e38782ceb2f0",
    "task_status": "submitted"
  }
}

Phản hồi thăm dò

Thăm dò GET /api/v1/image/{task_id} để kiểm tra trạng thái:

jsonSao chép
{
  "code": 0,
  "data": {
    "task_id": "{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_result": {
      "credit": 0.09,
      "images": [
        {
          "url": "https://example.com/generated-image.jpeg"
        }
      ]
    }
  },
  "message": "success"
}

Phản hồi lỗi

jsonSao chép
{
  "code": 1201,
  "message": "[width, height] Invalid parameter (e.g. wrong key or value)",
  "data": null
}

Giá trị trạng thái

• submitted: Tác vụ đã được chấp nhận
• processing: Đang tạo hình ảnh
• succeed: Đã tạo hình ảnh xong
• failed: Tạo hình ảnh không thành công

Thời gian xử lý

Thời gian xử lý thông thường: 15-60 giây tùy thuộc vào độ phức tạp.

Các phương pháp hay nhất

1. Prompt chi tiết: Prompt mô tả chi tiết hơn sẽ mang lại kết quả tốt hơn
2. Tỷ lệ khung hình: Chọn tỷ lệ phù hợp với trường hợp sử dụng mục tiêu trước khi tạo
3. Chất lượng chỉnh sửa hình ảnh: Khi chỉnh sửa, hãy sử dụng hình ảnh nguồn có độ phân giải cao và đủ sáng