API Seedream 5.5

Tài liệu tham khảo API đầy đủ cho các mô hình Seedream 5.5 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.5 (Tạo ảnh từ văn bản)

Đ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 trên 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.

Tùy chọn

Ví dụ về yêu cầ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.5',
    prompt: 'Editorial fashion portrait, soft window light, muted palette',
    resolution: '1.5k',
    width: 16,
    height: 9,
    background: 'auto'
  })
});

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

Seedream 5.5 Edit (Chỉnh sửa ả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 trên 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.

Tùy chọn

Ví dụ về yêu cầ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.5-edit',
    prompt: 'Change the hairstyle',
    image_url_list: [
      'https://img.bestimage.ai/test/2026/7/1/ad8e011a-3e9b-49f0-9397-282bf51e2e45_162640331.jpeg'
    ],
    resolution: '1.5k',
    width: 16,
    height: 9,
    background: 'auto'
  })
});

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

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

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

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

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

Đị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 khi kiểm tra trạng thái

Gọi định kỳ 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": 200,
      "images": [
        {
          "url": "https://example.com/generated-image.png"
        }
      ]
    }
  },
  "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
}

Các giá trị trạng thái

• submitted: Hệ thống đã tiếp nhận tác vụ
• processing: Đang tạo ảnh
• succeed: Đã tạo ảnh xong
• failed: Tạo ảnh thất bại

Thời gian xử lý

Kiểm tra định kỳ cho đến khi tác vụ có trạng thái succeed hoặc failed. Khi tác vụ vừa được gửi hoặc đang được xử lý, phản hồi có thể chưa chứa ảnh kết quả.

Khuyến nghị khi sử dụng

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