Graydient AI 렌더링 API
앱, 내부 도구 또는 렌더 파이프라인을 구축할 때 Graydient는 전용 GPU에서 오픈 이미지, 비디오, LLM 모델을 하나의 API로 정액 요금에 제공합니다.
포함된 요금제
개인 API는 Video Max에만 포함됩니다. Images와 Video Plus에는 API 접근 권한이 없습니다. 청구 포털에서 언제든지 업그레이드, 다운그레이드 또는 취소할 수 있으며, 요금은 일할 계산됩니다. 비즈니스 플랜 및 API 가격은 business.graydient.ai에서 확인하세요.
개인 API는 한 명의 사용자를 위한 키이며, 어떤 개인 플랜에서도 자동 트래픽은 허용되지 않습니다. 즉, 봇, 스크립트, 스케줄러, 배치 작업, 스크래퍼, 다중 사용자 앱 또는 재판매 접근이 금지됩니다. 호출은 약 10초에 한 번으로 제한됩니다. 자동 또는 과도한 트래픽을 보내는 키는 사전 통보 없이 취소됩니다.
다중 사용자 또는 화이트 라벨 제품 구축
가상 사용자 및 화이트 라벨 로그인은 다수 사용자를 위한 비즈니스급 기능입니다. 개인 API에서 작동하므로 개발 중 Video Max에서 다중 사용자 및 화이트 라벨 흐름을 구축하고 테스트할 수 있습니다.
다중 사용자 제품, 자동 트래픽 또는 재판매 접근을 라이브로 운영하려면 비즈니스 플랜이 필요합니다: 전용 GPU 서버. business.graydient.ai에서 포함 내용, 가격 및 구매 정보를 확인하세요.
| 개인 API (Video Max) | 비즈니스 배포 | |
|---|---|---|
| 사용자 | 한 명의 사용자 (당신) | 당신 제품의 사용자들 |
| 재판매 | 허용되지 않음 | 허용됨 |
| 가상 사용자 및 화이트라벨 로그인 | 빌드 및 테스트 | 실서비스 |
| 획득 방법 | Video Max 구독 | 전용 GPU 서버 또는 비즈니스 계약 |
API 작동 방식
현재 버전은 V3이며, https://cloud.graydient.ai/api/v3/에 있습니다. JSON:API 사양을 따릅니다: application/vnd.api+json을 보내고 받고, API 토큰 페이지에서 받은 표준 HTTP Bearer 토큰으로 인증하며, attributes 멤버가 있는 data 객체에서 결과를 읽습니다.
렌더링은 비동기식입니다. 프롬프트와 필수 callback_url을 포함해 POST /api/v3/render/에 POST합니다. Graydient는 즉시 render_hash와 예상 대기 및 렌더 시간을 응답합니다. 작업이 완료되면 결과를 웹훅으로 POST합니다. 선택적 필드는 다음과 같습니다:
- error_url: 실패 시 웹훅
- init_image 및 mask_image: 이미지 변환 및 인페인팅용
- placeholders: ControlNet 모드 또는 IP 어댑터용 명명된 이미지 URL
- progressive_return: 이미지별 콜백 하나씩
- session_id: 렌더를 자체 사용자와 연동
워크플로우는 프롬프트 내 워크플로우 명령어로 같은 엔드포인트를 통해 실행됩니다.
폴링 없이 상태 확인: GET GET /api/v3/render/{render_hash}는 렌더 상태를 반환하지만 문서에서는 폴링을 권장하지 않습니다. 웹훅이나 wss://cloud.graydient.ai/render-events/{render_hash}의 WebSocket 스트림을 사용하세요. 시작, 이미지 완료, 완료 및 오류 이벤트를 전송합니다.
다른 엔드포인트 종류
- 채팅: 페르소나가 있는 LLM 채팅. 응답은 콜백으로 가거나 sync: true와 함께 인라인으로 돌아오며, 비전 모델은 image_url을 받습니다.
- 컨셉: 사용 가능한 모델과 LoRA 목록.
- 워크플로우: 워크플로우 목록과 txt2img, img2img, txt2vid, img2vid 같은 지원 기능.
- 지식 베이스: 도메인 생성, 사실 추가, URL 크롤링 후 검색 또는 채팅.
- 스킬: 자연어 요청을 워크플로우 명령어로 변환.
- 가상 사용자: 최종 사용자를 계정 내 기록에 매핑. 개인 API에서 빌드 및 테스트 후 비즈니스 배포에서 실서비스.
전체 참조: API 문서. 문서에 따르면 아직 개발 중입니다.
일반적인 사용 사례
- 자체 앱 구동: 이미지, 비디오 또는 채팅 기능의 렌더 백엔드로 Graydient 사용. 개인 API에서 개발 후 실제 사용자 도착 시 비즈니스 배포로 이동.
- 호스팅 모델 사용: 설치한 LoRA와 체크포인트로 렌더링. 자세한 내용은 자신만의 AI 모델 호스팅 참조.
- ComfyAPI 스타일 워크플로우를 원격으로 실행: 자신의 코드에서 매핑된 워크플로우를 호출하세요.
- 제품 및 카탈로그 이미지: 개인 API의 속도 제한 내에서 파이프라인에서 이미지 업스케일, 편집 또는 스타일 변경.
- 배치 렌더링: 지속적이고 대량 배치에는 개인 API 대신 전용 GPU 서버 사용.
- 지식 베이스 채팅: 지식 베이스와 채팅 엔드포인트로 지원 또는 문서 도우미 구축.
전용 GPU 서버
자동 트래픽, 다중 사용자 제품, 재판매 API 접근 또는 하루 종일 배치 렌더링을 계획한다면 비즈니스 플랜이 필요합니다: 전용 GPU 서버로, 전용 머신과 공유 대기열이 없습니다. 가격, 포함 내용 및 주문 양식은 business.graydient.ai에서 확인하세요.
전용 서버의 렌더링별 가격(비디오 포함)은 business.graydient.ai에 나와 있습니다. 이 렌더링별 가격은 비즈니스 플랜에만 적용됩니다. Images, Video Plus 및 Video Max는 렌더링별 요금 없이 정액제입니다.
개인 플랜에서는 자동 트래픽이 허용되지 않습니다. Images, Video Plus 및 Video Max는 한 명의 사용자를 위한 정액제 플랜이며, 자동 트래픽을 보내는 키는 취소됩니다.
시작하기
- Video Max 구독. 언제든 청구 포털에서 플랜 변경 또는 취소 가능.
- API 토큰 페이지에서 토큰 생성.
- API 문서를 읽고 GitHub에서 Graydient API 예제 확인.
- 웹훅 엔드포인트 설정 후 첫 렌더 요청 전송.
- 문서 권장대로 결과 이미지 미러링 및 썸네일 생성 후 사용자에게 제공.
API 지원은 info@graydient.ai 이메일로 가능. 모든 사용은 허용 사용 정책 및 이용 약관에 따름.