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

Định dạng chính thức của Replicate

Nếu cần thêm model nào, bạn có thể liên hệ bộ phận hỗ trợ để thêm.

Thay thế domain chính thức https://api.replicate.com bằng {{BASE_URL}}/replicate.

Các tham số đầu vào, đầu ra và phương thức gọi giống hệt với tài liệu chính thức.

Quy trình tích hợp

1. Tạo task

Sau khi gửi yêu cầu tạo, bạn sẽ nhận được một ID task.

2. Kiểm tra tiến độ task

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

⚠️ Lưu ý: Các liên kết 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 phản hồi

Trường	Kiểu dữ liệu	Mô tả
input	object	Dữ liệu đầu vào
output	string hoặc []string	Kết quả đầu ra (URL)
status	string	Trạng thái: `starting`, `processing`, `succeeded`, `failed`

1. Tạo task bằng cách dùng đường dẫn model

Ví dụ với model black-forest-labs/flux-schnell:

Kết quả trả về sẽ chứa id, là ID của task:

{
  "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"
  }
}

2. Tạo task bằng cách dùng `version`

Ví dụ với model lucataco/flux-schnell-lora.

Tham khảo version tại: https://replicate.com/lucataco/flux-schnell-lora?input=http

3. Truy vấn task

Sau khi có id, bạn có thể kiểm tra tiến trình hoặc kết quả:

Phản hồi mẫu:

{
  "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\nrunning quantized prediction\nUsing seed: 62182\n  0%|          | 0/4 [00:00<?, ?it/s]\n 75%|███████▌  | 3/4 [00:00<00:00, 15.38it/s]\n100%|██████████| 4/4 [00:00<00:00, 13.43it/s]\nTotal safe images: 1 out of 1\n",
  "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
  }
}

⚠️ Các tệp và liên kết trong phản hồi có thời hạn sử dụng ngắn, hãy lưu trữ nếu cần thiết.

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

Định dạng chính thức của Replicate#

Quy trình tích hợp#

Giải thích các trường quan trọng trong phản hồi#

1. Tạo task bằng cách dùng đường dẫn model#