API render AI Graydient
Nếu bạn đang xây dựng ứng dụng, công cụ nội bộ hoặc pipeline render, Graydient cung cấp mô hình hình ảnh, video và LLM mở trên GPU chuyên dụng, qua một API duy nhất, với giá cố định hàng tháng.
Gói nào bao gồm
API cá nhân chỉ đi kèm với Video Max. Images và Video Plus không bao gồm truy cập API. Bạn có thể nâng cấp, hạ cấp hoặc hủy bất cứ lúc nào trong cổng thanh toán, với phí tính theo tỷ lệ. Giá gói Business và API có tại business.graydient.ai.
API cá nhân là khóa dành cho một người dùng duy nhất, và lưu lượng tự động không được phép trên bất kỳ gói cá nhân nào. Điều này có nghĩa không có bot, script, bộ lập lịch, công việc hàng loạt, trình thu thập dữ liệu, ứng dụng đa người dùng hoặc truy cập bán lại. Nó bị giới hạn tần suất: giữ khoảng một lần gọi mỗi 10 giây. Các khóa gửi lưu lượng tự động hoặc quá mức sẽ bị thu hồi mà không báo trước.
Xây dựng sản phẩm đa người dùng hoặc nhãn trắng
Người dùng ảo và đăng nhập nhãn trắng là tính năng cấp doanh nghiệp cho ứng dụng đã triển khai, tức là sản phẩm có nhiều người dùng. Chúng hoạt động trên API cá nhân, nên bạn có thể xây dựng và thử nghiệm luồng đa người dùng và nhãn trắng trên Video Max trong quá trình phát triển.
Để chạy sản phẩm đa người dùng, lưu lượng tự động hoặc truy cập bán lại cần gói Business: máy chủ GPU riêng. business.graydient.ai giải thích những gì bao gồm, liệt kê giá và bán gói.
| API cá nhân (Video Max) | Triển khai doanh nghiệp | |
|---|---|---|
| Người dùng | Một người dùng (bạn) | Người dùng sản phẩm của bạn |
| Bán lại | Không được phép | Được phép |
| Người dùng ảo và đăng nhập nhãn trắng | Xây dựng và thử nghiệm | Ra mắt |
| Cách lấy | Đăng ký Video Max | Máy chủ GPU riêng hoặc thỏa thuận kinh doanh |
Cách API hoạt động
Phiên bản hiện tại là V3, tại https://cloud.graydient.ai/api/v3/. Nó tuân theo đặc tả JSON:API: gửi và nhận application/vnd.api+json, xác thực bằng token HTTP Bearer tiêu chuẩn từ trang token API của bạn, và đọc kết quả từ đối tượng data với thành phần attributes.
Quá trình render là không đồng bộ. Bạn POST đến POST /api/v3/render/ với prompt và callback_url bắt buộc. Graydient trả lời ngay với render_hash cùng thời gian chờ và render ước tính. Khi công việc hoàn thành, nó POST kết quả đến webhook của bạn. Các trường tùy chọn bao gồm:
- error_url: webhook cho các lỗi
- init_image và mask_image: cho image-to-image và inpainting
- placeholders: URL hình ảnh được đặt tên cho các chế độ ControlNet hoặc bộ điều hợp IP
- progressive_return: một callback cho mỗi hình ảnh
- session_id: liên kết các render với người dùng của bạn
Các workflow chạy qua cùng một endpoint với lệnh workflow trong prompt.
Trạng thái không cần polling: GET GET /api/v3/render/{render_hash} trả về trạng thái render, nhưng tài liệu khuyên bạn không nên polling. Dùng webhook hoặc luồng WebSocket tại wss://cloud.graydient.ai/render-events/{render_hash}, gửi các sự kiện started, image_done, done và error.
Các nhóm endpoint khác
- Chat: chat LLM với persona. Phản hồi gửi đến callback hoặc trả về ngay trong dòng với sync: true, và các mô hình vision chấp nhận image_url.
- Concepts: liệt kê các mô hình và LoRA có sẵn.
- Workflows: liệt kê các workflow và những gì mỗi workflow hỗ trợ, như txt2img, img2img, txt2vid và img2vid.
- Knowledge base: tạo domain, thêm dữ kiện, thu thập URL, rồi tìm kiếm hoặc chat.
- Skills: biến yêu cầu ngôn ngữ tự nhiên thành lệnh workflow.
- Người dùng ảo: ánh xạ người dùng cuối của bạn với các bản ghi trên tài khoản của bạn. Xây dựng và thử nghiệm trên API cá nhân, rồi ra mắt trên triển khai doanh nghiệp.
Tham khảo đầy đủ: tài liệu API. Tài liệu nói họ vẫn đang phát triển.
Các trường hợp sử dụng điển hình
- Cung cấp sức mạnh cho ứng dụng của bạn: dùng Graydient làm backend render cho tính năng hình ảnh, video hoặc chat. Phát triển trên API cá nhân, rồi chuyển sang triển khai doanh nghiệp khi có người dùng thật.
- Dùng các mô hình bạn lưu trữ: render với các LoRA và checkpoint bạn đã cài. Xem tự lưu trữ mô hình AI của bạn.
- Chạy workflow kiểu ComfyAPI từ xa: gọi workflow đã ánh xạ từ mã của bạn.
- Hình ảnh sản phẩm và danh mục: nâng cấp, chỉnh sửa hoặc thay đổi phong cách hình ảnh từ pipeline, trong giới hạn tốc độ của API cá nhân.
- Render hàng loạt: cho các lô lớn, liên tục, dùng máy chủ GPU riêng thay vì API cá nhân.
- Chat kiến thức: xây trợ lý hỗ trợ hoặc tài liệu trên knowledge base và các endpoint chat.
Máy chủ GPU riêng
Nếu bạn dự định chạy lưu lượng tự động, sản phẩm đa người dùng, truy cập API bán lại hoặc kết xuất hàng loạt cả ngày, bạn cần gói Business: máy chủ GPU riêng, với máy riêng và không dùng chung hàng đợi. Giá, những gì bao gồm và mẫu đặt hàng có tại business.graydient.ai.
Giá mỗi lần kết xuất cho máy chủ riêng, bao gồm video, được liệt kê tại business.graydient.ai. Giá mỗi lần kết xuất này chỉ áp dụng cho gói Business. Images, Video Plus và Video Max vẫn là gói cố định không tính phí mỗi lần kết xuất.
Lưu lượng tự động không được phép trên các gói cá nhân. Images, Video Plus và Video Max là các gói cố định dành cho một người dùng duy nhất, và các khóa gửi lưu lượng tự động sẽ bị thu hồi.
Bắt đầu
- Đăng ký Video Max. Bạn có thể thay đổi hoặc hủy gói bất cứ lúc nào trong cổng thanh toán.
- Tạo token trên trang token API của bạn.
- Đọc tài liệu API và xem trên GitHub các ví dụ sử dụng API Graydient.
- Thiết lập endpoint webhook, rồi gửi yêu cầu render đầu tiên.
- Sao lưu và tạo ảnh thu nhỏ kết quả trước khi phục vụ người dùng, như tài liệu khuyên.
Hỗ trợ API có qua email tại info@graydient.ai. Mọi sử dụng đều tuân theo chính sách sử dụng chấp nhận được và điều khoản sử dụng.