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: $84 mỗi tháng khi thanh toán theo năm ($999 thanh toán hàng năm) hoặc $99.99 theo tháng. Gói 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ệ.
API cá nhân là khóa cho một người dùng, không được bán lại. Có giới hạn tần suất: giữ khoảng một lần gọi mỗi 10 giây và tránh gọi hàng loạt. Khóa có thể hết hạn tự động nếu gửi quá nhiều yêu cầu.
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.
Khi ra mắt sản phẩm đa người dùng hoặc bán lại quyền truy cập, bạn cần tùy chọn cấp doanh nghiệp: máy chủ GPU riêng hoặc thỏa thuận kinh doanh. Để thảo luận triển khai doanh nghiệp, viết thư tới info@graydient.ai.
| 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 định chạy sản phẩm đa người dùng, bán lại truy cập API hoặc render hàng loạt cả ngày, Graydient cung cấp máy chủ GPU Video Max riêng tại $499.99 mỗi tháng. Bạn có máy riêng không phải xếp hàng, chạy công việc dài hơn và đặt giới hạn cho khách hàng về những gì họ làm và thời gian chạy hàng đợi. Bạn có thể thêm nhiều máy khi mở rộng, hợp đồng yêu cầu báo trước 30 ngày, không ràng buộc dài hạn.
Giá render trên máy chủ riêng: mỗi render trên máy chủ riêng là $0.02, bao gồm video. Giá này chỉ áp dụng cho máy chủ riêng. Các gói Images, Video Plus và Video Max vẫn là giá cố định, không tính phí theo render.
Để thuê, viết thư đến info@graydient.ai.
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.