Hướng dẫn tích hợp

Gọi API theo định dạng chính thức của Replicate

| Nếu cần thêm model, vui lòng liên hệ bộ phận hỗ trợ để được thêm vào

Thay thế https://api.replicate.com trên trang chủ bằng {{BASE_URL}}/replicate
Input, output, phương thức request giống hoàn toàn với trang chủ

Quy trình tích hợp

Tạo task
Sau khi submit task, lấy về task ID

Lấy tiến độ task
Dùng task ID để truy vấn tiến độ và lấy kết quả

PS: Link tài nguyên trả về chỉ có hiệu lực trong 1 giờ

Giải thích các trường quan trọng trong response body

Trường	Kiểu	Mô tả
input	object	Đầu vào
output	string hoặc []string	URL output nội dung
status	string	Trạng thái: starting / processing / succeeded / failed

Tạo task — theo đường dẫn (path)
Lấy black-forest-labs/flux-schnell làm ví dụ

Trường id trong response body là task id dùng cho bước truy vấn tiếp theo

{
  "id": "qpt5jq1fssrmc0cmd5hvy31mdg",
  "model": "black-forest-labs/flux-schnell",
  "version": "dp-4d0bcc010b3049749a251855f12800be",
  "input": {
    "aspect_ratio": "1:1",
    "go_fast": true,
    "megapixels": "1",
    "num_inference_steps": 4,
    "num_outputs": 1,
    "output_format": "jpg",
    "output_quality": 80,
    "prompt": "Japanese cartoon anime style, (1 person) (Gender: Male, Age: 30, Hair: Short black hair, Outfit: Dark blue hunting attire, includes a fitted jacket and trousers.) (A dimly lit room filled with tension,  is questioning Female, 27 years old, long black hair, pink tulle dress., who stands nervously in her pink dress, the sound of rain pattering against the window.)"
  },
  "logs": "",
  "output": null,
  "data_removed": false,
  "error": null,
  "status": "starting",
  "created_at": "2025-01-15T09:54:55.566Z",
  "urls": {
    "cancel": "https://api.replicate.com/v1/predictions/qpt5jq1fssrmc0cmd5hvy31mdg/cancel",
    "get": "https://api.replicate.com/v1/predictions/qpt5jq1fssrmc0cmd5hvy31mdg",
    "stream": "https://stream.replicate.com/v1/files/bcwr-gvuc2rokjozhlaxh6dcvk6tvhh2ymt4egnnpxvmtqql57angyfsq"
  }
}

Tạo task — theo version
Lấy lucataco/flux-schnell-lora làm ví dụ
Tài liệu tham khảo: https://replicate.com/lucataco/flux-schnell-lora?input=http
Từ tài liệu tham khảo, lấy được version là 2a6b576af31790b470f0a8442e1e9791213fa13799cbb65a9fc1436e96389574

Response body có định dạng giống như trên
Lấy kết quả task
Dùng task id lấy được từ bước tạo task ở trên
Kết quả nằm ở trường quan trọng output
Lưu ý: Cả kết quả trả về lẫn các file liên kết đều có thời hạn sử dụng
get {{BASE_URL}}/replicate/v1/predictions/{id}

Response body

{
  "id": "ctdwaehfz1rm80cmd5nsjd8114",
  "model": "black-forest-labs/flux-schnell",
  "version": "dp-4d0bcc010b3049749a251855f12800be",
  "input": {
    "aspect_ratio": "1:1",
    "go_fast": true,
    "megapixels": "1",
    "num_inference_steps": 4,
    "num_outputs": 1,
    "output_format": "jpg",
    "output_quality": 80,
    "prompt": "Japanese cartoon anime style, (1 person) (Gender: Male, Age: 30, Hair: Short black hair, Outfit: Dark blue hunting attire, includes a fitted jacket and trousers.) (A dimly lit room filled with tension,  is questioning Female, 27 years old, long black hair, pink tulle dress., who stands nervously in her pink dress, the sound of rain pattering against the window.)"
  },
  "logs": "Using seed: 62182
running quantized prediction
Using seed: 62182
  0%|          | 0/4 [00:00<?, ?it/s]
 75%|███████▌  | 3/4 [00:00<00:00, 15.38it/s]
100%|██████████| 4/4 [00:00<00:00, 13.43it/s]
Total safe images: 1 out of 1
",
  "output": [
    "https://replicate.delivery/xezq/RoEhEdyl8PoIGFFPg46TU4Svj24i1NDVYmzehJfqLuX9nTFUA/out-0.jpg"
  ],
  "data_removed": false,
  "error": null,
  "status": "succeeded",
  "created_at": "2025-01-15T10:03:39.896Z",
  "started_at": "2025-01-15T10:03:40.584470194Z",
  "completed_at": "2025-01-15T10:03:41.142386377Z",
  "urls": {
    "cancel": "https://api.replicate.com/v1/predictions/ctdwaehfz1rm80cmd5nsjd8114/cancel",
    "get": "https://api.replicate.com/v1/predictions/ctdwaehfz1rm80cmd5nsjd8114",
    "stream": "https://stream.replicate.com/v1/files/bcwr-q57vie7wuzg3wxv2hvpajgmzqzmxe67kqddednevutmrpdcft6xq"
  },
  "metrics": {
    "image_count": 1,
    "predict_time": 0.557916184
  }
}

Gọi API theo định dạng chính thức của Replicate#

Gọi API theo định dạng chính thức của Replicate