Seedream 5.0 API

Tài liệu tham chiếu API đầy đủ cho các mô hình Seedream 5.0 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

Seedream 5.0 (Văn Bản sang Ảnh)

Endpoint

POST /api/v1/image/task

Tham Số Yêu Cầu

Bắt buộc

Lưu ý: Tỷ lệ width:height phải là một trong: 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 1:1

Ví Dụ 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.0',
    prompt: 'A futuristic cityscape at night with neon lights',
    width: 16,
    height: 9,
    resolution: '2k'
  })
});

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 Edit (Chỉnh Sửa Ảnh)

Endpoint

POST /api/v1/image/task

Tham Số Yêu Cầu

Bắt buộc

Tùy Chọn

Ví Dụ Chỉnh Sửa Một Ảnh

javascriptSao chép
{
  model_name: 'seedream-v5.0-edit',
  image_url_list: ['https://example.com/photo.jpg'],
  prompt: 'Add dramatic lighting and enhance the colors',
  width: 16,
  height: 9,
  resolution: '2k'
}

Ví Dụ Kết Hợp Nhiều Ảnh

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

Định Dạng Phản Hồi

Phản Hồi Ban Đầu

jsonSao chép
{
  "code": 0,
  "data": {
    "task_id": "{task_id}",
    "task_status": "submitted",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}"
  },
  "message": "success"
}

Phản Hồi Polling

Thực hiện polling 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.0997,
      "images": [
        {
          "url": "https://example.com/generated-image.jpeg"
        }
      ]
    }
  },
  "message": "success"
}

Giá Trị Trạng Thái

• submitted: Tác vụ đã được chấp nhận
• processing: Đang tạo ảnh
• succeed: Tạo ảnh hoàn tất
• failed: Tạo ảnh thất bại

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ân giải và độ phức tạp.

Thực Hành Tốt Nhất

1. Prompt Chi Tiết: Prompt mô tả càng cụ thể thì kết quả càng tốt
2. Lựa Chọn Độ Phân Giải: Dùng 2k để xử lý nhanh hơn, 4k cho đầu ra chất lượng in ấn
3. Tỷ Lệ Khung Hình: Chọn tỷ lệ phù hợp với mục đích sử dụng trước khi tạo ảnh
4. 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à ánh sáng tốt